JAVA MAIL应用五 (详解PROPERTIES SESSION)

1．Properties（属性对象）

由于JavaMail需要和邮件服务器进行通信，这就要求程序提供许多诸如服务器地址、端口、用户名、密码等信息，JavaMail通过Properties对象封装这些属性西信息。如下面的代码封装了两个属性信息：

Properties props=new Properties();

props.put("mail.smtp.host","https://www.360docs.net/doc/6d1272787.html,");

props.put("mail.smtp.auth","true");

针对不同的的邮件协议，JavaMail规定了服务提供者必须支持一系列属性，下表是针对SMTP 协议的一些常见属性（属性值都以String类型进行设置，属性类型栏仅表示属性是如何被解析的）：

属性名属性类型说明

mail.stmp.host String SMTP服务器地址，如https://www.360docs.net/doc/6d1272787.html,

mail.stmp.port int SMTP服务器端口号，默认为25

mail.stmp.auth boolean SMTP服务器是否需要用户认证，默认为false https://www.360docs.net/doc/6d1272787.html,er String SMTP默认的登陆用户名

mail.stmp.from String默认的邮件发送源地址

mail.stmp.socketFactory.class String socket工厂类类名，通过设置该属性可以覆盖提供

者默认的实现，必须实现https://www.360docs.net/doc/6d1272787.html,.SocketFactory接

口

mail.stmp.socketFactory.port int指定socket工厂类所用的端口号，如果没有规定，

则使用默认的端口号

mail.smtp.socketFactory.fallbackboolean设置为true时，当使用指定的socket类创建socket

失败后，将使用https://www.360docs.net/doc/6d1272787.html,.Socket创建socket，默认

为true

mail.stmp.timeout int I/O连接超时时间，单位为毫秒，默认为永不超时其他几个协议也有类似的一系列属性，如POP3的mail.pop3.host、mail.pop3.port以及IMAP 的mail.imap.host、mail.imap.port等。

更详细的信息请查看com.sun.mail.smtp、com.sun.mail.pop3和com.sun.mail.imap这三个包的Javadoc：https://www.360docs.net/doc/6d1272787.html,/products/javamail/javadocs/index.html。

2．Session（会话对象）

Session是一个很容易被误解的类，这归咎于混淆视听的类名。千万不要以为这里的Session 像HttpSession一样代表真实的交互会话，但创建Session对象时，并没有对应的物理连接，它只不过是一对配置信息的集合。Session的主要作用包括两个方面：

1．接收各种配置属性信息：通过Properties对象设置的属性信息；

2．初始化JavaMail环境：根据JavaMail的配置文件，初始化JavaMail环境，以便通过Session对象创建其他重要类的实例。

所以，如果把Session更名为Configure也许更容易理解一些。

Session通过JavaMail配置文件以及程序中设置的Properties对象构建一个邮件处理环境，后续的处理将在Session基础上进行。Session拥有多个静态工厂方法用于创建Session实例。getInstance方法

1．static Session getDefaultInstance(Properties props,Authenticator authenticator)：当JVM中已经存在默认的Session实例中，直接返回这个实例，否则创建一个新的Session实例，并将其作为JVM中默认Session实例。这个API很诡异，我们将对它进行详细的讲解。由于这个

默认Session实例可以被同一个JVM所有的代码访问到，而Session中本身又可能包括密码、用户名等敏感信息在内的所有属性信息，所以后续调用也必须传入和第一次相同的Authenticator实例，否则将抛出https://www.360docs.net/doc/6d1272787.html,ng.SecurityException异常。如果第一次调用时Authenticator入参为null，则后续调用通过null的Authenticator入参或直接使用getDefaultInstance(Properties props)即可返回这个默认的Session实例。值得一提的是，虽然后续调用也会传入Properties，但新属性并不会起作用，如果希望采用新的属性值，则可以通过getDefaultInstance(Properties props)创建一个新的Session实例达到目的。Authenticator 在这里承当了两个功能：首先，对JVM中默认Session实例进行认证保护，后续调用执行getDefaultInstance(Properties props,Authenticator authenticator)方法时必须和第一次一样；其次，在具体和邮件服务器交互时，又作为认证的信息；

2．static Session getDefaultInstance(Properties props)：返回JVM中默认的Session实例，如果第一次创建Session未指定Authenticator入参，后续调用可以使用该访问获取Session; 3．static Session getInstance(Properties props,Authenticator authenticator)：创建一个新的Session实例，它不会在JVM中被作为默认实例共享；

