a_cmsnotification.java

一个cms内容管理平台

/*
 * File   : $Source: /usr/local/cvs/opencms/src/org/opencms/notification/A_CmsNotification.java,v $
 * Date   : $Date: 2006/11/29 16:31:26 $
 * Version: $Revision: 1.3 $
 *
 * This library is part of OpenCms -
 * the Open Source Content Mananagement System
 *
 * Copyright (C) 2005 Alkacon Software GmbH (http://www.alkacon.com)
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2.1 of the License, or (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
 * Lesser General Public License for more details.
 *
 * For further information about Alkacon Software GmbH, please see the
 * company website: http://www.alkacon.com
 *
 * For further information about OpenCms, please see the
 * project website: http://www.opencms.org
 * 
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 */

package org.opencms.notification;

import org.opencms.db.CmsUserSettings;
import org.opencms.file.CmsObject;
import org.opencms.file.CmsUser;
import org.opencms.mail.CmsHtmlMail;
import org.opencms.main.CmsException;
import org.opencms.main.CmsLog;
import org.opencms.main.OpenCms;
import org.opencms.util.CmsMacroResolver;
import org.opencms.util.CmsStringUtil;
import org.opencms.xml.content.CmsXmlContent;
import org.opencms.xml.content.CmsXmlContentFactory;

import java.util.List;
import java.util.Locale;

import javax.mail.MessagingException;

import org.apache.commons.logging.Log;

/**
 * Abstract class to create a notfication which will be send as a html mail to
 * a user in OpenCms.
 * 
 * @author Peter Bonrad
 * 
 * @version $Revision: 1.3 $ 
 * 
 * @since 6.5.3
 */
public abstract class A_CmsNotification extends CmsHtmlMail {

    /** The log object for this class. */
    private static final Log LOG = CmsLog.getLog(A_CmsNotification.class);

    /** The CmsObject. */
    private CmsObject m_cms;

    /** The locale of the reciever of the content notification. */
    private Locale m_locale;

    /** The macro resolver used. */
    private CmsMacroResolver m_macroResolver;

    /** The xml-content to read subject, header and footer of the notification. */
    private CmsXmlContent m_mailContent;

    /** The receiver of the notification. */
    private CmsUser m_receiver;

    /**
     * Creates a new A_CmsNotification.<p>
     * 
     * @param cms the cms object to use
     * @param receiver the cms user who should receive the message
     */
    public A_CmsNotification(CmsObject cms, CmsUser receiver) {

        m_cms = cms;
        m_receiver = receiver;

        m_macroResolver = new CmsMacroResolver();
    }

    /**
     * Adds a new macro to the used macro resolver. Macros are used for the xml
     * content file.
     * 
     * @param key The key of the macro.
     * @param value The value of the macro. 
     */
    public void addMacro(String key, String value) {

        m_macroResolver.addMacro(key, value);
    }

    /**
     * Returns the CmsObject.<p>
     *
     * @return the CmsObject
     */
    public CmsObject getCmsObject() {

        return m_cms;
    }

    /**
     * Returns the locale.<p>
     *
     * @return the locale
     */
    public Locale getLocale() {

        return m_locale;
    }

    /**
     * Returns the receiver.<p>
     *
     * @return the receiver
     */
    public CmsUser getReceiver() {

        return m_receiver;
    }

