本文主要是介绍77. Lotus Notes中编程发送邮件（三）之XPages中用Java发送邮件，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！
在46. LotusNotes中编程发送邮件（一）和47.Lotus Notes中编程发送邮件（二）里笔者介绍了在Lotus Notes发送邮件的几种简单场景和需求，并给出了以LotusScript编写的通用代码。本文介绍可在XPages开发时使用的一个用于发送邮件的Java类，具备LotusScript代码的所有功能，且有更友好方便的API。
这个类具备如下功能：
- 发送Notes邮件。
- 发送HTML邮件。
- 设置抄送和盲送。
- 设置显示的发件人（发送HTML邮件时无效）。
- 设置回邮件的地址。
具有以下特点：
- 使用简单，方便。对最普通的发送邮件的情况只需两行代码。可根据情况灵活设置抄送、盲送、显示的发件人和回邮件的地址等多个属性。每个设置属性的方法都返回该邮件类的当前实例，使得可以进行简洁的链式调用。
- 参数灵活。按照Notes邮件文档对应各收件人的文本域可接受的数据类型，设定各收件人时，既可使用单个的字符串，也可用代表多人的Vector<String>。
- 使用安全。对设定的各收件人都进行了参数校验，确保可以被邮件文档的文本域接受。
我们先来看使用这个邮件类的示例，代码是一个被XPage调用的managed bean的方法：
public void testMail(){String sendTo="admin";String body="hello";try {//一封简单的Notes邮件，和下面的各种邮件一道，收件人使用的都是Notes用户名作地址。Mail mail=new Mail(sendTo, "A simple Notes mail", body);mail.send();//一封有各种收件人的简单的Notes邮件mail=new Mail(sendTo, "User1", "User2", "A Notes mail with all types of receivers", body);mail.send();//一封设置了抄送和回邮件的地址的Notes邮件mail=new Mail(sendTo, "A Notes mail with some receivers and replyTo set using Mail's methods", body);mail.setCopyTo("User1").setReplyTo("ServiceDesk").send();//一封设置了显示的发件人的HTML邮件mail=new Mail(sendTo, "A HTML mail", "<h1>Hello</h1>");mail.setPrincipal("ServiceDesk").send();} catch (Exception e) {XSPUtil.feedback(e.getMessage());}}下面是这个邮件类的代码，如果要在普通的Java代理里使用，只需改写Session对象的来源。
package starrow.xsp;import java.util.Vector;import starrow.AppException;import lotus.domino.Database;
import lotus.domino.Directory;
import lotus.domino.Document;
import lotus.domino.MIMEEntity;
import lotus.domino.NotesException;
import lotus.domino.RichTextItem;
import lotus.domino.Session;
import lotus.domino.Stream;@SuppressWarnings("unchecked")
public class Mail {private Session session;private Database db;private Document memo;private String domain=""; //Notes domainprivate Object sendTo;private String subject="";private String body="";private Document docLink=null;private Object copyTo="";private Object blindCopyTo="";private String replyTo="";private String principal="";/*** Only set the fields. Put all the Notes related actions in the buildMail method to avoid NotesException in constructs.* @param sendTo provide String or Vector<String> value to set the Notes text item. * @param copyTo provide String or Vector<String> value to set the Notes text item.* @param blindCopyTo provide String or Vector<String> value to set the Notes text item.* @param subject String value* @param body can be HTML in case of sending HTML mails.* @throws NotesException*/public Mail(Object sendTo, Object copyTo, Object blindCopyTo, String subject, String body){this.setSendTo(sendTo);this.setCopyTo(copyTo);this.setBlindCopyTo(blindCopyTo);this.subject=subject;this.body=body;}public Mail(Object sendTo, String subject, String body){this(sendTo, "", "", subject, body);}/*** Check and set the sendTo field.* @param sendTo String or Vector of Strings* @return the current instance for the convenience of method chaining.*/private Mail setSendTo(Object sendTo){if (!Mail.isTextValues(sendTo)){throw new IllegalArgumentException("sendTo should be a String or Vector<String>.");}this.sendTo=sendTo;return this;}/*** Check and set the copyTo field.* @param copyTo String or Vector of Strings* @return the current instance for the convenience of method chaining.*/public Mail setCopyTo(Object copyTo){if (!Mail.isTextValues(copyTo)){throw new IllegalArgumentException("copyTo should be a String or Vector<String>.");}this.copyTo=copyTo;return this;}/*** Check and set the blindCopyTo field.* @param blindCopyTo String or Vector of Strings* @return the current instance for the convenience of method chaining.*/ public Mail setBlindCopyTo(Object blindCopyTo){if (!Mail.isTextValues(blindCopyTo)){throw new IllegalArgumentException("blindCopyTo should be a String or Vector<String>.");}this.blindCopyTo=blindCopyTo;return this; }public Mail setReplyTo(String replyTo){this.replyTo=replyTo;return this;}public Mail setPrincipal(String principal){this.principal=principal;return this;}public Mail setDocLink(Document doc){this.docLink=doc;return this;}private void buildMail() throws NotesException{session = XSPUtil.getSession();db = session.getCurrentDatabase();memo = db.createDocument();memo.replaceItemValue("Form", "memo");memo.replaceItemValue("SendTo",sendTo);memo.replaceItemValue("CopyTo", copyTo);memo.replaceItemValue("BlindCopyTo", blindCopyTo);memo.replaceItemValue("Subject",subject);// Principal overrides From// Must be formatted as below and must include the Domino domain//memo.Principal = |"Customer Service" <starrow@mail.com@DominoDomain>|if ( ! this.replyTo.equals("")) {this.getDomain();memo.replaceItemValue("ReplyTo", this.replyTo + "@" + this.domain);}if ( ! this.principal.equals("")) {this.getDomain();memo.replaceItemValue("Principal" ,this.principal + "@" + this.domain);}}public static boolean isTextValues(Object value){//Notes text items accept values of String or Vector<String>//But cannot perform instanceof check against parameterized type Vector<String>. //Use instead its raw form Vector since generic type information will be erased at runtime.if (value instanceof String){return true;}if (value instanceof Vector){Vector list=(Vector)value;if (list.get(0) instanceof String){return true;}}return false; }private void getDomain() throws NotesException {if ( ! this.domain.equals("")) {return;}Directory nd = session.getDirectory(session.getServerName());Vector info = nd.getMailInfo(session.getEffectiveUserName());this.domain=(String) info.get(5);}/*public void copyItem(Item item, String itemName) throws NotesException {memo.copyItem(item, itemName);}*/public void send() throws AppException{try{this.buildMail();RichTextItem bodyItem=memo.createRichTextItem("Body");bodyItem.appendText(body);if (docLink != null) {bodyItem.appendDocLink(docLink,"click the link");}memo.send();}catch(Exception e){throw new AppException(e.getMessage());}}/*** Setting principal has no effect on a HTML mail.* @throws AppException*/public void sendHTMLMail() throws AppException {try {this.buildMail();session.setConvertMIME(false);Stream stream = session.createStream();stream.writeText(body);MIMEEntity entity = memo.createMIMEEntity("Body");entity.setContentFromText(stream,"text/html;charset=UTF-8", 1725);stream.close();memo.send(false);session.setConvertMIME(true);} catch (Exception e) {throw new AppException(e.getMessage());}}}
这篇关于77. Lotus Notes中编程发送邮件（三）之XPages中用Java发送邮件的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！
