Apache log4j 提供了各种布局对象,每一个对象都可以根据各种布局格式记录数据。另外,也可以创建一个布局对象格式化测井数据中的特定应用的方法。
所有的布局对象 - Appender对象收到 LoggingEvent 对象。布局对象检索来自LoggingEvent 的消息参数,并应用适当的 ObjectRenderer 获得消息的字符串表示。
布局类型:
在层次结构中的顶级类是抽象类是org.apache.log4j.Layout。这是 log4j 的 API 中的所有其他布局类的基类。
布局类定义为抽象在应用程序中,不要直接使用这个类; 相反,使用它的子类来工作,如下:
-
DateLayout
-
HTMLLayout ( 在本教程解释)
-
PatternLayout ( 在本教程解释)
-
SimpleLayout
-
XMLLayout
布局方法:
这个类提供了一个框架实现在所有其它布局对象的所有常见的操作,并声明了两个抽象方法。
S.N. | 方法 & 描述 |
---|---|
1 | public abstract boolean ignoresThrowable() 这种方法表示日志信息是否处理传递给它的日志记录事件的一部分,任何 java.lang.Throwable 对象。如果布局对象处理 Throwable 对象,那么布局对象不忽视它,并返回false。 |
2 | public abstract String format(LoggingEvent event) 独特的布局子类将实施这一方法的布局特定的格式 |
除了这些抽象方法,布局类提供具体的实现下列方法:
S.N. | 方法 & 描述 |
---|---|
1 | public String getContentType() 返回使用的布局的对象的内容类型。基类将返回 text/plain 作为默认的内容类型 |
2 | public String getFooter() 指定日志消息的页脚信息 |
3 | public String getHeader() 指定日志消息的标头信息 |
每个子类可以通过重写的具体实现这些方法返回类特定的信息。