上文提到過(guò)，LogRecord可以理解為是一個(gè)DTO，那么LogRecord里面到底存儲(chǔ)了哪些數(shù)據(jù)呢？我們可以看一下LogRecord類(lèi)中含有哪些get/set方法，get方法如下所示：

Level getLevel()
String getLoggerName()
String getMessage()
long getMillis()
Object[] getParameters()
ResourceBundle getResourceBundle()
String getResourceBundleName()
long getSequenceNumber()
String getSourceClassName()
String getSourceMethodName()
int getThreadID()
Throwable getThrown()

每個(gè)get方法都有相應(yīng)的set方法。

在記錄日志的過(guò)程中可以直接使用LogRecord對(duì)象，也可以不直接使用LogRecord對(duì)象，而是由日志組件內(nèi)部為我們自動(dòng)組裝成一個(gè)LogRecord對(duì)象。我們之前通過(guò)logger.info這一類(lèi)方法記錄日志時(shí)，內(nèi)部會(huì)根據(jù)我們傳入的參數(shù)以及調(diào)用的方法自動(dòng)組裝成一個(gè)LogRecord對(duì)象。例如：

logger.info("Hello")

該方法首先轉(zhuǎn)調(diào)方法logger.log(Level.INFO, “Hello”),該方法內(nèi)部自動(dòng)幫我們創(chuàng)建了LogRecord：

public void log(Level level, String msg) {
    if (!isLoggable(level)) {
        return;
    }
    LogRecord lr = new LogRecord(level, msg);
    doLog(lr);
}

LogRecord給我們提供了一個(gè)含有兩個(gè)參數(shù)的構(gòu)造方法，第一個(gè)參數(shù)指定需要記錄的信息的級(jí)別，第二個(gè)參數(shù)指定需要記錄的信息，即:

public LogRecord(Level level, String msg) {
    // Make sure level isn't null, by calling random method.
    level.getClass();
    this.level = level;
    message = msg;
    // Assign a thread ID and a unique sequence number.
    sequenceNumber = globalSequenceNumber.getAndIncrement();
    threadID = defaultThreadID();
    millis = System.currentTimeMillis();
    needToInferCaller = true;
}

當(dāng)然我們也可以直接構(gòu)造LogRecord對(duì)象，然后通過(guò)Logger.log(LogRecord record)方法來(lái)記錄日志，如下所示：

public class JavaLogging {
    private static final Logger logger = Logger.getLogger(JavaLogging.class.getName());
    public static void main(String[] args) {
        LogRecord infoLogRecord = new LogRecord(Level.INFO, "info");
        LogRecord severeLogRecord = new LogRecord(Level.SEVERE, "severe");
        logger.log(infoLogRecord);
        logger.log(severeLogRecord);
    }
}

但這樣做顯然不太方便，還是通過(guò)logger.info，logger.warning這一類(lèi)方法來(lái)記錄日志更簡(jiǎn)便，當(dāng)然這一類(lèi)方法也有他們的局限處，比如無(wú)法傳遞Throwable類(lèi)型的異常信息等。
getLevel()方法返回的就是當(dāng)前日志信息的級(jí)別，即通過(guò)logger.info方法調(diào)用時(shí)，當(dāng)前日志信息的級(jí)別為INFO級(jí)別，通過(guò)logger.severe方法調(diào)用時(shí)，當(dāng)前日志信息級(jí)別為SEVERE級(jí)別。JUL中的級(jí)別涉及如下三個(gè)方面：

• 日志記錄器(Logger)的級(jí)別
• 當(dāng)前需要記錄的日志信息（message）的級(jí)別
• 真正執(zhí)行日志記錄操作的Handler的級(jí)別

我們是要將當(dāng)前需要記錄的日志信息的級(jí)別與日志記錄器Logger的級(jí)別以及Handler的級(jí)別相比較，只有高于或等于他們的信息才會(huì)被記錄。首先是與Logger的級(jí)別進(jìn)行比較，如果低于Logger的級(jí)別則直接不輸出，如果高于或等于Logger的級(jí)別，到真正執(zhí)行輸出時(shí)還需要跟Handler的級(jí)別進(jìn)行比較。

