JMail 应用实践（一）--- 简介用Java程序发送email

       用JavaMail 发送电子邮件虽然很简单，但是对于未接触过的朋友，它还存在着一丝神秘。本文通过用一个简单的Java 应用程序发送一封电子邮件来揭开这片神秘的面纱，而对于邮件协议等等内容，这里暂不涉及---东西太多了就像云雾一样遮住了双眼。这方面以后还需要跟大家专门探讨一下。

 

       JavaMail API 是一个用于阅读、编写和发送电子消息的可选包（标准扩展），与Microsoft Outlook、FoxMail之类的软件功能相似。这也可以看出，API本身的用途并不是用来传输、发送和转发电子消息，这些都是邮件服务器的工作，JMail API 用来创建邮件用户代理（Mail User Agent）类型程序，邮件服务器我们以后再介绍。

 

       在开始介绍一下本示例的运行环境:

      ·Window 2000 Server sp4

    ·JDK 6u10b

    ·JMail API v1.4.2

    ·JAF API v1.1 (JavaBean Activation Framework) 这个是JMail API依赖的支持库

   ·Eclipse 3.4 for J2EE Developers

 

 

   

    用JavaMail发送电子邮件的过程比较简单，大致分为以下四个步骤：

 

    1. 创建Properties 对象，设置邮件服务器属性：mail.smtp.host ，其指定你的SMTP服务器，这个服务器不用担心，我们就用163现成的。

 

      2.  建立一个邮件会话，你可以创建若干个邮件会话，有兴趣可以研究研究

 

      3.  创建你的邮件信息对象，该对象包含了你的邮件的全部内容，包括发送人，接受人，标题，正文，附件等内容

 

    4. 邮件传输，邮件的传输只有送出和收到两中状态。JavaMail 将之称为传输和存储。这里我只展示发送邮件  

 

        用代码来描述如下所示：

		String host = ...; // 指定的smtp服务器
		String from = ...; // 邮件发送人的邮件地址
		String to = ...; // 邮件接收人的邮件地址

		// 创建Properties 对象
		Properties props = System.getProperties();

		// 添加smtp服务器属性
		props.put("mail.smtp.host", host);

		// 创建邮件会话
		Session session = Session.getDefaultInstance(props, null);

		try {
			// 定义邮件信息
			MimeMessage message = new MimeMessage(session);
			message.setFrom(new InternetAddress(from));
			message.addRecipient(Message.RecipientType.TO, new InternetAddress(
					to));
			message.setSubject("HelloWorld JavaMail");
			message.setText("Welcome to JavaMail World!");

			// 发送消息
			Transport.send(message);

		} catch (MessagingException e) {
			// TODO Auto-generated catch block
			e.printStackTrace();
		}

  

       以上已经描述用JMail 发送邮件的大致过程，如果你有一个免费的不需要帐户认证的公用邮件服务器，上面的程序已经可以用来发送邮件了。（不过我没有找到这样的邮件服务器，不过可以自己配置一个^_^）

 

 

       眼见为实，不真正发送成功一个邮件，始终会让人觉得掉胃口。要想那样，我们需要稍微修改上面的程序，完整的程序如下：

package com.zhaipuhong.j2ee.jmail;

import java.util.Properties;

import javax.mail.Authenticator;
import javax.mail.Message;
import javax.mail.MessagingException;
import javax.mail.PasswordAuthentication;
import javax.mail.Session;
import javax.mail.Transport;
import javax.mail.internet.InternetAddress;
import javax.mail.internet.MimeMessage;

public class HelloJMail {
	
       public static void sendMail() {
	String host = "smtp.163.com"; // 指定的smtp服务器
	String from = ""; // 邮件发送人的邮件地址
	String to = ""; // 邮件接收人的邮件地址
	final String username = "";  //发件人的邮件帐户
	final String password = "";   //发件人的邮件密码

	// 创建Properties 对象
	Properties props = System.getProperties();

	// 添加smtp服务器属性
	props.put("mail.smtp.host", host);
	props.put("mail.smtp.auth", "true");   //163的stmp不是免费的也不公用的，需要验证

	// 创建邮件会话
	Session session = Session.getDefaultInstance(props, new Authenticator(){  //验账账户
		@Override
		public PasswordAuthentication getPasswordAuthentication() {
			return new PasswordAuthentication(username, password);
		}
			
	});

	try {
	        // 定义邮件信息
	     MimeMessage message = new MimeMessage(session);
                       message.setFrom(new InternetAddress(from));
	       message.addRecipient(Message.RecipientType.TO, new InternetAddress(
					to));
	       message.setSubject("HelloWorld JavaMail");
                       message.setText("Welcome to JavaMail World!");

	       // 发送消息
	     //session.getTransport("smtp").send(message);  //也可以这样创建Transport对象
	     Transport.send(message);

	} catch (MessagingException e) {
		e.printStackTrace();
	}
      }

