Struts-输出日志-使用log4j

１。什么是日志：
　　程序运行时，往特定输出文件或数据库里输出程序信息，
　 如:出错信息，运行记录，调试记录，等等。

日志（LOG）一般分为以下几种类型。
FATAL：系统错误（大错误）（程序被错误中断）
系统出现大错误时输出（程序无法处理的大错误，如硬件错误）
ERROR：异常（程序被错误中断）
程序运行时出现的错误（程序员可以捕获处理）
WARN ：警告（程序不会中断）
程序不算出错，但以不推荐方式运行时输出。
INFO : 信息（程序不会中断）
程序中有意输出的信息，如程序运行信息，
如“程序开始”“程序结束”等。
DEBUG: 调试记录（程序不会中断）
调试程序时，跟踪程序运行的输出信息。
２．Log4J的使用。
Log4J是为了输出日志的Java程序包，是Apached的一个子项目。
可在http://logging.apache.org 下载并免费使用。
可以把LOG输出到，控制台，文件，或数据库。
这个网址里有很多Log4程序包，他们分别是，
log4c -- ANSI C 版
log4E -- Eiffel 版
log::Log4perl -- Perl 版
log4net -- .NET 版
log4r -- Ruby 版
log4j -- Java版

３．Log4J的能输出LOG的优先级。
级别高 OFF 关闭所有LOG
FATAL 不可预想的无法继续运行程序的场合，一般是写进syslog（
系统日志）,在应用程序中很难捕获。
ERROR 出现异常，应用程序停止运行等，需要紧急对应的程度的错误。
WARN 警告，以不建议的方式运行。
INFO 信息，实际运行中最基本程度的信息，如，启动服务器，
运行某某程序或方法，运行结束等。
DEBUG 调试时输出的信息，有可能产生非常大量的LOG文件。
如为解决问题而设置输出断点LOG等。DEBUG调试时输出的
信息，所以投入运行时一般关闭DEBUG级别的LOG。
tracever log4j的 1.2.12 新加入比DEBUG还小的断点。
级别低 ALL 打开所有LOG

４．Struts使用Log4J。
项目里的，[JavaSource]下做一个，log4j.xml或log4j.properties以后
Struts就可以使用Log4J了，log4j.xml，log4j.properties是Log4J的
设置文档。struts先读入log4j.xml，要是没有再读入log4j.properties。
我认为log4j.xml更容易理解，而且可以做到赛选各种级别LOG后输出
（log4j.properies无法赛选），所以只讲log4j.xml。

５．Log4j.xml设置方法。

Xml代码
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
<log4j:configuration xmlns:log4j='http://jakarta.apache.org/log4j/'>

<!-- org.apache.log4j.ConsoleAppender （输出到控制台），
org.apache.log4j.FileAppender （输出到文件），
org.apache.log4j.DailyRollingFileAppender

（每天输出产生一个日志文件），
org.apache.log4j.RollingFileAppender

（文件大小到达指定尺寸的时候产生一个新的文件），

可通过 log4j.appender.R.MaxFileSize=100KB 设置文件

大小，还可通过 log4j.appender.R.MaxBackupIndex=1

设置为保存一个备份文件。
org.apache.log4j.WriterAppender

（将日志信息以流格式发送到任意指定的地方） -->

<!-- 输出通道"STDOUT"，输出所有信息到控制台

（也就是System.out.println()） -->
<appender name="STDOUT" class="org.apache.log4j.ConsoleAppender">
<!--org.apache.log4j.HTMLLayout （以 HTML 表格形式布局），
org.apache.log4j.PatternLayout （可以灵活地指定Log内容布局模式），
org.apache.log4j.SimpleLayout （包含日志信息的级别和信息字符串），
org.apache.log4j.TTCCLayout

（包含日志产生的时间、线程、类别等等信息） -->
<!-- 输出自定义内容的LOG -->
<layout class="org.apache.log4j.PatternLayout">
<!--
%m 输出代码中指定的消息
%p 输出优先级，即 DEBUG ， INFO ， WARN ， ERROR ， FATAL
%r 输出自应用启动到输出该 log 信息耗费的毫秒数
%c 输出打了Log的类名，%c{1}从类名开始输出一个，

例如com.tongshida.Action，{1}时只输出Action,

