Spring Email API (Java/Kotlin)

It is an API for Java and Kotlin to send emails with Spring. To add to the project, only do this things.

Add dependency to pom.xml

For Java:

<dependency>
	<groupId>com.github.migangqui</groupId>
	<artifactId>spring-email-api-java</artifactId>
	<version>${currentVersion}</version>
</dependency>

For Kotlin:

<dependency>
	<groupId>com.github.migangqui</groupId>
	<artifactId>spring-email-api-kotlin</artifactId>
	<version>${currentVersion}</version>
</dependency>

${currentVersion} is 1.0.1

Add the following properties in application.yml of the project

spring:
  mail:
    default-encoding: UTF-8
    host: # for example: smtp.gmail.com
    username: # Your email
    password: # Your email pass
    port: # SMPT port, for exaple: 25, 587
    properties:
      mail:
        transport.protocol: smtp
# Optional properties
#        smtp:
#          ssl:
#            trust: '*'
#          auth: true
#          starttls:
#            enable: true
#            required: true

Enable async

Add @EnableAsync annotation in your Spring Application class to enable async send method.

Component scan

It's not neccesary add the package to component scan with this new version.

How to use

You have to inject EmailService as dependency in your Spring component. The service provide these methods:

Java

public interface EmailService {
    SendEmailResult send(Email emailDTO);
        
    Future<SendEmailResult> sendAsync(Email emailDTO);
}

Kotlin

interface AmazonS3Service {
    fun send(email: Email): SendEmailResult

    fun sendAsync(email: Email): Future<SendEmailResult>
}