JAVA之日志操作

ＪＡＶＡ之日志操作－Ａｐａｃｈｅ

根据网络资料整理

日志论

在应用程序中输出日志有三个目的：

（１）监视代码中变量的变化情况，把数据周期性地记录到文件中供其他应用进行统计分析工作。

（２）跟踪代码运行轨迹，作为日后审计的依据。

（３）担当集成开发环境中的调试器，向文件或控制台打印代码的调试信息。

Ａｐａｃｈｅ通用日志包（ＣｏｍｍｏｎｓＬｏｇｇｉｎｇＰａｃｋａｇｅ）是Ａｐａｃｈｅ的一个开放源代码项目，它提供了一组通用的日志接口，用户可以自由地选择实现日志接口的第三方软件。通用日志包目前支持以下日志实现：

•Log4J日志器（ｈｔｔｐ：／／ｊａｋａｒｔａ．ａｐａｃｈｅ．ｏｒｇ／ｌｏｇ４ｊ）

•ＪＤＫ１．４Ｌｏｇｇｉｎｇ日志器（ＪＤＫ１．４自带）

•ＳｉｍｐｌｅＬｏｇ日志器（把日志消息输出到标准系统错误流Ｓｙｓｔｅｍ．ｅｒｒ）

•ＮｏＯｐＬｏｇ（不输出任何日志信息）

通用日志包中的两个常用接口：ＬｏｇＦａｃｔｏｒｙ和Ｌｏｇ，分别介绍如下：

•Ｌｏｇ接口

通用日志包把消息分为６个级别：ＦＡＴＡＬ、ＥＲＲＯＲ、ＷＡＲＮ、ＩＮＦＯ、ＤＥＢＵＧ和ＴＲＡＣＥ。其中ＦＡＴＡＬ级别最高，ＴＲＡＣＥ级别最低。Ｌｏｇ接口提供输出不同级别消息的方法：ｏｆｆ－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－最高等级的，用于关闭所有日志记录ｆａｔａｌ（Ｏｂｊｅｃｔｍｅｓｓａｇｅ）－－－－－－－输出ＦＡＴＡＬ级别的消息。

ｅｒｒｏｒ（Ｏｂｊｅｃｔｍｅｓｓａｇｅ）－－－－－－－输出ＥＲＲＯＲ级别的消息。

ｗａｒｎ（Ｏｂｊｅｃｔｍｅｓｓａｇｅ）－－－－－－－输出ＷＡＲＮ级别的消息。

ｉｎｆｏ（Ｏｂｊｅｃｔｍｅｓｓａｇｅ）－－－－－－－输出ＩＮＦＯ级别的消息。

ｄｅｂｕｇ（Ｏｂｊｅｃｔｍｅｓｓａｇｅ）－－－－－－－输出ＤＥＢＵＧ级别的消息。

ｔｒａｃｅ（Ｏｂｊｅｃｔｍｅｓｓａｇｅ）－－－－－－－输出ＴＲＡＣＥ级别的消息。

ａｌｌ－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－最低等级的，用于打开所有日志记录

注：只有当输出日志的级别大于或等于为日志配置器配置的日志级别时，这个方法才会执行。如何指定日志器的日志级别，不同的日志器实现会有不同的实现方案。

•ＬｏｇＦａｃｔｏｒｙ接口

ＬｏｇＦａｃｔｏｒｙ接口提供了获得日志器实例的两个静态方法：

ｐｕｂｌｉｃｓｔａｔｉｃＬｏｇｇｅｔＬｏｇ（Ｓｔｒｉｎｇｎａｍｅ）ｔｈｒｏｗｓＬｏｇＣｏｎｆｉｇｕｒａｔｉｏｎＥｘｃｅｐｔｉｏｎ；ｐｕｂｌｉｃｓｔａｔｉｃＬｏｇｇｅｔＬｏｇ（Ｃｌａｓｓｃｌａｓｓ）ｔｈｒｏｗｓＬｏｇＣｏｎｆｉｇｕｒａｔｉｏｎＥｘｃｅｐｔｉｏｎ；注：ｎａｍｅ参数作为日志器的名字；ｃｌａｓｓ参数指定类名作为日志器名字。