getLoggerName()方法是獲取當(dāng)前日志記錄器名字，日志記錄器名字就是調(diào)用Logger.getLogger(String name)方法時(shí)傳入的參數(shù)，在我們的例子中就是cn.codecrazy.study.JavaLogging。

getMillis()返回值默認(rèn)就是創(chuàng)建LogRecord對(duì)象時(shí)的當(dāng)前系統(tǒng)時(shí)間戳（從1970年到現(xiàn)在所經(jīng)過(guò)的毫秒數(shù)），millis屬性值是在LogRecourd的構(gòu)造方法中進(jìn)行賦值的。

getThrown()方法返回Throwable類(lèi)型的信息，即獲取異常信息，我們目前為止記錄的日志信息只是記錄一段message，并沒(méi)有記錄發(fā)生異常時(shí)的異常堆棧信息，要記錄這種類(lèi)型的信息，我們需要通過(guò)Logger.log()方法來(lái)進(jìn)行日志的記錄，Logger.log有幾種重載的方法，其中有一種就能傳遞Throwable信息，該方法如下所示:

public void log(Level level, String msg, Throwable thrown) {
    if (!isLoggable(level)) {
        return;
    }
    LogRecord lr = new LogRecord(level, msg);
    lr.setThrown(thrown);
    doLog(lr);
}

可以看到將傳入的Throwable類(lèi)型參數(shù)賦值給了LogRecord對(duì)象的thrown屬性，因此在LogRecord中通過(guò)getThrown()方法就能獲取到傳入的Throwable信息，最終可以對(duì)異常堆棧信息進(jìn)行輸出。示例代碼如下：

public class JavaLogging {
    private static final Logger logger = Logger.getLogger(JavaLogging.class.getName());
    public static void main(String[] args) {
        logger.log(Level.SEVERE, "error", new NullPointerException("NPE"));
    }
}

輸出為：

八月 10, 2018 9:02:42 下午 cn.codecrazy.study.JavaLogging main
嚴(yán)重: error
java.lang.NullPointerException: NPE
    at cn.codecrazy.study.JavaLogging.main(JavaLogging.java:11)

getSourceClassName()方法用來(lái)獲取記錄日志的操作是在哪個(gè)類(lèi)中進(jìn)行的，在我們的例子中該方法的返回值就是cn.codecrazy.study.JavaLogging。

getSourceMethodName()方法用來(lái)獲取記錄日志的操作是在哪個(gè)方法中進(jìn)行的，在我們的例子中該方法的返回值就是main。

需要注意一點(diǎn)的是，上述兩個(gè)方法所獲取的類(lèi)名和方法名有可能是不正確的。如果我們?cè)谟涗浫罩镜倪^(guò)程中沒(méi)有主動(dòng)設(shè)置這兩個(gè)屬性的值，那么這兩個(gè)屬性的值就會(huì)被自動(dòng)推斷出來(lái)，推斷出來(lái)的結(jié)果有可能就會(huì)出現(xiàn)偏差。我們可以看一下getSourceClassName()方法內(nèi)部實(shí)現(xiàn)：

    public String getSourceClassName() {
        if (needToInferCaller) {
            inferCaller();
        }
        return sourceClassName;
    }

可以看到如果needToInferCaller的值為true時(shí)，就會(huì)執(zhí)行inferCaller方法對(duì)發(fā)起記錄日志請(qǐng)求操作的類(lèi)名和方法名進(jìn)行推斷，關(guān)于如何推斷我們?cè)谶@里不進(jìn)行深入研究。
getSequenceNumber()為每一個(gè)LogRecord對(duì)象都賦予一個(gè)唯一的序號(hào)，從0開(kāi)始。每創(chuàng)建一個(gè)LogRecord對(duì)象該值就增加1，在LogRecord的構(gòu)造方法中給該屬性賦值：
sequenceNumber = globalSequenceNumber.getAndIncrement();
globalSequenceNumber的聲明如下：
private static final AtomicLong globalSequenceNumber = new AtomicLong(0);

