java 邮箱通知功能实现

标题 java 邮箱通知功能实现

1.本实现依赖maven库，首先在pom.xml中引入java依赖

<!-- mail -->
		<dependency>
			<groupId>com.sun.mail</groupId>
			<artifactId>javax.mail</artifactId>
	   </dependency>

2.邮件发送工具类

package com.feinno.env.common.util.mail;

import java.util.Date;
import java.util.Properties;

import javax.activation.DataHandler;
import javax.activation.FileDataSource;
import javax.mail.Address;
import javax.mail.BodyPart;
import javax.mail.Multipart;
import javax.mail.Session;
import javax.mail.Transport;
import javax.mail.internet.InternetAddress;
import javax.mail.internet.MimeBodyPart;
import javax.mail.internet.MimeMessage;
import javax.mail.internet.MimeMultipart;
import javax.mail.internet.MimeUtility;


public class MailUtil {
	
	/**
     * 发送邮件
     *
     * @param emailSMTPHost 发件人邮箱的 SMTP 服务器地址
     * @param smtpPort 		SMTP 服务器的端口
     * @param sendMail 		发件人邮箱
     * @param receiveMail  	收件人邮箱
     * @param mailAccount  	发件人账户
     * @param mailPassword	发件人密码
     * @param subject 	       邮件主题
     * @param content	       邮件内容
     * 发件人邮箱的 SMTP 服务器地址, 必须准确, 不同邮件服务器地址不同, 一般(只是一般, 绝非绝对)格式为: smtp.xxx.com
     * 网易163邮箱的 SMTP 服务器地址为: smtp.163.com    腾讯: smtp.qq.com  POP3服务器:pop3.163.com  奇点服务器地址:mail.ultrapower.com.cn
     * SMTP 服务器的端口 (非 SSL 连接的端口一般默认为 25, 可以不添加, 如果开启了 SSL 连接,
	 * 需要改为对应邮箱的 SMTP 服务器的端口, 具体可查看对应邮箱服务的帮助,
	 * QQ邮箱的SMTP(SLL)端口为465或587, 其他邮箱自行去查看)
     */
	public static boolean sendMail(String emailSMTPHost,String smtpPort, String sendMail, String receiveMail,
			String mailAccount, String mailPassword,String subject, String content){
		
		try{
			// 1. 创建参数配置, 用于连接邮件服务器的参数配置
			Properties props = new Properties();                    // 参数配置
			props.setProperty("mail.transport.protocol", "smtp");   // 使用的协议（JavaMail规范要求）
			props.setProperty("mail.smtp.host", emailSMTPHost);   // 发件人的邮箱的 SMTP 服务器地址
			props.setProperty("mail.smtp.auth", "true");            // 需要请求认证
			
			// PS: 某些邮箱服务器要求 SMTP 连接需要使用 SSL 安全认证 (为了提高安全性, 邮箱支持SSL连接, 也可以自己开启),
			//     如果无法连接邮件服务器, 仔细查看控制台打印的 log, 如果有有类似 “连接失败, 要求 SSL 安全连接” 等错误,
			//     打开下面 /* ... */ 之间的注释代码, 开启 SSL 安全连接。
			props.setProperty("mail.smtp.port", smtpPort);
			///props.setProperty("mail.smtp.socketFactory.class", "javax.net.ssl.SSLSocketFactory");
			//props.setProperty("mail.smtp.socketFactory.fallback", "false");
			//props.setProperty("mail.smtp.socketFactory.port", smtpPort);
			
			// 2. 根据配置创建会话对象, 用于和邮件服务器交互
			MyAuthenticator popAuthenticator = new MyAuthenticator(mailAccount,mailPassword);
			Session   session  =  Session.getDefaultInstance(props, popAuthenticator);
			session.setDebug(true);                                 // 设置为debug模式, 可以查看详细的发送 log
			
			// 3. 创建一封邮件
			MimeMessage message = createMimeMessage(session,sendMail,receiveMail,subject,content);
			
			// 4. 根据 Session 获取邮件传输对象
			Transport transport = (Transport) session.getTransport("smtp");
			
			// 5. 使用 邮箱账号 和 密码 连接邮件服务器, 这里认证的邮箱必须与 message 中的发件人邮箱一致, 否则报错
			// 
			//    PS_01: 成败的判断关键在此一句, 如果连接服务器失败, 都会在控制台输出相应失败原因的 log,
			//           仔细查看失败原因, 有些邮箱服务器会返回错误码或查看错误类型的链接, 根据给出的错误
			//           类型到对应邮件服务器的帮助网站上查看具体失败原因。
			//
			//    PS_02: 连接失败的原因通常为以下几点, 仔细检查代码:
			//           (1) 邮箱没有开启 SMTP 服务;
			//           (2) 邮箱密码错误, 例如某些邮箱开启了独立密码;
			//           (3) 邮箱服务器要求必须要使用 SSL 安全连接;
			//           (4) 请求过于频繁或其他原因, 被邮件服务器拒绝服务;
			//           (5) 如果以上几点都确定无误, 到邮件服务器网站查找帮助。
			//
			//    PS_03: 仔细看log, 认真看log, 看懂log, 错误原因都在log已说明。
			transport.connect(emailSMTPHost,mailAccount, mailPassword);
			
			// 6. 发送邮件, 发到所有的收件地址, message.getAllRecipients() 获取到的是在创建邮件对象时添加的所有收件人, 抄送人, 密送人
			transport.sendMessage(message, message.getAllRecipients());
			
			// 7. 关闭连接
			transport.close();
			return true;
		}catch(Exception e){
			return false;
		}
	}
	
