/*
 * 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.message;

import java.io.IOException;
import java.io.ObjectInputStream;
import java.io.ObjectOutputStream;
import java.text.MessageFormat;
import java.util.Arrays;
import java.util.IllegalFormatException;
import java.util.Locale;

import org.apache.logging.log4j.Logger;
import org.apache.logging.log4j.status.StatusLogger;

Handles messages that consist of a format string conforming to java.text.MessageFormat.
@serialIn version 2.1, due to a bug in the serialization format, the serialization format was changed along with its serialVersionUID value.
/** * Handles messages that consist of a format string conforming to java.text.MessageFormat. * * @serial In version 2.1, due to a bug in the serialization format, the serialization format was changed along with * its {@code serialVersionUID} value. */
public class MessageFormatMessage implements Message { private static final Logger LOGGER = StatusLogger.getLogger(); private static final long serialVersionUID = 1L; private static final int HASHVAL = 31; private String messagePattern; private transient Object[] parameters; private String[] serializedParameters; private transient String formattedMessage; private transient Throwable throwable; private final Locale locale;
Constructs a message.
Params:
  • locale – the locale for this message format
  • messagePattern – the pattern for this message format
  • parameters – The objects to format
Since:2.6
/** * Constructs a message. * * @param locale the locale for this message format * @param messagePattern the pattern for this message format * @param parameters The objects to format * @since 2.6 */
public MessageFormatMessage(final Locale locale, final String messagePattern, final Object... parameters) { this.locale = locale; this.messagePattern = messagePattern; this.parameters = parameters; final int length = parameters == null ? 0 : parameters.length; if (length > 0 && parameters[length - 1] instanceof Throwable) { this.throwable = (Throwable) parameters[length - 1]; } }
Constructs a message.
Params:
  • messagePattern – the pattern for this message format
  • parameters – The objects to format
/** * Constructs a message. * * @param messagePattern the pattern for this message format * @param parameters The objects to format */
public MessageFormatMessage(final String messagePattern, final Object... parameters) { this(Locale.getDefault(Locale.Category.FORMAT), messagePattern, parameters); }
Returns the formatted message.
Returns:the formatted message.
/** * Returns the formatted message. * @return the formatted message. */
@Override public String getFormattedMessage() { if (formattedMessage == null) { formattedMessage = formatMessage(messagePattern, parameters); } return formattedMessage; }
Returns the message pattern.
Returns:the message pattern.
/** * Returns the message pattern. * @return the message pattern. */
@Override public String getFormat() { return messagePattern; }
Returns the message parameters.
Returns:the message parameters.
/** * Returns the message parameters. * @return the message parameters. */
@Override public Object[] getParameters() { if (parameters != null) { return parameters; } return serializedParameters; } protected String formatMessage(final String msgPattern, final Object... args) { try { final MessageFormat temp = new MessageFormat(msgPattern, locale); return temp.format(args); } catch (final IllegalFormatException ife) { LOGGER.error("Unable to format msg: " + msgPattern, ife); return msgPattern; } } @Override public boolean equals(final Object o) { if (this == o) { return true; } if (o == null || getClass() != o.getClass()) { return false; } final MessageFormatMessage that = (MessageFormatMessage) o; if (messagePattern != null ? !messagePattern.equals(that.messagePattern) : that.messagePattern != null) { return false; } return Arrays.equals(serializedParameters, that.serializedParameters); } @Override public int hashCode() { int result = messagePattern != null ? messagePattern.hashCode() : 0; result = HASHVAL * result + (serializedParameters != null ? Arrays.hashCode(serializedParameters) : 0); return result; } @Override public String toString() { return getFormattedMessage(); } private void writeObject(final ObjectOutputStream out) throws IOException { getFormattedMessage(); out.writeUTF(formattedMessage); out.writeUTF(messagePattern); final int length = parameters == null ? 0 : parameters.length; out.writeInt(length); serializedParameters = new String[length]; if (length > 0) { for (int i = 0; i < length; i++) { serializedParameters[i] = String.valueOf(parameters[i]); out.writeUTF(serializedParameters[i]); } } } private void readObject(final ObjectInputStream in) throws IOException { parameters = null; throwable = null; formattedMessage = in.readUTF(); messagePattern = in.readUTF(); final int length = in.readInt(); serializedParameters = new String[length]; for (int i = 0; i < length; ++i) { serializedParameters[i] = in.readUTF(); } }
Return the throwable passed to the Message.
Returns:the Throwable.
/** * Return the throwable passed to the Message. * * @return the Throwable. */
@Override public Throwable getThrowable() { return throwable; } }