JavaMail API中文文档

Java Servlet API说明文档（2.1a版）（一）/Info/121/Info37231/译者前言：近来在整理有关Servlet资料时发现，在网上竟然找不到一份中文的Java Servlet API的说明文档，而在有一本有关JSP的书后面附的Java Servlet API说明竟然不全，而这份文档的2.1a版在1998年的11月份就已定稿。

所以我决定翻译一份中文的文档（其中一些与技术关系不大的部分已被略去），有兴趣的读者可以从/products/servlet/2.1/servletspec-2.1.zip下载原文阅读。

Java Servlet API说明文档（2.1a版）1998年11月绪言这是一份关于2.1版Java Servlet API的说明文档，作为对这本文档的补充，你可以到/products/servlet/index.html下面下载Javadoc格式的文档。

谁需要读这份文档这份文档描述了Java Servlet API的最新版本2.1版。

所以，这本书对于Servlet 的开发者及servlet引擎的开发者同样适用。

Java Servlet API的组成Java Servlet API由两个软件包组成：一个是对应HTTP的软件包，另一个是不对应HTTP的通用的软件包。

这两个软件包的同时存在使得Java Servlet API能够适应将来的其他请求-响应的协议。

这份文档以及刚才提及的Javadoc格式的文档都描述了这两个软件包，Javadoc 格式的文档还描述了你应该如何使用这两个软件包中的所有方法。

有关规范你也许对下面的这些Internet规范感兴趣，这些规范将直接影响到Servlet API的发展和执行。

你可以从/7c/in-notes/rfc/.cache找到下面提到的所有这些RFC规范。

RFC1738统一资源定位器(URL)RFC1808相关统一资源定位器RFC1945超文本传输协议--HTTP/1.0RFC2045多用途Internet邮件扩展(多用途网际邮件扩充协议(MIME))第一部分:Internet信息体格式RFC2046多用途Internet邮件扩展(多用途网际邮件扩充协议(MIME))第二部分:媒体类型RFC2047多用途网际邮件扩充协议(MIME)(多用途Internet邮件扩展)第三部分:信息标题扩展用于非ASCII文本RFC2048多用途Internet邮件扩展(多用途网际邮件扩充协议(MIME))第四部分:注册步骤RFC2049多用途Internet邮件扩展(多用途网际邮件扩充协议(MIME))第五部分:一致性标准和例子RFC2068超文本传输协议--HTTP/1.1RFC2069一个扩展HTTP:摘要访问鉴定RFC2109HTTP状态管理机制RFC2145HTTP版本号的使用和解释RFC2324超文本Coffee Pot控制协议(HTCPCP/1.0)万维网协会（）管理着这些协议的规范和执行。

JavaMail快速入门——使用JavaMail APls发送和接收
Email
TonyLoton; 郑涛
【期刊名称】《《程序员：CSDN开发高手》》
【年(卷),期】2004(000)002
【摘要】本文中Tony Loton将带你走上开发基于Java的。

Email应用的第一步，如果你喜欢创建自己的Email客户端程序而不是用Microsoft Outlook,或者喜欢
建一个基于Web的Email系统而不用诸如Hotmail之类的东西，那么本文正是
你所需要的。

为了从一个不同寻常的角度来审视JavaMail潜在的能力。

【总页数】7页(P78-84)
【作者】TonyLoton; 郑涛
【作者单位】
【正文语种】中文
【中图分类】TP393.098
【相关文献】
1.例题53 基于JavaMail API的邮件接收 [J], 左瑞欣
2.基于JavaMail API的邮件认证与接收 [J], 钟忺;刘春燕
3.使用JavaMail/JAF开发中文邮件系统的关键技术研究 [J], 袁梅冷;聂哲
4.一种使用JavaMail的邮件直接发送方法及其实现 [J], 沈洪良;朱国进
5.应用JavaMail接收和发送E-mail [J], 魏钢
因版权原因，仅展示原文概要，查看原文内容请购买。

javaapi帮助文档chm1java api 帮助文档chm 1.5 1.6 中文版英文版Sun 公司提供的Java API Docs是学习和使用Java语言中最经常使用的参考资料之一。

但是长期以来此文档只有英文版，对于中国地区的Java开发者来说相当的不便。

