QQ邮件发送工具类

邮件发送的简单实用，本文的邮件，支持包括正文、正文图片、本地附件、excel附件。

package io.ctc.util;

import com.sun.mail.util.MailSSLSocketFactory;
import org.apache.poi.xssf.usermodel.XSSFWorkbook;
import org.springframework.core.io.ClassPathResource;

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 javax.mail.util.ByteArrayDataSource;
import java.io.ByteArrayInputStream;
import java.io.ByteArrayOutputStream;
import java.io.IOException;
import java.io.InputStream;
import java.util.List;
import java.util.Properties;

/**
 * @Description 邮件发送工具类
 * @Author wk
 * @Date 2021/9/13 10:05
 **/
public class EmailUtils {

    /**
     * QQ邮箱，邮件工具
     * @param mailText 邮件文本内容
     * @param picturePath 正文图片地址 (仅支持 src/resources 下的文件，可自行改造文件读取方法)
     * @param appendixFilePath 附件地址 (仅支持 src/resources 下的文件，可自行改造文件读取方法)
     * @param workbooks excel文件
     * @throws Exception
     */
    public static void sendEmailByQQ(String mailText, List<String> picturePath, List<String> appendixFilePath, List<XSSFWorkbook> workbooks, List<String> workbookNames) throws Exception{
        //创建一个配置文件保存并读取信息
        Properties properties = new Properties();

        //设置qq邮件服务器
        properties.setProperty("mail.host","smtp.qq.com");
        //设置发送的协议
        properties.setProperty("mail.transport.protocol","smtp");
        //设置用户是否需要验证
        properties.setProperty("mail.smtp.auth", "true");


        //=================================只有QQ存在的一个特性，需要建立一个安全的链接
        // 关于QQ邮箱，还要设置SSL加密，加上以下代码即可
        MailSSLSocketFactory sf = new MailSSLSocketFactory();
        sf.setTrustAllHosts(true);
        properties.put("mail.smtp.ssl.enable", "true");
        properties.put("mail.smtp.ssl.socketFactory", sf);

        //=================================准备工作完毕

        //1.创建一个session会话对象；
        Session session = Session.getDefaultInstance(properties, new Authenticator() {
            @Override
            protected PasswordAuthentication getPasswordAuthentication() {
                return new PasswordAuthentication("您的邮箱地址", "授权码（16位，没有空格)");
            }
        });

        //可以通过session开启Dubug模式，查看所有的过程
        session.setDebug(true);


        //2.获取连接对象，通过session对象获得Transport，需要捕获或者抛出异常；
        Transport tp = session.getTransport();

        //3.连接服务器,需要抛出异常；
        tp.connect("smtp.qq.com","您的邮箱地址","授权码");

        //4.连接上之后我们构造需要发送邮件；
        MimeMessage mimeMessage = structureEmail(session, mailText, picturePath, appendixFilePath, workbooks, workbookNames);

        //5.发送邮件
        tp.sendMessage(mimeMessage,mimeMessage.getAllRecipients());

        //6.关闭连接
        tp.close();
    }

    /**
     * 邮件构造
     * @param session 会话
     * @param mailText 邮件文本
     * @param picturePath 文本中所要展示的图片
     * @param appendixFilePath 本地附件文件
     * @param workbooks excel文件附件
     * @return
     * @throws MessagingException
     * @throws IOException
     */
    public static MimeMessage structureEmail(Session session, String mailText, List<String> picturePath, List<String> appendixFilePath, List<XSSFWorkbook> workbooks, List<String> workbookNames) throws MessagingException, IOException {

        //消息的固定信息
        MimeMessage mimeMessage = new MimeMessage(session);

        //邮件发送人
        mimeMessage.setFrom(new InternetAddress("发送人邮箱地址"));
        //邮件接收人，可以同时发送给很多人，我们这里只发给自己；
        mimeMessage.setRecipient(Message.RecipientType.TO, new InternetAddress("收件人邮箱地址"));
        mimeMessage.setSubject("邮件测试"); //邮件主题

        // 正文处理声明（包含文本中的图片，以及文字）
        MimeMultipart text = new MimeMultipart();
        //邮件内容
        // 图片处理
        StringBuilder mailTextBuilder = new StringBuilder(mailText);
        for (int i = 0; i < picturePath.size(); i++) {
            //图片
            MimeBodyPart body1 = new MimeBodyPart();
            body1.setDataHandler(new DataHandler(getFileDataSource(picturePath.get(i), null)));
            //图片设置ID，在文本中引用
            body1.setContentID("picture"+i);
            // 将图片拼接到文本中
            mailTextBuilder.append("<img src='cid:picture").append(i).append("'>");
            // 添加图片
            text.addBodyPart(body1);
        }
        mailText = mailTextBuilder.toString();

        //文本处理
        MimeBodyPart body2 = new MimeBodyPart();
        body2.setContent(mailText,"text/html;charset=utf-8");
        // 添加正文
        text.addBodyPart(body2);
        // 文本和图片内嵌显示
        text.setSubType("related");
        // 附件处理
        // 附件声明
        MimeMultipart allFile =new MimeMultipart();
        for (String path : appendixFilePath) {
            MimeBodyPart body3 = new MimeBodyPart();
            body3.setDataHandler(new DataHandler(getFileDataSource(path, null)));
            // 附件设置名字
            body3.setFileName(path);
            // 添加附件
            allFile.addBodyPart(body3);
        }
        // excel 文件
        for (int i = 0; i < workbooks.size(); i++) {
            MimeBodyPart body4 = new MimeBodyPart();
            body4.setDataHandler(new DataHandler(getFileDataSource("", workbooks.get(i))));
            body4.setFileName(workbookNames.get(i)+ ".xlsx"); //附件设置名字
            // 添加excel
            allFile.addBodyPart(body4);
        }
        //拼装邮件正文内容
        MimeBodyPart contentText =  new MimeBodyPart();
        contentText.setContent(text);

        //拼接正文和附件
        allFile.addBodyPart(contentText);//正文（附件在上面添加）
        allFile.setSubType("mixed"); //正文和附件都存在邮件中，所有类型设置为mixed；


        //放到Message消息中
        mimeMessage.setContent(allFile);
        mimeMessage.saveChanges();//保存修改


        return mimeMessage;

    }

    /**
     * 获取DataSource类型的文件
     * @param path resources下文件的路径
     * @param workbook excel文件
     * @return DataSource
     * @throws IOException
     */
    private static DataSource getFileDataSource(String path, XSSFWorkbook workbook) throws IOException {
        if(workbook != null){
            ByteArrayOutputStream out = new ByteArrayOutputStream();
            workbook.write(out);
            out.flush();
            out.close();
            byte[] bt = out.toByteArray();
            InputStream is = new ByteArrayInputStream(bt, 0, bt.length);
            return new ByteArrayDataSource(is, "application/msexcel");
        }
        ClassPathResource classPathResource = new ClassPathResource(path);
        return new FileDataSource(classPathResource.getFile());
    }
}