Coder 爱翻译 How Tomcat Works 第七章
Chapter 7: Logger
日志是一个记录信息的组件。在Catalina中，它容器相关联的日志比其它组件相对简单得多。Tomcat在org.apache.catalina.logger包下提供多种类型的日志。
本章有三个部分：第一部分包括org.apache.catalina.Logger接口，所有的日志组件都必须实现这个接口。第二部分介绍了在Tomcat中的日志，第三章详细讲述了本章的应用程序使用Tomcat的日志。
The Logger Interface
一个日志必须实现org.apache.catalina.Logger接口：
Listing 7.1: The Logger interface package org.apache.catalina; import java.beans.PropertyChangeListener; public interface Logger { public static final int FATAL = Integer.MIN_VALUE; public static final int ERROR = 1; public static final int WARNING = 2; public static final int INFORMATION = 3; public static final int DEBUG = 4; public Container getContainer(); public void setContainer(Container container); public String getInfo(); public int getVerbosity(); public void setVerbosity(int verbosity); public void addPropertyChangeListener(PropertyChangeListener listener); public void log(String message); public void log(Exception exception, String msg); public void log(String message, Throwable throwable); public void log(String message, int verbosity); public void log(String message, Throwable throwable, int verbosity); public void removePropertyChangeListener(PropertyChangeListener listener); } Logger接口提供许多log方法供实现类选择调用。这些方法中最简单的方法是接受一个字符串，这个字符串被用来当做记录信息。
最后两个log方法接收一个详细记录级别。如果传递的这个数比这个类实例设置的详细记录级别低，这个信息就会被记录下来。否则，这个信息会被忽略。这里用public Static变量定义了5个详细记录级别：FATAL, ERROR, WARNING, INFORMATION和DEBUG。而getVerbosity和setVerbosity方法用来获取和设置相应的值。
此外，Logger接口有getContainer和setContainer方法把一个Logger实例和一个容器相关联起来。它也提供addPropertyChangeListener和removePropertyChangeListener方法，来增加和移除一个PropertyChangeListener。
当你看见在Tomcat中的logger类的实现，这些方法将会更清楚，容易理解。
Tomcat's Loggers
Tomcat提供三个日志记录类：FileLogger, SystemErrLogger和SystemOutLogger。这些类都在org.apache.catalina.logger包下面，且它们都继承自org.apache.catalina.logger.LoggerBase类。在Tomcat 4中，LoggerBase类实现了org.apache.catalina.Logger接口。在Tomcat 5中，它也实现了Lifecycle和MbeanRegistration。类图：
The LoggerBase Class
在Tomcat 5中，LoggerBase类相当复杂，因为它包含了创建MBeans的代码。这里我们看Tomcat 4中的LoggerBase类。
在Tomcat 4中，LoggerBase类是一个抽象类，它提供Logger接口的所有方法实现，除了
log(String msg)方法。
public abstract void log(String msg);
这个方法重载是在子类中记录信息。而其他所有的log方法重载都调用这个重载。因为每一个子类把记录信息记录到不同的地方，所以这个在LoggerBase类的方法重载为空。
现在看看这个类的详细记录等级。它通过一个protected的叫做verbosity的变量来定义的。ERROR是它的默认值：
protected int verbosity = ERROR;
详细记录等级可以通过调用setVerbosity方法来改变等级。传递下面的字符串：FATAL, ERROR, WARNING, INFORMATION或DEBUG。
Listing 7.2: The setVerbosity method public void setVerbosityLevel(String verbosity) { if ("FATAL".equalsIgnoreCase(verbosity)) this.verbosity = FATAL; else if ("ERROR".egualsIgnoreCase(verbosity)) this.verbosity = ERROR; else if ("WARNING".equalsIgnoreCase(verbosity)) this.verbosity = WARNING; else if ("INFORMATION".equalsIgnoreCase(verbosity)) this.verbosity = INFORMATION; else if ("DEBUG".equalsIgnoreCase(verbosity)) this.verbosity = DEBUG; }有两个log方法接收一个整型作为详细记录等级。在这些方法重载中，如果传递给详细记录等级的值比实例的详细记录的等级低时，log(String message)这个方法重载会被调用。
Listing 7.3: The log method overloads that accept verbosity public void log(String message, int verbosity) { if (this.verbosity >= verbosity) log(message); } public void log(String message, Throwable throwable, int verbosity) { if (this.verbosity >= verbosity) log(message, throwable); } 下面我们讨论LoggerBase类的三个子类，你将看到log(String message)方法重载的实现。
The SystemOutLogger Class
LoggerBase类的子类提供了log(String message)方法重载的实现。每一个接收的message会被传递给System.out.println方法。
Listing 7.4: The SystemOutLogger Class package org.apache.catalina.logger; public class SystemOutLogger extends LoggerBase { protected static final String info = "org.apache.catalina.logger.SystemOutLogger/1.0"; public void log(String msg) { System.out.println(msg); } } The SystemErrLogger Class
这个类和SystemOutLogger相似。除了传递给log(String message)方法的重载的message参数的调用,message会传递给System.err.println()方法。
Listing 7.5: The SystemErrLogger class package org.apache.catalina.logger; public class SystemErrLogger extends LoggerBase { protected static final String info = "org.apache.catalina.logger.SystemErrLogger/1.0"; public void log(String msg) { System.err.println(msg); } } The FileLogger Class
FileLogger类是LoggerBase的最复杂的子类。它把接收到的信息写入一个文件。每个信息可以被标记上时间戳。当首先初始化时，这个类的实例创建一个文件，它的名字包含当天的日期信息。如果日期变化了，它将为这个新日期创建一个新的文件，然后记录下所有信息。这个类实例允许你添加一个前缀和后缀给日志文件的名字。
在Tomcat 4中。FileLogger类实现了Lifecycle接口，所以它可以被实现了org.apache.catalina.Lifecycle接口的任意组件来启动和停止它。在Tomcat 5中，LoggerBase类(FileLogger的父类)实现了Lifecycle。
在tomcat 4中LoggerBase(继承Lifecycle接口)类的start和stop方法只是触发了监听器相关的生命周期事件的启动和停止事件。注意stop方法也调用了private close方法关闭日志文件。
Listing 7.6: The start and stop methods public void start() throws LifecycleException { // Validate and update our current component state if (started) throw new LifecycleException (sm.getString("fileLogger.alreadyStarted")); lifecycle.fireLifecycleEvent(START_EVENT, null); started = true; } public void stop() throws LifecycleException { // Validate and update our current component state if (!started) throw new LifecycleException (sm.getString("fileLogger.notStarted")); lifecycle.fireLifecycleEvent(STOP__EVENT, null); started = false; close (); } FileLogger类的最重要的方法是log方法。
Listing 7.7: The log method public void log(String msg) { // Construct the timestamp we will use, if reguested Timestamp ts = new Timestamp(System.currentTimeMillis()); String tsString = ts.toString().substring(0, 19); String tsDate = tsString.substring(0, 10); // If the date has changed, switch log files if (!date.equals(tsDate)) { synchronized (this) { if (!date.equals(tsDate)) { close (); date = tsDate; open (); } } } // Log this message, timestamped if necessary if (writer != null) { if (timestamp) { writer.println(tsString + " " + msg); } else { writer.println(msg); } } }log方法接收一个message，并写入到日志文件。在FileLogger实例的生命周期期间，log方法可能打开和关闭多个日志文件。典型地，如果日期变化了，log方法通过关闭当前文件，并打开一个新的文件来交替日志文件。让我们看下open、close和log方法怎么工作。
The open method
open方法在制定的目录中创建一个新的log文件。
Listing 7.8: The open method private void open() { // Create the directory if necessary File dir = new File(directory); if (!dir.isAbsolute()) dir = new File(System.getProperty("catalina.base"), directory); dir.mkdirs(); // Open the current log file try { String pathname = dir.getAbsolutePath() + File.separator + prefix + date + suffix; writer = new PrintWriter(new FileWriter(pathname, true), true); } catch (IOException e) { catch (IOException e) { writer = null; } } open方法首先检查创建日志文件的目录是否存在。如果这个目录不存在，这个方法也创建这个目录。这个目录被存储在类变量directory。
File dir = new File(directory); if (!dir.isAbsolute()) dir = new File(System.getProperty("catalina.base"), directory); dir.mkdirs();然后它路径的文件打开，前缀当前日期和后缀。
try ( String pathname = dir.getAbsolutePath() + File.separator + prefix + date + suffix;
接下来，它构建一个java.io.PrintWriter实例，它的writer是一个记录了路径名的java.io.FileWriter对象。然后PrintWriter实例指配给类变量writer。log方法使用writer来记录message。
writer = new PrintWriter(new FileWriter(pathname, true), true);
The close method
close方法刷新PrintWriter的writer，刷新它的内容，关闭PrintWriter，把PrintWriter设置为null，并设置日期为一个空字符串。
Listing 7.9: The close method private void close() { if (writer == null) return; writer.flush(); writer.close(); writer = null; date = ""; } The log method
log方法通过创建一个java.sql.Timestamp类的实例开始。这个Timestamp类是一个java.util.Date类的轻微包装。在log方法里实例化Timestamp类的目是为了更容易获取当前日期。log方法用传递一个用long长整型表示的当前时间给Timestamp类的构造器来构建一个TimeStamp实例。
Timestamp ts = new Timestamp(System.currentTimeMillis());
使用Timestamp的toString方法，你可以获取当前日期的字符串表现形式。toString方法的输出下面格式：
yyyy-mm-dd hh:mm: SS.fffffffff
fffffffff表示从00:00:00经过的毫秒数。要获取日期和小时，log方法调用substring方法：
String tsString = ts.toString().substring(0, 19);
然后，从tsString获取日期部分，log方法使用下面方法：
String tsDate = tsString.substring(0, 10);
然后log方法比较tsDate和初始化为空字符串的String变量date，如果tsDate的值和date变量不相同，它就关闭当前日志文件，指配tsDate的值给date，打开这个新的日志文件。
// If the date has changed, switch log files if (!date.equals(tsDate)) { synchronized (this) { if (!date.equals(tsDate)) { close(); date = tsDate; open(); } } }最后，log方法把输出流PrintWriter实例写入日志文件。如果timestamp的变量值是true，它给信息加上时间戳前缀（tsString）。否则，它记录的信息，不加时间戳前缀。
// Log this message, timestamped if necessary if (writer != null) { if (timestamp) { writer.println(tsString + " " + msg); } else { writer.println(msg); } }The Application
和第六章的应用程序类似。除了你有一个SimpleContext对象相关的FileLogger。
Listing 7.10: The Bootstrap class package ex07.pyrmont.startup; import ex07.pyrmont.core.SimpleContext; import ex07.pyrmont.core.SimpleContextLifecycleListener; import ex07.pyrmont.core.SimpleContextMapper; import ex07.pyrmont.core.SimpleLoader; import ex07.pyrmont.core.SimpleWrapper; import org.apache.catalina.Connector; import org.apache.catalina.Context; import org.apache.catalina.Lifecycle; import org.apache.catalina.LifecycleListener; import org.apache.catalina.Loader; import org.apache.calalina.loggor.FileLogger; import org.apache.catalina.Mapper;import org.apache.catalina.Wrapper; import org.apache.catalina.connector.http.HttpConnector; public final class Bootstrap { public static void main(String[] args) { Connector connector = new HttpConnector(); Wrapper Wrapper1 = new SimpleWrapper(); Wrapper1.setName("Primitive"); Wrapper1.setServletClass("PrimitiveServlet"); Wrapper wrapper2 = new SimpleWrapper(); wrapper2.setName("Modern"); Wrapper2.setServletClass("ModernServlet"); Loader loader = new SimpleLoader(); Context context = new SimpleContext(); context.addChild(wrapper1); context.addChild(wrapper2); Mapper mapper = new SimpleContextMapper(); mapper.setProtocol("http"); LifecycleListener listener = new SimpleContextLifecycleListener(); ((Lifecycle) context).addLifecycleListener(listener); context.addMapper(mapper); context.setLoader(loader); // context.addServletMapping(pattern, name); context.addServletMapping("/Primitive", "Primitive"); context.addServletMapping("/Modern", "Modern");// ------ add logger -------- System.setProperty("catalina.base", System.getProperty("user.dir")); FileLogger logger = new FileLogger(); logger.setPrefix("FileLog_"); logger.setSuffix(".txt"); logger.setTimestamp(true); logger.setDirectory("webroot"); context.setLogger(logger); //-------------------------- connector.setContainer(context); try { connector.initialize(); ((Lifecycle) connector).start(); ((Lifecycle) context).start(); // make the application wait until we press a key. System.in.read(); ((Lifecycle) context).stop(); } catch (Exception e) { e.printStackTrace(); } } }第七章 完