/*
 * Licensed to the Apache Software Foundation (ASF) under one or more
 * contributor license agreements. See the NOTICE file distributed with
 * this work for additional information regarding copyright ownership.
 * The ASF licenses this file to You under the Apache license, Version 2.0
 * (the "License"); you may not use this file except in compliance with
 * the License. You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the license for the specific language governing permissions and
 * limitations under the license.
 */
package org.apache.logging.log4j.core.net;

import java.io.ByteArrayOutputStream;
import java.io.IOException;
import java.io.OutputStream;
import java.util.Date;
import java.util.Properties;

import javax.activation.DataSource;
import javax.mail.Authenticator;
import javax.mail.Message;
import javax.mail.MessagingException;
import javax.mail.PasswordAuthentication;
import javax.mail.Session;
import javax.mail.Transport;
import javax.mail.internet.InternetHeaders;
import javax.mail.internet.MimeBodyPart;
import javax.mail.internet.MimeMessage;
import javax.mail.internet.MimeMultipart;
import javax.mail.internet.MimeUtility;
import javax.mail.util.ByteArrayDataSource;

import org.apache.logging.log4j.LoggingException;
import org.apache.logging.log4j.core.Layout;
import org.apache.logging.log4j.core.LogEvent;
import org.apache.logging.log4j.core.appender.AbstractManager;
import org.apache.logging.log4j.core.appender.ManagerFactory;
import org.apache.logging.log4j.core.config.Configuration;
import org.apache.logging.log4j.core.impl.Log4jLogEvent;
import org.apache.logging.log4j.core.impl.MutableLogEvent;
import org.apache.logging.log4j.core.layout.AbstractStringLayout.Serializer;
import org.apache.logging.log4j.core.layout.PatternLayout;
import org.apache.logging.log4j.core.util.CyclicBuffer;
import org.apache.logging.log4j.core.util.NameUtil;
import org.apache.logging.log4j.core.util.NetUtils;
import org.apache.logging.log4j.message.ReusableMessage;
import org.apache.logging.log4j.util.PropertiesUtil;
import org.apache.logging.log4j.util.Strings;

