本文讲Java内置的java.util.logging软件包中的 api。主要解释怎样使用该api添加logging到你的application中,怎样加配置它等。但是本文不谈你应该把什么东西写到日志中。

Note :本文谈到的api是Java 6中的。不涉及其他流行的Java logging api(比如Log4J, SLF4J, Apache Commons Logging, LogBack 等)。它只关注Java内置的API。

如果你能够选择你自己的logging api,你也许可以选择上面提到的流行api。但是,如果你像我一样,正在开发Google APP Engine上的web应用,那么你不得不使用java.util.logging。

Java Logging: 综述

下图是Java Logging API工作的概况示意图:

所有的logging都是通过一个Loger 实例产生的,Logger收集数据,保存到LogRecord。LogRecord转发到Handler。Handler来决定怎么处理这些LogRecord。例如,LogRecord可以写到disk,或者通过网络发送到一个监控系统。

Logger和Handler都可以使用Filter来筛选LogRecord,来决定是否转发。

  • Log Level 每一条message都包含一个log level的标签。这个level是一个整数,用来标识这条message的重要性。数值越大,重要性越高。
  • Logger Hierachy Logger实例按层级组织,底层的Logger获得的信息会转发到祖先Logger。因此,log level 和 messages 可以被筛选,或者选择是否接受整个Logger分支。
  • LogManager 用来控制Logger hierarchy, 同时还管理一个全局的日志配置文件。

Java Logging: 基本使用方法

通常的做法是,在需要添加日志的类中创建一个 static final的Logger 实例,所有该类的对象共享该实例。例子如下:

public class LoggingExamples {

    private static final Logger logger =
Logger.getLogger(LoggingExamples.class.getName()); // 通常把该类的全名作为Logger的名字
  public void doIt() {
logger.entering(getClass().getName(), "doIt"); try{
//... something that can throw an exception
} catch (Exception e) {
logger.log(Level.SEVERE, "Error doing XYZ", e);
} logger.exiting(getClass().getName(), "doIt");
}
}

Java Logging: Logger类

为了产生一条message,你可以调用以下方法:

//log 组产生指定level上的message
log (Level level, String message);
log (Level level, String message, Object param1); //对象信息被插入到message中
log (Level level, String message, Object[] params); //示例: logger.log(Level.SEVERE, "Hello logging: {0}, {1}",     new Object[] {"P1", "P2"}); 注意传参数的格式 log (Level level, String message, Throwable t); log (LogRecord record);

//在log()的基础上增加了sourceClass和sourceMethod俩个参数,用来说明这条message产生自那个类的那个方法。
logp (Level level, String sourceClass, String sourceMethod, String msg);
logp (Level level, String sourceClass, String sourceMethod, String msg,
Object param1);
logp (Level level, String sourceClass, String sourceMethod, String msg,
Object[] params);
logp (Level level, String sourceClass, String sourceMethod, String msg,
Throwable t);

//在logp()基础上增加了bundle。Resource bundle是一些键值对,主要用于国际化
logrb(Level level, String sourceClass, String sourceMethod,
String bundle, String msg);
logrb(Level level, String sourceClass, String sourceMethod,
String bundle, String msg, Object param1);
logrb(Level level, String sourceClass, String sourceMethod,
String bundle, String msg, Object[] params);
logrb(Level level, String sourceClass, String sourceMethod,
String bundle, String msg, Throwable t); entering(String sourceClass, String sourceMethod);
entering(String sourceClass, String sourceMethod, Object param1);
entering(String sourceClass, String sourceMethod, Object[] params); exiting (String sourceClass, String sourceMethod);
exiting (String sourceClass, String sourceMethod, Object result); fine (String message);
finer (String message);
finest (String message); config (String message);
info (String message);
warning (String message);
severe (String message); throwing(String sourceClass, String sourceMethod, Throwable t); //几个重要的函数
void addHandler(Handler handler) Add a log Handler to receive logging messages. 每一个Handler可以调用setFormatter函数设置输出格式
void setFilter(Filter newFilter) Set a filter to control output on this Logger.
void setLevel(Level newLevel) Set the log level specifying which message levels will be logged by this logger.

原文地址:在这里

