springboot业务功能实战(二十)连接内外网邮箱配置全解析,实现邮件提醒功能

Posted 小黄鸡1992

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了springboot业务功能实战(二十)连接内外网邮箱配置全解析,实现邮件提醒功能相关的知识,希望对你有一定的参考价值。

1.业务代码

实体类(存放接口的发送信息)

public class MailVO {
    /**
     * 邮件Id
     */
    @ApiModelProperty(value = "邮件Id", name = "邮件Id")
    private String id;
    /**
     * 邮件发送人
     */
    @ApiModelProperty(value = "邮件发送人", name = "邮件发送人")
    private String emailSender;
    /**
     * 邮件接收人(多个邮箱则用逗号","隔开)
     */
    @ApiModelProperty(value = "邮件接收人", name = "邮件接收人")
    private String emailReciever;
    /**
     * 邮件主题
     */
    @ApiModelProperty(value = "邮件主题", name = "邮件主题")
    private String emailSubject;
    /**
     * 邮件内容
     */
    @ApiModelProperty(value = "邮件内容", name = "邮件内容")
    private String emailText;
    /**
     * 发送时间
     */
    @ApiModelProperty(value = "发送时间", name = "发送时间")
    private Long sentDate;
    /**
     * 抄送(多个邮箱则用逗号","隔开)
     */
    @ApiModelProperty(value = "抄送(多个邮箱则用逗号\\",\\"隔开)", name = "抄送(多个邮箱则用逗号\\",\\"隔开)")
    private String carbonCopy;
    /**
     * 密送(多个邮箱则用逗号","隔开)
     */
    @ApiModelProperty(value = "密送(多个邮箱则用逗号\\",\\"隔开)", name = "密送(多个邮箱则用逗号\\",\\"隔开)")
    private String blindCarbonCopy;
    /**
     * 状态
     */
    @ApiModelProperty(value = "状态", name = "状态")
    private String status;
    /**
     * 报错信息
     */
    @ApiModelProperty(value = "报错信息", name = "报错信息")
    private String error;
    /**
     * 邮件附件
     */
    @JsonIgnore
    @ApiModelProperty(value = "邮件附件", name = "邮件附件")
    private MultipartFile[] multipartFiles;
}

controller

@RestController
@RequestMapping("/mail")
public class MailController {

    @Autowired
    private MailService mailService;

    /**
     * 功能描述: 发送邮件
     *
     * @param mailVO
     * @return MailVO
     */
    @PostMapping("/send")
    @ApiOperation(value = "发送邮件")
    public MailVO sendMail(@RequestBody MailVO mailVO) {
        //发送邮件和附件
        return mailService.sendMail(mailVO);
    }

}

service

public interface MailService {
    /**
     * 功能描述:发送邮件
     *
     * @param mailVO
     * @return MailVO
     */
    MailVO sendMail(MailVO mailVO);

    /**
     * 功能描述:检测邮件信息类
     *
     * @param mailVo
     * @return
     */
    void checkMail(MailVO mailVo);

    /**
     * 功能描述:构建复杂的邮件
     *
     * @param mailVo
     * @return
     */
    void sendMimeMail(MailVO mailVo);

    /**
     * 功能描述:保存邮件
     *
     * @param mailVo
     * @return mailVo
     */
    MailVO saveMail(MailVO mailVo);

}

serviceimpl(发送邮件的逻辑功能)

@Service("mailService")
public class MailServiceImpl implements MailService {

    private Logger logger = LoggerFactory.getLogger(getClass());
    @Autowired
   private JavaMailSenderImpl mailSender;

    @Override
    public MailVO sendMail(MailVO mailVO) {
        try {
            //1.检测邮件
            checkMail(mailVO);
            //2.发送邮件
            sendMimeMail(mailVO);
            //3.保存邮件
            return saveMail(mailVO);
        } catch (Exception e) {
            //打印错误信息
            logger.error("发送邮件失败:", e);
            mailVO.setStatus("fail");
            mailVO.setError(e.getMessage());
            return mailVO;
        }

    }

    @Override
    public void checkMail(MailVO mailVo) {
        if (StringUtils.isEmpty(mailVo.getEmailReciever())) {
            throw new RuntimeException("邮件收信人不能为空");
        }
        if (StringUtils.isEmpty(mailVo.getEmailSubject())) {
            throw new RuntimeException("邮件主题不能为空");
        }
        if (StringUtils.isEmpty(mailVo.getEmailText())) {
            throw new RuntimeException("邮件内容不能为空");
        }
    }

