FreeMarker 이메일 템플릿 표시 문제 해결

FreeMarker를 통해 전송된 이메일의 HTML 표시 문제 해결

Java 및 Spring 프레임워크 구성

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.servlet.view.freemarker.FreeMarkerConfigurer;
import freemarker.template.Template;
import java.util.Map;
import java.util.HashMap;
import java.nio.charset.StandardCharsets;
import javax.mail.internet.MimeMessage;
import org.springframework.mail.javamail.JavaMailSender;
import org.springframework.mail.javamail.MimeMessageHelper;
import org.springframework.stereotype.Service;
@Service
public class EmailService {
    @Autowired
    private JavaMailSender mailSender;
    @Autowired
    private FreeMarkerConfigurer freemarkerConfigurer;
    public void sendEmail(Map<String, Object> model) throws Exception {
        Template template = freemarkerConfigurer.getConfiguration().getTemplate("emailTemplate.ftl");
        String html = FreeMarkerTemplateUtils.processTemplateIntoString(template, model);
        MimeMessage message = mailSender.createMimeMessage();
        MimeMessageHelper helper = new MimeMessageHelper(message, MimeMessageHelper.MULTIPART_MODE_MIXED_RELATED, StandardCharsets.UTF_8.name());
        helper.setTo("example@example.com");
        helper.setText(html, true);
        helper.setSubject("Testing from Spring Boot");
        mailSender.send(message);
    }
}

HTML 이메일 콘텐츠에 대한 CSS 인라인 구현

Spring 이메일 및 CSS 인라인을 사용하는 Java

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.core.io.ClassPathResource;
import org.springframework.util.StreamUtils;
import java.nio.charset.StandardCharsets;
import org.springframework.mail.javamail.MimeMessageHelper;
import org.springframework.mail.javamail.JavaMailSender;
import org.jsoup.Jsoup;
import org.jsoup.nodes.Document;
@Service
public class InlineCssEmailService {
    @Autowired
    private JavaMailSender mailSender;
    public void sendStyledEmail(Map<String, Object> model, String templatePath) throws Exception {
        String htmlContent = new String(StreamUtils.copyToByteArray(new ClassPathResource(templatePath).getInputStream()), StandardCharsets.UTF_8);
        Document document = Jsoup.parse(htmlContent);
        document.select("style").forEach(style -> {
            String css = style.data();
            document.select(style.attr("for")).attr("style", css);
        });
        MimeMessage message = mailSender.createMimeMessage();
        MimeMessageHelper helper = new MimeMessageHelper(message, true);
        helper.setTo("test@example.com");
        helper.setSubject("Styled Email Test");
        helper.setText(document.outerHtml(), true);
        mailSender.send(message);
    }
}

이메일 템플릿 통합 FAQ

1. 내 이메일에 HTML 코드가 표시되는 이유는 무엇입니까?
2. 이는 일반적으로 잘못된 MIME 유형 설정이나 이메일 전송 구성의 HTML 지원 부족으로 인해 이메일 클라이언트가 HTML을 콘텐츠로 인식하지 못하는 경우에 발생합니다.
3. 내 스타일이 Outlook에 적용되었는지 어떻게 확인할 수 있나요?
4. 사용 CSS inlining 외부 또는 헤더 스타일을 무시할 수 있는 Outlook에서 스타일이 제거되지 않도록 합니다.
5. 프리마커란 무엇인가요?
6. FreeMarker는 템플릿을 기반으로 텍스트 출력을 생성하는 데 사용되는 템플릿 엔진으로, 동적 HTML 이메일을 만드는 데 자주 사용됩니다.
7. HTML 이메일을 어떻게 테스트하나요?
8. Litmus 또는 Email on Acid와 같은 이메일 테스트 도구를 사용하면 이메일을 보내기 전에 다양한 이메일 클라이언트에서 이메일이 어떻게 보이는지 미리 볼 수 있습니다.
9. 내 이메일에 이미지가 표시되지 않는 이유는 무엇입니까?
10. 이는 이메일 클라이언트가 기본적으로 이미지를 차단하거나 HTML 코드에서 이미지를 참조하는 방식에 문제가 있기 때문일 수 있습니다.

템플릿 렌더링에 대한 논의 마무리

FreeMarker 템플릿을 사용하여 이메일 렌더링의 복잡성을 탐색하려면 템플릿 엔진과 이메일 클라이언트 기능을 모두 명확하게 이해해야 합니다. CSS 인라인화 및 다양한 클라이언트에 대한 세심한 테스트와 같은 전략을 채택함으로써 개발자는 이메일 표시 방식을 크게 개선할 수 있습니다. 또한 올바른 Spring 구성과 Java 클래스를 이해하고 활용하면 디자인 기대치를 충족하는 이메일을 전달하는 데 도움이 될 수 있으며 궁극적으로 전문적이고 매력적인 사용자 경험을 보장할 수 있습니다.