    /**
     * @see org.opencms.mail.CmsSimpleMail#send()
     */
    public void send() throws MessagingException {

        try {
            // check if user is valid and has a mail address specified
            if (CmsStringUtil.isEmpty(m_receiver.getEmail())) {
                LOG.error(Messages.get().getBundle().key(Messages.LOG_NOTIFICATION_NO_ADDRESS_1, m_receiver.getName()));
                return;
            }

            if (LOG.isInfoEnabled()) {
                LOG.info(Messages.get().getBundle().key(Messages.LOG_NOTIFICATION_SEND_1, m_receiver.getEmail()));
            }

            // read resource with subject, header and footer
            m_mailContent = CmsXmlContentFactory.unmarshal(m_cms, m_cms.readFile(getNotificationContent()));

            // detect locale
            List locales = m_mailContent.getLocales();
            Locale userLocale = new CmsUserSettings(m_receiver).getLocale();
            if (locales.contains(userLocale)) {
                // mail is localized in the user locale, use that
                m_locale = userLocale;
            } else if (locales.contains(OpenCms.getWorkplaceManager().getDefaultLocale())) {
                // mail is localized in the system default locale, use that
                m_locale = OpenCms.getWorkplaceManager().getDefaultLocale();
            } else {
                // use any localization
                m_locale = (Locale)locales.get(0);
            }

            // define macro resolver
            m_macroResolver.addMacro("firstname", m_receiver.getFirstname());
            m_macroResolver.addMacro("lastname", m_receiver.getLastname());
            m_macroResolver.addMacro("project", m_cms.getRequestContext().currentProject().getName());

            StringBuffer msg = new StringBuffer();

            // append html header
            appendHtmlHeader(msg);

            // append header from xmlcontent
            msg.append(CmsMacroResolver.resolveMacros(
                m_mailContent.getStringValue(m_cms, "Header", m_locale),
                m_macroResolver));

            // append body
            msg.append("\n<br/><br/>\n");
            msg.append(generateHtmlMsg());
            msg.append("\n<br/><br/>\n");

            // append footer from xmlcontent
            msg.append(CmsMacroResolver.resolveMacros(
                m_mailContent.getStringValue(m_cms, "Footer", m_locale),
                m_macroResolver));

            // append html footer
            appenHtmlFooter(msg);

            addTo(m_receiver.getEmail(), m_receiver.getFirstname() + ' ' + m_receiver.getLastname());
            setSubject(CmsMacroResolver.resolveMacros(
                m_mailContent.getStringValue(m_cms, "Subject", m_locale),
                m_macroResolver));
            setHtmlMsg(msg.toString());

            // send mail
            super.send();
        } catch (CmsException e) {
            LOG.error(Messages.get().getBundle().key(Messages.LOG_NOTIFICATION_SEND_ERROR_0), e);
        }
    }

    /**
     * Append the html-code to start a html mail message to the given buffer.<p>
     * 
     * @param buffer The StringBuffer to add the html code to.
     */
    protected void appendHtmlHeader(StringBuffer buffer) {

        buffer.append("<html><head><style type=\"text/css\">\n");
        buffer.append("<!--\n");
        buffer.append("body { font-family: Verdana, Arial, Helvetica, sans-serif; background-color:#ffefdb; }\n");
        buffer.append("a { color:#b22222; text-decoration:none; }\n");
        buffer.append("table { white-space: nowrap; font-size: x-small; }\n");
        buffer.append("tr.trow1 { background-color: #cdc0b0; }\n");
        buffer.append("tr.trow2 { background-color: #eedfcc; }\n");
        buffer.append("tr.trow3 { background-color: #ffefdb; }\n");
        buffer.append("--></style>\n");
        buffer.append("</head><body><span style='font-size:8.0pt;'>");
    }

    /**
     * Append the html-code to finish a html mail message to the given buffer.
     * 
     * @param buffer The StringBuffer to add the html code to. 
     */
    protected void appenHtmlFooter(StringBuffer buffer) {

        buffer.append("</span></body></html>");
    }

    /**
     * Overwrite the method to generate the message body of the notification. This
     * text is placed between the header and the footer of the defined xmlcontent
     * and the required html code is added.<p>
     * 
     * @return The text to be inserted in the notification.
     */
    protected abstract String generateHtmlMsg();

    /**
     * Overwrite the method to return the path to the xmlcontent, where the subject,
     * the header and the footer are defined.<p>
     * 
     * @return The path to the xmlcontent file.
     */
    protected abstract String getNotificationContent();
}