什么是SMTP
SMTP 是Simple Mail Transfer Protocol (SMTP)的简称，由 RFC 821 定义。它是一个用来发送电子邮件的协议，互联网上绝大部分的邮件系统都使用SMTP作为邮件传输机制。
怎样使用Java Mail API来发送邮件
依赖
首先，添加Java Mail依赖：
<dependency>
<groupId>javax.mail</groupId>
<artifactId>mail</artifactId>
<version>1.4.7</version>
</dependency>
设置
当我们使用某些邮件客户端，例如Outlook，作为代理来接收邮件时，需要提供以下信息：
- 协议 : SMTP 用于发送； POP3 或 IMAP 用于接收
- 主机 : 用于发送和接收邮件的服务器主机地址
- 端口 : 服务器主机上对应于上述协议的邮件收发端口
- 用户名: 用于访问以上邮件服务器的用户名
- 密码 : 用于访问以上邮件服务器的、对应于用户名的密码
同样的，当使用Java mail API去实现自己的邮件收送端时，也需要以上的信息，例如:
Properties properties = System.getProperties();
properties.setProperty("mail.smtp.host", "smtp.sohu.com"); //provide host, default is localhost
properties.setProperty("mail.smtp.port", "25"); //provide port, default is 25
properties.setProperty("mail.smtp.auth", "true"); //indicate authentication is required or not, it's required by most of servers 这些信息也可以存在一个Properties文件里，然后读取这个文件来获取山配置：
mail.smtp.host=smtp.sohu.com mail.smtp.port=25 mail.smtp.auth=true ...
然后加载：
FileInputStream is = new FileInputStream("mail.properties");
properties.load(is);
is.close();
Session（会话）
接下来，就需要创建一个 Session， 一个邮件 Session 管理着配置选项和用来连接服务器以进行交互的用户认证信息，以下代码用来创建一个Session:
Session session = Session.getDefaultInstance(properties, new Authenticator() {
@Override
protected PasswordAuthentication getPasswordAuthentication() {
return new PasswordAuthentication(properties.getProperty("username"), properties.getProperty("password"));
}
});
需要提供用户名、密码和其他的一些配置信息（Setting一节中介绍了）来创建一个Session。
发送文本
有了Session以后，就可以准备发送邮件了。在Java mail API里，每个邮件都由一个 javax.mail.Message 对象表示，然而 javax.mail.Message 是一个抽象类，因此需要转向它的一个具体实现，通常使用 javax.mail.internet.MimeMessage，下面代码展示了一个最简单的、用于发送文本邮件的方式：
MimeMessage message = new MimeMessage(session);
message.setText("Hello Java Mail Body");
message.setSubject("Hello Java Mail");
message.setFrom(new InternetAddress(properties.getProperty("from")));
message.addRecipient(RecipientType.TO, new InternetAddress(properties.getProperty("to")));
message.saveChanges();
Transport.send(message);
这里多了一个From和To用来表示邮件的发送者和接收者，以上示例中，这两个值也来自properties文件。
Content-Type（内容类型）
当使用setText()方法设置邮件内容里，默认的Content-Type类型是 text/plain 。当发送邮件时，也可以指定期望的 Content-Type 值，方法之一就是使用 setDataHandler() 而不是 setText() 去设置邮件内容:
DataHandler dh = new DataHandler("<p style='color:red'>Html Mail Content</p>", "text/html");
message.setDataHandler(dh);
以上内容在邮件中展示后，类似于:
Html Mail Content
而如果把 Content-Type 从 "text/html" 变成 "text/plain"，则结果大不一样了:
<p style='color:red'>Html Mail Content</p>
Multipart（复杂类型）
以上例子是一个简单，消息只包含单一类型的邮件内容，这个内容包装在一个 DataHandler 实例里（实际上，私底下所有的邮件内容都包装在一个 DataHandler 实例中，不管是通过 setText() 还是 setContent() 方法），以下是简单消息的一个结构图：
除了以上简单消息结构，消息也可以包含复杂类型的结构，这种情况下 DataHandler 对象包含的就是一个multipart 对象，而不是仅仅是一个单一的内容块。一个multipart 对象是一个 BodyPart 对象的容器，一个 BodyPart 对象的结构有点类似于 以上简单消息对象的结构，因为他们两都实现了 Part 接口。每一个 BodyPart 对象都包含了属性（ attributes）和内容（content），但是 Bodypart 对象的属性只限定于定义在 Part 接口中的那些。一个重要的属性就是 content-type 。一个 BodyPart 对象的内容又是一个DataHandler 对象，它可以包含数据或者另一个 Multipart 对象，因此它是一个递归的结构：
下面是一个 multipart 的代码示例：
MimeMultipart mmp = new MimeMultipart();
// create textual content, and add it to the bodypart object
MimeBodyPart body1 = new MimeBodyPart();
body1.setContent("<h1>Mail HTML Body Content</h1>", "text/html");
mmp.addBodyPart(body1);
// Create a second body part object, set text to it, This
// second object holds xml data.
MimeBodyPart body2 = new MimeBodyPart();
body2.setContent("<a>Mail XML Content</a>", "application/xml");
mmp.addBodyPart(body2);
message.setContent(mmp);
第一个body对象会作为邮件内容，以HTML格式呈现，第二部分内容会作一个XML格式的附件发送，附件名不定。
附件
以上介绍了一个发送附件的变通方法，但不是通常的选择。这一节里将介绍怎么用Java Mail API发送含有一个或多个附件的邮件，将以上示例中的 body2 内容作为一个实际的附件，而是上示的奇怪的方式。
首先将内容存成一个xml文件，假设文件名为： 'attach.xml'，然后用以下代码添加为附件发送：
...
MimeBodyPart body2 = new MimeBodyPart();
//old one
// body2.setContent("<a>Mail XML Content</a>", "application/xml");
//new one
FileDataSource attachment = new FileDataSource("attach.xml");
DataHandler dh = new DataHandler(attachment);
body2.setDataHandler(dh);
body2.setFileName("attach.xml");
mmp.addBodyPart(body2);
...
然后接收端就可以收到一个命令文件名为 'attach.xml' 的附件的邮件了。
更多...
如果连接要求 SSL 配置，则更多的设置选项需要被指定，例如 GMail的连接：
Properties props = System.getProperties();
props.setProperty("mail.smtp.host", "smtp.gmail.com");
props.setProperty("mail.smtp.port", "465");
props.setProperty("mail.smtp.auth", "true");
//more configurations
props.setProperty("mail.smtp.socketFactory.class", "javax.net.ssl.SSLSocketFactory");
props.setProperty("mail.smtp.socketFactory.fallback", "false");
props.setProperty("mail.smtp.socketFactory.port", "465");
怎样使用camel-mail组件
依赖
添加以下依赖：
<dependency>
<groupId>org.apache.camel</groupId>
<artifactId>camel-mail</artifactId>
<version>2.12.2</version>
</dependency>
URI 格式
smtp://[username@]host[:port][?options]
或者是带安全的连接：
smtps://[username@]host[:port][?options]
缺省 Ports
|
|
|
|
|
|
|
|
|
选项
下面是一些基础选项，更多的可以看 http://camel.apache.org/mail.html ：
|
| Default | Description |
|
|
| The host name or IP address to connect to. |
|
| See DefaultPorts | The TCP port number to connect on. |
|
|
| The user name on the email server. |
|
|
| The password on the email server. |
|
|
| The mail message content type. Use |
|
|
| The TO recipients (the receivers of the mail). Separate multiple email addresses with a comma. |
|
|
| As of Camel 2.8.4, 2.9.1+, the Reply-To recipients (the receivers of the response mail). Separate multiple email addresses with a comma. |
|
|
| The CC recipients (the receivers of the mail). Separate multiple email addresses with a comma. |
|
|
| The BCC recipients (the receivers of the mail). Separate multiple email addresses with a comma. |
|
|
| The FROM email address. |
|
|
| As of Camel 2.3, the Subject of the message being sent. Note: Setting the subject in the header takes precedence over this option. |
|
|
| The connection timeout in milliseconds. Default is 30 seconds. |
根据介绍，基本可以理解这些选项的意义和用法。
示例
下面是一些用camel-mail组件展示如何发送邮件的例子。
发送文本
from("timer:foo?repeatCount=1")
.setBody(constant("MailBody")) //set mail body
.to(
"smtp:" //protocol, required
+ "//"
+ "host" //host, required, change as your case
+ ":"
+ "port" //port, has default value, change as your case
+ "?"
+ "from=from" //from, default is camel@localhost, change as your case
+ "&"
+ "username=from" //username, required ， change as your case
+ "&"
+ "password=password" //password, required , change as your case
+ "&"
+ "subject=MailSubject" //mail subject
+ "&"
+ "to=to" //to, required, change as your case
);
邮件的内容来自camel route的exchange的body。
Content-Type
默认的 Content-Type 为 text/plain，因此接收到文件内容就是纯文本的，没有任何修饰的，例如<b>MailBody</b>,如果想把它变成一个 HTML 格式的，则需要指定 Content-Type 为 text/html，例如：
from("timer:foo?repeatCount=1")
.setBody(constant("<b>MailBody</b>"))//set body
.to(
"smtp:" //protocol, required
+ "//"
+ "host" //host, required, change as your case
+ ":"
+ "port" //port, has default value, change as your case
+ "?"
+ "from=from" //from, default is camel@localhost, change as your case
+ "&"
+ "username=username" //username, required , change as your case
+ "&"
+ "password=password" //password, required , change as your case
+ "&"
+ "subject=MailSubject" //mail subject
+ "&"
+ "to=to" //to, required, change as your case
+ "&"
+ "contentType=text/html" //specify content-type
);
现在邮件内容会以HTML格式呈现：MailBody
附件
按我的了解，好像没有简单的选项可以指定附件，方法之一就是使用Bean或者是Processor去指定附件，例如：
from("timer:foo?repeatCount=1").process(new Processor() {
public void process(Exchange exchange) throws Exception {
exchange.getIn().setBody(constant("<h1>Mail HTML Body Content</h1>"));//set Body
exchange.getIn().addAttachment("attach.xml", new DataHandler(new FileDataSource("attach.xml"))); //Add attachment
}
}).to("smtp://...");
扫一扫
1万+
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
