扫码一下
查看教程更方便
Apache log4j 提供了各种 Layout 对象,每个对象都可以根据各种布局格式化日志数据。 也可以创建一个 Layout 对象,以特定于应用程序的方式格式化日志数据。
所有 Layout
对象都从 Appender
对象接收 LoggingEvent
对象。 然后,Layout
对象从 LoggingEvent
中检索消息参数并应用适当的 ObjectRenderer
来获取消息的字符串表示形式。
层次结构中的顶级类是抽象类 org.apache.logging.log4j.Layout
。 这是 log4j API 中所有其他布局类的基类。
Layout 类在应用程序中被定义为抽象类,我们从不直接使用该类; 相反,我们使用它的子类,如下所示:
该类提供了所有其他 Layout 对象中所有常见操作的框架实现,并声明了两个抽象方法。
序号 | 方法 | 描述 |
---|---|---|
1 | public abstract boolean ignoresThrowable() | 它指示日志记录信息是否处理作为日志记录事件的一部分传递给它的任何 java.lang.Throwable 对象。 如果 Layout 对象处理 Throwable 对象,则 Layout 对象不会忽略它,并返回 false。 |
2 | public abstract String format(LoggingEvent event) | 单独的 Layout 子类为布局特定格式实现此方法。 |
除了这些抽象方法之外,Layout 类还为下面列出的方法提供了具体实现:
序号 | 方法 | 描述 |
---|---|---|
1 | public String getContentType() | 它返回 Layout 对象使用的内容类型。 基类返回 text/plain 作为默认内容类型。 |
2 | public String getFooter() | 它指定日志消息的页脚信息。 |
3 | public String getHeader() | 它指定日志消息的标头信息。 |
每个子类都可以通过覆盖这些方法的具体实现来返回特定于类的信息。