ｌｏｇ４ｊ简介

几乎每个大的应用程序都有它自己的日志和跟踪程序的ＡＰＩ。顺应这一规则，Ｅ．Ｕ．ＳＥＭＰＥＲ项目组决定编写它自己的程序跟踪ＡＰＩ（ｔｒａｃｉｎｇＡＰＩ）。这开始于１９９６年早期。经过无数的工作，更改和性能加强，这个ＡＰＩ终于成为一个十分受欢迎的Ｊａｖａ日志软件包，那就是log4j。这个软件包的发行遵守opensource认证的ApacheSoftwareLicense。最新的log4j版本包括全部的源代码，类文件和文档资料，可以在ｈｔｔｐ：／／ｌｏｇｇｉｎｇ．ａｐａｃｈｅ．ｏｒｇ／ｌｏｇ４ｊ／找到它们。

Log4j是Ａｐａｃｈｅ的一个开放源代码项目，通过使用Log4j，我们可以控制日志信息输送的目的地是控制台、文件、ＧＵＩ组件、甚至是套接口服务器、ＮＴ的事件记录器、ＵＮＩＸＳｙｓｌｏｇ守护进程等；我们也可以控制每一条日志的输出格式；通过定义每一条日志信息的级别，我们能够更加细致地控制日志的生成过程。最令人感兴趣的就是，这些可以通过一个配置文件来灵活地进行配置，而不需要修改应用的代码。

ｌｏｇ４ｊ三个组件

通常，我们都提供一个名为ｌｏｇ４ｊ．ｐｒｏｐｅｒｔｉｅｓ的文件，在第一次调用到Log4J 时，Ｌｏｇ４Ｊ会在类路径（．．／ｗｅｂ－ｉｎｆ／ｃｌａｓｓ／当然也可以放到其它任何目录，只要该目录被包含到类路径中即可）中定位这个文件，并读入这个文件完成的配置。这个配置文件告诉Ｌｏｇ４Ｊ以什么样的格式、把什么样的信息、输出到什么地方。

Ｌｏｇ４ｊ有三个主要的组件：Ｌｏｇｇｅｒｓ（记录器），Ａｐｐｅｎｄｅｒｓ（输出源）和

Ｌａｙｏｕｔｓ（布局），这里可简单理解为日志类别，日志要输出的地方和日志以何种形式输出。综合使用这三个组件可以轻松的记录信息的类型和级别，并可以在运行时控制日志输出的样式和位置。下面对三个组件分别进行说明：１、Ｌｏｇｇｅｒｓ

Ｌｏｇｇｅｒｓ组件在此系统中被分为五个级别：ＤＥＢＵＧ、ＩＮＦＯ、ＷＡＲＮ、ＥＲＲＯＲ和ＦＡＴＡＬ。这五个级别是有顺序的，ＤＥＢＵＧ＜ＩＮＦＯ＜ＷＡＲＮ＜ＥＲＲＯＲ＜ＦＡＴＡＬ，分别用来指定这条日志信息的重要程度，明白这一点很重要，这里Ｌｏｇ４ｊ有一个规则：假设Ｌｏｇｇｅｒｓ级别为Ｐ，如果在Ｌｏｇｇｅｒｓ中发生了一个级别Ｑ比Ｐ高，则可以启

动，否则屏蔽掉。

假设你定义的级别是ｉｎｆｏ，那么ｅｒｒｏｒ和ｗａｒｎ的日志可以显示而比他低的ｄｅｂｕｇ信息就不显示了。

Ｊａｖａ程序举例来说：

／／建立Ｌｏｇｇｅｒ的一个实例，命名为ｃｏｍ．ｆｏｏ

Ｌｏｇｇｅｒｌｏｇｇｅｒ＝Ｌｏｇｇｅｒ．ｇｅｔＬｏｇｇｅｒ（＂ｃｏｍ．ｆｏｏ＂）；／／＂ｃｏｍ．ｆｏｏ＂是实例进行命名，也可以任意

／／设置ｌｏｇｇｅｒ的级别。通常不在程序中设置ｌｏｇｇｅｒ的级别。一般在配置文件中设置。

