org.opencms.notification.A_CmsNotification Maven / Gradle / Ivy
Show all versions of opencms-test Show documentation
/*
* This library is part of OpenCms -
* the Open Source Content Management System
*
* Copyright (c) Alkacon Software GmbH & Co. KG (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 & Co. KG, 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.i18n.CmsMessages;
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;
import org.apache.commons.mail.EmailException;
/**
* Abstract class to create a notfication which will be send as a html mail to
* a user in OpenCms.
*
* @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 xml-content to read subject, header and footer of the notification. */
protected CmsXmlContent m_mailContent;
/** The CmsObject. */
private CmsObject m_cms;
/** The locale of the receiver of the content notification. */
private Locale m_locale;
/** The macro resolver used. */
private CmsMacroResolver m_macroResolver;
/** The receiver of the notification. */
private CmsUser m_receiver;
/**
* Creates a new A_CmsNotification.
*
* @param cms the cms object to use
* @param receiver the receiver of the notification
*/
public A_CmsNotification(CmsObject cms, CmsUser receiver) {
m_cms = cms;
m_receiver = receiver;
m_macroResolver = new CmsMacroResolver();
m_macroResolver.setCmsObject(cms);
}
/**
* 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.
*
* @return the CmsObject
*/
public CmsObject getCmsObject() {
return m_cms;
}
/**
* Returns the locale.
*
* @return the locale
*/
public Locale getLocale() {
return m_locale;
}
/**
* Returns the receiver.
*
* @return the receiver
*/
public CmsUser getReceiver() {
return m_receiver;
}
/**
* @see org.apache.commons.mail.Email#send()
*/
@Override
public String send() throws EmailException {
String messageID = null;
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 null;
}
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 = locales.get(0);
}
String mailCharset = Messages.get().getBundle(m_locale).key(Messages.GUI_MAIL_CHARSET_0);
if (!CmsMessages.isUnknownKey(mailCharset)) {
setCharset(mailCharset);
}
// define macro resolver
m_macroResolver.addMacro("firstname", m_receiver.getFirstname());
m_macroResolver.addMacro("lastname", m_receiver.getLastname());
m_macroResolver.addMacro("project", m_cms.getRequestContext().getCurrentProject().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
\n");
msg.append(generateHtmlMsg());
msg.append("\n
\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();
// get MIME message ID
messageID = getMimeMessage().getMessageID();
} catch (CmsException e) {
LOG.error(Messages.get().getBundle().key(Messages.LOG_NOTIFICATION_SEND_ERROR_0), e);
} catch (MessagingException e) {
LOG.error(Messages.get().getBundle().key(Messages.LOG_NOTIFICATION_SEND_ERROR_0), e);
}
return messageID;
}
/**
* Append the html-code to start a html mail message to the given buffer.
*
* @param buffer The StringBuffer to add the html code to.
*/
protected void appendHtmlHeader(StringBuffer buffer) {
buffer.append("\r\n");
buffer.append("
\r\n");
buffer.append(" \r\n");
buffer.append(" \r\n");
buffer.append(" \r\n");
}
/**
* 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(" \r\n" + "");
}
/**
* 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.
*
* @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.
*
* @return The path to the xmlcontent file.
*/
protected abstract String getNotificationContent();
}