【log】slf4j 使用手册

     SLF4J 可以作为各种日志框架的抽象，譬如  java.util.logging 、 logback 、log4j  .  详情参看  slf4j 官网

Hello World                  

 

    引入 SLF4J 需要的 jar 包(以 maven 为例):

    org.slf4j
    slf4j-api
    1.7.21

    运行如下程序：

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

public class HelloWorld {
  public static void main(String[] args) {
    Logger logger = LoggerFactory.getLogger(HelloWorld.class);
    logger.info("Hello World");
  }
}

   有如下报错内容：

SLF4J: Failed to load class "org.slf4j.impl.StaticLoggerBinder".
SLF4J: Defaulting to no-operation (NOP) logger implementation
SLF4J: See http://www.slf4j.org/codes.html#StaticLoggerBinder for further details.

   从这里可以看出 SLF4J 仅仅是抽象，还需要具体的实现。结合官方提供的 SLF4J 的简单实现 jar 包：

    org.slf4j
    slf4j-simple
    1.7.21

  重新编译运行即可完成 Hello World

典型的使用模式              

package com.ycit.controller;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;


/**
 * Created by xlch on 2016/10/24.
 */
@Controller
public class HomeController {

    private static final Logger log = LoggerFactory.getLogger(HomeController.class);

    @RequestMapping("/home")
    public String home(){
        log.debug("home method run...");
        boolean flag = true;
        if (flag) {
            log.info("flag is {}",flag);//如果 flag 为 true ，打印 flag is true
        }
        return "home";
    }

}

           sample 只会打印 INFO 级别 和 更高级别的信息 。

结合其他的 日志框架部署（中间件）          

     slf4j-log4j12-1.7.21.jar

                    ★  用于结合  log4j  1.2 版本使用 ，需要加入 log4j.jar

    slf4j-jdk14-1.7.21.jar

                   ★ 用于结合 java.util.logging 使用

     slf4j-nop-1.7.21.jar

                  ★ 结合 NOP 使用 ，

    slf4j-sample-1.7.21.jar

                 ★ 结合 Simple 的实现使用 ，Simple 的实现  使用  System.err 输出所有的事件 .仅仅 INFO  级别和 更高级别的信息会打印 ，在比较小的 引用中可能会有用的。

    slf4j-jcl-1.7.21.jar

                ★ 结合  Jakarta 的 Commons Logging使用 ， 将 slf4j 的所有日志委派给 jcl 处理。

    logback-classic-1.0.13.jar（需要 logback-core-1.0.13.jar）

               ★ 原生态实现， Logback 的  ch.qos.logback.classic.Logger 类 是 SLF4J 的  org.slf4j.Logger 接口的直接实现 。

     切换日志框架仅仅需要替换 slf4j 绑定 即可 。即切换以上提到的 中间件。例如 ， 把 java.util.logging 切换到 log4j ,需要将  slf4j-log4j12-1.7.21 替换 slf4j-jdk14-1.7.21 。

     SLF4J 不依赖于任何特殊的类加载机制 ，事实上 ，每个 SLF4J 的中间件 是在 编译时使用一种仅仅只能一种的日志插件进行硬连接 。不要引入多个中间件。

以下为关系图。

声明日志的项目依赖                

鉴于 Maven 的传递依赖规则 ，对于常规的项目声明日志依赖 可以只声明一个单独的依赖。具体如下：

   Logback-classic

                   只需要在 Maven 的 pom.xml 文件中声明 ch.qos.logback:logback-classic  即可 ，Maven 会自动加载 依赖的 jar 包 。

    ch.qos.logback
    logback-classic
    1.1.7

    Log4j

        如下声明即可引入相关依赖

    org.slf4j
    slf4j-log4j12
    1.7.21

    Java.util.logging

       如下声明即可引入相关依赖

    org.slf4j
    slf4j-jdk14
    1.7.21

使用实例：                                                        

slf4j + log4j1.2

    参看    【log】log4j 1.2  的 WEB 项目中使用 log4j 模块