Java邮件发送

JavaWeb邮件发送学习

1.前言

邮件发送在网络中应用甚广，用户登录需要用到的验证码安全验证，注册用户成功与否的邮件通知，重要文件发送等等都需要用上邮件，可知这一知识的重要性。下文就是一篇以qq邮箱为例的JavaWeb邮件发送学习文章，一些注意点和常见的报错解决方案都会有提到

2.邮件发送原理剖析

用户从qq邮箱发送邮件到网易邮箱原理步骤：

1. 用户A登录qq邮箱客户端编写内容，点击发送
2. 邮件会通过network进到qq邮箱服务器，然后经过里面的SMTP服务器通过邮件传输协议SMTP发送到对应的网易邮箱服务器（这里会有缓存）
3. 网页邮箱服务器的SMTP服务器会接收发送过来的邮件，然后存放进网页邮箱服务器的文件系统（此时文件已经发送完成，用户A会通知用户B查收邮件
4. 用户B通过网易邮箱客户端向网页邮箱服务器发出请求取出未读邮件，此时POP3服务器将从文件系统里面取出要查收的文件，然后返回给网易邮箱客户端，供用户查看。

原理图如下：

3.javaweb实现邮件发送

用一个简单的账号注册功能示例学习

3.1、导包

邮件发送需要准备的依赖包 mail.jar 和 activation.jar （这里用maven导包方式）

<!-- 邮件发送依赖 -->
<dependency>
  <groupId>javax.mail</groupId>
  <artifactId>mail</artifactId>
  <version>1.4.7</version>
</dependency>

<dependency>
  <groupId>javax.activation</groupId>
  <artifactId>activation</artifactId>
  <version>1.1.1</version>
</dependency>

3.2、jsp前端页面

<form action="${pageContext.request.contextPath}/RegisterServlet.do" method="post">
    用户名：<input type="text" name="username"> <br>
    密码：<input type="password" name="password"> <br>
    邮箱：<input type="text" name="email"> <br>
    <input type="submit" value="注册">
</form>

3.3、servlet后端页面

public class RegisterServlet extends HttpServlet {
    @Override
    protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
        //接收用户请求
        String username = req.getParameter("username");
        String password = req.getParameter("password");
        String email = req.getParameter("email");
        //实例化注册用户对象
        User user = new User(username, password, email);
        //通过多线程实现异步操作(即不等待邮件发送完成，直接运行后面的内容，避免用户长时间等待),提高用户体验
        MailSend mailSend = new MailSend(user);
        Thread thread = new Thread(mailSend);
        thread.start();
        
        req.setAttribute("message","注册成功！我们已经给您发送了一封邮件通知，请注意查收！如网络不稳定，可能过会儿收到。");
        req.getRequestDispatcher("/info.jsp").forward(req,resp);
    }
    @Override
    protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
        doGet(req, resp);
    }
}

**注意：**不要忘了Servlet的注册噢~

3.4、注册的用户实体类User

//注册的用户实体类
public class User implements Serializable {

    private String username;
    private String password;
    private String email;

    public User(){
    }

    public User(String username,String password,String email){
        this.username = username;
        this.password = password;
        this.email = email;
    }

    public String getUsername() {
        return username;
    }

    public void setUsername(String username) {
        this.username = username;
    }

    public String getPassword() {
        return password;
    }

    public void setPassword(String password) {
        this.password = password;
    }

    public String getEmail() {
        return email;
    }

    public void setEmail(String email) {
        this.email = email;
    }

    @Override
    public String toString() {
        return "User{" +
                "username='" + username + '\'' +
                ", password='" + password + '\'' +
                ", email='" + email + '\'' +
                '}';
    }
}

3.5、实现邮件发送的封装类（重点核心）

//邮件发送工具
//实现Runnable具备多线程能力，因为发送邮件需要连接到对应邮箱服务器（需要耗费点时间），开启线程提高用户体验
public class MailSend implements Runnable{

    private User m_user;
    private final String m_From="******@qq.com";
    private final String m_host="smtp.qq.com";
    private final String m_protocol="smtp";
    private  String m_authCode="fcpljl*******";//授权码(16位的)
    public MailSend(User user)
    {
        this.m_user =user;
    }

