admin/sms4j
1
0
Fork 0
mirror of https://gitee.com/dromara/sms4j.git synced 2025-12-06 17:08:40 +08:00
Code Issues Packages Projects Releases Wiki Activity

完成基础发送定义

Browse Source
This commit is contained in:
wind 2023-06-08 23:52:05 +08:00
parent 1cff9a1b73
commit a45df3ea28
13 changed files with 510 additions and 37 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
pom.xml
View File

@ -63,6 +63,7 @@
<activation.version>1.1.1</activation.version>
<mail.version>1.6.2</mail.version>
<sunactivation.version>1.2.0</sunactivation.version>
<jakarta.activation.version>1.2.2</jakarta.activation.version>
</properties>
<dependencyManagement>
@ -180,6 +181,12 @@
<version>${sunactivation.version}</version>
</dependency>
<dependency>
<groupId>jakarta.activation</groupId>
<artifactId>jakarta.activation-api</artifactId>
<version>${jakarta.activation.version}</version>
</dependency>
</dependencies>
</dependencyManagement>

11
sms4j-Email-plugin/pom.xml
View File

@ -56,6 +56,17 @@
<artifactId>javax.activation</artifactId>
<version>${sunactivation.version}</version>
</dependency>
<dependency>
<groupId>jakarta.activation</groupId>
<artifactId>jakarta.activation-api</artifactId>
<version>${jakarta.activation.version}</version>
</dependency>
<dependency>
<groupId>cn.hutool</groupId>
<artifactId>hutool-cron</artifactId>
<version>${hutool.version}</version>
</dependency>
</dependencies>
</dependencyManagement>

14
sms4j-Email-plugin/sms4j-Email-api/src/main/java/org/dromara/email/api/Blacklist.java Normal file
View File

@ -0,0 +1,14 @@
package org.dromara.email.api;
import java.util.List;
/**
* Blacklist
* <p> 黑名单实现 实现此接口，发送邮件时将自动排除调黑名单中的收件人
* @author :Wind
* 2023/6/8 23:05
**/
public interface Blacklist {
List<String> getBlacklist();
}

158
sms4j-Email-plugin/sms4j-Email-api/src/main/java/org/dromara/email/api/MailClient.java
View File

