来自云龙湖轮廓分明的月亮 发表于 2024-1-20 06:57:03

SpringBoot进阶教程(七十八)邮件服务

Sun公司提供了JavaMail用来实现邮件发送,但是配置烦琐,Spring中提供了JavaMailSender用来简化邮件配置,Spring Boot则提供了MailSenderAutoConfiguration对邮件的发送做了进一步简化。
v准备工作

开通POP3/SMTP服务或者IMAP/SMTP服务使用邮箱发送邮件,首先要申请开通POP3/SMTP服务或者IMAP/SMTP服务。SMTP全称为Simple Mail Transfer Protocol,译作简单邮件传输协议,它定义了邮件客户端软件与SMTP服务器之间,以及SMTP服务器与SMTP服务器之间的通信规则。
我使用的是QQ邮箱,若你也使用QQ邮箱,可以参考下面截图。当然我也试了其它邮箱,开通方法大同小异。
https://img2023.cnblogs.com/blog/506684/202309/506684-20230928145651472-1828998612.png
v架构搭建

maven依赖      <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-mail</artifactId>
      </dependency>邮箱配置server.port=8300
#邮箱配置
#平台地址,这里用的是qq邮箱,使用其他邮箱请更换
spring.mail.host=smtp.qq.com
#端口号
spring.mail.port=587
#发送邮件的邮箱地址:改成自己的邮箱
spring.mail.username=123456@qq.com
#注意这里不是邮件的登录密码,是发送短信后它给你的授权码 填写到这里
spring.mail.password=xxxxxxxxx
#与发件邮箱一致
spring.mail.from=123456@qq.com调用JavaMailSender接口发送邮件由于Spring Boot的starter模块提供了自动化配置,所以在引入了spring-boot-starter-mail依赖之后,会根据配置文件中的内容去创建JavaMailSender实例,因此我们可以直接在需要使用的地方直接@Autowired来引入邮件发送对象。
EmailService
package com.test.service;

/**
* @Author chen bo
* @Date 2023/10
* @Des
*/
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
/**
* @Author chen bo
* @Date 2023/10
* @Des
*/
@Slf4j
@Service
public class EmailServiceImpl implements EmailService {
    /**
   * Spring Boot 提供了一个发送邮件的简单抽象,使用的是下面这个接口,这里直接注入即可使用
   */
    @Autowired
    private JavaMailSender mailSender;

    /**
   * 配置文件中我的qq邮箱
   */
    @Value("${spring.mail.from}")
    private String from;

    /**
   * 简单文本邮件
   * @param to 收件人
   * @param subject 主题
   * @param content 内容
   */
    @Override
    public void sendSimpleMail(String to, String subject, String content) {
      //创建SimpleMailMessage对象
      SimpleMailMessage message = new SimpleMailMessage();
      //邮件发送人
      message.setFrom(from);
      //邮件接收人
      message.setTo(to);
      //邮件主题
      message.setSubject(subject);
      //邮件内容
      message.setText(content);
      //发送邮件
      mailSender.send(message);
    }

    /**
   * html邮件
   * @param to 收件人,多个时参数形式 :"xxx@xxx.com,xxx@xxx.com,xxx@xxx.com"
   * @param subject 主题
   * @param content 内容
   */
    @Override
    public void sendHtmlMail(String to, String subject, String content) {
      //获取MimeMessage对象
      MimeMessage message = mailSender.createMimeMessage();
      MimeMessageHelper messageHelper;
      try {
            messageHelper = new MimeMessageHelper(message, true);
            //邮件发送人
            messageHelper.setFrom(from);
            //邮件接收人,设置多个收件人地址
            InternetAddress[] internetAddressTo = InternetAddress.parse(to);
            messageHelper.setTo(internetAddressTo);
            //messageHelper.setTo(to);
            //邮件主题
            message.setSubject(subject);
            //邮件内容,html格式
            messageHelper.setText(content, true);
            //发送
            mailSender.send(message);
            //日志信息
            log.info("邮件已经发送。");
      } catch (Exception e) {
            log.error("发送邮件时发生异常!", e);
      }
    }

    /**
   * 带附件的邮件
   * @param to 收件人
   * @param subject 主题
   * @param content 内容
   * @param filePath 附件
   */
    @Override
    public void sendAttachmentsMail(String to, String subject, String content, String filePath) {
      MimeMessage message = mailSender.createMimeMessage();
      try {
            MimeMessageHelper helper = new MimeMessageHelper(message, true);
            helper.setFrom(from);
            helper.setTo(to);
            helper.setSubject(subject);
            helper.setText(content, true);

            FileSystemResource file = new FileSystemResource(new File(filePath));
            String fileName = filePath.substring(filePath.lastIndexOf(File.separator));
            helper.addAttachment(fileName, file);
            mailSender.send(message);
            //日志信息
            log.info("邮件已经发送。");
      } catch (Exception e) {
            log.error("发送邮件时发生异常!", e);
      }
    }
}EmailController
/**
* @Author chen bo
* @Date 2023/10
* @Des
*/
@RestController
public class EmailController {
    @Autowired
    private EmailService emailService;
    @PostMapping("sendSimpleMail")
    public String sendSimpleMail(String to, String subject, String content) {
      emailService.sendSimpleMail(to, subject, content);
      return "Hi";
    }
}postman请求
https://img2023.cnblogs.com/blog/506684/202309/506684-20230928145950241-1788572109.png
收到邮件
https://img2023.cnblogs.com/blog/506684/202309/506684-20230928145959347-1587639671.png
v源码地址

https://github.com/toutouge/javademosecond/tree/master/hellolearn

免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作!
页: [1]
查看完整版本: SpringBoot进阶教程(七十八)邮件服务