log4j的简单介绍和应用以及与commons-logging的区别

dom4j的使用

学习前的准备：

1.jar包：dom4j的jar包–>log4j-1.2.16.jar

概念和晦涩难懂的东西

dom4j简介

log4j的发展历史以及版本

用法或功能的简要介绍

- log4j由3大组件构成:Logger,Appender和Layout,分别为日志类型,日志输出目的地,日志输出格式. - log4j支持两种类型的配置文件,xml和properties;log4j.properties配置文件如下:(需要把log4j的配置文件放在classpath下) - 1.logger    负责输出日志信息，并能够对日志信息进行分类筛选，即决定哪些日志信息应该被输出，哪些该被忽略。Loggers组件输出日志信息时分为5个级别：DEBUG、INFO、WARN、ERROR、FATAL。这五个级别的顺序是：DEBUG<INFO<WARN<ERROR<FATAL。如果设置某个Logger组件的级别是P，则只有级别比P高的日志信息才能输出。Logger是有继承关系的，最上层是rootLogger，定义的其他Logger都会继承rootLogger。    Logger的定义格式：log4j.[loggername]=[level],appenderName,appenderName,…;    例如：log4j.rootCategory/rootLogger=INFO, stdout , R              --rootCategory 是loggername            --INFO 是level ：这句指INFO以下级别的日志不会显示。            --stdout , R是appenderName            --rootLogger是新的写法，而rootCategory是旧的写法，推荐使用rootLogger.    这里level是指Logger的优先级，appenderName是日志信息的输出地，可以同时定义多个输出地。- 2.appender    定义了日志输出目的地，指定日志信息应该被输出到什么地方。输出的目的地可以是控制台、文件或网络设备。    Appender的定义格式：    log4j.appender.appenderName = fully.qualified.name.of.appender.class      "fully.qualified.name.of.appender.class" 可以指定下面五个目的地中的一个：

Appender类名 作用 org.apache.log4j.ConsoleAppender 将日志输出到控制台 org.apache.log4j.FileAppender 将日志输出到文件 org.apache.log4j.DailyRollingFileAppender 每天产生一个日志文件 org.apache.log4j.RollingFileAppender 文件大小到达指定尺寸时产生一个新的文件 org.apache.log4j. WriterAppender 将日志信息以流格式发送到任意指定的地方

- ConsoleAppender选项
Threshold=WARN:指定日志消息的输出最低层次。
ImmediateFlush=true:默认值是true,意谓着所有的消息都会被立即输出。
Target=System.err：默认情况下是：System.out,指定输出控制台。
- FileAppender 选项
Threshold=WARN:指定日志消息的输出最低层次。
ImmediateFlush=true:默认值是true,意谓着所有的消息都会被立即输出。
File=mylog.txt:指定消息输出到mylog.txt文件。
Append=false:默认值是true,即将消息增加到指定文件中，false指将消息覆盖指定的文件内容
- DailyRollingFileAppender
Threshold=WARN:指定日志消息的输出最低层次。
ImmediateFlush=true:默认值是true,意谓着所有的消息都会被立即输出。
File=mylog.txt:指定消息输出到mylog.txt文件。
Append=false:默认值是true,即将消息增加到指定文件中，false指将消息覆盖指定的文件内容。
DatePattern=’.’yyyy-ww:每周滚动一次文件，即每周产生一个新的文件。当然也可以指定按月、周、天、时和分。即对应的格式如下：
‘.’yyyy-MM: 每月
‘.’yyyy-ww: 每周
‘.’yyyy-MM-dd: 每天
‘.’yyyy-MM-dd-a: 每天两次
‘.’yyyy-MM-dd-HH: 每小时
‘.’yyyy-MM-dd-HH-mm: 每分钟
- RollingFileAppender 选项
Threshold=WARN:指定日志消息的输出最低层次。
ImmediateFlush=true:默认值是true,意谓着所有的消息都会被立即输出。
File=mylog.txt:指定消息输出到mylog.txt文件。
Append=false:默认值是true,即将消息增加到指定文件中，false指将消息覆盖指定的文件内容。
MaxFileSize=100KB: 后缀可以是KB, MB 或者是 GB. 在日志文件到达该大小时，将会自动滚动，即将原来的内容移到mylog.log.1文件。
MaxBackupIndex=2:指定可以产生的滚动文件的最大数。

- 3.layout    通过在Appender的后面附加Layout来实现格式化输出。    一个Logger可以有多个Appender，每个Appender对应一个Layout。