@ -1,8 +1,162 @@
package org.dromara.email.api;
import java.lang.String;
import java.util.List;
import java.util.Map;
public interface MailClient {
void sendMail(String mailAddress, String Title ,String body);
/**
* sendMail
* <p> 发送纯文本邮件
* @param mailAddress 收件人地址
* @param title 邮件标题
* @param body 邮件正文
* @author :Wind
*/
void sendMail(String mailAddress, String title ,String body);
/**
* sendMail
* <p> 群体发送纯文本邮件
* @param mailAddress 收件人地址,添加多个
* @param title 邮件标题
* @param body 邮件正文
* @author :Wind
*/
void sendMail(List<String> mailAddress ,String title ,String body);
/**
* sendEmail
* <p>发送带有附件的文本邮件
* @param mailAddress 收件人地址
* @param title 邮件标题
* @param body 邮件正文
* @param files 附件，可添加多个
* @author :Wind
*/
void sendEmail(String mailAddress, String title, String body, String... files);
/**
* sendEmail
* <p>群体发送带有附件的文本邮件
* @param mailAddress 收件人地址，添加多个
* @param title 邮件标题
* @param body 邮件正文
* @param files 附件，可添加多个
* @author :Wind
*/
void sendEmail(List<String> mailAddress, String title, String body, String... files);
/**
* sendHtml
* <p> 读取模板发送html邮件，无正文
* <p> 将默认读取resources/template下的html文件，第三个参数为html的名称，需携带尾缀
* @param mailAddress 收件人地址，添加多个
* @param title 邮件标题
* @param htmlName 邮件正文
* @param parameter key为模板的变量名称 无需携带大括号 value为模板变量所对应的值
* @author :Wind
*/
void sendHtml(String mailAddress, String title , String htmlName, Map<String,Object> parameter);
/**
* sendHtml
* <p> 读取模板发送html邮件,无正文
* <p> 将默认读取resources/template下的html文件，第三个参数为html的名称，需携带尾缀
* <p> 用户可以自己编写一个实体类，并实现Parameter接口，编写get和set方法，这样一来字段的名称则为模板变量名称，对象的值则为模板变量的值
* @param mailAddress 收件人地址，添加多个
* @param title 邮件标题
* @param htmlName 邮件模板名称
* @param parameter 实体
* @author :Wind
*/
void sendHtml(String mailAddress, String title , String htmlName, Parameter parameter);
/**
* sendHtml
* <p> 读取模板发送html邮件,无正文，带附件
* <p> 将默认读取resources/template下的html文件，第三个参数为html的名称，需携带尾缀
* @param mailAddress 收件人地址，添加多个
* @param title 邮件标题
* @param htmlName 邮件模板名称
* @param parameter 实体
* @param files 附件，可添加多个
* @author :Wind
*/
void sendHtml(String mailAddress, String title , String htmlName,Map<String,Object> parameter,String...files);
/**
* sendHtml
* <p> 读取模板发送html邮件,无正文，带附件
* <p> 将默认读取resources/template下的html文件，第三个参数为html的名称，需携带尾缀
* <p> 用户可以自己编写一个实体类，并实现Parameter接口，编写get和set方法，这样一来字段的名称则为模板变量名称，对象的值则为模板变量的值
* @param mailAddress 收件人地址，添加多个
* @param title 邮件标题
* @param htmlName 邮件模板名称
* @param parameter 实体
* @param files 附件，可添加多个
* @author :Wind
*/
void sendHtml(String mailAddress, String title , String htmlName,Parameter parameter,String...files);
/**
* sendHtml
* <p> 读取模板发送html邮件,并携带正文
* <p> 将默认读取resources/template下的html文件，第四个参数为html的名称，需携带尾缀
* @param mailAddress 收件人地址，添加多个
* @param title 邮件标题
* @param body 邮件文本正文
* @param htmlName 邮件正文
* @param parameter key为模板的变量名称 无需携带大括号 value为模板变量所对应的值
* @author :Wind
*/
void sendHtml(String mailAddress, String title ,String body, String htmlName, Map<String,Object> parameter);
/**
* sendHtml
* <p> 读取模板发送html邮件,并携带正文
* <p> 将默认读取resources/template下的html文件，第四个参数为html的名称，需携带尾缀
* <p> 用户可以自己编写一个实体类，并实现Parameter接口，编写get和set方法，这样一来字段的名称则为模板变量名称，对象的值则为模板变量的值
* @param mailAddress 收件人地址，添加多个
* @param title 邮件标题
* @param body 邮件文本正文
* @param htmlName 邮件正文
* @param parameter 实体
* @author :Wind
*/
void sendHtml(String mailAddress, String title ,String body, String htmlName, Parameter parameter);
/**
* sendHtml
* <p> 读取模板发送html邮件,并携带正文和附件
* <p> 将默认读取resources/template下的html文件，第四个参数为html的名称，需携带尾缀
* @param mailAddress 收件人地址，添加多个
* @param title 邮件标题
* @param body 邮件文本正文
* @param htmlName 邮件正文
* @param parameter key为模板的变量名称 无需携带大括号 value为模板变量所对应的值
* @param files 附件，可添加多个
* @author :Wind
*/
void sendHtml(String mailAddress, String title ,String body, String htmlName, Map<String,Object> parameter,String...files);
/**
* sendHtml
* <p> 读取模板发送html邮件,并携带正文和附件
* <p> 将默认读取resources/template下的html文件，第四个参数为html的名称，需携带尾缀
* <p> 用户可以自己编写一个实体类，并实现Parameter接口，编写get和set方法，这样一来字段的名称则为模板变量名称，对象的值则为模板变量的值
* @param mailAddress 收件人地址，添加多个
* @param title 邮件标题
* @param body 邮件文本正文
* @param htmlName 邮件正文
* @param parameter key为模板的变量名称 无需携带大括号 value为模板变量所对应的值
* @param files 附件，可添加多个
* @author :Wind
*/
void sendHtml(String mailAddress, String title ,String body, String htmlName, Parameter parameter,String...files);
void sendHtml(String mailAddress, String Title ,String body);
}

11
sms4j-Email-plugin/sms4j-Email-api/src/main/java/org/dromara/email/api/Parameter.java Normal file
View File

