https://github.com/sevensource/html-email-service

Library for creating and sending HTML email with Spring. Contains functionality to transform text to html, as well as html to text.
https://github.com/sevensource/html-email-service

email email-sender email-template java java-mail spring thymeleaf

Last synced: 10 months ago
JSON representation

Library for creating and sending HTML email with Spring. Contains functionality to transform text to html, as well as html to text.

• Host: GitHub
• URL: https://github.com/sevensource/html-email-service
• Owner: sevensource
• License: apache-2.0
• Created: 2012-11-15T01:06:41.000Z (about 13 years ago)
• Default Branch: master
• Last Pushed: 2020-10-13T00:21:46.000Z (over 5 years ago)
• Last Synced: 2024-11-16T01:16:04.318Z (about 1 year ago)
• Topics: email, email-sender, email-template, java, java-mail, spring, thymeleaf
• Language: Java
• Size: 106 KB
• Stars: 0
• Watchers: 3
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
[![GitHub Tag](https://img.shields.io/github/tag/sevensource/html-email-service.svg?maxAge=3600)](https://github.com/sevensource/html-email-service/tags)

[![Maven Central](https://img.shields.io/maven-central/v/org.sevensource.mail/html-email-service.svg?maxAge=3600)](http://search.maven.org/#search%7Cga%7C1%7Cg%3A%22org.sevensource.mail%22%20AND%20a%3A%22html-email-service%22)

[![License](https://img.shields.io/github/license/sevensource/html-email-service.svg)](https://github.com/sevensource/html-email-service/blob/master/LICENSE)

[![Build Status](https://img.shields.io/circleci/project/github/sevensource/html-email-service.svg)](https://circleci.com/gh/sevensource/html-email-service)

# html-email-service

## Wrapper library for creating and sending HTML email with Spring.

 * uses Thymeleaf for templating

 * transforms text to html

 * transforms html to text

 * attachments (inline and attachment)

## Example

```xml

	org.sevensource.mail

	html-email-service

	${the.version}

```

```java

@Configuration

public class EmailServiceConfiguration {

	@Autowired

	ApplicationContext applicationContext;

	

	// also see ConfigurableJavaMailSenderConfiguration

	@Autowired 

	JavaMailSender javaMailSender;

	

	@Bean

	public EmailTemplateRendererService emailTemplateRenderService() {

		return new EmailTemplateRendererService(factory);

	}

	

	@Bean

	public EmailSenderService emailSenderService() {

		TemplateEngineFactory factory = new DefaultTemplateEngineFactory(applicationContext);

		return new EmailTemplateRendererService(factory);

	}

}

```

```java

public void sendmail() {

	DefaultEmailModel model = new DefaultEmailModel();

	model.setFrom("foo@bar.com", "Foobar");

	model.addTo("far@boo.com", "Farboo");

	model.setSubject("Let's get things started");

	

	//create a simple HTML representation from plain text

	String text = "Make sure to check out http://www.github.com"; 

	String html = emailTemplateRendererService.textToHtml(text);

	model.setText(text);

	model.setHtml(html);

	

	emailService.sendMail(model);

	

	// ...or render a Thymeleaf template into HTML and automatically

	// provide a text only fallback version

	Map renderModel = new HashMap<>();

	renderModel.put("message", "Check out http://www.github.com");

	html = emailTemplateRendererService.render("someTemplate", emailModel, renderModel, Locale.ENGLISH);

	text = emailTemplateRendererService.htmlToText(html);

	model.setText(text);

	model.setHtml(html);

	

	emailService.sendMail(model);

}

```