ｌｏｇｇｅｒ．ｓｅｔＬｅｖｅｌ（Ｌｅｖｅｌ．ＩＮＦＯ）；

Ｌｏｇｇｅｒｂａｒｌｏｇｇｅｒ＝Ｌｏｇｇｅｒ．ｇｅｔＬｏｇｇｅｒ（＂ｃｏｍ．ｆｏｏ．Ｂａｒ＂）；

／／下面这个请求可用，因为ＷＡＲＮ＞＝ＩＮＦＯ

ｌｏｇｇｅｒ．ｗａｒｎ（＂Ｌｏｗｆｕｅｌｌｅｖｅｌ．＂）；

／／下面这个请求不可用，因为ＤＥＢＵＧ＜ＩＮＦＯ

ｌｏｇｇｅｒ．ｄｅｂｕｇ（＂Ｓｔａｒｔｉｎｇｓｅａｒｃｈｆｏｒｎｅａｒｅｓｔｇａｓｓｔａｔｉｏｎ．＂）；

／／命名为ｃｏｍ．ｆｏｏ．ｂａｒ的实例ｂａｒｌｏｇｇｅｒ会继承实例ｃｏｍ．ｆｏｏ的级别。因此，下面这个请求可用，因为ＩＮＦＯ＞＝ＩＮＦＯ

ｂａｒｌｏｇｇｅｒ．ｉｎｆｏ（＂Ｌｏｃａｔｅｄｎｅａｒｅｓｔｇａｓｓｔａｔｉｏｎ．＂）；

／／下面这个请求不可用，因为ＤＥＢＵＧ＜ＩＮＦＯ

ｂａｒｌｏｇｇｅｒ．ｄｅｂｕｇ（＂Ｅｘｉｔｉｎｇｇａｓｓｔａｔｉｏｎｓｅａｒｃｈ＂）；

这里是否可用的意思是能否输出Ｌｏｇｇｅｒ信息。

在对Ｌｏｇｇｅｒ实例进行命名时，没有限制，可以取任意自己感兴趣的名字。一般情况下建议以类的所在位置来命名Ｌｏｇｇｅｒ实例，这是目前来讲比较有效的Ｌｏｇｇｅｒ命名方式。这样可以使得每个类建立自己的日志信息，便于管理。比如：

ｓｔａｔｉｃＬｏｇｇｅｒｌｏｇｇｅｒ＝

Ｌｏｇｇｅｒ．ｇｅｔＬｏｇｇｅｒ（ＣｌｉｅｎｔＷｉｔｈＬｏｇ４ｊ．ｃｌａｓｓ．ｇｅｔＮａｍｅ（））；

２、Ａｐｐｅｎｄｅｒｓ

禁用与使用日志请求只是Ｌｏｇ４ｊ其中的一个小小的地方，Ｌｏｇ４ｊ日志系统允许把日志输出到不同的地方，如控制台（Ｃｏｎｓｏｌｅ）、文件（Ｆｉｌｅｓ）、根据天数或者文件大小产生新的文件、以流的形式发送到其它地方等等。

其语法表示为：

ｏｒｇ．ａｐａｃｈｅ．ｌｏｇ４ｊ．ＣｏｎｓｏｌｅＡｐｐｅｎｄｅｒ（控制台）

ｏｒｇ．ａｐａｃｈｅ．ｌｏｇ４ｊ．ＦｉｌｅＡｐｐｅｎｄｅｒ（文件）

ｏｒｇ．ａｐａｃｈｅ．ｌｏｇ４ｊ．ＤａｉｌｙＲｏｌｌｉｎｇＦｉｌｅＡｐｐｅｎｄｅｒ（每天产生一个日志文件）ｏｒｇ．ａｐａｃｈｅ．ｌｏｇ４ｊ．ＲｏｌｌｉｎｇＦｉｌｅＡｐｐｅｎｄｅｒ（文件大小到达指定尺寸的时候产生一个新的文件）

ｏｒｇ．ａｐａｃｈｅ．ｌｏｇ４ｊ．ＷｒｉｔｅｒＡｐｐｅｎｄｅｒ（将日志信息以流格式发送到任意指定