4．static Session getInstance(Properties props)：根据相关属性创建一个新的Session实例，未使用安全认证信息；

Session是JavaMail提供者配置文件以及设置属性信息的“容器”，Session本身不会和邮件服务器进行任何的通信。所以在一般情况下，我们仅需要通过getDefaultInstance()获取一个共享的Session实例就可以了，下面的代码创建了一个Session实例：

Properties props=System.getProperties();

props.setProperty("mail.transport.protocol","smtp");…

Session session=Session.getDefaultInstance(props);

注意：要观察传到邮件服务器上的邮件命令，请用session.setDebug(true)设置调试标志。3．Transport和Store（传输和存储）

邮件操作只有发送或接收两种处理方式，JavaMail将这两种不同操作描述为传输（javax.mail.Transport）和存储（javax.mail.Store），传输对应邮件的发送，而存储对应邮件的接收。

Session提供了几个用于创建Transport和Store实例的方法，在具体讲解这些方法之前，我们事先了解一下Session创建Transport和Store的内部机制。我们知道提供者在javamail.providers配置文件中为每一种支持的邮件协议定义了实现类，Session根据协议类型（stmp、pop3等）和邮件操作方式（传输和存储）这两个信息就可以定位到一个实例类上。比如，指定stmp协议和transport类型后，Session就会使用com.sun.mail.smtp.SMTPTransport 实现类创建一个Transport实例，而指定pop3协议和store类型时，则会使用com.sun.mail.pop3.POP3Store实例类创建一个Store实例。Session提供了多个重载的getTransport()和getStore()方法，这些方法将根据Session中Properties属性设置情况进行工作，影响这两套方法工作的属性包括：

属性名说明

mail.transport.protocol默认的邮件传输协议，例如，smtp

mail.store.protocol默认的存储邮件协议，例如：pop3

mail.host默认的邮件服务地址，例如：192.168.67.1

https://www.360docs.net/doc/6d1272787.html,er默认的登陆用户名，例如：zapldy

下面，我们再回头来了解Session的getTransport()和getStore()的重载方法。

Transport的getTransport()方法

1．Transport getTransport()：当Session实例设置了mail.transport.protocol属性时，该方法返

回对应的Transport实例，否则抛出javax.mail.NoSuchProviderException。

2．Transport getTransport(String protocol)：如果Session没有设置mail.transport.protocol属性，可以通过该方法返回指定类型的Transport，如transport=session.getTransport(“smtp”)。

如果Session中未包含Authenticator，以上两方法创建的Transport实例和邮件服务器交互时必须显示提供用户名/密码的认证信息。如果Authenticator非空，则可以在和邮件服务器交互时被作为认证信息使用。

除了以上两种提供认证信息的方式外，Session还可以使用以下的方法为Transport提供认证信息。

3．Transport getTransport(URLName url)：用户可以通过URLName入参指定邮件协议、邮件服务器、端口、用户名和密码信息，请看下面的代码：

