我和我的项目之整合QQ邮箱发送邮件

写在前面：

和上一篇整合短信发送一样，邮件发送也是我们平常生活中会经常遇到的一种情景。有时也会发送验证码到自己的邮箱类似手机发送短信验证码。有时也会发送链接地址进行激活登录。上一篇用了短信这一篇就来用下发送邮件吧。

Yml

把发送邮箱需要用到的属性在yml里配置。

#QQ邮箱配置
mail:
  #发送邮件服务器
  mailHost: smtp.qq.com 
  #端口号
  mailPort: 465
  #发送邮件的邮箱地址
  #mailUsername和mailFrom要一样！！！！！！！！！！！！！
  mailUsername: 【你自己QQ邮箱】
  #邮箱授权码
  mailPassword: 【你自己QQ邮箱里的授权码】
  #时间延迟
  mailTimeout: 25000
  #发送人
  #mailUsername和mailFrom要一样！！！！！！！！！！！！！
  mailFrom: 【你自己QQ邮箱】
  #发件人
  personal: 【发件人名称】
  #主题
  subject: 【邮箱验证码】

邮箱授权码,去自己QQ邮箱。邮箱设置选择账户，开启POP3/SMTP服务。然后会得到一个授权码。

GlobalConfig

获取yml里的属性，进行对应绑定。之前已经绑定过了发送短信，这次加上绑定邮箱。

//全局参数变量设置
@Configuration
public class GlobalConfig implements InitializingBean {


    //======================================邮件配置========================================================
    /*** 邮箱服务器 */
    @Value("${mail.mailHost}")
    public String mailHost;


    /*** 邮箱的端口 */
    @Value("${mail.mailPort}")
    public String mailPort;


    /*** 邮箱账号 */
    @Value("${mail.mailUsername}")
    public String mailName;


    /*** 邮箱授权码 */
    @Value("${mail.mailPassword}")
    public String mailPassword;


    /*** 邮箱超时时间 */
    @Value("${mail.mailTimeout}")
    public String mailTimeout;


    /*** 邮箱发送人 */
    @Value("${mail.mailFrom}")
    public String mailFrom;


    /*** 邮箱发件人 */
    @Value("${mail.personal}")
    public String mailPerson;


    /*** 邮箱主题 */
    @Value("${mail.subject}")
    public String mailSubject;


    //=====================邮件配置======================
    public static String MAIL_HOST;
    public static String MAIL_PORT;
    public static String MAIL_NAME;
    public static String MAIL_PASSWORD;
    public static String MAIL_TIMEOUT;
    public static String MAIL_FROM;
    public static String MAIL_PERSON;


    @Override
    public void afterPropertiesSet() throws Exception {
        //=======邮件配置=============
        MAIL_HOST = mailHost;
        MAIL_PORT = mailPort;
        MAIL_NAME = mailName;
        MAIL_PASSWORD = mailPassword;
        MAIL_TIMEOUT = mailTimeout;
        MAIL_FROM = mailFrom;
        MAIL_PERSON = mailPerson;
        MAIL_SUBJECT = mailSubject;
    }
}

EmailService

把发送邮件做成一个个Service（发送文本邮件、发送Html邮件、发送带附件邮件）。需要用到的时候进行@Autowired即可。

public interface EmailService {
    /**
     * 发送文本邮件
     * @param to 收件人
     * @param subject 主题
     * @param content 内容
     */
    void sendSimpleMail(String to, String subject, String content);


    /**
     * 发送HTML邮件
     * @param to 收件人
     * @param subject 主题
     * @param content 内容
     */
    void sendHtmlMail(String to, String subject, String content);


    /**
     * 发送带附件的邮件
     * @param to 收件人
     * @param subject 主题
     * @param content 内容
     * @param filePath 附件
     */
    void sendAttachmentsMail(String to, String subject, String content, String filePath);
}

EmailServiceImpl

实现了EmailService接口，在这里主要实现其相对应的功能。在里面进行发送邮件javaMailSender模板的配置工作。每次调用里面发送邮件接口时，才去加载GlobalConfig里的配置。

Ps:在JavaMailProperties中加上下面这3个属性。并设置它们为true。

mail.smtp.starttls.enable: true

mail.smtp.starttls.required: true

mail.smtp.ssl.enable: true

@Service
public class EmailServiceImpl implements EmailService {


    /**
     * 放弃项目启动 初始化时 加载。不然GlobalConfig加载不进来。
     每次来调用的时候 才去加载 configEmail
     */


    /**
     * 配置邮件发送
     */
    public JavaMailSenderImpl configEmail() {
        JavaMailSenderImpl javaMailSender = new JavaMailSenderImpl();


        javaMailSender.setHost(GlobalConfig.MAIL_HOST);
        javaMailSender.setPort(Integer.parseInt(GlobalConfig.MAIL_PORT));
        //Ps：mailUsername和mailFrom要一样
        javaMailSender.setUsername(GlobalConfig.MAIL_NAME);
        javaMailSender.setPassword(GlobalConfig.MAIL_PASSWORD);
        javaMailSender.setDefaultEncoding("Utf-8");


        Properties p = new Properties();
//        mail.smtp.starttls.enable: true
//        mail.smtp.starttls.required: true
//        mail.smtp.ssl.enable: true
        p.setProperty("mail.smtp.timeout", "25000");
        p.setProperty("mail.smtp.auth", "true");
        p.setProperty("mail.smtp.starttls.enable", "true");
        p.setProperty("mail.smtp.starttls.required", "true");
        p.setProperty("mail.smtp.ssl.enable", "true");
        javaMailSender.setJavaMailProperties(p);
        
        return javaMailSender;
    }
}