    @Override
    public void sendMimeMail(MailVO mailVo) {
        try {
            //true表示支持复杂类型
            MimeMessageHelper messageHelper = new MimeMessageHelper(mailSender.createMimeMessage(), true);
            //邮件发信人从配置项读取
            mailVo.setEmailSender(mailVo.getEmailSender());
            //邮件发信人
            messageHelper.setFrom(mailVo.getEmailSender());
            //邮件收信人
            messageHelper.setTo(mailVo.getEmailReciever().split(","));
            //邮件主题
            messageHelper.setSubject(mailVo.getEmailSubject());
            //邮件主题
            messageHelper.setText(mailVo.getEmailText());
            //抄送
            if (!StringUtils.isEmpty(mailVo.getCarbonCopy())) {
                messageHelper.setCc(mailVo.getCarbonCopy().split(","));
            }
            //密送
            if (!StringUtils.isEmpty(mailVo.getBlindCarbonCopy())) {
                messageHelper.setCc(mailVo.getBlindCarbonCopy().split(","));
            }
            //添加邮件附件
            if (mailVo.getMultipartFiles() != null) {
                for (MultipartFile multipartFile : mailVo.getMultipartFiles()) {
                    messageHelper.addAttachment(multipartFile.getOriginalFilename(), multipartFile);
                }
            }
            //发送时间
            if (!StringUtils.isEmpty(mailVo.getSentDate().toString())) {
                messageHelper.setSentDate(new Date());
            }
            //正式发送邮件
            mailSender.send(messageHelper.getMimeMessage());
            mailVo.setStatus("ok");
            logger.info("发送邮件成功:{}->{}", mailVo.getEmailSender(), mailVo.getEmailReciever());
        } catch (Exception e) {
            //发送失败
            throw new RuntimeException(e);
        }
    }

    @Override
    public MailVO saveMail(MailVO mailVo) {
        return mailVo;
    }

}

2.配置文件

其中配置文件分内外网

使用外网(qq邮箱)

application.xml

spring:
 mail:
    host: smtp.qq.com #SMTP服务器地址
    username: xxxx@qq.com #登陆账号
    password: 1 #授权码 不是密码
    default-encoding: utf-8 #utf-8格式
    properties:
      mail:
        smtp:
          ssl:
            enable: true #一定要开启ssl,不然会503 验证失败
    servlet:
      multipart:
        max-file-size: 10MB #限制单个文件大小
        max-request-size: 50MB #限制请求总量

获取授权码

访问qq邮箱,访问左上角帮助中心

 

返回的就是授权码 复制到上文即可

内网邮箱

spring:
 mail:
    host: mail.xxx.com #SMTP服务器地址
    port: 25  #内网需要指定端口需要指定
    username: xxx@xx.com #登陆账号
    password: xxxx    #登陆密码
    default-encoding: utf-8
    properties:
      mail:
        smtp:
          ssl:
            enable: false #根据自己内网是否启动配置
    servlet:
      multipart:
        max-file-size: 10MB #限制单个文件大小
        max-request-size: 50MB #限制请求总量

然后就可以发送邮件了

3.接口入参


{
  "emailSender":"xxxx@xxx.com",
  "emailReciever":"xxx@xxx.com",
  "emailSubject":"测试邮件",
  "emailText":"6月7日上午,2021年高考首场语文考试结束。澎湃新闻从教育部考试中心获悉,今年全国高考语文共有8套试卷,教育部考试中心命制4套,分别为全国甲卷、全国乙卷、新高考Ⅰ卷、新高考Ⅱ卷,北京、天津、上海、浙江。",
   "sentDate": 20210607
}

 

以上是关于springboot业务功能实战(二十)连接内外网邮箱配置全解析,实现邮件提醒功能的主要内容,如果未能解决你的问题,请参考以下文章

企业级springboot落地:连接内外网邮箱,实现邮件提醒功能

慕课网实战Spark Streaming实时流处理项目实战笔记二十之铭文升级版

SpringBoot--实战开发--压力测试(二十四)

第二十九节: Asp.Net Core零散总结(各种目录内外网ip)[不断补充]

慕课网实战Spark Streaming实时流处理项目实战笔记二十一之铭文升级版

Java 微服务 day02 源代码 SpringBoot 实战开发 整合Mybatis(数据库连接池),通用Mapper整合,业务层整合