SimpleLayout.java

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

import org.apache.log4j.spi.LoggingEvent;

/**
 * SimpleLayout consists of the level of the log statement, followed by " - " and then the log message itself. For
 * example,
 *
 * <pre>
 * DEBUG - Hello world
 * </pre>
 *
 * <p>
 *
 * @author Ceki G&uuml;lc&uuml;
 * @since version 0.7.0
 *
 * <p>
 * {@link PatternLayout} offers a much more powerful alternative.
 */
public class SimpleLayout extends Layout {

    StringBuffer sbuf = new StringBuffer(128);

    public SimpleLayout() {
    }

    public void activateOptions() {
    }

    /**
     * Returns the log statement in a format consisting of the <code>level</code>, followed by " - " and then the
     * <code>message</code>. For example,
     *
     * <pre>
     * INFO - "A message"
     * </pre>
     *
     * <p>
     * The <code>category</code> parameter is ignored.
     * <p>
     *
     * @return A byte array in SimpleLayout format.
     */
    public String format(LoggingEvent event) {

        sbuf.setLength(0);
        sbuf.append(event.getLevel().toString());
        sbuf.append(" - ");
        sbuf.append(event.getRenderedMessage());
        sbuf.append(LINE_SEP);
        return sbuf.toString();
    }

    /**
     * The SimpleLayout does not handle the throwable contained within {@link LoggingEvent LoggingEvents}. Thus, it
     * returns <code>true</code>.
     *
     * @since version 0.8.4
     */
    public boolean ignoresThrowable() {
        return true;
    }
}