目前Sun 公司正在组织多方力量将此文档翻译成中文，并于2005年10月31日在Sun 中国技术社区（/doc/ba14186412.html,/）正式发布第一批中文版Java API文档（包括/doc/ba14186412.html,ng和java.util 类库API 文档的中文版）。

经过将近10个月的努力，目前我们已经将Java SE 5.0的全部API文档中文化。

开发人员可以通过Sun 中国技术社区的网站在线浏览相关文档，也可以将全部文档下载到本地以方便检索和使用。

J2SE DK & API下载-------------------------/doc/ba14186412.html,/j2se/1.3/dow nload.html/doc/ba14186412.html,/j2se/1.4.2/do wnload.html/doc/ba14186412.html,/javase/downl oads/index_jdk5.jsp/doc/ba14186412.html,/javase/downl oads/index.jspJ2EE DK & API下载-------------------------/doc/ba14186412.html,/j2ee/1.3/inde x.jsp/doc/ba14186412.html,/j2ee/1.3/dow nload.html/doc/ba14186412.html,/j2ee/1.4/inde x.jsp/doc/ba14186412.html,/j2ee/1.4/dow nload.html/doc/ba14186412.html,/javaee/downl oads/index.jspJDK1.6API中文版（全）-------------------------* HTML 格式(在线英文) /doc/ba14186412.html,/javase/6/docs/ * HTML 格式(在线中文) /doc/ba14186412.html,/jdk/jdk-api-localizations/jdk-api-zh-cn/publish/1.6.0/html/zh_CN/api/ind ex.html* zip 格式(中文) /doc/ba14186412.html,/jdk/jdk-api-localizations/jdk-api-zh-cn/publish/1.6.0/html_zh_CN.zip * CHM 格式(中文) /doc/ba14186412.html,/jdk/jdk-api-localizations/jdk-api-zh-cn/publish/1.6.0/chm/JDK_API_1_6_zh_CN.CHMJDK1.5API中文版（全）-------------------------* HTML 格式(在线英文) /doc/ba14186412.html,/javase/5/docs/ * HTML 格式(在线中文) /doc/ba14186412.html,/Java_Docs/html/z h_CN/api/index.html* zip 格式(中文) /doc/ba14186412.html,/Java_Docs/html_zh_CN.zip* CHM 格式(中文) /doc/ba14186412.html,/jdk/jdk-api-localizations/jdk-api-zh-cn/builds/JDK_API_1_5_zh_CN.CH M 相关网站-------------------------/doc/ba14186412.html,/doc/ba14186412.html,//doc/ba14186412.html,/downloads/ /doc/ba14186412.html,/javaee/downl oads//doc/ba14186412.html,/javase/downl oads/随着开始全面接触JavaAPI，现在人手一份中文版的JavaAPI文档（java-docs-api-cn.zip），在写代码的过程中需要经常查阅。

javaMail邮件接收解析内容及附件及删除邮件使⽤javaMail获取邮件内容。

⼯具类可直接使⽤。

