Log4j のコンポーネント構成
Log4j は、次の 3 つの重要なコンポーネントで構成されます。
1. ログ情報の優先順位 (Logger)
2. ログ情報の出力先 (Appender)
3.ログ情報 (レイアウト)。
概要:
ログ情報の優先順位は高いものから低いものまで、ERROR、WARN、INFO、DEBUG があり、それぞれこのログ情報の重要性を指定します。
ログ情報の出力先は、ログは出力されます。コンソールはまだファイル内にあります。出力形式はログ情報の表示内容を制御します。
Log4j の概要
Log4j は Apache のオープンソース プロジェクトであり、Log4j を使用すると、コンソール、ファイル、GUI コンポーネント、さらにはソケット サーバー、NT イベント レコーダー、UNIX Syslog デーモンなどへのログ情報の送信先を制御できます。各ログ情報のレベルを定義することで、ログの生成プロセスをより詳細に制御することもできます。 log4j--java のログ (Java ログ)。
Log4j のダウンロード アドレス: http://logging.apache.org/log4j/2.x/download.html
Log4j 設定ファイル形式
Log4j は 2 つのタイプの設定ファイルをサポートします形式:
1. XML 形式のファイル
2. プロパティ形式のファイル
構成ファイルをまったく使用せずに、コード内で Log4j 環境を構成することもできます。ただし、構成ファイルを使用すると、アプリケーションがより柔軟になります。
Log4j 定義設定ファイル
1. ルート Logger を設定します
構文は次のとおりです:
log4j.rootLogger = [ level ] , appenderName, appenderName, …
パラメータの説明:
level はログの優先度であり、OFF、FATAL、ERROR、WARN、INFO、DEBUG、ALL に分かれています。またはあなたが定義したレベル。
オフ: すべてのログ記録をオフにするために使用される最高レベルです。
致命的: 重大なエラー イベントが発生するたびにアプリケーションが終了することを示します。
エラー: エラー イベントが発生しても、システムの継続的な動作には影響がないことを示します。
警告: 潜在的なエラー状況が発生することを示します
情報: 通常は粗粒度レベルで使用され、アプリケーションの実行プロセス全体が強調されます
デバッグ: 通常は粗粒レベルで使用され、実行プロセス全体が強調されますアプリケーションの。
All: すべてのログをオンにするために使用される最低レベル。
Log4j は、高から低まで、ERROR、WARN、INFO、DEBUG の 4 つのレベルのみを使用することをお勧めします。ここで定義したレベルを通じて、アプリケーション内の対応するレベルへのログ情報の切り替えを制御できます。
appenderNameはログ情報の出力先を指し、出力先は同時に複数指定可能です。
2. ログ情報の出力先 Appender を設定します
構文は次のとおりです:
log4j.appender.appenderName = fully.qualified.name.of.appender.class log4j.appender.appenderName.option1 = value1 ... log4j.appender.appenderName.option = valueN
Log4j が提供するアペンダーは次のとおりです:
org.apache.log4j.ConsoleAppender (console)
org.apache.log4j。 (ファイル)
org.apache.log4j.DailyRollingFileAppender (毎日ログファイルを生成します)
org.apache.log4j.RollingFileAppender (ファイルサイズが指定したサイズに達したときに新しいファイルを生成します)
org.apache.log4j .WriterAppender (ログ情報をストリーム形式で指定した場所に送信します)
3. ログ情報の形式を設定します
構文は次のとおりです:
log4j.appender.appenderName.layout = fully.qualified.name.of.layout.class log4j.appender.appenderName.layout.option1 = value1 … log4j.appender.appenderName.layout.option = valueN
Log4j によって提供されるレイアウトは次のとおりです:
org .apache .log4j.HTMLLayout (HTMLテーブル形式のレイアウト)、
org.apache.log4j.PatternLayout (レイアウトモードを柔軟に指定可能)、
org.apache.log4j.SimpleLayout (ログのレベルと情報文字列が含まれます)情報)、
org.apache.log4j.TTCCLayout (ログ生成時間、スレッド、カテゴリなどの情報が含まれます)
Log4J は、C 言語の printf 関数に似た出力形式を使用して、ログ情報をフォーマットします。
% m コードで指定されたメッセージを出力します。
%p 出力の優先順位、つまり DEBUG、INFO、WARN、ERROR、FATAL
%r アプリケーションの起動から終了までにかかるミリ秒数を出力します。ログ情報を出力します。
%c 所属するクラスを出力します。 オブジェクトは通常、クラスの完全名です。
%t は、ログイベントを生成したスレッドの名前を出力します。
%n は、キャリッジリターンを出力します。 Windows プラットフォームは「rn」、Unix プラットフォームは「n」です。
%d 出力 ログ時点の日付または時刻。デフォルトの形式は ISO8601 です。後で形式を指定することもできます。例: %d{yyy MMM dd HH:mm:ss,SSS}、出力は次のようになります: October 18, 2002 22:10 :28,921
%l ログ イベントが発生した場所 (カテゴリ名、発生したスレッドとコードの行数。例: Testlog4.main(TestLog4.java:10)
%x: 現在のスレッドに関連付けられた NDC (ネストされた診断環境) を出力します。特に Java サーブレットのようなマルチクライアントおよびマルチスレッド アプリケーションで使用されます。
%%: "%" 文字を出力 %F: ログメッセージが生成されるファイル名を出力
%L: コード内の行番号を出力
%m: コード内で指定されたメッセージを出力、生成された特定のログ 情報
%n: キャリッジ リターンとライン フィード文字を出力します。これは、Windows プラットフォームでは「rn」、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.xml的配置方式
View Code <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE log4j:configuration SYSTEM "log4j.dtd"> <log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/"> <appender name="appender1" class="org.apache.log4j.RollingFileAppender"> <param name="File" value="logfile08.html" /> <param name="MaxFileSize" value="1MB" /> <param name="MaxBackupIndex" value="5" /> <layout class="org.apache.log4j.HTMLLayout"> </layout> </appender> <root> <level value="debug" /> <appender-ref ref="appender1" /> </root> </log4j:configuration>
代码中使用Log4j
在程序中使用 Log4j之前,首先要将commons-logging.jar和logging-log4j-1.2.9.jar导入到classpath中,并将 log4j.properties放于src根目录中。 在类中使用log4j,首先声明一个静态变量 Logger logger=Logger.getLog("classname").现在就可以使用了。
用法如下:logger.debug("debug message")或者logger.info("info message").
1.得到记录器
使用Log4j,第一步就是获取日志记录器,这个记录器将负责控制日志信息。
其语法为:
public static Logger getLogger( String name)
通过指定的名字获得记录器,如果必要的话,则为这个名字创建一个新的记录器。Name一般取本类的名字,比如:
static Logger logger = Logger.getLogger ( ServerWithLog4j.class.getName () )
2.读取配置文件
当获得了日志记录器之后,第二步将配置Log4j环境,其语法为:
BasicConfigurator.configure (): 自动快速地使用缺省Log4j环境。
PropertyConfigurator.configure ( String configFilename) :读取使用Java的特性文件编写的配置文件。
DOMConfigurator.configure ( String filename ) :读取XML形式的配置文件。
3.插入记录信息(格式化日志信息)
当上两个必要步骤执行完毕,您就可以轻松地使用不同优先级别的日志记录语句插入到您想记录日志的任何地方,语法如下:
Logger.debug ( Object message ) ;
Logger.info ( Object message ) ;
Logger.warn ( Object message ) ;
Logger.error ( Object message ) ;
程序演示
1.使用程序进行日志信息输出
package org.demo.log4j.dennisit; import java.io.IOException; import org.apache.commons.logging.impl.Log4JLogger; import org.apache.log4j.BasicConfigurator; import org.apache.log4j.FileAppender; import org.apache.log4j.Layout; import org.apache.log4j.Level; import org.apache.log4j.Logger; import org.apache.log4j.SimpleLayout; /** * * @version : 1.1 * * @author : 苏若年 <a href="mailto:DennisIT@163.com">发送邮件</a> * * @since : 1.0 创建时间: 2013-1-1 下午03:19:42 * * @function: 通过代码将日志输出 * */ public class Log4jPrintByCode { private static Logger logger = Logger.getLogger(Log4jPrintByCode.class); private Layout layout = new SimpleLayout(); private FileAppender fileAppender; //使用构造依赖,创建对象时初始化 public Log4jPrintByCode(Layout layout, Level level,String distDir){ BasicConfigurator.configure(); //使用默认的配置信息,不需要写log4j.properties try { init(layout,level, distDir); } catch (Exception e) { e.printStackTrace(); } } public void init(Layout layout, Level level,String distDir) throws Exception{ logger.setLevel(level); //设置日志输出级别 fileAppender = new FileAppender(layout,distDir,false); logger.addAppender(fileAppender); //添加输出端 } public static void main(String[] args) { SimpleLayout layout = new SimpleLayout(); String logDir = "log4jcode.Log"; Log4jPrintByCode log4jCode = new Log4jPrintByCode(layout,Level.INFO,logDir); //下面信息将被输出 log4jCode.logger.info("log info print by log4j"); log4jCode.logger.warn("log warn print by log4j"); log4jCode.logger.error("log error print by log4j"); } public Layout getLayout() { return layout; } public void setLayout(Layout layout) { this.layout = layout; } public FileAppender getFileAppender() { return fileAppender; } public void setFileAppender(FileAppender fileAppender) { this.fileAppender = fileAppender; } }
为了提高效率,我们可以在写日志前增加判断:
// 记录debug级别的信息 if (logger.isDebugEnabled()) { logger.debug("This is debug message from Dao."); } // 记录info级别的信息 if (logger.isInfoEnabled()) { logger.info("This is info message from Dao."); }
如果这个类作为基类,如J2EE中的BaseDao、BaseAction、BaseService等等,则我们可以将各层的日志信息分类输出到各个文件。
2.Log4J将同一个日志信息输出到多个目的地
/* 创建数据库 */ create database db_log4j; /* 切换数据库 */ use db_log4j; /* 日志信息表 */ create table tb_log( logId int not null auto_increment comment '流水号' , createDate varchar(45) default null comment '日志生成时间' , thread varchar(45) default null comment '当前线程', level varchar(45) default null comment '当前日志级别' , class varchar(45) default null comment '生成日志的类', message varchar(245) default null comment '日志具体信息', primary key(logId) );
应用实例将日志信息同时输出到控制台,文件和数据库中.
创建数据库与 表
/* 创建数据库 */ create database db_log4j; /* 切换数据库 */ use db_log4j; /* 日志信息表 */ create table tb_log( logId int not null auto_increment comment '流水号' , createDate varchar(45) default null comment '日志生成时间' , thread varchar(45) default null comment '当前线程', level varchar(45) default null comment '当前日志级别' , class varchar(45) default null comment '生成日志的类', message varchar(245) default null comment '日志具体信息', primary key(logId) );
配置文件log4j.properties
#定义3个输出端 log4j.rootCategory=INFO,A1,A2,A3 #定义A1输出到控制器 log4j.appender.A1=org.apache.log4j.ConsoleAppender #定义A1的布局模式为PaternLayout log4j.appender.A1.layout=org.apache.log4j.PatternLayout # 定义A1的输出格式 log4j.appender.A1.layout.ConversionPattern=%4p [%t] (%F:%L) - %m%n #定义A2输出到文件 log4j.appender.A2=org.apache.log4j.RollingFileAppender #定义A2输出到哪个文件 log4j.appender.A2.File=./log/sysLog.log #定义A2输出文件的最大长度 log4j.appender.A2.MaxFileSize = 1KB #定义A2的备份文件数 log4j.appender.A2.MaxBackupIndex = 3 #定义A2的布局模式为PatternLayout log4j.appender.A2.layout=org.apache.log4j.PatternLayout #定义A2的输出模式 log4j.appender.A2.layout.ConversionPattern=%d{yyyy-MM-dd hh:mm:ss}:%p %t %c - %m%n #定义A3输出到数据库 log4j.appender.A3=org.apache.log4j.jdbc.JDBCAppender log4j.appender.A3.URL=jdbc:mysql://localhost:3306/db_log4j log4j.appender.A3.driver=com.mysql.jdbc.Driver log4j.appender.A3.user=root log4j.appender.A3.password=root #定义A3的布局和执行的SQL语句 log4j.appender.A3.layout=org.apache.log4j.PatternLayout log4j.appender.A3.layout.ConversionPattern=INSERT INTO tb_log(createDate,thread,level,class,message) values('%d','%t','%-5p','%c','%m')
Java测试代码
package org.demo.log4j.dennisit; import org.apache.log4j.Logger; import org.apache.log4j.PropertyConfigurator; /** * * @version : 1.1 * * @author : 苏若年 <a href="mailto:DennisIT@163.com">发送邮件</a> * * @since : 1.0 创建时间: 2013-1-1 下午04:13:59 * * @function: 通过配置文件控制日志信息输出到多个目的端 * */ public class Log4jPrintByConfigure { private static Logger logger = Logger.getLogger(Log4jPrintByConfigure.class); public static void main(String[] args) throws Exception { //加载log配置文件log4j.properties PropertyConfigurator.configure("configure/log4j.properties");//文件存放在src同目录的configure文件夹下 //如果放在src下的话,参数应为"bin/log4j.properties"或者"src/log4j.properties", 建议以bin为准 //以下信息将被打印输出 logger.debug("logger print DEBUG messgae"); logger.info("logger print INFO message"); logger.warn("logger print WARN message"); logger.error("logger print ERROR message"); logger.fatal("Here is FATAL message"); } }
更多使用Log4j为项目配置日志输出应用详解以及示例演示的实现分析相关文章请关注PHP中文网!