/**
 * 发送文本邮件
 * @param to 收件人
 * @param subject 主题
 * @param content 内容
 */
@Override
public void sendSimpleMail(String to, String subject, String content) {
    //每次来调用的时候 才去加载 configEmail
    JavaMailSenderImpl javaMailSender = configEmail();


    //创建SimpleMailMessage对象
    SimpleMailMessage message = new SimpleMailMessage();
    //邮件发送人 Ps：mailUsername和mailFrom要一样
    message.setFrom(GlobalConfig.MAIL_NAME);
    //邮件接收人
    message.setTo(to);
    //邮件主题
    message.setSubject(subject);
    //邮件内容
    message.setText(content);
    //发送邮件
    javaMailSender.send(message);
    //日志信息
    log.info("邮件已经发送。");
}
/**
 * 发送HTML邮件
 * @param to 收件人
 * @param subject 主题
 * @param content 内容
 */
 @Override
 public void sendHtmlMail(String to, String subject, String content) {
      //每次来调用的时候 才去加载 configEmail
      JavaMailSenderImpl javaMailSender = configEmail();


      //获取MimeMessage对象
      MimeMessage message = javaMailSender.createMimeMessage();
      MimeMessageHelper messageHelper;
      try {
          messageHelper = new MimeMessageHelper(message, true);
          //邮件发送人
          messageHelper.setFrom(GlobalConfig.MAIL_FROM);
          //邮件接收人
          messageHelper.setTo(subject);
          //邮件主题
          message.setSubject(subject);
          //邮件内容，html格式
          messageHelper.setText(content, true);
          //发送
          javaMailSender.send(message);
          //日志信息
          log.info("邮件已经发送。");
      } catch (MessagingException e) {
          log.error("发送邮件时发生异常！", e);
      }
 }
/**
* 发送带附件的邮件
* @param to 收件人
* @param subject 主题
* @param content 内容
* @param filePath 附件
*/
@Override
public void sendAttachmentsMail(String to, String subject, String content, String filePath) {
    //每次来调用的时候 才去加载 configEmail
    JavaMailSenderImpl javaMailSender = configEmail();
    MimeMessage message = javaMailSender.createMimeMessage();
    try {
        MimeMessageHelper helper = new MimeMessageHelper(message, true,"UTF-8");
        helper.setFrom(GlobalConfig.MAIL_FROM);
        helper.setTo(to);
        helper.setSubject(subject);
        // 第二个参数true表示使用HTML语言来编写邮件
        helper.setText(content, true);
        //FileSystemResource file = new FileSystemResource(new File("src/main/resources/static/image/picture.jpg"));
        //helper.addAttachment("图片.jpg", file);//添加带附件的邮件
        //helper.addInline("picture", file);//添加带静态资源的邮件
        FileSystemResource file = new FileSystemResource(new File(filePath));
        String fileName = filePath.substring(filePath.lastIndexOf(File.separator));
        helper.addAttachment(fileName, file);
        javaMailSender.send(message);
        //日志信息
        log.info("邮件已经发送。");
    } catch (MessagingException e) {
        log.error("发送邮件时发生异常！", e);
    }
}

‍

测试 发送邮件和带附件发送

@Autowired
private EmailService emailService;


/**
*发送文本邮件
*@param to 收件人
*/
@PostMapping("/sendEmail")
public WebResponse sendEmail(String to){


//===================================发送文本邮件=================================
String authCode = AuthCodeUtil.generateAuthCode();
String content = "您正在邮箱认证，认证验证码为"+authCode+"请在2分钟内按页面提示填写验证码，切勿将验证码泄露于他人。";
emailService.sendSimpleMail(to, GlobalConfig.MAIL_SUBJECT,content);


//========================发送带附件的邮件========================
emailService.sendAttachmentsMail(to, GlobalConfig.MAIL_SUBJECT,"发送带附件的邮件","C:\\Users\\YScredit\\Desktop\\security\\src\\main\\resources\\templates\\yiqingmoban01.docx");
return WebResponse.resSuccess("发送成功",1);
}

后续可自定义Impl里的内容 方便根据业务需要进行更改。整体不难，根据API即可操作成功。调试过程中也出现了一些问题。总结如下:

1.  yml属性配置里的 mailUsername（发送邮件的邮箱地址）和mailFrom（发送人）要一致。

2. EmailServiceImpl中configEmail配置邮件发送需要加上以下三个属性

//        mail.smtp.starttls.enable:true
//        mail.smtp.starttls.required:true
//        mail.smtp.ssl.enable: true

Nice~