什么是Exchange
Exchange Server是微软公司的一套电子邮件服务组件。它支持多种电子邮件网络协议，如：SMTP、POP3、IMAP4。Exchange Server是个消息与协作系统，可以被用来架构应用于企业、学校的邮件系统甚至于免费邮件系统，也可以用于开发工作流。
Exchange特别之处
传统的电子邮箱，像QQ邮箱、163邮箱，用的都是SMTP协议来发送邮件，POP3/IMAP来收取邮件，这些协议都是早期公开的邮件通信协议，至今都被广泛地使用，网上有很多方案和技术文档。
而Exchange邮箱使用的是微软自己定制的Exchange ActiveSync协议，这套协议兼容SMTP、POP3、IMAP4等多种电子邮件协议，因此能够与其他邮箱进行邮件通信，但这套协议是微软所定制的，所以不能像其他邮箱那样调用SMTP来直接发送邮件，必须调用微软所给出的接口，微软基于Java给出了一套单独的接口。
添加jar包
<dependency>
<groupId>com.microsoft.ews-java-api</groupId>
<artifactId>ews-java-api</artifactId>
<version>2.0</version>
</dependency>
代码实现
import java.net.URI;
import java.net.URISyntaxException;
import java.util.ArrayList;
import microsoft.exchange.webservices.data.core.ExchangeService;
import microsoft.exchange.webservices.data.core.enumeration.misc.ExchangeVersion;
import microsoft.exchange.webservices.data.core.enumeration.property.BodyType;
import microsoft.exchange.webservices.data.core.enumeration.property.WellKnownFolderName;
import microsoft.exchange.webservices.data.core.service.folder.Folder;
import microsoft.exchange.webservices.data.core.service.item.EmailMessage;
import microsoft.exchange.webservices.data.core.service.item.Item;
import microsoft.exchange.webservices.data.credential.ExchangeCredentials;
import microsoft.exchange.webservices.data.credential.WebCredentials;
import microsoft.exchange.webservices.data.property.complex.MessageBody;
import microsoft.exchange.webservices.data.search.FindItemsResults;
import microsoft.exchange.webservices.data.search.ItemView;
/**
*
* microsoft发送邮件工具类
* @author shi
* @date 2019/10/30
*
**/
public class ExchangeMailUtil {
//邮件服务器地址
private String mailServer;
//用户名
private String user;
//密码
private String password;
//使用的方式，默认可用不填
private String domain;
/**
* 构造方法
*/
public ExchangeMailUtil(String mailServer, String user, String password) {
this.mailServer = mailServer;
this.user = user;
this.password = password;
}
/**
* 构造方法
*/
public ExchangeMailUtil(String mailServer, String user, String password, String domain) {
this.mailServer = mailServer;
this.user = user;
this.password = password;
this.domain = domain;
}
/**
* 创建邮件服务
*
* @return 邮件服务
*/
private ExchangeService getExchangeService() {
ExchangeService service = new ExchangeService(ExchangeVersion.Exchange2007_SP1);
//用户认证信息
ExchangeCredentials credentials;
if (domain == null) {
credentials = new WebCredentials(user, password);
} else {
credentials = new WebCredentials(user, password, domain);
}
service.setCredentials(credentials);
try {
service.setUrl(new URI(mailServer));
} catch (URISyntaxException e) {
e.printStackTrace();
}
return service;
}
/**
* 收取邮件
*
* @param max 最大收取邮件数
* @throws Exception
*/
public ArrayList<EmailMessage> receive(int max) throws Exception {
ExchangeService service = new ExchangeService(ExchangeVersion.Exchange2007_SP1);
ExchangeCredentials credentials = new WebCredentials(user, password);
service.setCredentials(credentials);
service.setUrl(new URI(mailServer));
//绑定收件箱,同样可以绑定发件箱
Folder inbox = Folder.bind(service, WellKnownFolderName.Inbox);
//获取文件总数量
int count = inbox.getTotalCount();
if (max > 0) {
count = count > max ? max : count;
}
//循环获取邮箱邮件
ItemView view = new ItemView(count);
FindItemsResults<Item> findResults = service.findItems(inbox.getId(), view);
ArrayList<EmailMessage> result = new ArrayList<>();
for (Item item : findResults.getItems()) {
EmailMessage message = EmailMessage.bind(service, item.getId());
result.add(message);
}
return result;
}
/**
* 收取所有邮件
* @throws Exception
*/
public ArrayList<EmailMessage> receive() throws Exception {
return receive(0);
}
/**
* 发送带附件的mail
* @param subject 邮件标题
* @param to 收件人列表
* @param cc 抄送人列表
* @param bodyText 邮件内容
* @param attachmentPaths 附件地址列表
* @throws Exception
*/
public void send(String subject, String[] to, String[] cc, String bodyText, String[] attachmentPaths)throws Exception {
ExchangeService service = getExchangeService();
EmailMessage msg = new EmailMessage(service);
msg.setSubject(subject);
MessageBody body = MessageBody.getMessageBodyFromText(bodyText);
body.setBodyType(BodyType.HTML);
msg.setBody(body);
for (String toPerson : to) {
msg.getToRecipients().add(toPerson);
}
if (cc != null) {
for (String ccPerson : cc) {
msg.getCcRecipients().add(ccPerson);
}
}
if (attachmentPaths != null) {
for (String attachmentPath : attachmentPaths) {
msg.getAttachments().addFileAttachment(attachmentPath);
}
}
msg.send();
}
/**
* 发送不带抄送人的邮件
* @param subject 标题
* @param to 收件人列表
* @param bodyText 邮件内容
* @throws Exception
*/
public void send(String subject,String[] to,String bodyText) throws Exception {
send(subject, to, null, bodyText);
}
/**
* 发送不带附件的mail
* @param subject 邮件标题
* @param to 收件人列表
* @param cc 抄送人列表
* @param bodyText 邮件内容
* @throws Exception
*/
public void send(String subject, String[] to, String[] cc, String bodyText) throws Exception {
send(subject, to, cc, bodyText, null);
}
}
测试方法
/**
* 发送邮件主方法
* @throws Exception
*/
public static void main(String[] args) throws Exception {
// Outlook Web Access路径通常为/EWS/exchange.asmx
ExchangeMailUtil mailUtil = new ExchangeMailUtil("https://mail.xxxxxxxx.com/ews/exchange.asmx", "username",
"123456");
//接收人
String[] to = mailUtil.removeArrayEmpty(new String[]{"xxxxxxx@shinho.net.cn"});
//抄送人
String[] cc = mailUtil.removeArrayEmpty(new String[]{"xxxxxxx@shinho.net.cn"});
// 发送邮件
mailUtil.send("Subject", to, cc, "content");
}
附：官方文档地址
https://github.com/OfficeDev/ews-java-api/wiki/Getting-Started-Guide