package com.szy.project.utils;import java.io.BufferedInputStream;import java.io.BufferedOutputStream;import java.io.File;import java.io.FileNotFoundException;import java.io.FileOutputStream;import java.io.IOException;import java.io.InputStream;import java.io.UnsupportedEncodingException;import java.text.SimpleDateFormat;import java.util.Date;import java.util.Properties;import javax.mail.Address;import javax.mail.BodyPart;import javax.mail.Flags;import javax.mail.Folder;import javax.mail.Message;import javax.mail.MessagingException;import javax.mail.Multipart;import javax.mail.Part;import javax.mail.Session;import javax.mail.Store;import javax.mail.internet.InternetAddress;import javax.mail.internet.MimeMessage;import javax.mail.internet.MimeMultipart;import javax.mail.internet.MimeUtility;/*** 邮件接受测试**//*** 使⽤POP3协议接收邮件*/public class POP3ReceiveMailTest {public static void main(String[] args) throws Exception {resceive();}/*** 接收邮件*/public static void resceive() throws Exception { /** * 因为现在使⽤的是163邮箱⽽163的 pop地址是　　端⼝是　110 * ⽐如使⽤好未来企业邮箱就需要换成好未来邮箱的 pop服务器地址 和端⼝110 */ String duankou = "110"; // 端⼝号 String servicePath = ""; // 服务器地址// 准备连接服务器的会话信息Properties props = new Properties();props.setProperty("mail.store.protocol", "pop3"); // 使⽤pop3协议props.setProperty("mail.pop3.port", duankou); // 端⼝props.setProperty("mail.pop3.host", servicePath); // pop3服务器// 创建Session实例对象Session session = Session.getInstance(props);Store store = session.getStore("pop3");store.connect("157********@", "***********"); //163邮箱程序登录属于第三⽅登录所以这⾥的密码是163给的授权密码⽽并⾮普通的登录密码// 获得收件箱Folder folder = store.getFolder("INBOX");/* Folder.READ_ONLY：只读权限* Folder.READ_WRITE：可读可写（可以修改邮件的状态）*/folder.open(Folder.READ_WRITE); //打开收件箱// 由于POP3协议⽆法获知邮件的状态,所以getUnreadMessageCount得到的是收件箱的邮件总数System.out.println("未读邮件数: " + folder.getUnreadMessageCount());// 由于POP3协议⽆法获知邮件的状态,所以下⾯得到的结果始终都是为0System.out.println("删除邮件数: " + folder.getDeletedMessageCount());System.out.println("新邮件: " + folder.getNewMessageCount());// 获得收件箱中的邮件总数System.out.println("邮件总数: " + folder.getMessageCount());// 得到收件箱中的所有邮件,并解析Message[] messages = folder.getMessages();parseMessage(messages);//得到收件箱中的所有邮件并且删除邮件deleteMessage(messages);//释放资源folder.close(true);store.close();}/*** 解析邮件* @param messages 要解析的邮件列表*/public static void parseMessage(Message ...messages) throws MessagingException, IOException {if (messages == null || messages.length < 1)throw new MessagingException("未找到要解析的邮件!");// 解析所有邮件for (int i = 0, count = messages.length; i < count; i++) {MimeMessage msg = (MimeMessage) messages[i];System.out.println("------------------解析第" + msg.getMessageNumber() + "封邮件-------------------- ");System.out.println("主题: " + getSubject(msg));System.out.println("发件⼈: " + getFrom(msg));System.out.println("收件⼈：" + getReceiveAddress(msg, null));System.out.println("发送时间：" + getSentDate(msg, null));System.out.println("是否已读：" + isSeen(msg));System.out.println("邮件优先级：" + getPriority(msg));System.out.println("是否需要回执：" + isReplySign(msg));System.out.println("邮件⼤⼩：" + msg.getSize() * 1024 + "kb");boolean isContainerAttachment = isContainAttachment(msg);System.out.println("是否包含附件：" + isContainerAttachment);if (isContainerAttachment) {saveAttachment(msg, "f:\\mailTest\\"+msg.getSubject() + "_"+i+"_"); //保存附件}StringBuffer content = new StringBuffer(30);getMailTextContent(msg, content);System.out.println("邮件正⽂：" + (content.length() > 100 ? content.substring(0,100) + "..." : content)); System.out.println("------------------第" + msg.getMessageNumber() + "封邮件解析结束-------------------- "); System.out.println();}}/*** 解析邮件* @param messages 要解析的邮件列表*/public static void deleteMessage(Message ...messages) throws MessagingException, IOException {if (messages == null || messages.length < 1)throw new MessagingException("未找到要解析的邮件!");// 解析所有邮件for (int i = 0, count = messages.length; i < count; i++) {/*** 邮件删除*/Message message = messages[i];String subject = message.getSubject();// set the DELETE flag to truemessage.setFlag(Flags.Flag.DELETED, true);System.out.println("Marked DELETE for message: " + subject);}}/*** 获得邮件主题* @param msg 邮件内容* @return 解码后的邮件主题*/public static String getSubject(MimeMessage msg) throws UnsupportedEncodingException, MessagingException { return MimeUtility.decodeText(msg.getSubject());}/*** 获得邮件发件⼈* @param msg 邮件内容* @return 姓名 <Email地址>* @throws MessagingException* @throws UnsupportedEncodingException*/public static String getFrom(MimeMessage msg) throws MessagingException, UnsupportedEncodingException {String from = "";Address[] froms = msg.getFrom();if (froms.length < 1)throw new MessagingException("没有发件⼈!");InternetAddress address = (InternetAddress) froms[0];String person = address.getPersonal();if (person != null) {person = MimeUtility.decodeText(person) + "";} else {person = "";}from = person + "<" + address.getAddress() + ">";return from;}/*** 根据收件⼈类型，获取邮件收件⼈、抄送和密送地址。

今天一下午都在整java的api。 我的目标是在eclipse平台中用鼠标点击java的api就会自动显示出中文的注释。并且能在help中方便地搜索java的api。 这其实是使用bada开发平台后留下的后遗症。

图1.就是想要这个效果 最终结果是没有得到满意答案，发现最方便的方法还是另外开一个chm中文api文档。 下面我讲述一下整个下午我的三个收获。

一：首先是获取演示程序和英文api(就是java本身提供的接口文件，

Application Programming Interface，应用程序编程接口)

在安装jdk(java development kit)的时候，会遇到一个自定义安装的步骤，这里有4个安装可选。有几个是默认安装的。4个分别是标准开发工具，演示程序及样例，Api，数据库。 在鼠标点到的位置上单击(忘了左键还是右键)会有一个选项框，可以决定安装或不安装对应功能。下面"更改"可以改变安装路径。 图2.安装选项框 把中间两个功能选中就可以在安装完成后在根目录中看到两个文件夹Sample和Demo。里面就是示例程序。

图3，安装后出现的文件夹 并且可以在eclipse中把鼠标移到api自带方法时会弹出api说明。 图4，弹出api说明 二：在Eclipse帮助文档中加入API_doc文档。 首先下载API_doc文档。 地址：http://ishare.iask.sina.com.cn/f/7140029.html (2012.6.13) (感谢无偿贡献的网友) 文件有点大30M且只支持浏览器下载。

之后就是 ||在eclipse/plugins/下建立一个目录org.sun.java.doc.sdk_1.5.0，然后在这个目录下创建两个文件 plugin.xml 和toc.xml。 plugin.xml文件内容： id="org.sun.java.doc.sdk" name="Java 2 SDK Doc" version="1.5.0" provider-name="sun.org"> toc.xml文件内容： 然后将下载的jdk1_50doc.zip改名为doc.zip后放在与刚创建的两个文件相同目录下。注意，文件名一定要是doc.zip，zip 文件里面应该有这样的目录层次结构：jdk1_50doc/index.html 然后重启Eclipse即可在帮助文档中看到api|| (竖线分隔部分转自博客园Byron lee：

Properties props = new Properties(); props.setProperty("java.naming.factory.initial“,"org.jnp.interfaces.Nam ingContextFactory"); props.setProperty("java.naming.provider.url", "localhost:1099"); props.setProperty("java.naming.factory.url.pkgs“,"org.jboss.naming"); ctx = new InitialContext(props); System.err.println("** Unable to connect to the server");
InternetAddress
表示电子邮件地址； InternetAddress dest=new InternetAddress(“me@”); 使用该InternetAddress，可以将Message对象 发送到指定的邮箱；


msg.setRecipient(Message.RecipientType.T O,dest); //将电子邮件中的To:字段设置成dest指定的地址
JavaMail API
javax.mail.Session javax.mail.internet.InternetAddress javax.mail.Message javax.mail.Transport
Session
定义全局和每用户邮件相关属性——用于定义客户端和服 务器的交互方式； JavaMail Session

JavaMail⼊门第四篇接收邮件上⼀篇中，我们学会了如何⽤JavaMail API提供的Transport类发送邮件，同样，JavaMail API中也提供了⼀些专门的类来对邮件的接收进⾏相关的操作，在介绍这些类之前，我们先来了解下邮件接收API的体系结构，JavaMail API中定义了⼀个java.mail.Store类，它⽤于执⾏邮件的接收任务，我们在程序中调⽤这个类中的⽅法可以获取邮箱中的各个邮件夹的信息。

JavaMail使⽤Folder对象表⽰邮件夹，通过Folder对象的⽅法可以获取邮件夹中的所有邮件信息，⽽我们知道邮件的信息可以使⽤Message对象来表⽰，Message类中就包含了操作邮件的各种⽅法了，例如获取邮件的发送者，主题，正⽂内容，发送时间等，它们⼯作关系如下：1、从Session对象中获得实现了某种邮件发送协议的Store对象；2、登录邮箱，连接上POP3或者IMAP4服务器；3、调⽤Store的getFolder⽅法，获取邮箱中的某个邮件夹的Folder对象；4、调⽤Folder对象中的getMessage或getMessages⽅法，获取邮件夹中的某⼀封邮件或者是所有邮件，每⼀封的邮件以⼀个Message对象返回。

接下来我们⽤以上类来接收邮件1import java.util.Properties;23import javax.mail.Address;4import javax.mail.Folder;5import javax.mail.Message;6import javax.mail.Session;7import javax.mail.Store;89class MailReceives {10public static void main(String[] args) throws Exception {11// 定义连接POP3服务器的属性信息12 String pop3Server = "";13 String protocol = "pop3";14 String username = "123456@";15 String password = "****************"; // QQ邮箱的SMTP的授权码，1617 Properties props = new Properties();18 props.setProperty("mail.transport.protocol", protocol); // 使⽤的协议（JavaMail规范要求）19 props.setProperty("mail.smtp.host", pop3Server); // 发件⼈的邮箱的 SMTP服务器地址2021// 获取连接22 Session session = Session.getDefaultInstance(props);23 session.setDebug(false);2425// 获取Store对象26 Store store = session.getStore(protocol);27 store.connect(pop3Server, username, password); // POP3服务器的登陆认证2829// 通过POP3协议获得Store对象调⽤这个⽅法时，邮件夹名称只能指定为"INBOX"30 Folder folder = store.getFolder("INBOX");// 获得⽤户的邮件帐户31 folder.open(Folder.READ_WRITE); // 设置对邮件帐户的访问权限3233 Message[] messages = folder.getMessages();// 得到邮箱帐户中的所有邮件3435for (Message message : messages) {36 String subject = message.getSubject();// 获得邮件主题37 Address from = (Address) message.getFrom()[0];// 获得发送者地址38 System.out.println("邮件的主题为: " + subject + "\t发件⼈地址为: " + from);39 System.out.println("邮件的内容为：");40 message.writeTo(System.out);// 输出邮件内容到控制台41 }4243 folder.close(false);// 关闭邮件夹对象44 store.close(); // 关闭连接对象45 }46 }控制台输出结果：可以看到控制台输出的是邮件的原始内容，还未被解析，所以需要经过解析才能阅读，下⼀篇将讲解如何解析邮件。

18
ACCP V4.0
总结 2-2
Multipart 消息是 Message 类的对象.其内容类型设置为 Multipart Multipart 消息可以有多个 Bodypart Bodypart 既可以为纯文本,也可以为附件
19
ACCP V4.0
�
3
ACCP V4.0
JavaMail API
JavaMail 用于通过网络或 Internet 发送和接收邮件
JavaMail API
抽象类的 集合
跨平台和跨 协议
提供发送和接 收 JavaMail 的 功能
SMTP 服务 器用于发送 邮件
POP3 和 IMAP 服务器用于接收 邮件
4
ACCP V4.0Fra bibliotek6ACCP V4.0
Folder 类
Folder 类定义存取 备份 附加 删除信息等方法 可以只读 类定义存取,备份 附加,删除信息等方法 备份,附加 删除信息等方法,可以只读 模式(READ_ONLY),读写模式打开文件夹 模式 读写模式打开文件夹 (READ_WRITE)
Folder 类
子文件夹 包含消息 抽象类 关闭状态
第十三章 JavaMail
ACCP V4.0
目标
使用 JavaMail API发送和接收邮件
2
ACCP V4.0
邮件协议
SMTP:简单邮件传送协议,Simple Mail Transfer Protocol协议定义了发送电子邮件的规范. POP3:Post office Protocol version3 邮局协议第 三版,协议定义了接收邮件的规范 IMAP:Internet Messager Access Protocol,因特尔 消息访问服务,比POP3更强大.

java 解析mail 抄送如果你想要在 Java 中解析电子邮件中的 "抄送"（CC）部分，你可以使用Java Mail API。

下面是一个简单的示例，展示如何使用 Java Mail API 来解析一个 MIME 格式的电子邮件，并提取 "抄送" 部分：```javaimport ;import ;import ;public class EmailCCExtractor {public static void main(String[] args) throws MessagingException { // 假设邮件存储在 "" 这个文件夹中，邮件地址是 ""，密码是 "your-password"String host = "";String username = "";String password = "your-password";String emailId = username; // 使用你的邮件地址Properties properties = new Properties();("", "imap");("", host);("", "993"); // 使用 IMAP 的端口号("", "true"); // 启用 SSL// 创建会话对象Session session = (properties, null);Store store = ("imap");(username, password);// 获取收件箱文件夹Folder inboxFolder = ("INBOX");(_ONLY);// 获取收件箱中的所有邮件，并遍历它们以提取抄送者 Message[] messages = ();for (Message message : messages) {// 获取邮件的主题和抄送者列表String subject = ();List<InternetAddress> ccList = 抄送Addresses(message);if (ccList != null) {for (InternetAddress cc : ccList) {("抄送者: " + ());}} else {("没有找到抄送者");}}// 关闭文件夹和会话对象(false);();}}```这个示例假设你使用的是 IMAP 协议，并且邮件存储在名为 "" 的服务器上的 "INBOX" 文件夹中。

elasticsearch7版本java api中文详解Elasticsearch是一个分布式、实时的搜索和分析引擎，它具有高性能、可扩展性和强大的全文搜索功能。

Java API是Elasticsearch提供的一组Java开发接口，用于与Elasticsearch集群进行交互。

本文将详细解释Elasticsearch7版本Java API的使用方法和相关注意事项。

一、依赖配置在使用Elasticsearch7版本的Java API之前，首先要确保在项目配置文件中添加正确的依赖项。

一般情况下，我们需要添加以下两个依赖项：```xml<dependency><groupId>org.elasticsearch</groupId><artifactId>elasticsearch</artifactId><version>7.0.0</version></dependency><dependency><groupId>org.elasticsearch.client</groupId><artifactId>elasticsearch-rest-high-level-client</artifactId><version>7.0.0</version></dependency>```这两个依赖项分别提供了Elasticsearch的核心功能和高级客户端的支持，确保在使用Java API时能正常操作和访问Elasticsearch集群。

二、连接Elasticsearch集群在开始使用Java API之前，我们需要先与Elasticsearch集群建立连接。

连接的方式有两种：1. TransportClient方式（Deprecated）```javaTransportClient client = new PreBuiltTransportClient(Settings.EMPTY).addTransportAddress(newTransportAddress(InetAddress.getByName("localhost"), 9300));```这种方式已经被官方宣布为过时（Deprecated），建议使用High-Level REST Client方式进行连接。

第25卷第3期 计算机应用与软件Vo l 25No .32008年3月 Co m puter Applicati o ns and Soft w are M ar .2008使用JavaM ail/J AF 开发中文邮件系统的关键技术研究袁梅冷 聂 哲(深圳职业技术学院软件工程系 广东深圳518055)收稿日期:2006-04-13。

袁梅冷,讲师,主研领域:J 2EE 技术,电子商务等。

摘 要 Java M ail 提供了对邮件收发核心流程很好的支持,但在开发实用邮件系统过程中,必然会遇到Java M a il 本身并不支持的如嵌套邮件内容解释、M I M E 类型数据处理框架结构、中文乱码等技术难题。

在全面研究基于Java 技术的邮件系统开发的基础上,给出了通用的解决方案和实现要点。

关键词Java M ail J AF 中文乱码 邮件系统RES EARCH ON THE KEY TEC HNOLOG I ES IN THE DEVELOPM ENTOF CH INES E E MA IL S YSTEM BASED ON J AVAMA IL AND J AFYuanM eileng N ie Zhe(D e part m ent of S oft w are Engineeri ng,Colle g e of Sh e nzh e n P ol y t echnic ,Sh e nzhen 518055,Guangdong,China )Abstrac t Java M a il facilita tes the deve l op m en t o f E m ail Sy stem .H ow eve r ,during the develop m ent o f practi ca l E m a il syste m,so m e proble m s such as t he pars i ng o f nesti ng e m a il content ,t he process fra m ework o f data o fM I M E type ,and the unreadab le Ch i nese cha rs can not be supported by Java M a i.l G enera l so l utions to t hese prob l em s are presented ,and the key techno l og i es are prov i ded .K eywordsJava M ail JavaBeans A cti vation Fra m ewo rk(J A F) U nreadable ch i nese cha rs E m ail syste m0 引 言Java 语言作为一种强大的网络编程语言,为支持邮件系统的开发推出了Java M ail 开发包,极大地简化了基于Java 技术的邮件系统的开发。

Coremail XT V2.0 标准API（Java）使用手册盈世信息科技（北京）有限公司Coremail. Copyright 2000-2009 Mailtech.盈世信息科技（北京）有限公司版权声明本文档版权归盈世信息科技（北京）有限公司所有，并保留一切权利。

未经书面许可，任何公司和个人不得将此文档中的任何部分公开、转载或以其他方式散发给第三方。

否则，必将追究其法律责任。

免责声明本文档仅提供阶段性信息，所含内容可根据产品的实际情况随时更新，恕不另行通知。

如因文档使用不当造成的直接或间接损失，本公司不承担任何责任。

文档更新本文档由盈世信息科技（北京）有限公司于2009年9月最后修订。

公司网站销售咨询热线800-830-7652技术支持热线800-830-5422联系方式广州地址：广州市中山大道科韵路16号广州信息港网易大厦3楼邮编：510665 联系电话：+86(20)85106566 传真：+86(20)85106595北京地址：北京市西城区西外大街1号院西环广场T3座7层B7-B8邮编：100044 联系电话：+86(10)58301930 传真：+86(10)58302888上海地址：上海市静安区长乐路672弄33号B幢3楼邮编：200040 联系电话：+86(21)61103951 传真：+86(21)61107756成都地址：成都市高新区永丰路47号玉林商务港5楼518室邮编：610041 联系电话：+86(28)66252331 传真：+86(28)66252332盈世信息科技（北京）有限公司目录1 Coremail XT API通用函数说明 (1)1.1 getClient(连接APIServer使用的socket) (1)1.2 getRetCode（获取操作的返回值） (1)1.3 getResult（操作的返回结果） (2)1.4 getResultEx（返回操作的返回结果） (2)1.5 getErrorInfo（描述操作失败原因） (2)1.6 toString（返回操作结果的字符串表示） (2)1.7 close（释放连接与资源） (3)2 API函数的使用步骤 (3)3 Coremail XT API具体功能应用 (4)3.1 登录 (4)3.1.1 用户登录 (4)3.1.2 检查用户是否存在 (6)3.1.3 验证用户密码 (6)3.1.4 检查用户的session，返回用户信息 (6)3.1.5 检查用户的session，并刷新访问时间 (7)3.1.6 获取用户session中的变量 (7)3.1.7 用户退出 (8)3.2 用户维护 (8)3.2.1 创建用户 (8)3.2.2 删除用户 (9)3.2.3 用户属性获取 (9)3.2.4 用户属性变更 (10)3.2.5 用户是否存在判定 (10)4 附录 (11)4.1 API配置文件说明 (11)4.2 返回信息表 (12)4.3 用户属性表 (13)盈世信息科技（北京）有限公司1Coremail XT API通用函数说明APIContext类提供一个工厂方法，产生一个的客户端连接IClient类型的实例，即API 客户端对象。

创建一个 Servlet，用于接受 HTTP 页面上的邮件服务器 名称、发件人地址、收件人地址、主题和消息的内容 发送邮件
演示：示例 2
ห้องสมุดไป่ตู้
14
列出 Inbox 中的邮件
import java.util.*; import java.io.*; import javax.mail.*; import javax.mail.internet.*; import javax.activation.*; public class writemessage { public static void main(String[] args) { Session ses = Session.getDefaultInstance(System.getProperties(),null); 获得 Session 对象 Store store = ses.getStore(protocol); 获得 Store 对象并连接到 Store store.connect(hostname, username, password) Folder folder = store.getFolder(Inbox); 获得默认文件夹并以 Read_Write folder.open(Folder.READ_WRITE); 模式打开 获得数组中的所有消息 Message arraymessage[] = folder.getMessages(); for(int i=0, j=arraymessage.length; i<j; i++) { arraymessage[i].writeTo(System.out); } folder.close(false); store.close(); } }

第一件我们需要知道的事情是，通用电子邮件库实际上是包裹在JavaMail外层的API，所以无论我们选择哪种API，我们都需要JavaMail库。

您可能还需要JavaBeans激活框架（JavaBeans Activation Framework (JAF)），该框架将负责处理关于邮件选项的更复杂的内容。

最后一个在“购物列表”上的就是通用电子邮件库（Commons Email），您需要从JAF中将JavaMail库中的mail.jar、JAF中的activation.jar和通用电子邮件库中的commons-email-1.0.jar添加到classpath的设置中。

我们现在已经拥有了支持部件的工具包，让我们从使用JavaMail发送简单的电子邮件开始讲解，我们将提出所有的设置放到一个单独的静态类MailSettings当中，这样做将在比较代码的时候容易些。

在发送电子邮件之前，您还需要知道SMTP服务器的主机名，SMTP服务器是负责将您的邮件发送到外部世界去的机器。

JavaMail使用了Session类的概念来保存诸如SMTP主机和认证的信息，主要想法是基于会话（Sessions）在Java虚拟机中可以被隔离，这可以阻止恶意代码窃取其他用户在其他会话中的信息，这些信息可能包括用户名和密码等认证信息。

“但是”，您可能会说，“在同一时间，我只在Java 虚拟机上运行一个应用程序，而且我相信我的代码。

”JavaMa il的目的是开发大型的邮件系统，它有一个具有复杂性的关联层，您可以绕过没有经验的用户，我们用以下的例子来说明：Properties props=new Properties();props.put("mail.sm tp.host",MailSettings.sm tpHost);Session session=Session.get DefaultInstance(props,null);此处，并没有创建新的会话，您只是从会话工厂（session factory）中得到并通过Pr operties的实例来进行设置，我们只对SMTP主机进行了设置和传送，在得到默认的实例的同时创建了一个共享的会话，现在我们可以使用这个会话来创建邮件消息了。

Java类库中是带有javamail的！所有不需要再下载。

1）运行例子时会出现：Exception in thread "main" ng.NoClassDefFoundError: com/sun/mail/util/LineOutputStream这样的错误，原因是版本不兼容，后来我没有用java ee 5.0而是用j2ee1.4.自己导入mail.jar包就没有出现错误。

2）运行完书本的例子（文本，包含有图片，附件。

另外图片是分为两种，一是引用外部资源，二是嵌入内部）。

对其有个大概的了解。

下面给个完整的例子，包含有图片和附件的。

public class ComplexMessage {/***@param args*@throws MessagingException*@throws AddressException*@throws IOException*@throws FileNotFoundException*/public static void main(String[] args) throws AddressException,MessagingException, FileNotFoundException, IOException{// TODO Auto-generated method stubSession session = Session.getDefaultInstance(new Properties()); // 设置发送邮件的客户端服务器端环境MimeMessage message=createMessage( session);message.writeTo(new FileOutputStream("d:\\test3.eml"));}public static MimeMessage createMessage(Session session) throws AddressException, MessagingException{String from = "4054702459047@";String to = "4074505429047@";String subject = "test";String data = "<FONT face=宋体color=#0909f7 size=7><SPAN style='ACKGROUND-COLOR: #6911ee'><SPAN style='BACKGROUND-COLOR: #000000'><SPAN style='BACKGROUND-COLOR: #000000'><SPAN style='BACKGROUND-COLOR: #ffffff'><EM>华南理工大学</EM> </SPAN></SPAN></SPAN></SPAN></FONT>"+"<img src='cid:test1.jpg'>";Message message = new MimeMessage(session);// 创建MimeMessage实例对象message.setFrom(new InternetAddress(from));message.setRecipient(Message.RecipientType.TO, new InternetAddress(to));message.setSentDate(new Date());message.setSubject(subject);MimeBodyPart contentPart=createContent(data,"d:\\test.jpg");MimeBodyPart attachPart1=createAttachment("d:\\xml.xml");MimeBodyPart attachPart2=createAttachment("d:\\report13.jasper");MimeMultipart multipart=new MimeMultipart("mixed");multipart.addBodyPart(contentPart);multipart.addBodyPart(attachPart1);multipart.addBodyPart(attachPart2);//这里MimeMessage是由MIME对象的消息头和MimeMultipart组成，而MimeMultipart可由//MimeBodyPart 组成。