Layout的定义格式：
log4j.appender.appenderName.layout = fully.qualified.name.of.layout.class
fully.qualified.name.of.layout.class可以是下面中的一种

Layout类名 作用 org.apache.log4j.HTMLLayout 以HTML表格形式布局 org.apache.log4j.PatternLayout 可以灵活地指定布局模式 org.apache.log4j.SimpleLayout 包含日志信息的级别和信息字符串 org.apache.log4j.TTCCLayout 包含日志产生的时间、线程、类别等等信息

- HTMLLayout 选项
-LocationInfo=true:默认值是false,输出java文件名称和行号。
-Title=my app file: 默认值是 Log4J Log Messages。
- PatternLayout 选项
- ConversionPattern=%m%n :指定怎样格式化指定的消息。
- XMLLayout 选项
-LocationInfo=true:默认值是false,输出java文件和行号。
如果使用PatternLayout布局就要指定的打印信息的具体格式ConversionPattern：
语句：log4j.appender.A1.layout.ConversionPattern=
%-4r %-5p %d{yyyy-MM-dd HH:mm:ssS} %c %m%n

具体符号代表的意义
1）－X号: X信息输出时左对齐。
2）%p: 输出日志信息优先级，即DEBUG，INFO，WARN，ERROR，FATAL。
3）%d: 输出日志时间点的日期或时间，默认格式为ISO8601，也可以在其后指定格式，比如：%d{yyy MMM dd HH:mm:ss,SSS}，输出类似：2002年10月18日 22：10：28，921。
4）%r: 输出自应用启动到输出该log信息耗费的毫秒数。
5）%c: 输出日志信息所属的类目，通常就是所在类的全名。
6）%t: 输出产生该日志事件的线程名。
7）%l: 输出日志事件的发生位置，相当于%C.%M(%F:%L)的组合,包括类目名、发生的线程，以及在代码中的行数。举例：Testlog4.main(TestLog4.java:10)。
8）%x: 输出和当前线程相关联的NDC(嵌套诊断环境),尤其用到像java servlets这样的多客户多线程的应用中。
9）%%: 输出一个”%”字符。
10）%F: 输出日志消息产生时所在的文件名称。
11） %L: 输出代码中的行号。
12）%m: 输出代码中指定的消息,产生的日志具体信息。
13）%n: 输出一个回车换行符，Windows平台为”\r\n”，Unix平台为”\n”输出日志信息换行。
可以在%与模式字符之间加上修饰符来控制其最小宽度、最大宽度、和文本的对齐方式。如：
1)%20c：指定输出category的名称，最小的宽度是20，如果category的名称小于20的话，默认的情况下右对齐。
2)%-20c:指定输出category的名称，最小的宽度是20，如果category的名称小于20的话，”-“号指定左对齐。
3)%.30c:指定输出category的名称，最大的宽度是30，如果category的名称大于30的话，就会将左边多出的字符截掉，但小于30的话也不会有空格。
4)%20.30c:如果category的名称小于20就补空格，并且右对齐，如果其名称长于30字符，就从左边交远销出的字符截掉。

实用用例

一个简单的log4j的配置log4j.properties
log4j.rootLogger=info,mylog
log4j.appender.mylog=org.apache.log4j.ConsoleAppender
log4j.appender.mylog.layout=org.apache.log4j.PatternLayout
log4j.appender.mylog.layout.ConversionPattern=[-] %p %d{yyyy-MM-dd HH:mm:ss} %m %n

代码中的应用
import org.arache.log4j.Logger;
static Logger logger = Logger.getLogger(your-className.class);
#需要插入日志的地方只需
logger.debug(your-message);
logger.info(your-message);
logger.warn(your-message);
logger.error(your-message);
logger.fatal(your-message);
写程序的时候,为了调试,会加入大量的logger信息,当然程序调试完毕不需要这些输出信息时,只需把输出的级别调高,如调到error级别,这样error以下级别的logger就不会出输出.非常简单,方便.
其实也可以把log4j简单的理解为 我们平常写的sys控制台输出语句，如果配置过log4j后我们完全可以用logger.xxxx来代替 sys输出语句。

参考资料
//这个同时也介绍了log4j与commmons-logging的区别。
http://blog.csdn.net/courage89/article/details/29649801
http://zhangjunhd.blog.51cto.com/113473/21211
//log4j的百度百科
http://baike.baidu.com/link?url=rMnpaqueMgUApMtIVofw0CxrI_rRKzzxLkRER23bOHekkmOSUPMGfJQZb9ajGyZpMWsAeDWttF8wYcOejTgHh_