可以看出在系統(tǒng)運(yùn)行期間，每一個(gè)LogRecord對(duì)象都有一個(gè)唯一的編號(hào)。
getThreadId()方法獲取當(dāng)前線程的id,需要注意的是該id有可能不是真正的線程id,構(gòu)造方法中是通過(guò)如下語(yǔ)句對(duì)threadId進(jìn)行賦值的：
threadID = defaultThreadID();

defaultThreadID()方法如下：

private int defaultThreadID() {
    long tid = Thread.currentThread().getId();
    if (tid < MIN_SEQUENTIAL_THREAD_ID) {
        return (int) tid;
    } else {
        Integer id = threadIds.get();
        if (id == null) {
            id = nextThreadId.getAndIncrement();
            threadIds.set(id);
        }
        return id;
    }
}

可以看到通過(guò)Thread.currentThread().getId()獲取的線程id是long類(lèi)型的，但是LogRecord中的threadId字段是int類(lèi)型的，因此它們之間沒(méi)辦法做到一一對(duì)應(yīng)，參考JDK-6278014
getResourceBundle()和getResourceBundleName()以及getParameters()方法都是與日志信息本地化相關(guān)的，本地化與國(guó)際化我覺(jué)得是同一個(gè)概念的兩個(gè)不同角度，只有支持國(guó)際化才有所謂的在不同地區(qū)的本地化，我們不咬文嚼字了。關(guān)于本地化或者說(shuō)國(guó)際化的相關(guān)內(nèi)容，我之前的一片文章《Tomcat7.0源碼分析——國(guó)際化》有所涉及，這里就不再詳細(xì)論述了，getParameters方法中獲取到的參數(shù)就是用來(lái)格式化帶有占位符的文本信息的。如果getResourceBundle()不為null，則說(shuō)明要進(jìn)行本地化輸出，那么這個(gè)時(shí)候最外層傳入的message字段代表的就是key，通過(guò)該key去獲取到對(duì)應(yīng)的value，如果對(duì)應(yīng)的value找不到，則把key當(dāng)成value，然后再判斷parameters數(shù)組中是否有值，如果有值，則需要用這些值去替換掉value中的占位符。如果getResourceBundle()方法返回null，則不需要進(jìn)行本地化，那么最外層傳入的message就是真正要進(jìn)行輸出的信息，message中可能含有占位符，此時(shí)還需要判斷parameters數(shù)組中是否有值，如果有值，還需要一一替換掉message中的占位符，然后進(jìn)行輸出，我們來(lái)看一下parameters是如何使用的：

public class JavaLogging {
    private static final Logger logger = Logger.getLogger(JavaLogging.class.getName());
    public static void main(String[] args) {
        logger.log(Level.INFO, "Hello, {0}", "World");
        logger.log(Level.INFO, "{0}{1}{2}", new Object[]{"Log", 4, 'J'});
    }
}

上述代碼中分別調(diào)用了Logger的如下兩個(gè)方法：

public void log(Level level, String msg, Object param1) {
    if (!isLoggable(level)) {
        return;
    }
    LogRecord lr = new LogRecord(level, msg);
    Object params[] = { param1 };
    lr.setParameters(params);
    doLog(lr);
}

public void log(Level level, String msg, Object params[]) {
    if (!isLoggable(level)) {
        return;
    }
    LogRecord lr = new LogRecord(level, msg);
    lr.setParameters(params);
    doLog(lr);
}

這兩個(gè)方法本質(zhì)上都是一樣的，內(nèi)部在構(gòu)造LogRecord時(shí)對(duì)parameters屬性進(jìn)行賦值。輸出結(jié)果如下所示:

八月 11, 2018 4:22:05 下午 cn.codecrazy.study.JavaLogging main
信息: Hello, World
八月 11, 2018 4:22:05 下午 cn.codecrazy.study.JavaLogging main
信息: Log4J

可以看到parameters的作用就是用來(lái)填充message中的占位符的。關(guān)于格式化的這一部分我們后面介紹Formatter組件的時(shí)候再詳細(xì)論述。