/*
* Copyright (C) The Apache Software Foundation. All rights reserved.
*
* This software is published under the terms of the Apache Software
* License version 1.1, a copy of which has been included with this
* distribution in the LICENSE.txt file. */
package org.apache.log4j;
import org.apache.log4j.spi.OptionHandler;
import org.apache.log4j.spi.LoggingEvent;
/**
Extend this abstract class to create your own log layout format.
@author Ceki Gülcü
*/
public abstract class Layout implements OptionHandler {
// Note that the line.separator property can be looked up even by
// applets.
public final static String LINE_SEP = System.getProperty("line.separator");
public final static int LINE_SEP_LEN = LINE_SEP.length();
/**
Implement this method to create your own layout format.
*/
abstract
public
String format(LoggingEvent event);
/**
Returns the content type output by this layout. The base class
returns "text/plain".
*/
public
String getContentType() {
return "text/plain";
}
/**
Returns the header for the layout format. The base class returns
<code>null</code>. */
public
String getHeader() {
return null;
}
/**
Returns the footer for the layout format. The base class returns
<code>null</code>. */
public
String getFooter() {
return null;
}
/**
If the layout handles the throwable object contained within
{@link LoggingEvent}, then the layout should return
<code>false</code>. Otherwise, if the layout ignores throwable
object, then the layout should return <code>true</code>.
<p>The {@link SimpleLayout}, {@link TTCCLayout}, {@link
PatternLayout} all return <code>true</code>. The {@link
org.apache.log4j.xml.XMLLayout} returns <code>false</code>.
@since 0.8.4 */
abstract
public
boolean ignoresThrowable();
}
|