@ -0,0 +1,11 @@
package org.dromara.email.api;
/**
* Parameter
* <p> 空接口，用于标定用户自己的实体类型
* 用于发送html模板邮件时候 用户传递自己的实体序列化进行的类型标定
* @author :Wind
* 2023/6/8 19:36
**/
public interface Parameter {
}

5
sms4j-Email-plugin/sms4j-Email-comm/pom.xml
View File

@ -18,7 +18,10 @@
</properties>
<dependencies>
<dependency>
<groupId>cn.hutool</groupId>
<artifactId>hutool-cron</artifactId>
</dependency>
</dependencies>
</project>

29
sms4j-Email-plugin/sms4j-Email-comm/src/main/java/org/dromara/email/comm/config/MailSmtpConfig.java
View File

@ -1,6 +1,9 @@
package org.dromara.email.comm.config;
import lombok.Data;
import lombok.Builder;
import lombok.EqualsAndHashCode;
import lombok.Getter;
import lombok.ToString;
/**
* MailSmtpConfig
@ -8,12 +11,20 @@ import lombok.Data;
* @author :Wind
* 2023/6/7 21:19
**/
@Data
@Builder
@ToString
@Getter
@EqualsAndHashCode
public class MailSmtpConfig {
/**
* 端口号
* */
private String host;
private String port;
/**
* 发件人地址
* */
private String fromAddress;
/**
* 服务器地址
@ -29,4 +40,16 @@ public class MailSmtpConfig {
* 密码
* */
private String password;
/**
* 是否开启ssl 默认开启
* */
@Builder.Default
private String isSSL = "true";
/**
* 是否开启验证 默认开启
* */
@Builder.Default
private String isAuth = "true";
}

11
sms4j-Email-plugin/sms4j-Email-comm/src/main/java/org/dromara/email/comm/utils/BaseUtil.java Normal file
View File

@ -0,0 +1,11 @@
package org.dromara.email.comm.utils;
import java.io.File;
public class BaseUtil {
public static String getPathName(String path) {
String[] split = path.split(File.separator);
return split[split.length-1];
}
}

36
sms4j-Email-plugin/sms4j-Email-comm/src/main/java/org/dromara/email/comm/utils/ReflectUtil.java Normal file
View File

@ -0,0 +1,36 @@
package org.dromara.email.comm.utils;
import org.dromara.email.comm.errors.MailException;
import java.lang.reflect.Field;
import java.lang.reflect.Parameter;
import java.util.HashMap;
import java.util.Map;
public class ReflectUtil {
/**
* 反射获取接口对象的原类名
*/
public static String getObjectName(Parameter parameter) {
return parameter.getClass().getTypeName();
}
/**
* 将对象的属性和属性值变为map
* */
public static Map<String, Object> getValues(Parameter parameter) {
try {
Map<String ,Object> map = new HashMap<>();
Class<?> clazz = Class.forName(getObjectName(parameter));
Field[] declaredFields = clazz.getDeclaredFields();
for (Field declaredField : declaredFields) {
declaredField.setAccessible(true);
map.put(declaredField.getName(),declaredField.get(parameter));
}
return map;
} catch (Exception e) {
throw new MailException(e);
}
}
}

5
sms4j-Email-plugin/sms4j-Email-core/pom.xml
View File

@ -34,6 +34,11 @@
<artifactId>javax.activation</artifactId>
</dependency>
<dependency>
<groupId>jakarta.activation</groupId>
<artifactId>jakarta.activation-api</artifactId>
</dependency>
</dependencies>

62
sms4j-Email-plugin/sms4j-Email-core/src/main/java/org/dromara/email/core/factory/ConfigFactory.java Normal file
View File

