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 domain
    private 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());
        }
    }

}