JarCastingSpring 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>
}