{2}输出 tongshida.Action
%C 输出.Error(）方法所在的类。
%M 输出生成LOG的类当中的方法名称
%t 输出产生该日志事件的线程名
%n 输出一个回车换行符， Windows 平台为 “rn”,Unix 平台为 “n”
%d 输出日志时间点的日期或时间，默认格式为 ISO8601 ，也可以在

其后指定格式，比如： %d{yyyy MMM dd HH:mm:ss,SSS} ，输出类似：

2002 年 10 月 18 日 22 ： 10 ： 28 ， 921
%l 输出日志事件的发生位置，包括类目名、发生的线程，以及在代码中

的行数。
%[数值]p 输出的%p字符串长度小于[数值]时，补空格，默认右对齐，

前加-号，左对齐，这里也可以是%m等别的
%.[数值]p输出的%p字符串长度大于[数值]，后面切掉。
%[数值].[数值]p 就是综合上两行。
-->
<!-- 输出时Log内容的具体定义 -->
<param name="ConversionPattern"

value="[%d{yyyy-MM-dd HH:mm:ss,SSS}][%-20c{1}]★%-5p★%m%n"/>
</layout>
</appender>

<!-- 输出通道"DEBUG"，输出方式是：只输出DEBUG级别的LOG，并文件

大小到达指定大小时产生新的Log文件 -->
<appender name="DEBUG" class="org.apache.log4j.RollingFileAppender">
<!-- 输出Log文件的路径和文件名 -->
<param name="File" value="logs/debug/debug.log"/>
<!-- TOMCAT等WEB服务器重新启动时，是否插入到原有的LOG文件里，

true 插入false 新建 -->
<param name="Append" value="true"/>

<!-- 只输出定义的级别以上的LOG,因为在下面过滤LOG信息所以屏蔽 -->
<!-- param name="Threshold" value="info"/ -->

<!-- 因选择了RollingFileAppender了才有下面两个 MaxFileSize，

MaxBackupIndex 选项 -->
<!-- MaxFileSize是一个LOG文件的最大的文件大小，当LOG文件超过这个

值时，自动转成 *.log.1的LOG文件 -->
<param name="MaxFileSize" value="500KB"/>
<!-- MaxBackupIndex生成自动转成 *.log.1的LOG文件的个数，设置3时最多

生成3个LOG备份文件，它们是[*.log.1][*.log.2][*.log.3] -->
<param name="MaxBackupIndex" value="2"/>
<!-- 输出时Log内容的具体定义 -->
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern"

value="[%d{yyyy-MM-dd HH:mm:ss,SSS}][%-20c{1}]★%-5p★%m%n"/>
</layout>
<!-- 过滤输出时Log内容，在这里，LevelMin，LevelMax都定义了DEBUG，

所以只输出DEBUG级别LOG的数据 -->
<filter class="org.apache.log4j.varia.LevelRangeFilter">
<!-- 指定输出LOG内容的最低等级 -->
<param name="LevelMin" value="DEBUG"/>
<!-- 指定输出LOG内容的最高等级 -->
<param name="LevelMax" value="DEBUG"/>
</filter>
</appender>
<!-- 输出通道"INFO"，输出方式是：只输出INFO级别的LOG，并文件大小

到达指定大小时产生新的Log文件 -->
<appender name="INFO" class="org.apache.log4j.RollingFileAppender">
<param name="File" value="logs/info/info.log"/>
<param name="Append" value="true"/>
<param name="MaxFileSize" value="500KB"/>
<param name="MaxBackupIndex" value="2"/>
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern"

value="[%d{yyyy-MM-dd HH:mm:ss,SSS}][%-20c{1}]★%-5p★%m%n"/>
</layout>
<filter class="org.apache.log4j.varia.LevelRangeFilter">
<param name="LevelMin" value="INFO"/>
<param name="LevelMax" value="INFO" />
</filter>
</appender>
<!-- 输出通道"WARN"，输出方式是：只输出WARN级别的LOG，并文件

大小到达指定大小时产生新的Log文件 -->
<appender name="WARN" class="org.apache.log4j.RollingFileAppender">
<param name="File" value="logs/warn/warn.log"/>
<param name="Append" value="true"/>
<param name="MaxFileSize" value="500KB"/>
<param name="MaxBackupIndex" value="2"/>
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern"

value="[%d{yyyy-MM-dd HH:mm:ss,SSS}][%-20c{1}]★%-5p★%m%n"/>
</layout>
<filter class="org.apache.log4j.varia.LevelRangeFilter">
<param name="LevelMin" value="WARN"/>
<param name="LevelMax" value="WARN"/>
</filter>
</appender>
<!-- 输出通道"ERROR"，输出方式是：只输出ERROR级别的LOG，并文件

大小到达指定大小时产生新的Log文件 -->
<appender name="ERROR" class="org.apache.log4j.RollingFileAppender">
<param name="File" value="logs/error/error.log"/>
<param name="Append" value="true"/>
<param name="MaxFileSize" value="500KB"/>
<param name="MaxBackupIndex" value="2"/>
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern"

value="[%d{yyyy-MM-dd HH:mm:ss,SSS}][%-20c{1}]★%-5p★%m%n"/>
</layout>
<filter class="org.apache.log4j.varia.LevelRangeFilter">
<param name="LevelMin" value="ERROR"/>
<param name="LevelMax" value="ERROR"/>
</filter>
</appender>
<!-- 输出通道"FATAL"，输出方式是：只输出INFO级别的LOG，并文件大小

到达指定大小时产生新的Log文件 -->
<appender name="FATAL" class="org.apache.log4j.RollingFileAppender">
<param name="File" value="logs/fatal/fatal.log"/>
<param name="Append" value="true"/>
<param name="MaxFileSize" value="500KB"/>
<param name="MaxBackupIndex" value="2"/>
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern"

value="[%d{yyyy-MM-dd HH:mm:ss,SSS}][%-20c{1}]★%-5p★%m%n"/>
</layout>
<filter class="org.apache.log4j.varia.LevelRangeFilter">
<param name="LevelMin" value="FATAL"/>
<param name="LevelMax" value="FATAL"/>
</filter>
</appender>
<!-- 输出通道"ALL"，输出方式是：输出所有级别的LOG，并文件大小到达

指定大小时产生新的Log文件 -->
<appender name="ALL" class="org.apache.log4j.RollingFileAppender">
<param name="File" value="logs/all/all.log"/>
<param name="Append" value="true"/>
<param name="MaxFileSize" value="500KB"/>
<param name="MaxBackupIndex" value="2"/>
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern"

value="[%d{yyyy-MM-dd HH:mm:ss,SSS}][%-20c{1}]★%-5p★%m%n"/>
</layout>
<filter class="org.apache.log4j.varia.LevelRangeFilter">
<param name="LevelMin" value="DEBUG"/>
<param name="LevelMax" value="FATAL"/>
</filter>
</appender>
<!-- 输出通道"EVERYDAY"，输出方式是：输出所有级别的LOG，并每天一个

日志文件 -->
<appender name="EVERYDAY" class="org.apache.log4j.DailyRollingFileAppender">
<param name="File" value="logs/ereryday/ereryday.log"/>
<param name="Append" value="true"/>
<!-- param name="Threshold" value="DEBUG"/ -->
<!-- 以日为单位输出LOG文件，每日输出一个LOG文件-->
<param name="DatePattern" value="'.'yyyy-MM-dd"/>
<!-- 以时为单位输出LOG文件，每小时输出一个LOG文件
<param name="DatePattern" value="'.'yyyy-MM-dd-HH"/>
-->
<layout class="org.apache.log4j.PatternLayout">
<!-- The default pattern: Date Priority [Category] Message -->
<param name="ConversionPattern"

value="[%d{yyyy-MM-dd HH:mm:ss,SSS}][%-20c{1}]★%-5p★%m%n"/>
<!-- The full pattern: Date MS Priority [Category] (Thread:NDC)

Message <param name="ConversionPattern"

value="%d %-5r %-5p [%c] (%t:%x) %m%n"/>
-->
</layout>
<!-- 过滤输出时Log内容，在这里，LevelMin是DEBUG，LevelMax都FATAL，

所以输出DEBUG级别到FATAL级别的LOG数据 -->
<filter class="org.apache.log4j.varia.LevelRangeFilter">
<param name="LevelMin" value="DEBUG"/>
<param name="LevelMax" value="FATAL"/>
</filter>
</appender>

<!-- 输出通道"DATABASE"，输出方式是：输出所有级别的LOG到数据库 -->
<appender name="DATABASE" class="org.apache.log4j.jdbc.JDBCAppender">
<!--数据库的驱动，这里用的是MSSQL-->
<param name="driver" value="com.microsoft.jdbc.sqlserver.SQLServerDriver"/>
<!--这是Oracle用的驱动，在这里用MSSQL所以屏蔽掉了
<param name="driver" value="oracle.jdbc.driver.OracleDriver" />
-->
<!--要连接的数据库-->
<param name="URL"

value="jdbc:microsoft:sqlserver://192.168.0.120:

1433;DatabaseName=test" />
<!--连接数据库的用户名-->
<param name="user" value="sa" />
<!--连接数据库的密码-->
<param name="password" value="sa" />
<!--向MSSQL数据库表LOG中插入数据的sql语句-->
<param name="sql" value=" INSERT INTO LOG

(LOGDATE,LOGLEVEL,LOGCLASS,LOGLOGGER,LOGMESSAGE)

values ('%d{yyyy-MM-dd HH:mm:ss}','%.50p', '%.50c',

'%.50l', '%.1000m')"/>



<!-- Oracle 的 insert 语句
<param name="sql" value=" insert into logrecord

(id,packageid,userid,syscodeid,info,logtime,loglevel)

values(?,?,?,?,?,to_date('%d{yyyy-MM-dd HH:mm:ss}',

'yyyy-MM-dd HH24:mi:ss'),'%p')" />
-->
<!-- 过滤输出时Log内容，在这里，LevelMin是ERROR，LevelMax都

FATAL，所以输出DEBUG级别到FATAL级别的LOG数据 -->
<filter class="org.apache.log4j.varia.LevelRangeFilter">
<param name="LevelMin" value="ERROR"/>
<param name="LevelMax" value="FATAL"/>
</filter>
</appender>

<!-- 输出通道"HTML"，输出方式是：输出所有级别的LOG到数据库 -->
<appender name="HTML" class="org.apache.log4j.RollingFileAppender">

<param name="File" value="logs/html/htmllog.html" />
<param name="Append" value="true" />

<!-- 只输出定义的级别以上的LOG,因为在下面过滤LOG信息所以屏蔽 -->
<!-- param name="Threshold" value="info"/ -->
<param name="MaxFileSize" value="50KB"/>
<param name="MaxBackupIndex" value="2"/>
<!-- 好像现在只有固定输出格式 -->
<!-- 输出的HTML都缺少</table></body>等代码，log4j的Bug？

我建议是不要使用 -->
<layout class="org.apache.log4j.HTMLLayout">
<param name="Title" value="TSD HP HTML LOG" />
</layout>
<filter class="org.apache.log4j.varia.LevelRangeFilter">
<param name="LevelMin" value="DEBUG"/>
<param name="LevelMax" value="FATAL"/>
</filter>
</appender>

<!-- 设置域名限制，即com.tongshida域及以下的日志均输出到下面

对应的通道中, 虽然下面<roo>的<priority value="ERROR">设置

成ERROR，但com.tongshida下面的程序中的LOG要输出

level="DEBUG"的 DEBUG级别以上的LOG-->
<!--给客户交货时要把它屏蔽-->
<logger name="com.tongshida">
<!-- 设置com.tongshida以下函数输出LOG的级别 -->
<level value="DEBUG"/>
<!-- 好像是指定输出通道，因为下面root里指定了所以这里屏蔽掉了
<appender-ref ref="DEBUG"/>
-->
</logger>

<root>
<!-- 设置输出范围，在这里光输出ERROR以上的，ERROR级别，

FATAL级别的LOG -->
<priority value="ERROR"/>
<!-- 上边设置的输出通道，使用的在这里定义 -->
<appender-ref ref="STDOUT"/>
<appender-ref ref="DEBUG"/>
<appender-ref ref="INFO"/>
<appender-ref ref="WARN"/>
<appender-ref ref="ERROR"/>
<appender-ref ref="FATAL"/>
<appender-ref ref="ALL"/>
<appender-ref ref="EVERYDAY"/>
<appender-ref ref="DATABASE"/>
<appender-ref ref="HTML"/>

</root>
</log4j:configuration>



６．Log4j在Java程序里的使用。
Logger log = Logger.getLogger(inputClass);
//输出到数据库时有"'"会出错所以把它换成全角
String outmessage = message.replaceAll("'", "’");
log.debug(outmessage);log.error(outmessage);log.warn(outmessage);
如想要动态输出LOG（更改输出目录和文件名），也就是强制改变读到
内存中的[Log4j.xml]里的相应输出目录和文件名。鉴于篇幅没能写下。

７．MSSQL_log_table_Creater.sql
CREATE TABLE [LOG] (
ID INTEGER NOT NULL PRIMARY KEY,
LOGDATE DATETIME,
LOGTIME TIMESTAMP,
LOGTHREAD VARCHAR(50),
LOGLEVEL VARCHAR(50),
LOGCLASS VARCHAR(50),
LOGLOGGER VARCHAR(200),
LOGMESSAGE VARCHAR(2000)
)