连接内外网邮箱，实现邮件提醒功能

在调用过mq后，或者事件办完后，经常有邮件通知提醒的需求。而springboot也提供了start，只需要按照要求调用方法即可。但是网络上大多事如何调用外网邮箱的博文，本文将分别实现如何调用内外网邮件。

1.业务代码

1.pom文件

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-mail</artifactId>
    <version>2.3.7.RELEASE</version>
</dependency>

2.实体类

存放接口的发送信息。

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

3.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);
    }

}

3.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);

}

5.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.配置文件

上文代码在其他博文中很多，大多相同。而重点就是配置文件。

1.使用外网

修改application.xml。

spring:
 mail:
    host: smtp.qq.com #SMTP服务器地址
    username: [e-mail] #登陆账号
    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 #限制请求总量

注意：不要填写，而是授权码。

1.获取授权码

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

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

2.内网邮箱

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

然后就可以发送邮件了。

要注意：此处是邮箱的登录而不是授权码！同时跟邮件创建者确定好邮箱开放的类型与端口号。否者会照成失败的情况。

3.接口调用入参

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

接口调用成功后，即可访问邮件查看是否发送成功。