@ -0,0 +1,62 @@
package org.dromara.email.core.factory;
import org.dromara.email.api.Blacklist;
import org.dromara.email.api.MailClient;
import org.dromara.email.comm.config.MailSmtpConfig;
import org.dromara.email.comm.errors.MailException;
import org.dromara.email.core.service.MailBuild;
import javax.mail.MessagingException;
import java.util.HashMap;
import java.util.Map;
/**
* ConfigFactory
* <p> 配置工厂
* @author :Wind
* 2023/6/8 22:35
**/
public class ConfigFactory{
private static final Map<Object,MailSmtpConfig> configs = new HashMap<>();
/**
* createMailClient
* <p>从工厂获取一个邮件发送实例
* @param key 配置的标识key
* @author :Wind
*/
public static MailClient createMailClient(Object key){
try {
return MailBuild.build(configs.get(key));
} catch (MessagingException e) {
throw new MailException(e);
}
}
/**
* createMailClient
* <p>从工厂获取一个邮件发送实例,该实例发送短信将依照黑名单中的数据进行过滤
* @param key 配置的标识key
* @param blacklist 黑名单接口，实例将从这里获取黑名单数据
* @author :Wind
*/
public static MailClient createMailClient(Object key, Blacklist blacklist){
try {
return MailBuild.build(configs.get(key));
} catch (MessagingException e) {
throw new MailException(e);
}
}
/**
* set
* <p>将一个配置对象交给工厂
* @param key 标识
* @param config 配置对象
* @author :Wind
*/
public static void set(Object key, MailSmtpConfig config){
configs.put(key,config);
}
}

74
sms4j-Email-plugin/sms4j-Email-core/src/main/java/org/dromara/email/core/service/MailBuild.java Normal file
View File

@ -0,0 +1,74 @@
package org.dromara.email.core.service;
import cn.hutool.core.collection.CollUtil;
import lombok.Data;
import org.dromara.email.api.Blacklist;
import org.dromara.email.api.MailClient;
import org.dromara.email.comm.config.MailSmtpConfig;
import org.dromara.email.comm.errors.MailException;
import javax.mail.*;
import javax.mail.internet.AddressException;
import javax.mail.internet.InternetAddress;
import javax.mail.internet.MimeMessage;
import java.util.ArrayList;
import java.util.List;
import java.util.Objects;
import java.util.Properties;
@Data
public class MailBuild {
private Message message;
private Session session;
private MailSmtpConfig config;
private Blacklist blacklist;
private MailBuild(MailSmtpConfig config) throws MessagingException {
Properties props = new Properties();
props.put("mail.smtp.host", config.getSmtpServer());
props.put("mail.smtp.auth", config.getIsAuth());
props.put("mail.smtp.port", config.getPort());
props.put("mail.smtp.ssl.enable", config.getIsSSL());
// props.put("mail.smtp.ssl.socketFactory", new MailSSLSocketFactory());
this.session = Session.getInstance(props, new Authenticator() {
protected PasswordAuthentication getPasswordAuthentication() {
return new PasswordAuthentication(config.getUsername(), config.getPassword());
}
});
this.message = new MimeMessage(session);
this.message.setFrom(new InternetAddress(config.getFromAddress()));
this.config = config;
}
public static MailClient build(MailSmtpConfig config) throws MessagingException {
return MailService.NewMailService(new MailBuild(config));
}
/**
* eliminate
* <p>过滤黑名单内容
*
* @param
* @author :Wind
*/
public InternetAddress[] eliminate(List<String> source) {
List<String> list = new ArrayList<>();
try {
if (Objects.isNull(blacklist)) {
return InternetAddress.parse(Objects.requireNonNull(CollUtil.join(source, ",")));
}
for (String s : blacklist.getBlacklist()) {
if (!source.contains(s)) {
list.add(s);
}
}
return InternetAddress.parse(CollUtil.join(list, ","));
} catch (AddressException e) {
throw new MailException(e);
}
}
}

124
sms4j-Email-plugin/sms4j-Email-core/src/main/java/org/dromara/email/core/service/MailService.java
View File

