/*
 * 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.Format;
import java.text.MessageFormat;
import java.util.Arrays;
import java.util.Locale;
import java.util.regex.Pattern;

Handles messages that contain a format String. Dynamically determines if the format conforms to MessageFormat or String.format and if not then uses ParameterizedMessage to format.
/** * Handles messages that contain a format String. Dynamically determines if the format conforms to * MessageFormat or String.format and if not then uses ParameterizedMessage to format. */
public class FormattedMessage implements Message { private static final long serialVersionUID = -665975803997290697L; private static final int HASHVAL = 31; private static final String FORMAT_SPECIFIER = "%(\\d+\\$)?([-#+ 0,(\\<]*)?(\\d+)?(\\.\\d+)?([tT])?([a-zA-Z%])"; private static final Pattern MSG_PATTERN = Pattern.compile(FORMAT_SPECIFIER); private String messagePattern; private transient Object[] argArray; private String[] stringArgs; private transient String formattedMessage; private final Throwable throwable; private Message message; private final Locale locale;
Constructs with a locale, a pattern and a single parameter.
Params:
  • locale – The locale
  • messagePattern – The message pattern.
  • arg – The parameter.
Since:2.6
/** * Constructs with a locale, a pattern and a single parameter. * @param locale The locale * @param messagePattern The message pattern. * @param arg The parameter. * @since 2.6 */
public FormattedMessage(final Locale locale, final String messagePattern, final Object arg) { this(locale, messagePattern, new Object[] { arg }, null); }
Constructs with a locale, a pattern and two parameters.
Params:
  • locale – The locale
  • messagePattern – The message pattern.
  • arg1 – The first parameter.
  • arg2 – The second parameter.
Since:2.6
/** * Constructs with a locale, a pattern and two parameters. * @param locale The locale * @param messagePattern The message pattern. * @param arg1 The first parameter. * @param arg2 The second parameter. * @since 2.6 */
public FormattedMessage(final Locale locale, final String messagePattern, final Object arg1, final Object arg2) { this(locale, messagePattern, new Object[] { arg1, arg2 }); }
Constructs with a locale, a pattern and a parameter array.
Params:
  • locale – The locale
  • messagePattern – The message pattern.
  • arguments – The parameter.
Since:2.6
/** * Constructs with a locale, a pattern and a parameter array. * @param locale The locale * @param messagePattern The message pattern. * @param arguments The parameter. * @since 2.6 */
public FormattedMessage(final Locale locale, final String messagePattern, final Object... arguments) { this(locale, messagePattern, arguments, null); }
Constructs with a locale, a pattern, a parameter array, and a throwable.
Params:
  • locale – The Locale
  • messagePattern – The message pattern.
  • arguments – The parameter.
  • throwable – The throwable
Since:2.6
/** * Constructs with a locale, a pattern, a parameter array, and a throwable. * @param locale The Locale * @param messagePattern The message pattern. * @param arguments The parameter. * @param throwable The throwable * @since 2.6 */
public FormattedMessage(final Locale locale, final String messagePattern, final Object[] arguments, final Throwable throwable) { this.locale = locale; this.messagePattern = messagePattern; this.argArray = arguments; this.throwable = throwable; }
Constructs with a pattern and a single parameter.
Params:
  • messagePattern – The message pattern.
  • arg – The parameter.
/** * Constructs with a pattern and a single parameter. * @param messagePattern The message pattern. * @param arg The parameter. */
public FormattedMessage(final String messagePattern, final Object arg) { this(messagePattern, new Object[] { arg }, null); }
Constructs with a pattern and two parameters.
Params:
  • messagePattern – The message pattern.
  • arg1 – The first parameter.
  • arg2 – The second parameter.
/** * Constructs with a pattern and two parameters. * @param messagePattern The message pattern. * @param arg1 The first parameter. * @param arg2 The second parameter. */
public FormattedMessage(final String messagePattern, final Object arg1, final Object arg2) { this(messagePattern, new Object[] { arg1, arg2 }); }
Constructs with a pattern and a parameter array.
Params:
  • messagePattern – The message pattern.
  • arguments – The parameter.
/** * Constructs with a pattern and a parameter array. * @param messagePattern The message pattern. * @param arguments The parameter. */
public FormattedMessage(final String messagePattern, final Object... arguments) { this(messagePattern, arguments, null); }
Constructs with a pattern, a parameter array, and a throwable.
Params:
  • messagePattern – The message pattern.
  • arguments – The parameter.
  • throwable – The throwable
/** * Constructs with a pattern, a parameter array, and a throwable. * @param messagePattern The message pattern. * @param arguments The parameter. * @param throwable The throwable */
public FormattedMessage(final String messagePattern, final Object[] arguments, final Throwable throwable) { this.locale = Locale.getDefault(Locale.Category.FORMAT); this.messagePattern = messagePattern; this.argArray = arguments; this.throwable = throwable; } @Override public boolean equals(final Object o) { if (this == o) { return true; } if (o == null || getClass() != o.getClass()) { return false; } final FormattedMessage that = (FormattedMessage) o; if (messagePattern != null ? !messagePattern.equals(that.messagePattern) : that.messagePattern != null) { return false; } if (!Arrays.equals(stringArgs, that.stringArgs)) { return false; } return true; }
Gets the message pattern.
Returns:the message pattern.
/** * Gets the message pattern. * @return the message pattern. */
@Override public String getFormat() { return messagePattern; }
Gets the formatted message.
Returns:the formatted message.
/** * Gets the formatted message. * @return the formatted message. */
@Override public String getFormattedMessage() { if (formattedMessage == null) { if (message == null) { message = getMessage(messagePattern, argArray, throwable); } formattedMessage = message.getFormattedMessage(); } return formattedMessage; } protected Message getMessage(final String msgPattern, final Object[] args, final Throwable aThrowable) { try { final MessageFormat format = new MessageFormat(msgPattern); final Format[] formats = format.getFormats(); if (formats != null && formats.length > 0) { return new MessageFormatMessage(locale, msgPattern, args); } } catch (final Exception ignored) { // Obviously, the message is not a proper pattern for MessageFormat. } try { if (MSG_PATTERN.matcher(msgPattern).find()) { return new StringFormattedMessage(locale, msgPattern, args); } } catch (final Exception ignored) { // Also not properly formatted. } return new ParameterizedMessage(msgPattern, args, aThrowable); }
Gets the message parameters.
Returns:the message parameters.
/** * Gets the message parameters. * @return the message parameters. */
@Override public Object[] getParameters() { if (argArray != null) { return argArray; } return stringArgs; } @Override public Throwable getThrowable() { if (throwable != null) { return throwable; } if (message == null) { message = getMessage(messagePattern, argArray, null); } return message.getThrowable(); } @Override public int hashCode() { int result = messagePattern != null ? messagePattern.hashCode() : 0; result = HASHVAL * result + (stringArgs != null ? Arrays.hashCode(stringArgs) : 0); return result; } private void readObject(final ObjectInputStream in) throws IOException, ClassNotFoundException { in.defaultReadObject(); formattedMessage = in.readUTF(); messagePattern = in.readUTF(); final int length = in.readInt(); stringArgs = new String[length]; for (int i = 0; i < length; ++i) { stringArgs[i] = in.readUTF(); } } @Override public String toString() { return getFormattedMessage(); } private void writeObject(final ObjectOutputStream out) throws IOException { out.defaultWriteObject(); getFormattedMessage(); out.writeUTF(formattedMessage); out.writeUTF(messagePattern); out.writeInt(argArray.length); stringArgs = new String[argArray.length]; int i = 0; for (final Object obj : argArray) { final String string = String.valueOf(obj); stringArgs[i] = string; out.writeUTF(string); ++i; } } }