JavaMail的常用类介绍

来源:互联网 发布:linux memmap 编辑:程序博客网 时间:2024/04/30 09:00

事先说明

没用过JavaMail的人可能看不懂这些介绍,不过不要紧,后面的文章有具体的实例,到时也可倒回来查看这些类的用法
(1) javax.mail.Properties
 
  JavaMail需要Properties来创建一个session对象。它将寻找字符串"mail.smtp.host",属性值就是发送邮件的主机

用法
 Properties props = new Properties (); 
   props.put("mail.smtp.host", "smtp.163.com");//可以换上你的smtp主机名。 


(2) javax.mail.Session
 
  这个Session类代表JavaMail 中的一个邮件session. 每一个基于 JavaMail的应用程序至少有一个session但是可以有任意多的session 在这个例子中, Session对象需要知道用来处理邮件的SMTP 服务器。 

用法
   Session sendMailSession; 
   sendMailSession = Session.getInstance(props, null); 


(3) javax.mail.Transport
 
  邮件是既可以被发送也可以被受到。JavaMail使用了两个不同的类来完成这两个功能:Transport Store. Transport 是用来发送信息的,而Store用来收信。对于这的教程我们只需要用到Transport对象。 

用法: 
Transport transport; 
  transport = sendMailSession.getTransport("smtp"); 

  用JavaMail Session对象的getTransport 方法来初始化Transport。传过去的字符串申明了对象所要使用的协议,如"smtp"。这将为我们省了很多时间。因为JavaMail以境内置了很多协议的实现方法。 

 注意: JavaMail并不是绝对支持每一个协议,目前支持IMAP SMTP POP3. 


(4) javax.mail.MimeMessage
 
  Message对象将存储我们实际发送的电子邮件信息,Message对象被作为一个MimeMessage对象来创建并且需要知道应当选择哪一个JavaMail session 

  用法: 
Message newMessage = new MimeMessage(sendMailSession); 


(5) javax.mail.InternetAddress
 
一旦您创建了 Session  Message,并将内容填入消息后,就可以用Address确定信件地址了。和 Message 一样,Address 也是个抽象类。您用的是Javax.mail.internet.InternetAddress 

用法
InternetAddress from=new InternetAddress("xxf@cafe.com"); 


(6) javax.mail.Store
 
Store
类实现特定邮件协议上的读、写、监视、查找等操作。通过Javax.mail.Store类可以访问Javax.mail.Folder类。 

用法
Store store=s.getSorte("pop3");//s
为一个邮件会话 
store.connect(popserver,username,password);//
通过你提供的pop地址,用户名和密码登录你的邮箱 
(7) javax.mail.Folder
 
Folder
类用于分级组织邮件,并提供照Javax.mail.Message格式访问email的能力。
用法
Folder folder=store.getFolder("INBOX"); 
folder.open(Folder.READ_ONLY); 


(8) javax.mail.Internet.MimeMultpart 
一般保存电子邮件内容的容器是Multipart抽象类,它定义了增加和删除及获得电子邮件不同部分内容的方法.由于Multipart是抽象类,我们必须为它使用一个具体的子类,JavaMail API提供javax.mail.Internet.MimeMultpart类来使用MimeMessage对象

用法
MimeMultipart multipart=new MimeMultipart(); 

:我们使用MimeMultipart对象的一个方法是addBodyPart(),它在我们的电子邮件内容里添加BodyPart(BodyPart类在下面紧接着要介绍)对象.消息可以有很多部分,一个BodyPart可以代表一个部分


(9) javax.mail.Internet.MimeBodyPart
 

MimeBodyPart
BodyPart具体用于mimeMessage的一个子类
MimeBodyPart
对象代表一个MimeMessage对象内容的一部分.每个MimeBodyPart被认为有两部分
一个MIME类型 
匹配这个类型的内容 

用法
MimeBodyPart mdp=new MimeBodyPart(); 
String text="Hello JavaMail!"; 
mdp.setContent(text,"text/plain");//
定义MIME类型为text/plain,并设置MimeBodyPart的内容


