JavaMail使用

使用JavaMail需要两个包:activation-1.1.jar和mail-1.4.2.jar(当然现在最新的版本已经不止了),也可以直接包含Java SE 6的j2ee.jar,自带了前面的两个包。我把邮件功能写成了一个服务,发送邮件的数据都通过Map<String, String>类型的参数封装了起来。代码见文章最后

Session

Session 定义了一个基本的邮件会话,任何工作都是基于这个Session的。Session 对象需要一个 java.util.Properties 对象来得到类似 邮件服务器,用户名,密码这样的信息。Session 的构造函数是私有的,可以通过 getDefaultInstance() 方法来取得一个单一的可以被共享的默认session 如:

1
2
Properties props = new Properties();
Session session = Session.getDefaultInstance(props, null );

或者,可以使用 getInstance() 方法来创建一个唯一的 session如:

1
2
Properties props = new Properties();
Session session = Session.getInstance(props, null );

在这两种方法中 其中的 null 参数是一个 Authenticator 对象,在这里没有被使用的,所以就是null。在大多数案例中,使用一个共享session 已经做够了。

Message

一旦你创建了Session对象,那么下面要做的就是创建message来发送。Message是一个抽象类,在大部分应用中你可以使用它的子类javax.mail.internet.MimeMessage 。MimeMessage 是一个理解在不同RFCs中定义的MIME类型以及headers的e-mail message。Message headers 必须使用 US-ASCII 字符集。可以用如下的方法创建一个Message

1
MimeMessage message = new MimeMessage(session);

我们注意到,这里需要用session对象作为构造函数的参数。当然,还有其它的构造函数,比如从用RFC822格式化过的输入流来创建message。

一旦你得到了 message ,你就可以来设置它的各个部分(parts)。设置内容(content)的基本的机制是使用setContent() 方法。

1
message.setContent( "Email Content. " , "text/plain" );

如果,你能够明确你的使用MimeMessage来创建message 并且只是使用普通的文本(plain text) 那么你也可以使用 setText() 方法,setTest()方法只需要设置具体的内容,它默认的MIME类型是 text/plain

1
message.setText( "Email Content. " );

对于普通文本类型的邮件,有一种机制是首选( message.setText(“Email Content. “))的设置内容的方法。如果要创建其它类型的message ,比如 HTML类型的message   那么还是需要使用前者 ( message.setContent(“Email Content. “,”text/html”); )
设置主题(subject ),使用setSubject() 方法

1
message.setSubject( " Subject " );

Address

当你已经创建Session 以及 Message,并且已经为message 填充了内容,那么接下来要做的就是给你的邮件添加一个地址(Address)。 就像Message一样,Address也是一个抽象类,我们可以使用它的一个子

javax.mail.internet.InternetAddress

创建一个地址非常简单

1
Address address = new InternetAddress( "<a href=" mailto:suixin @asiainfo .com ">[email protected]</a>" );

如果,你希望在出现邮件地址的地方出现一个名称,那么你只需要再多传递一个参数。

1
Address address = new InternetAddress( "<a href=" mailto:suixin @asiainfo .com&quot;,&quot;Steve ">[email protected]" , "Steve</a>" );

你需要为 message 的from以及 to 字段创建address对象。为了识别发送者,你需要使用setFrom() 和 setReplyTo() 方法。

1
messge.setFrom(address);

如果你的message 需要显示多个 from 地址,可以使用 addFrom() 方法

1
2
Address address[] = {....};
message.addFrom(address);

为了辨识message 的收件人,你需要使用 setRecipient() 方法。这个方法除了address参数之外,还需要一

Message.RecipientType 。
message.addRecipient(type,address);
Message.RecipientType有几个预先定义好的类型
Message.RecipientType.TO  收件人
Message.RecipientType.CC  抄送
Message.RecipientType.BCC  暗送

如果你的一封邮件,需要发送给你的老师,并还要给你的几个同学,那么你可以这样

1
2
3
4
Address toAddress = new InternetAddress( "<a href=" mailto:teacher @17288 .com ">[email protected]</a>" );
Address[] ccAddress = { new InternetAddress( "<a href=" mailto:schoolmate1 @17288 .com&quot;), new ">[email protected]" ), new </a> InternetAddress( "<a href=" mailto:schoolmate2 @17288 .com ">[email protected]</a>" )};
message.addRecipient(Message.RecipientType.To, toAddress);
message.addRecipient(Message.RecipientType.CC, ccAddress);

JavaMail 没有提供电子邮件地址有效性的检测。这些超越了JavaMail API的范围。