Manager for sending SMTP events.
/** * Manager for sending SMTP events. */
public class SmtpManager extends AbstractManager { private static final SMTPManagerFactory FACTORY = new SMTPManagerFactory(); private final Session session; private final CyclicBuffer<LogEvent> buffer; private volatile MimeMessage message; private final FactoryData data; private static MimeMessage createMimeMessage(final FactoryData data, final Session session, final LogEvent appendEvent) throws MessagingException { return new MimeMessageBuilder(session).setFrom(data.from).setReplyTo(data.replyto) .setRecipients(Message.RecipientType.TO, data.to).setRecipients(Message.RecipientType.CC, data.cc) .setRecipients(Message.RecipientType.BCC, data.bcc).setSubject(data.subject.toSerializable(appendEvent)) .build(); } protected SmtpManager(final String name, final Session session, final MimeMessage message, final FactoryData data) { super(null, name); this.session = session; this.message = message; this.data = data; this.buffer = new CyclicBuffer<>(LogEvent.class, data.numElements); } public void add(LogEvent event) { if (event instanceof Log4jLogEvent && event.getMessage() instanceof ReusableMessage) { ((Log4jLogEvent) event).makeMessageImmutable(); } else if (event instanceof MutableLogEvent) { event = ((MutableLogEvent) event).createMemento(); } buffer.add(event); } public static SmtpManager getSmtpManager( final Configuration config, final String to, final String cc, final String bcc, final String from, final String replyTo, final String subject, String protocol, final String host, final int port, final String username, final String password, final boolean isDebug, final String filterName, final int numElements) { if (Strings.isEmpty(protocol)) { protocol = "smtp"; } final StringBuilder sb = new StringBuilder(); if (to != null) { sb.append(to); } sb.append(':'); if (cc != null) { sb.append(cc); } sb.append(':'); if (bcc != null) { sb.append(bcc); } sb.append(':'); if (from != null) { sb.append(from); } sb.append(':'); if (replyTo != null) { sb.append(replyTo); } sb.append(':'); if (subject != null) { sb.append(subject); } sb.append(':'); sb.append(protocol).append(':').append(host).append(':').append("port").append(':'); if (username != null) { sb.append(username); } sb.append(':'); if (password != null) { sb.append(password); } sb.append(isDebug ? ":debug:" : "::"); sb.append(filterName); final String name = "SMTP:" + NameUtil.md5(sb.toString()); final Serializer subjectSerializer = PatternLayout.newSerializerBuilder().setConfiguration(config).setPattern(subject).build(); return getManager(name, FACTORY, new FactoryData(to, cc, bcc, from, replyTo, subjectSerializer, protocol, host, port, username, password, isDebug, numElements)); }
Send the contents of the cyclic buffer as an e-mail message.
Params:
  • layout – The layout for formatting the events.
  • appendEvent – The event that triggered the send.
/** * Send the contents of the cyclic buffer as an e-mail message. * @param layout The layout for formatting the events. * @param appendEvent The event that triggered the send. */
public void sendEvents(final Layout<?> layout, final LogEvent appendEvent) { if (message == null) { connect(appendEvent); } try { final LogEvent[] priorEvents = buffer.removeAll(); // LOG4J-310: log appendEvent even if priorEvents is empty final byte[] rawBytes = formatContentToBytes(priorEvents, appendEvent, layout); final String contentType = layout.getContentType(); final String encoding = getEncoding(rawBytes, contentType); final byte[] encodedBytes = encodeContentToBytes(rawBytes, encoding); final InternetHeaders headers = getHeaders(contentType, encoding); final MimeMultipart mp = getMimeMultipart(encodedBytes, headers); sendMultipartMessage(message, mp); } catch (final MessagingException | IOException | RuntimeException e) { logError("Caught exception while sending e-mail notification.", e); throw new LoggingException("Error occurred while sending email", e); } } protected byte[] formatContentToBytes(final LogEvent[] priorEvents, final LogEvent appendEvent, final Layout<?> layout) throws IOException { final ByteArrayOutputStream raw = new ByteArrayOutputStream(); writeContent(priorEvents, appendEvent, layout, raw); return raw.toByteArray(); } private void writeContent(final LogEvent[] priorEvents, final LogEvent appendEvent, final Layout<?> layout, final ByteArrayOutputStream out) throws IOException { writeHeader(layout, out); writeBuffer(priorEvents, appendEvent, layout, out); writeFooter(layout, out); } protected void writeHeader(final Layout<?> layout, final OutputStream out) throws IOException { final byte[] header = layout.getHeader(); if (header != null) { out.write(header); } } protected void writeBuffer(final LogEvent[] priorEvents, final LogEvent appendEvent, final Layout<?> layout, final OutputStream out) throws IOException { for (final LogEvent priorEvent : priorEvents) { final byte[] bytes = layout.toByteArray(priorEvent); out.write(bytes); } final byte[] bytes = layout.toByteArray(appendEvent); out.write(bytes); } protected void writeFooter(final Layout<?> layout, final OutputStream out) throws IOException { final byte[] footer = layout.getFooter(); if (footer != null) { out.write(footer); } } protected String getEncoding(final byte[] rawBytes, final String contentType) { final DataSource dataSource = new ByteArrayDataSource(rawBytes, contentType); return MimeUtility.getEncoding(dataSource); } protected byte[] encodeContentToBytes(final byte[] rawBytes, final String encoding) throws MessagingException, IOException { final ByteArrayOutputStream encoded = new ByteArrayOutputStream(); encodeContent(rawBytes, encoding, encoded); return encoded.toByteArray(); } protected void encodeContent(final byte[] bytes, final String encoding, final ByteArrayOutputStream out) throws MessagingException, IOException { try (final OutputStream encoder = MimeUtility.encode(out, encoding)) { encoder.write(bytes); } } protected InternetHeaders getHeaders(final String contentType, final String encoding) { final InternetHeaders headers = new InternetHeaders(); headers.setHeader("Content-Type", contentType + "; charset=UTF-8"); headers.setHeader("Content-Transfer-Encoding", encoding); return headers; } protected MimeMultipart getMimeMultipart(final byte[] encodedBytes, final InternetHeaders headers) throws MessagingException { final MimeMultipart mp = new MimeMultipart(); final MimeBodyPart part = new MimeBodyPart(headers, encodedBytes); mp.addBodyPart(part); return mp; } protected void sendMultipartMessage(final MimeMessage msg, final MimeMultipart mp) throws MessagingException { synchronized (msg) { msg.setContent(mp); msg.setSentDate(new Date()); Transport.send(msg); } }
Factory data.
/** * Factory data. */
private static class FactoryData { private final String to; private final String cc; private final String bcc; private final String from; private final String replyto; private final Serializer subject; private final String protocol; private final String host; private final int port; private final String username; private final String password; private final boolean isDebug; private final int numElements; public FactoryData(final String to, final String cc, final String bcc, final String from, final String replyTo, final Serializer subjectSerializer, final String protocol, final String host, final int port, final String username, final String password, final boolean isDebug, final int numElements) { this.to = to; this.cc = cc; this.bcc = bcc; this.from = from; this.replyto = replyTo; this.subject = subjectSerializer; this.protocol = protocol; this.host = host; this.port = port; this.username = username; this.password = password; this.isDebug = isDebug; this.numElements = numElements; } } private synchronized void connect(final LogEvent appendEvent) { if (message != null) { return; } try { message = createMimeMessage(data, session, appendEvent); } catch (final MessagingException e) { logError("Could not set SmtpAppender message options", e); message = null; } }
Factory to create the SMTP Manager.
/** * Factory to create the SMTP Manager. */
private static class SMTPManagerFactory implements ManagerFactory<SmtpManager, FactoryData> { @Override public SmtpManager createManager(final String name, final FactoryData data) { final String prefix = "mail." + data.protocol; final Properties properties = PropertiesUtil.getSystemProperties(); properties.put("mail.transport.protocol", data.protocol); if (properties.getProperty("mail.host") == null) { // Prevent an UnknownHostException in Java 7 properties.put("mail.host", NetUtils.getLocalHostname()); } if (null != data.host) { properties.put(prefix + ".host", data.host); } if (data.port > 0) { properties.put(prefix + ".port", String.valueOf(data.port)); } final Authenticator authenticator = buildAuthenticator(data.username, data.password); if (null != authenticator) { properties.put(prefix + ".auth", "true"); } final Session session = Session.getInstance(properties, authenticator); session.setProtocolForAddress("rfc822", data.protocol); session.setDebug(data.isDebug); return new SmtpManager(name, session, null, data); } private Authenticator buildAuthenticator(final String username, final String password) { if (null != password && null != username) { return new Authenticator() { private final PasswordAuthentication passwordAuthentication = new PasswordAuthentication(username, password); @Override protected PasswordAuthentication getPasswordAuthentication() { return passwordAuthentication; } }; } return null; } } }