(10) javax.activation.DataHandler
(包含在JAF
JavaMail API
不限制信息只为文本,任何形式的信息都可能作茧自缚MimeMessage的一部分.除了文本信息,作为文件附件包含在电子邮件信息的一部分是很普遍的.JavaMail API通过使用DataHandler对象,提供一个允许我们包含非文本BodyPart对象的简便方法

用法
DataHandler dh=new DataHandler(text,type); 
mdp.setDatahandler(dh);//mdp
是一个MimeBodyPart对象 


(11) javax.activation.FileDataSource
(包含在JAF
一个FileDataSource对象可以表示本地文件和服务器可以直接访问的资源.一个本地文件可以通过创建一个新的MimeBodyPart对象附在一个mimeMessage对象上

用法
MimeMultipart mm=new MimeMultipart(); 
MimeBodyPart mdp=new MimeBodyPart(); 
FileDataSource fds=new FileDataSource("c:/exam.txt"); 
mdp.setDataHandler(new DataHandler(fds)); //
设置数据源 
mm.addBodyPart(mdp); //
为当前消息MimeMultipart对象增加MimeBodyPart 


(12) javax.activation.URLDataSource
(包含在JAF
远程资源,URL不会指向它们,由一个URLDataSource对象表示.一个远程资源可以通过创建一个新mimeBodyPart对象附在一个mimeMessage对象上(FileDataSource差不多). 

4.试着编写第一个发送程序

在前面我们已对JavaMail作了一些介绍,下面我们可试着写自己的程序了.

首先,我们先写一个撰写邮件的html程序index.htm,如下:
-------------------------------------------------------------------------------------------
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=gb2312">
<title>
撰写邮件</title>
</head>

<body>
<form name="form1" method="post" action="testmail.jsp">
<table width="75" border="0" align="center" cellspacing="1" bgcolor="#006600" class="black">
<tr bgcolor="#FFFFFF">
<td width="24%">
收信人地址:</td>
<td width="76%">
<input name="to" type="text" id="to"></td>
</tr>
<tr bgcolor="#FFFFFF">
<td>
主题:</td>
<td>
<input name="title" type="text" id="title"></td>
</tr>
<tr>
<td height="107" colspan="2" bgcolor="#FFFFFF">
<textarea name="content" cols="50" rows="5" id="content"></textarea></td>
</tr>
<tr align="center">
<td colspan="2" bgcolor="#FFFFFF">
<input type="submit" name="Submit" value="
发送">
<input type="reset" name="Submit2" value="
重置">
</td>
</tr>
</table>
</form>
</body>
</html>


接着,我们再写一个处理程序testmail.jsp,如下:
-----------------------------------------------------------------------------------------
<%@ page contentType="text/html;charset=GB2312" %>
<%request.setCharacterEncoding("gb2312");%><!--
中文处理代码-->

<!--
引入要用到的类库-->
<%@ page import="java.util.*,javax.mail.*"%>
<%@ page import="javax.mail.internet.*"%>

<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=gb2312">
<title>
发送成功</title>
</head>

<body>
<%
try{

//
html表单中获取邮件信息
String tto=request.getParameter("to");
String ttitle=request.getParameter("title");
String tcontent=request.getParameter("content");

Properties props=new Properties();//
也可用Properties props = System.getProperties();
props.put("mail.smtp.host","smtp.163.net");//
存储发送邮件服务器的信息
props.put("mail.smtp.auth","true");//
同时通过验证
Session s=Session.getInstance(props);//
根据属性新建一个邮件会话
s.setDebug(true);

MimeMessage message=new MimeMessage(s);//
由邮件会话新建一个消息对象

//
设置邮件
InternetAddress from=new InternetAddress("boy@163.net");
message.setFrom(from);//
设置发件人
InternetAddress to=new InternetAddress(tto);
message.setRecipient(Message.RecipientType.TO,to);//
设置收件人,并设置其接收类型为TO
message.setSubject(ttitle);//
设置主题
message.setText(tcontent);//
设置信件内容
message.setSentDate(new Date());//
设置发信时间

//
发送邮件
message.saveChanges();//
存储邮件信息
Transport transport=s.getTransport("smtp");
transport.connect("smtp.163.net","boy","iloveyou");//
smtp方式登录邮箱
transport.sendMessage(message,message.getAllRecipients());//
发送邮件,其中第二个参数是所有
//
已设好的收件人地址
transport.close();

%>
<div align="center">
<p><font color="#FF6600">
发送成功!</font></p>
<p><a href="recmail.jsp">
去看看我的信箱</a><br>
<br>
<a href="index.htm">
再发一封</a> </p>
</div>
<%
}catch(MessagingException e){
out.println(e.toString());
}
%>
</body>
</html>

**********************************
注意***************************************

有好多书上和网上的文章在关键部分都是这样写testmail.jsp,如下:

String tto=request.getParameter("to");
String ttitle=request.getParameter("title");
String tcontent=request.getParameter("content");
Properties props=new Properties();
props.put("mail.smtp.host","smtp.163.net");
Session s=Session.getInstance(props);
MimeMessage message=new MimeMessage(s);

InternetAddress from=new InternetAddress("boy@163.net");
message.setFrom(from);
InternetAddress to=new InternetAddress(tto);
message.setRecipient(Message.RecipientType.TO,to);

message.setSubject(ttitle);
message.setText(tcontent);
message.setSentDate(new Date());

Store store=s.getStore("pop3");
store.connect("pop.163.net","boy","iloveyou");//
pop3的方式登录邮箱
Transport transport=s.getTransport("smtp");
transport.send(message);
store.close();

事实上,这种方式并不可靠,因为很多电子邮局的smtp服务器要求我们通过验证,所以用这种方式发邮件时,只能发给同类邮箱(即相同smtp的邮箱),甚至有时同类邮箱也发不出去.以上两种方式我试过很多次,结果证明第一种方式是最可靠的.


好了,我相信你应该会写最简单的Email发送程序了.OK,下一次我们将说说怎样写发送HTML格式的邮件.

5.发送HTML格式的邮件

所谓HTML格式,就是超文本格式.你的邮件可以用HTML代码编写,发给对方后,对方收到的将是信息将是超文本,超文本比纯文本好看多了.下以面是在以前例子的基础上修改的程序:

<%@ page contentType="text/html;charset=GB2312" %>
<%request.setCharacterEncoding("gb2312");%>
<%@ page import="java.util.*,javax.mail.*"%>
<%@ page import="javax.mail.internet.*"%>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=gb2312">
<title>
发送成功</title>
</head>

<body>
<%
try{
String tto=request.getParameter("to");
String ttitle=request.getParameter("title");
String tcontent=request.getParameter("content");
Properties props=new Properties();
props.put("mail.smtp.host","127.0.0.1");
props.put("mail.smtp.auth","true");
Session s=Session.getInstance(props);
s.setDebug(true);

MimeMessage message=new MimeMessage(s);

//
给消息对象设置发件人/收件人/主题/发信时间
InternetAddress from=new InternetAddress("xxf@cafe.com");
message.setFrom(from);
InternetAddress to=new InternetAddress(tto);
message.setRecipient(Message.RecipientType.TO,to);
message.setSubject(ttitle);
message.setSentDate(new Date());


//
给消息对象设置内容
BodyPart mdp=new MimeBodyPart();//
新建一个存放信件内容的BodyPart对象
mdp.setContent(tcontent,"text/html;charset=gb2312");//
BodyPart对象设置内容和格式/编码方式
Multipart mm=new MimeMultipart();//
新建一个MimeMultipart对象用来存放BodyPart
//
(事实上可以存放多个)
mm.addBodyPart(mdp);//
BodyPart加入到MimeMultipart对象中(可以加入多个BodyPart)
message.setContent(mm);//
mm作为消息对象的内容

message.saveChanges();
Transport transport=s.getTransport("smtp");
transport.connect("127.0.0.1","xxf","coffee");
transport.sendMessage(message,message.getAllRecipients());
transport.close();
%>
<div align="center">
<p><font color="#FF6600">
发送成功!</font></p>
<p><a href="recmail.jsp">
去看看我的信箱</a><br>
<br>
<a href="index.htm">
再发一封</a> </p>
</div>
<%
}catch(MessagingException e){
out.println(e.toString());
}
%>
</body>
</html>