【译文】Java Logging的更多相关文章

  1. java.logging的重定向?

    接着昨天的工作. 上面说要重定向java.util.logging.Logger的输出, 发现也不是不可能. package jmx; import java.util.logging.FileHan ...

  2. Java Se: Logging 框架说明

    Java Logging 用惯了log4j等日志工具,竟然不知Java还自带了个log工具.今天有空了就来了解一下. 先来看一个简单的例子: public class SystemTest { pri ...

  3. Java中的日志——Java.util.logging、log4j、commons-logging

    Java中给项目程序添加log主要有三种方式,一使用JDK中的java.util.logging包,一种是log4j,一种是commons-logging.其中log4j和commons-loggin ...

  4. Java 9 模块化(Modularity)

    JDK9的发布一直在推迟,终于在2017年9月21日发布了.下面是JDK9的几个下载地址: JDK9.0.1 Windows-x64下载地址 Oracle Java 官网下载地址 OpenJDK 9官 ...

  5. [翻译]Java日志终极指南

    本文由 ImportNew - Wing 翻译自 loggly.欢迎加入翻译小组.转载请见文末要求. Java日志基础 Java使用了一种自定义的.可扩展的方法来输出日志.虽然Java通过java.u ...

  6. top 10 tipis on Logging in Java- Tutorial (翻译)

    开篇废话,就记得出国之前有一回腾讯面试,面试官说既然你都快要出国了,英语肯定挺不错的,那为什么不去翻译一些国外好的文章呢,我希望找一个能主动学习的人,一直受教.目前在实习,需要做大数据相关方向,都是挺 ...

  7. Java 9终于要包含Jigsaw项目了

    当Jigsaw在Java 9中最终发布时,这个项目的历史已经超过八年了. 转载于:http://www.itxuexiwang.com/a/liunxjishu/2016/0228/180.html? ...

  8. How to do logging in C# with log4net

    If you are writing server code in C# or to a lesser extent desktop/client then it's a good idea to i ...

  9. (部署新java程序,程序报错,需copy的一个包)——java使用siger 获取服务器硬件信息

    mcat-siger.sh  查看是否安装siger rsync -aPuv /usr/lib64/libsigar-amd64-linux.so $i:/usr/lib64/ java使用siger ...

随机推荐

  1. Windows server用好windows server backup,发挥个人电脑该有的系统还原功能

    笔记本上安装windows server的各位是不是有个感触,默认软件升级.软件更新,系统是没有系统还原的(磁盘清理发现也没有还原点可清理),也就是系统出了问题,还原不了干着急. 其实,windows ...

  2. JS--中奖广告浮动效果

    618要到了.要帮公司做一个简单的中奖号码的浮动.怎么玩了.其实只需要使用scrollHeight;scrollTop;offsetHeight这三个就可以实现了. 代码如下: <html> ...

  3. 谈谈Java中的ThreadLocal

    什么是ThreadLocal ThreadLocal一般称为线程本地变量,它是一种特殊的线程绑定机制,将变量与线程绑定在一起,为每一个线程维护一个独立的变量副本.通过ThreadLocal可以将对象的 ...

  4. springboot Serving Web Content with Spring MVC

    Serving Web Content with Spring MVC This guide walks you through the process of creating a "hel ...

  5. [Template]高精度模板

    重新写一下高精度模板(不要问我为什么) 自认为代码风格比较漂亮(雾 如果有更好的写法欢迎赐教 封装结构体big B是压位用的进制,W是每位长度 size表示长度,d[]就是保存的数字,倒着保存,从1开 ...

  6. IIS上部署Net.Core

    部署: 1.安装vc_redist.x64vc_redist.x64 2.安装DotNetCore.1.0.0.RC2-WindowsHosting 3.安装DotNetCore.1.0.0-SDK. ...

  7. Linux 进程间通讯详解二

    消息队列 --消息队列提供了本机上从一个进程向另外一个进程发送一块数据的方法 --每个数据块都被认为有一个类型,接收者进程接收的数据块可以有不同的类型值 --消息队列也有管道一样的不足,就是每个消息的 ...

  8. Java,来源于大神

    也许你学习了那么久的Java了,但如果有人问你什么是JavaEE?你会怎么回答他呢?在此我来谈谈关于JavaEE的相关技术.(仅是个人见解) 在谈JavaEE时,我们首先来了解一下Java平台.目前, ...

  9. TypeScript Declaration Merging(声明合并)

    TypeScript中有一些独特的概念,来自需要描述JavaScript对象类型发生了哪些变化.举个例子,最为独特的概念就是"声明合并".理解了这个概念将会对你在当前JavaScr ...

  10. Codeforces Round #342 (Div. 2) D. Finals in arithmetic(想法题/构造题)

    传送门 Description Vitya is studying in the third grade. During the last math lesson all the pupils wro ...