    @Override
    public void run() {
        try {
            //1 设置邮件发送相关属性（固定需要的）
            Properties properties = new Properties();
            properties.setProperty("mail.host",m_host);//m_host qq邮件服务器
            properties.setProperty("mail.transport.protocol",m_protocol);//邮件发送协议
            properties.setProperty("mail.smtp.auth","true");//需要验证用户名和密码

            //2 qq邮箱需要设置SSL加密（这个是使用qq邮箱才需要的）
            MailSSLSocketFactory mailSSLSocketFactory = new MailSSLSocketFactory();
            mailSSLSocketFactory.setTrustAllHosts(true);
            properties.put("mail.smtp.ssl.enable","true");//SSL验证
            properties.put("mail.smtp.ssl.socketFactory",mailSSLSocketFactory);

            //3 创建session,定义整个环境所需的环境信息，如主机名，端口号，协议等
            Session session = Session.getDefaultInstance(properties, new Authenticator() {
                @Override
                protected PasswordAuthentication getPasswordAuthentication() {
                    return new PasswordAuthentication(m_From,m_authCode);
                }
            });

            //这个是用于后台打印 查看程序的运行状态（建议使用，可选）
            session.setDebug(true);

            //4 获取transport对象，用于发送邮件
            Transport transport = session.getTransport();

            //5 使用邮箱的用户名和授权码链接到邮件服务器
            transport.connect(m_host,m_From,m_authCode);

            //6 创建邮件（即写邮件部分，这里以普通纯文本邮件为例）
            MimeMessage mimeMessage = new MimeMessage(session);
            mimeMessage.setFrom(new InternetAddress(m_From));//设置发件人
            mimeMessage.setRecipients(Message.RecipientType.TO,m_user.getEmail());//设置收件人，从前端获取
            mimeMessage.setSubject("用户注册邮件通知");//发送邮件的主题框内容
            //发送邮件的正文框内容
            mimeMessage.setContent("<h1 style='color:red'>恭喜您，注册成功，您的用户名："+
                    m_user.getUsername()+"您的密码："+m_user.getPassword()+"，请妥善保管，如有问题请自行解决~</h1>","text/html;charset=UTF-8");

            //7 发送邮件
            transport.sendMessage(mimeMessage,mimeMessage.getAllRecipients());

            //8 关闭连接
            transport.close();
        } catch (Exception e) {
            e.printStackTrace();
            System.out.println(e.toString());
            System.out.println("邮件发送失败！");
        }
    }
}

4.带图片和附件的邮件

带图片和附件意味着这个文件内容部分不再是只有字符串，要实现发送则需把他们一层层的包装起来，然后再发送出去。则最好的处理办法就是使用MIME邮件中的MimeBodyPart类和MimeMultipart类（它们两个是对应的，一起出现使用的）。MIME邮件中各种不同类型的内容是分段存储的，各个段的排列方式、位置信息都通过Content-Type域的multipart类型来定义。multipart类型主要有三种子类型：mixed、related、alternative（分别对应着邮件可以发送附件、图片、文本类型的内容）。

邮件发送的其他代码不用改动，只需改动mimeMessage.setContent部分

//准备正文内容部分
MimeBodyPart text = new MimeBodyPart();
text.setContent("这是一封邮件正文，带图片<img src='cid:img.jpg'><br>图片介绍：......","text/html;charset=UTF-8");//通过引用cid将图片插入任意位置
//准备图片部分
MimeBodyPart img=new MimeBodyPart();
DataHandler dataHandler = new DataHandler(new FileDataSource("D:\\IDEA项目\\javaweb\\MailSend\\src\\01.jpg"));
img.setDataHandler(dataHandler);
img.setContentID("img.jpg");//设置cid，用于引用该图片
//准备附件内容
MimeBodyPart file = new MimeBodyPart();
DataHandler fileHandler = new DataHandler(new FileDataSource("D:\\IDEA项目\\javaweb\\MailSend\\src\\01.t'x't"));
file.setDataHandler(fileHandler);
file.setFileName("2.txt");//设置附件名称

//整合各个部分
MimeMultipart multipart = new MimeMultipart();
multipart.addBodyPart(img);
multipart.addBodyPart(text);
multipart.addBodyPart(file);
mm.setSubType("mixed");//
        
mimeMessage.setContent(multipart);//把整个好的内容设置到正文部分
mimeMessage.saveChanges();//保存
        
//发送邮件
transport.sendMessage(mimeMessage,mimeMessage.getAllRecipients());

5.常见的报错问题解决

除去Tomcat项目的问题，单纯考虑这种邮件发送功能，会出现的报错问题基本上都是javax.mail.AuthenticationFailedException: 535 authentication failed的问题，下面我讲一下，我碰到过的情况

• 授权码问题：由于一些原因，你获取到的授权码已过期，重新获取一次试一下
• 邮箱账号和使用的服务器不一致的问题：配置的发送方使用的是qq邮箱，而配置连接的服务器却是其他邮箱服务器
• 书写不规范的问题：哪些配置都是由固定写法的，认真核对检查一下，像：协议，服务器，邮箱名字，这些都是有影响的

---

以上就是关于我学习邮件发送的全部内容啦~希望可以帮助到大家！