URLName urln=new URLName(“smtp”,“https://www.360docs.net/doc/6d1272787.html,”,25,null,“masterspring2”,“spring”); Transport transport=session.getTransport(urln);

/*这里，指定了邮件协议为smtp，邮件服务器是https://www.360docs.net/doc/6d1272787.html,，端口为25，用户名/ *密码为masterspring2/spring。*/

消息发送的最后一部分是使用Transport类。这个类用协议指定的语言发送消息（通常是SMTP）。它是抽象类，它的工作方式与Session有些类似。仅调用静态send()方法，就能使用类的缺省版本：

Transport.send(message);

或者，您也可以从针对您的协议的会话中获得一个特定的实例，传递用户名和密码（如果不必要就不传），发送消息，然后关闭连接。

message.saveChanges();

Transport transport=session.getTransport("smtp");

transport.connect(host,username,password);

transport.sendMessage(message,message.getAllRecipients());

transport.close();

后面这种方法在您要发送多条消息时最好，因为它能保持邮件服务器在消息间的活动状态。基本send()机制为每个方法的调用设置与服务器独立的连接。

Store方法

用Session获取消息与发送消息开始很相似。但是，在session得到后，很可能使用用户名和密码或使用Authenticator连接到一个Store。类似于Transport，您告知Store使用什么协议：

//Store store=session.getStore("imap");

Store store=session.getStore("pop3");

store.connect(host,username,password);

连接到Store之后，接下来，您就可以获取一个Folder，您必需先打开它，然后才能读里面的消息。

Folder folder=store.getFolder("INBOX");

folder.open(Folder.READ_ONLY);

Message message[]=folder.getMessages();

POP3唯一可以用的文件夹是INBOX。如果使用IMAP，还可以用其它文件夹。

注意：Sun的供应商有意变得聪明。虽然Message message[]=folder.getMessages();看上去是个很慢的操作，它从服务器上读取每一条消息，但仅在你实际需要消息的一部分时，消息的内容才会被检索。

一旦有了要读的Message，您可以用getContent()来获取其内容，或者用writeTo()将内容

写入流。getContent()方法只能得到消息内容，而writeTo()的输出却包含消息头。

System.out.println(((MimeMessage)message).getContent());

一旦读完邮件，要关闭与folder和store的连接。

folder.close(aBoolean);

store.close();

传递给folder的close()方法的boolean表示是否清除已删除的消息从而更新folder。4．Message（消息对象）

一旦获得Session对象，就可以继续创建要发送的消息。这由Message类来完成。因为Message是个抽象类，您必需用一个子类，多数情况下为javax.mail.internet.MimeMessage。MimeMessage是个能理解MIME类型和头的电子邮件消息，正如不同RFC中所定义的。虽然在某些头部域非ASCII字符也能被译码，但Message头只能被限制为用US-ASCII字符。

要创建一个Message，请将Session对象传递给MimeMessage构造器：

MimeMessage message=new MimeMessage(session);

注意：还存在其它构造器，如用按RFC822格式的输入流来创建消息。

一旦获得消息，您就可以设置各个部分，因为Message实现Part接口（且MimeMessage实现MimePart）。设置内容的基本机制是setContent()方法，同时使用参数，分别代表内容和mime类型：

message.setContent("Hello","text/plain");

但如果，您知道您在使用MimeMessage，而且消息是纯文本格式，您就可以用setText()方法，它只需要代表实际内容的参数，（MIME类型缺省为text/plain）：

message.setText("Hello");

后一种格式是设置纯文本消息内容的首选机制。至于发送其它类型的消息，如HTML文件格式的消息，我们首选前者。

用setSubject()方法设置subject（主题）：

message.setSubject("First");

5．Address（地址）

一旦您创建了Session和Message，并将内容填入消息后，就可以用Address确定信件地址了。和Message一样，Address也是个抽象类。您用的是javax.mail.internet.InternetAddress类。若创建的地址只包含电子邮件地址，只要传递电子邮件地址到构造器就行了。

Address address=new InternetAddress("president@https://www.360docs.net/doc/6d1272787.html,");

若希望名字紧挨着电子邮件显示，也可以把它传递给构造器：

Address address=new InternetAddress("president@https://www.360docs.net/doc/6d1272787.html,","George Bush");

需要为消息的from域和to域创建地址对象。除非邮件服务器阻止，没什么能阻止你发送一段看上去是来自任何人的消息。

一旦创建了address（地址），将它们与消息连接的方法有两种。如果要识别发件人，您可以用setFrom()和setReplyTo()方法。

message.setFrom(address)

需要消息显示多个from地址，可以使用addFrom()方法：

Address address[]=...;

message.addFrom(address);

若要识别消息recipient（收件人），您可以使用addRecipient()方法。除address（地址）外，这一方法还请求一个Message.RecipientType。

message.addRecipient(type,address)

三种预定义的地址类型是：

Message.RecipientType.TO

https://www.360docs.net/doc/6d1272787.html,

Message.RecipientType.BCC

如果消息是发给副总统的，同时发送一个副本(carbon copy)给总统夫人，以下做法比较恰当：Address toAddress=new InternetAddress("vice.president@https://www.360docs.net/doc/6d1272787.html,");

Address ccAddress=new InternetAddress("https://www.360docs.net/doc/6d1272787.html,dy@https://www.360docs.net/doc/6d1272787.html,");

message.addRecipient(Message.RecipientType.TO,toAddress);

message.addRecipient(https://www.360docs.net/doc/6d1272787.html,,ccAddress);

JavaMail API没有提供电子邮件地址有效性核查机制。虽然通过编程，自己能够扫描有效字符（如RFC822中定义的）或验证邮件交换（mail exchange，MX）记录，但这些功能不属于JavaMail API。