Authenticator

通过Authenticator设置用户名、密码,来访问受保护的资源,这里的资源一般指的是邮件服务器。

Authenticator也是一个抽象类,你需要自己编写子类已备应用。你需要实现getPasswordAuthentication()方法,并返回一个PasswordAuthentication实例。你必须在 session被创建时, 注册你的 Authenticator。这样,当需要进行认证是,你的Authenticator就可以被得到。

1
2
3
4
Properties props = new Properties();
//设置属性
Authenticator auth = new YourAuthenticator();
Session session = Session.getDefaultInstance(props, auth);

Transport

发送消息最后的一步就是使用Transport类,你可以通过两种方法来进行发送。
Transport 是一个抽象类,你可以调用它静态的send() 方法来发送

1
Transport.send(message);

或者,你可以为你使用的协议从session中取得一个指定的实例,

1
2
3
Transport transport = session.getTransport( "smtp" );
transport.sendMessage(message, message.getAllRecipients());
transport.close();

Store and Folder

这两个类重要用于取得信息。在创建了Session之后,需要连接到一个 Store ,你需要告诉Store你使用的是什么协议。

1
2
3
// Store store = session.getStore("imap");
Store store = session.getStore( "pop3" );
store.connect(host, username, password);

在连接到一个 Store 后,你可以得到一个 Folder,当然,这个Floder必须是打开的。

1
2
3
Folder folder = store.getFolder( "INBOX" );
folder.open(Folder.READ_ONLY);
Message message[] = folder.getMessages();

如果使用POP3那么,INDEX是唯一可用的文件夹。如果使用的是IMAP,你就可以使用其它的文件夹。

代码

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
public boolean sendEmail(Map<String, String> data) {
     // 创建Properties 对象
     Properties props = System.getProperties();
     props.put( "mail.smtp.host" , Constants.HOST); // 全局变量
     props.put( "mail.smtp.auth" , "true" );
 
     // 创建邮件会话
     Session session = Session.getDefaultInstance(props,
     new Authenticator() { // 验账账户
         @Override
         public PasswordAuthentication getPasswordAuthentication() {
             return new PasswordAuthentication(Constants.USERNAME,
                                               Constants.PASSWORD);
         }
     });
 
     try {
         // 定义邮件信息
         MimeMessage message = new MimeMessage(session);
         message.setFrom( new InternetAddress(Constants.FROM));
         message.addRecipient(
             Message.RecipientType.TO,
             new InternetAddress(
                 // 这里可以添加多个目的用户
                 data.get(Constants.EMAIL_TO)
             )
         );
         // 添加邮件发送时间(不知道体现在哪儿)
         message.setSentDate( new Date());
         // 要编码,否则中文会出乱码,貌似这个方法是对数据进行了
         //("=?GB2312?B?"+enc.encode(subject.getBytes())+"?=")形势的包装
         message.setSubject(MimeUtility.encodeText(data.get(Constants.EMAIL_SUBJECT), "gbk" , "B" ));
 
         MimeMultipart mmp = new MimeMultipart();
         MimeBodyPart mbp_text = new MimeBodyPart();
         // "text/plain"是文本型,没有样式,
         //"text/html"是html样式,可以解析html标签
         mbp_text.setContent(data.get(Constants.EMAIL_TEXT),
                             "text/html;charset=gbk" );
         mmp.addBodyPart(mbp_text); // 加入邮件正文
 
         // 处理附件,可以添加多个附件
         if (data.get(Constants.EMAIL_ATTACHMENT) != null ) {
             String[] files = data.get(Constants.EMAIL_ATTACHMENT).split( "," );
             if (files.length != 0 ) {
                 for (String file : files) {
                     MimeBodyPart mbp_file = new MimeBodyPart();
                     FileDataSource fds = new FileDataSource(file);
                     mbp_file.setDataHandler( new DataHandler(fds));
                     mbp_file.setFileName(MimeUtility.encodeText(fds.getName(), "gbk" , "B" ));
                     mmp.addBodyPart(mbp_file);
                 }
             }
         }
         message.setContent(mmp);
         // message.setText(data.get(Constants.EMAIL_TEXT));
 
         // 发送消息
         // session.getTransport("smtp").send(message); //也可以这样创建Transport对象
         Transport.send(message);
         return true ;
     } catch (Exception e) {
         e.printStackTrace();
         return false ;
     }


来源:http://coolshell.cn/articles/4261.html

你可能感兴趣的:(JavaMail使用)