      public static void main(String[] args) {
	HelloJMail.sendMail();
      }

}

     上面的程序把我的邮箱帐号信息删除了，测试的时候补充你自己的邮箱帐号信息即可使用：

      ……
      public static void sendMail() {
             String host = "smtp.163.com"; // 指定的smtp服务器
         String from = ""; // 邮件发送人的邮件地址
         String to = ""; // 邮件接收人的邮件地址
         final String username = "";  //发件人的邮件帐户
         final String password = "";   //发件人的邮件密码
    ……

 

 

      FAQ:

     1. 如果你遇到“……553 authentication is required……”

      请检查你的如下设置是否正确：

    

……

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

……
Session session = Session.getDefaultInstance(props, new Authenticator(){//你也可以单独创建Authenticator对象
			@Override
			public PasswordAuthentication getPasswordAuthentication() {
				return new PasswordAuthentication(username, password);
			}
			
});

……

      2. 如果你遇到“……java.lang.NoClassDefFoundError……com/sun/mail/util/SharedByteArrayInputS 、   com/sun/mail/util/MailDateFormat……  ” 之类的错误

      可能你的项目中引用了j2ee.jar包，里面包含有jmail API,与你添加到classpath中的jmail.jar版本不一样或者内容有差别等造成，你需要在classpath中把你刚添加的jmail.jar和activation.jar放在j2ee.jar的前面，在IDE中，就在类库中把这两个包“move up”到j2ee.jar包的上面。

      

评论

10 楼 li370036149 2012-02-28  

zhanghuang0713 写道

大家好:在我用开发的过程中，我只知道一个人邮件是：[e-mail],我能通过什么方法知道他的邮件服务器（mail.smtp.host）是什么呢？因为我遇到了样的问题
报出这样异常：
javax.mail.MessagingException: Unknown SMTP host: smtp.softchina.com.cn;

坐等回答8楼问题

9 楼 energykey 2009-03-17  

谢谢你的分享，此文对我有非常大的帮助。呵呵！

8 楼 zhanghuang0713 2008-09-18  

大家好:在我用开发的过程中，我只知道一个人邮件是：[e-mail],我能通过什么方法知道他的邮件服务器（mail.smtp.host）是什么呢？因为我遇到了样的问题
报出这样异常：
javax.mail.MessagingException: Unknown SMTP host: smtp.softchina.com.cn;

7 楼 wxjia 2008-08-14  

Exception in thread "main" java.lang.NoClassDefFoundError: javax/activation/SecuritySupport
	at javax.activation.MailcapCommandMap.loadAllResources(MailcapCommandMap.java:211)
	at javax.activation.MailcapCommandMap.<init>(MailcapCommandMap.java:148)
	at javax.activation.CommandMap.getDefaultCommandMap(CommandMap.java:44)
	at javax.activation.DataHandler.getCommandMap(DataHandler.java:136)
	at javax.activation.DataHandler.getDataContentHandler(DataHandler.java:568)
	at javax.activation.DataHandler.writeTo(DataHandler.java:294)
	at javax.mail.internet.MimeUtility.getEncoding(MimeUtility.java:261)
	at javax.mail.internet.MimeBodyPart.updateHeaders(MimeBodyPart.java:1321)
	at javax.mail.internet.MimeMessage.updateHeaders(MimeMessage.java:2074)
	at javax.mail.internet.MimeMessage.saveChanges(MimeMessage.java:2042)
	at javax.mail.Transport.send(Transport.java:117)
	at test.JMailTest.sendMail(JMailTest.java:49)
	at test.JMailTest.main(JMailTest.java:57)

我用的你的示例 然后就报以上的异常，
我下的是官方的1.4.1而且eclipse也是用的3.3 还有JAF API v1.1 应该也是没有的， 但我现在的开发环境基本没的改了， 能不能发个我能用的示例看下

6 楼 zhaipuhong 2008-08-06  

zhuyx808 也可以定义Classpath中各各包加载的顺序。像我使用的是weblogic server我们确是也出现类似情况，我们就在weblogic server启动脚本中按顺序指定jar加载的循序。在tomcat下我还没有尝识过，不过肯定有办法。
如果真的没有办法就把你哪个j2ee.jar揭开，把jmail哪一部分给作个阑尾手术吧^_^

5 楼 zhuyx808 2008-08-06  

引用

可能你的项目中引用了j2ee.jar包，里面包含有jmail API,与你添加到classpath中的jmail.jar版本不一样或者内容有差别等造成，你需要在classpath中把你刚添加的jmail.jar和activation.jar放在j2ee.jar的前面，在IDE中，就在类库中把这两个包“move up”到j2ee.jar包的上面。

这个只能解决在IDE中的问题吧，假如你已经部署过的话，照样会出问题的，不知道这里你是怎么解决的（J2EE.JAR和JAMIL.JAR冲突问题）

4 楼 zhaipuhong 2008-08-04  

现在的163邮箱可能对stmp服务做了限制，我同事也遇到过类似的情况，我的163的邮箱是一点问题都没有的，他的163是刚申请不久的，他告诉我现在163的邮件服务器对stmp服务做了限制，我想可能是邮件服务器在安全方面更加严格了，我没有去深究这个问题。如果你有兴趣可以自己搭建一个自己的邮件服务器。那不是更刺激。这里我推荐你去看看我的一篇关于用james搭建邮件服务器的入门文章http://zhaipuhong.iteye.com/blog/213246


laiseeme 本程序是基于stmp协议发送邮件，邮件服务器支持stmp是必须的。

3 楼 laiseeme 2008-08-01  

如果想调用linux里面的邮件服务器发送邮件可以么？
要这样的话还得必须有一个支持smtp的邮箱

2 楼 CaleloKing 2008-07-31  

你好，但是我现在也是写了一个简单的测试发送到163的程序，报错的情况却不是你所说的这些，而是在Transport.send(m);这里报异常，进一步看，其实是在saveChanges()报异常。我很想不通，不知道你遇到过没？有什么办法解决。

1 楼 deepsea0001 2008-07-27  

楼主的文章都是精品！