	/**
     * 群发邮件
     *
     * @param emailSMTPHost 发件人邮箱的 SMTP 服务器地址
     * @param smtpPort 			SMTP 服务器的端口
     * @param sendMail 			发件人邮箱
     * @param toReceiveMails  	收件人邮箱集合
     * @param ccReceiveMails  	抄送人邮箱集合
     * @param mailAccount  		发件人账户
     * @param mailPassword		发件人密码
     * @param subject 	       	邮件主题
     * @param content	      	邮件内容
     * @param filePaths	      	附件集合
      * 发件人邮箱的 SMTP 服务器地址, 必须准确, 不同邮件服务器地址不同, 一般(只是一般, 绝非绝对)格式为: smtp.xxx.com
     * 网易163邮箱的 SMTP 服务器地址为: smtp.163.com    腾讯: smtp.qq.com  POP3服务器:pop3.163.com
     * SMTP 服务器的端口 (非 SSL 连接的端口一般默认为 25, 可以不添加, 如果开启了 SSL 连接,
	 * 需要改为对应邮箱的 SMTP 服务器的端口, 具体可查看对应邮箱服务的帮助,
	 * QQ邮箱的SMTP(SLL)端口为465或587, 其他邮箱自行去查看)
     */
	public static boolean sendMails(String emailSMTPHost,String smtpPort, String sendMail, String[] toReceiveMails,String[] toReceiveNames,
    		String[] ccReceiveMails,String[] ccReceiveNames,String[] filePaths,String mailAccount, 
			String mailPassword,String subject, String content){
		
			try{
				// 1. 创建参数配置, 用于连接邮件服务器的参数配置
				Properties props = new Properties();                    // 参数配置
				props.setProperty("mail.transport.protocol", "smtp");   // 使用的协议（JavaMail规范要求）
				props.setProperty("mail.smtp.host", emailSMTPHost);   // 发件人的邮箱的 SMTP 服务器地址
				props.setProperty("mail.smtp.auth", "true");            // 需要请求认证
				props.setProperty("mail.smtp.port", smtpPort);
				//props.setProperty("mail.smtp.socketFactory.class", "javax.net.ssl.SSLSocketFactory");
				//props.setProperty("mail.smtp.socketFactory.fallback", "false");
				//props.setProperty("mail.smtp.socketFactory.port", smtpPort);
				
				// 2. 根据配置创建会话对象, 用于和邮件服务器交互
				Session session = Session.getDefaultInstance(props);
				session.setDebug(true);                                 // 设置为debug模式, 可以查看详细的发送 log
				
				// 3. 创建邮件
				MimeMessage message = createMimeMessage(session, sendMail, subject, content, toReceiveMails,ccReceiveMails,filePaths);
				
				// 4. 根据 Session 获取邮件传输对象
				Transport transport = (Transport) session.getTransport();
				
				// 5. 使用 邮箱账号 和 密码 连接邮件服务器, 这里认证的邮箱必须与 message 中的发件人邮箱一致, 否则报错
				// 
				//    PS_01: 成败的判断关键在此一句, 如果连接服务器失败, 都会在控制台输出相应失败原因的 log,
				//           仔细查看失败原因, 有些邮箱服务器会返回错误码或查看错误类型的链接, 根据给出的错误
				//           类型到对应邮件服务器的帮助网站上查看具体失败原因。
				//
				//    PS_02: 连接失败的原因通常为以下几点, 仔细检查代码:
				//           (1) 邮箱没有开启 SMTP 服务;
				//           (2) 邮箱密码错误, 例如某些邮箱开启了独立密码;
				//           (3) 邮箱服务器要求必须要使用 SSL 安全连接;
				//           (4) 请求过于频繁或其他原因, 被邮件服务器拒绝服务;
				//           (5) 如果以上几点都确定无误, 到邮件服务器网站查找帮助。
				//
				//    PS_03: 仔细看log, 认真看log, 看懂log, 错误原因都在log已说明。
				transport.connect(mailAccount, mailPassword);
				
				// 6. 发送邮件, 发到所有的收件地址, message.getAllRecipients() 获取到的是在创建邮件对象时添加的所有收件人, 抄送人, 密送人
				transport.sendMessage(message, message.getAllRecipients());
				
				// 7. 关闭连接
				transport.close();
				return true;
			}catch(Exception e){
				return false;
			}
	}
	
