Commons-logging + Log4j 入门指南(转摘)
2006
-
10
-
30
Commons-logging + Log4j 入门指南(转摘)
一 ：为什么同时使用
commons-logging和Log4j?为什么不仅使用其中之一？
Commons-loggin的目的是为“所有的Java日志实现”提供一个统一的接口，它自身的日志功能平常弱（只有一个简单的SimpleLog?），所以一般不会单独使用它。Log4j的功能非常全面强大，是目前的首选。我发现几乎所有的Java开源项目都会用到Log4j，但我同时发现，所有用到Log4j的项目一般也同时会用到commons-loggin。我想，大家都不希望自己的项目与Log4j绑定的太紧密吧。另外一个我能想到的“同时使用 commons-logging和Log4j”的原因是，简化使用和配置。
二 ： Commons-logging能帮我们做什么？
提供一个统一的日志接口，简单了操作，同时避免项目与某个日志实现系统紧密a耦合很贴心的帮我们自动选择适当的日志实现系统（这一点非常好！）它甚至不需要配置
这里看一下它怎么“‘很贴心的’帮我们‘自动选择’‘适当的’日志实现系统”：
1) 首先在classpath下寻找自己的配置文件 commons-logging.properties，如果找到，则使用其中定义的Log实现类；
2) 如果找不到 commons-logging.properties文件，则在查找是否已定义系统环境变量org.apache.commons.logging.Log，找到则使用其定义的Log实现类；
建立一个叫 ：CATALINA_OPTS 的环境变量
给他的值 ： - Dorg.apache.commons.logging.Log = org.apache.commons.logging.impl.SimpleLog - Dorg.apache.commons.logging.simplelog.defaultlog = warn
3) 否则，查看classpath中是否有Log4j的包，如果发现，则自动使用Log4j作为日志实现类；
4) 否则，使用JDK自身的日志实现类（JDK1.4以后才有日志实现类）；
5) 否则，使用 commons-logging自己提供的一个简单的日志实现类SimpleLog；
（以上顺序不保证完全准确，请参考官方文档）
可见， commons-logging总是能找到一个日志实现类，并且尽可能找到一个“最合适”的日志实现类。我说它“很贴心”实际上是因为：
1、可以不需要配置文件；
2、自动判断有没有Log4j包，有则自动使用之；
3、最悲观的情况下也总能保证提供一个日志实现（SimpleLog）。
可以看到， commons-logging对编程者和Log4j都非常友好。
为了简化配置 commons-logging，一般不使用 commons-logging的配置文件，也不设置与 commons-logging相关的系统环境变量，而只需将Log4j的Jar包放置到classpash中就可以了。这样就很简单地完成了 commons-logging与Log4j的融合。如果不想用Log4j了怎么办？只需将classpath中的Log4j的Jar包删除即可。就这么简单！
代码应该怎么写？
我们在需要输出日志信息的“每一人”类中做如下的三个工作：
1、导入所有需的commongs-logging类：
Commons-loggin的目的是为“所有的Java日志实现”提供一个统一的接口，它自身的日志功能平常弱（只有一个简单的SimpleLog?），所以一般不会单独使用它。Log4j的功能非常全面强大，是目前的首选。我发现几乎所有的Java开源项目都会用到Log4j，但我同时发现，所有用到Log4j的项目一般也同时会用到commons-loggin。我想，大家都不希望自己的项目与Log4j绑定的太紧密吧。另外一个我能想到的“同时使用 commons-logging和Log4j”的原因是，简化使用和配置。
二 ： Commons-logging能帮我们做什么？
提供一个统一的日志接口，简单了操作，同时避免项目与某个日志实现系统紧密a耦合很贴心的帮我们自动选择适当的日志实现系统（这一点非常好！）它甚至不需要配置
这里看一下它怎么“‘很贴心的’帮我们‘自动选择’‘适当的’日志实现系统”：
1) 首先在classpath下寻找自己的配置文件 commons-logging.properties，如果找到，则使用其中定义的Log实现类；
2) 如果找不到 commons-logging.properties文件，则在查找是否已定义系统环境变量org.apache.commons.logging.Log，找到则使用其定义的Log实现类；
建立一个叫 ：CATALINA_OPTS 的环境变量
给他的值 ： - Dorg.apache.commons.logging.Log = org.apache.commons.logging.impl.SimpleLog - Dorg.apache.commons.logging.simplelog.defaultlog = warn
3) 否则，查看classpath中是否有Log4j的包，如果发现，则自动使用Log4j作为日志实现类；
4) 否则，使用JDK自身的日志实现类（JDK1.4以后才有日志实现类）；
5) 否则，使用 commons-logging自己提供的一个简单的日志实现类SimpleLog；
（以上顺序不保证完全准确，请参考官方文档）
可见， commons-logging总是能找到一个日志实现类，并且尽可能找到一个“最合适”的日志实现类。我说它“很贴心”实际上是因为：
1、可以不需要配置文件；
2、自动判断有没有Log4j包，有则自动使用之；
3、最悲观的情况下也总能保证提供一个日志实现（SimpleLog）。
可以看到， commons-logging对编程者和Log4j都非常友好。
为了简化配置 commons-logging，一般不使用 commons-logging的配置文件，也不设置与 commons-logging相关的系统环境变量，而只需将Log4j的Jar包放置到classpash中就可以了。这样就很简单地完成了 commons-logging与Log4j的融合。如果不想用Log4j了怎么办？只需将classpath中的Log4j的Jar包删除即可。就这么简单！
代码应该怎么写？
我们在需要输出日志信息的“每一人”类中做如下的三个工作：
1、导入所有需的commongs-logging类：
1 debug() 输出“调试”级别的日志信息；
2 info()输出“信息”级别的日志信息；
3 warn() 输出“警告”级别的日志信息；
4 error() 输出“错误”级别的日志信息；
5 fatal() 输出“致命错误”级别的日志信息；
2 info()输出“信息”级别的日志信息；
3 warn() 输出“警告”级别的日志信息；
4 error() 输出“错误”级别的日志信息；
5 fatal() 输出“致命错误”级别的日志信息；
根据不同的性质，日志信息通常被分成不同的级别，从低到高依次是：
“调试（DEBUG）”“信息（INFO）”“警告（WARN）”“错误（ERROR）”“致命错误（FATAL）”。
为什么要把日志信息分成不同的级别呢？这实际上是方便我们更好的控制它。比如，通过Log4j的配置文件，我们可以设置“输出‘调试’及以上级别的日志信息”（即“调试”“信息”“警告”“错误”“致命错误”），这对项目开发人员可能是有用的；我们还可以设置“输出“警告”及以上级别的日志信息”（即“警告”“错误”“致命错误”），这对项目最终用户可能是有用的。
仅从字面上理解，也可以大致得出结论：最常用的应该是debug()和info()；而warn()、error()、
fatal()仅在相应事件发生后才使用。
从上面三个步骤可以看出，使用 commons-logging的日志接口非常的简单，不需要记忆太多东西：仅仅用到了两个类Log, LogFactory，并且两个类的方法都非常少（后者只用到一个方法，前者经常用到的也只是上面第三步中列出的几个），同时参数又非常简单。
上面所介绍的方法是目前被普通应用的，可以说是被标准化了的方法，几乎所有的人都是这么用。如果不信，或想确认一下，就去下载几个知名的Java开源项目源代码看一下吧。
下面给出一个完整的Java类的代码：
“调试（DEBUG）”“信息（INFO）”“警告（WARN）”“错误（ERROR）”“致命错误（FATAL）”。
为什么要把日志信息分成不同的级别呢？这实际上是方便我们更好的控制它。比如，通过Log4j的配置文件，我们可以设置“输出‘调试’及以上级别的日志信息”（即“调试”“信息”“警告”“错误”“致命错误”），这对项目开发人员可能是有用的；我们还可以设置“输出“警告”及以上级别的日志信息”（即“警告”“错误”“致命错误”），这对项目最终用户可能是有用的。
仅从字面上理解，也可以大致得出结论：最常用的应该是debug()和info()；而warn()、error()、
fatal()仅在相应事件发生后才使用。
从上面三个步骤可以看出，使用 commons-logging的日志接口非常的简单，不需要记忆太多东西：仅仅用到了两个类Log, LogFactory，并且两个类的方法都非常少（后者只用到一个方法，前者经常用到的也只是上面第三步中列出的几个），同时参数又非常简单。
上面所介绍的方法是目前被普通应用的，可以说是被标准化了的方法，几乎所有的人都是这么用。如果不信，或想确认一下，就去下载几个知名的Java开源项目源代码看一下吧。
下面给出一个完整的Java类的代码：