@ -1,60 +1,114 @@
package org.dromara.email.core.service;
import lombok.extern.slf4j.Slf4j;
import org.dromara.email.api.Blacklist;
import org.dromara.email.api.MailClient;
import org.dromara.email.api.Parameter;
import org.dromara.email.comm.errors.MailException;
import org.dromara.email.comm.utils.BaseUtil;
import javax.activation.DataHandler;
import javax.activation.DataSource;
import javax.activation.FileDataSource;
import javax.mail.*;
import javax.mail.internet.InternetAddress;
import javax.mail.internet.MimeBodyPart;
import javax.mail.internet.MimeMessage;
import javax.mail.internet.MimeMultipart;
import java.util.Properties;
import java.util.*;
@Slf4j
public class MailService implements MailClient {
private MailService() {
private MailBuild mailBuild;
private MailService(MailBuild mailBuild) {
this.mailBuild = mailBuild;
}
public static MailClient NewMailService() {
return new MailService();
public static MailClient NewMailService(MailBuild mailBuild) {
return new MailService(mailBuild);
}
@Override
public void sendMail(String mailAddress, String Title, String body) {
String smtpServer = "smtp.qq.com";
String username = "wzsf1810@qq.com";
String password = "xophzbzswkzkiacb";
String fromAddress = "wzsf1810@qq.com";
String toAddress = "291203727@qq.com";
int port = 465; // SMTP服务器的端口号
public void sendMail(String mailAddress, String title, String body) {
sendEmail(mailAddress,title,body);
}
Properties props = new Properties();
props.put("mail.smtp.host", smtpServer);
props.put("mail.smtp.auth", "true");
props.put("mail.smtp.port", port);
props.put("mail.smtp.ssl.enable", "true");
// props.put("mail.smtp.ssl.socketFactory", new MailSSLSocketFactory());
@Override
public void sendMail(List<String> mailAddress, String title, String body) {
sendEmail(mailAddress,title,body);
}
Session session = Session.getInstance(props, new Authenticator() {
protected PasswordAuthentication getPasswordAuthentication() {
return new PasswordAuthentication(username, password);
}
});
@Override
public void sendEmail(String mailAddress, String title, String body, String... files) {
sendEmail(Collections.singletonList(mailAddress),title,body,files);
}
@Override
public void sendEmail(List<String> mailAddress, String title, String body, String... files) {
try {
Message message = new MimeMessage(session);
message.setFrom(new InternetAddress(fromAddress));
message.setRecipients(Message.RecipientType.TO, InternetAddress.parse(toAddress));
message.setSubject(Title);
Message message = mailBuild.getMessage();
message.setRecipients(Message.RecipientType.TO, mailBuild.eliminate(mailAddress));
message.setSubject(title);
message.setText(body);
Multipart multipart = new MimeMultipart();
for (String file : files) {
// 设置附件消息部分
MimeBodyPart messageBodyPart = new MimeBodyPart();
DataSource source = new FileDataSource(file);
messageBodyPart.setDataHandler(new DataHandler(source));
messageBodyPart.setFileName(BaseUtil.getPathName(file));
multipart.addBodyPart(messageBodyPart);
}
message.setContent(multipart);
Transport.send(message);
System.out.println("Email sent successfully.");
} catch (MessagingException e) {
System.out.println("Failed to send email: " + e.getMessage());
throw new MailException(e);
}
}
@Override
public void sendHtml(String mailAddress, String title, String htmlName, Map<String, Object> parameter) {
}
@Override
public void sendHtml(String mailAddress, String title, String htmlName, Parameter parameter) {
}
@Override
public void sendHtml(String mailAddress, String title, String htmlName, Map<String, Object> parameter, String... files) {
}
@Override
public void sendHtml(String mailAddress, String title, String htmlName, Parameter parameter, String... files) {
}
@Override
public void sendHtml(String mailAddress, String title, String body, String htmlName, Map<String, Object> parameter) {
}
@Override
public void sendHtml(String mailAddress, String title, String body, String htmlName, Parameter parameter) {
}
@Override
public void sendHtml(String mailAddress, String title, String body, String htmlName, Map<String, Object> parameter, String... files) {
}
@Override
public void sendHtml(String mailAddress, String title, String body, String htmlName, Parameter parameter, String... files) {
}
@Override
public void sendHtml(String mailAddress, String Title, String body) {
String smtpServer = "smtp.qq.com";
@ -89,11 +143,19 @@ public class MailService implements MailClient {
htmlPart.setContent(body, "text/html;charset=UTF-8");
message.setContent(multipart);
multipart.addBodyPart(htmlPart);
Transport.send(message);
MimeBodyPart messageBodyPart = new MimeBodyPart();
String filename = "file.txt";
DataSource source = new FileDataSource(filename);
messageBodyPart.setDataHandler(new DataHandler(source));
messageBodyPart.setFileName(filename);
multipart.addBodyPart(messageBodyPart);
Transport.send(message);
System.out.println("Email sent successfully.");
} catch (MessagingException e) {
System.out.println("Failed to send email: " + e.getMessage());
throw new MailException(e);
}
}
}