77. Lotus Notes中编程发送邮件（三）之XPages中用Java发送邮件

落日映苍穹つ 2022-09-20 08:43 268阅读 0赞

在[46. LotusNotes中编程发送邮件（一）][46. LotusNotes]和[47.Lotus Notes中编程发送邮件（二）][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());
            }
        }
    
    }

[46. LotusNotes]: http://blog.csdn.net/starrow/article/details/9968087
[47.Lotus Notes]: http://blog.csdn.net/starrow/article/details/10029385