	/**
     * 创建一封简单邮件
     *
     * @param session 和服务器交互的会话
     * @param sendMail 发件人邮箱
     * @param receiveMail 收件人邮箱
     * @return
     * @throws Exception
     */
    public static MimeMessage createMimeMessage(Session session, String sendMail, String receiveMail,String subject,String content) throws Exception {
        // 1. 创建一封邮件
        MimeMessage message = new MimeMessage(session);

        // 2. From: 发件人（昵称有广告嫌疑，避免被邮件服务器误认为是滥发广告以至返回失败，请修改昵称）
        message.setFrom(new InternetAddress(sendMail));

        // 3. To: 收件人（可以增加多个收件人、抄送、密送）
        message.setRecipient(MimeMessage.RecipientType.TO, new InternetAddress(receiveMail));

        // 4. Subject: 邮件主题（标题有广告嫌疑，避免被邮件服务器误认为是滥发广告以至返回失败，请修改标题）
        message.setSubject(subject, "UTF-8");

        // 5. Content: 邮件正文（可以使用html标签）（内容有广告嫌疑，避免被邮件服务器误认为是滥发广告以至返回失败，请修改发送内容）
        Multipart multipart = new MimeMultipart();  
        // 添加邮件正文  
        BodyPart contentBodyPart = new MimeBodyPart();  
        // 邮件内容  
        contentBodyPart.setContent(content, "text/html;charset=UTF-8");  
        multipart.addBodyPart(contentBodyPart);  
        message.setContent(multipart);

        // 6. 设置发件时间
        message.setSentDate(new Date());

        // 7. 保存设置
        message.saveChanges();

        return message;
    }
    
    
    /**
     * 
     *  创建一封群发邮件
     * @param session 和服务器交互的会话
     * @param sendMail 发件人邮箱
     * @param toReceiveMails 收件人邮箱(多人)
     * @param toReceiveNames 收件人名字(多人)
     * @param ccReceiveMails 抄送人邮箱(多人)
     * @param ccReceiveNames 抄送人名字(多人)
     * @param filePahts 	  附件集合 
     * @return
     * @throws Exception
     */
    public static MimeMessage createMimeMessage(Session session, String sendMail, String object, String content, String[] toReceiveMails,
    		String[] ccReceiveMails,String[] filePahts) throws Exception {
        // 1. 创建一封邮件
        MimeMessage message = new MimeMessage(session);

        // 2. From: 发件人（昵称有广告嫌疑，避免被邮件服务器误认为是滥发广告以至返回失败，请修改昵称）
        message.setFrom(new InternetAddress(sendMail, "系统管理员", "UTF-8"));

        // 3. 1: To: 收件人（可以增加多个收件人）
        Address to[] = new InternetAddress[toReceiveMails.length] ;  
        Address cc[] = new InternetAddress[ccReceiveMails.length] ;  
        for(int i=0;i<toReceiveMails.length;i++){  
            to[i] = new InternetAddress(toReceiveMails[i]) ;  
        } 
        message.setRecipients(MimeMessage.RecipientType.TO,to);  
        
        // 3. 2:  To: 抄送人（可以增加多个抄送人）
        for(int i=0;i<ccReceiveMails.length;i++){  
        	cc[i] = new InternetAddress(ccReceiveMails[i]) ;  
        } 
        message.setRecipients(MimeMessage.RecipientType.CC,cc);  

        // 4. Subject: 邮件主题（标题有广告嫌疑，避免被邮件服务器误认为是滥发广告以至返回失败，请修改标题）
        message.setSubject(object, "UTF-8");

        // 5. Content: 邮件正文（可以使用html标签）（内容有广告嫌疑，避免被邮件服务器误认为是滥发广告以至返回失败，请修改发送内容）
        // 向multipart对象中添加邮件的各个部分内容，包括文本内容和附件  
        Multipart multipart = new MimeMultipart();  
        // 添加邮件正文  
        BodyPart contentBodyPart = new MimeBodyPart();  
        // 邮件内容  
        contentBodyPart.setContent(content, "text/html;charset=UTF-8");  
        multipart.addBodyPart(contentBodyPart);  
        // 添加附件  
        if(filePahts.length>0){
        	for(String filePath:filePahts){
        		if (filePath != null && !"".equals(filePath)) {  
        			try{
        				BodyPart attachmentBodyPart = new MimeBodyPart();  
        				// 根据附件路径获取文件,  
        				FileDataSource dataSource = new FileDataSource(filePath);  
        				attachmentBodyPart.setDataHandler(new DataHandler(dataSource));  
        				//MimeUtility.encodeWord可以避免文件名乱码  
        				attachmentBodyPart.setFileName(MimeUtility.encodeWord(dataSource.getFile().getName()));  
        				multipart.addBodyPart(attachmentBodyPart);  
        			}catch(Exception e){
        				e.getMessage();
        			}
                }  
        	}
        }
        message.setContent(multipart);
        		
        // 6. 设置发件时间
        message.setSentDate(new Date());

        // 7. 保存设置
        message.saveChanges();

        return message;
    }
    
}

3.授权

package com.feinno.env.common.util.mail;

import javax.mail.Authenticator;
import javax.mail.PasswordAuthentication;

public class MyAuthenticator extends Authenticator {
    String name;
    String password;
     
    public MyAuthenticator(String name,String password){
        this.name = name;
        this.password = password;
         
    }
    protected PasswordAuthentication getPasswordAuthentication(){
        return new PasswordAuthentication(name,password);
    }
    
    public PasswordAuthentication performCheck(String user,String pass){
        name = user;
        password = pass;
        return getPasswordAuthentication();
    }
    
	public String getName() {
		return name;
	}
	public void setName(String name) {
		this.name = name;
	}
	public String getPassword() {
		return password;
	}
	public void setPassword(String password) {
		this.password = password;
	}
}

4.提供一个发送邮箱，并在设置中开通POP3/SMTP和IMAP/SMTP服务，下图以qq邮箱为例
发件人的密码不是你登录邮箱的密码，而是设置POP3/SMTP/IMAP是获取的授权码