# jbooster-logging

**Repository Path**: jbooster/jbooster-logging

## Basic Information

- **Project Name**: jbooster-logging
- **Description**: slf4j的扩展
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2017-08-20
- **Last Updated**: 2022-11-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# jbooster-logging user guide
## 添加依赖

```xml
<dependency>
    <groupId>org.jbooster</groupId>
    <artifactId>jbooster-logging</artifactId>
    <version>1.0.0-SNAPSHOT</version>
</dependency>
<repositories>
    <repository>
        <id>jbooster-repo-private</id>
        <name>Repository for jbooster</name>
        <url>http://repo.jbooster.org/repository/maven-public</url>
        <releases>
            <enabled>true</enabled>
        </releases>
        <snapshots>
            <enabled>true</enabled>
        </snapshots>
    </repository>
</repositories>
```

## 安装IntelliJ Plugin
### 方式一：从本地磁盘安装
1. 下载最新版的jar包: http://git.oschina.net/jbooster/jbooster-logging-intellij-plugin/tree/master/releases
2. 打开IntelliJ->Preferences->Plugins，点击"Install plugin from disk..."，选择之前下载的jar文件

### 方式二：从线上插件库下载安装
1. 打开IntelliJ->Preferences->Plugins->Browse repositories...
2. 搜索并安装：Jbooster Logging Plugin

## 集成示例

```java
package org.jbooster.integration.AccountService;

import org.jbooster.logging.annotations.Slf4j;
import static com.google.common.collect.ImmutableMap.of;

@Slf4j(system = "account", module = "service")
public class AccountService {

    public static void main(String[] args) {
        log.info("account updated, id = {}, amount = {}", 123L, 2000L);
        log.info("account updated.", of("id", 123L, "amount", 2000L));
    }
}
```

输出示例：

```
2016-07-10 17:26:45 +0800 [INFO] from org.jbooster.integration.AccountService in main - [account|service]account updated, id=123, amount=2000
2016-07-10 17:26:45 +0800 [INFO] from org.jbooster.integration.AccountService in main - [account|service]account updated. {id=123, amount=2000}
```

## 分流日志
配合@Slf4j注解中的Marker属性，可以分流特定日志单独写到一个日志文件中，以Log4j2为例子。

```java
import org.jbooster.logging.annotations.Slf4j;

@Slf4j(system = "account", module = "service", marker = "special")
public class AccountService {
    
}
```

```xml
<Appenders>
    <File name="FILE" fileName="logs/app.log">
      <PatternLayout>
        <Pattern>%d %p %c{1.} [%t] %m%n</Pattern>
      </PatternLayout>
      <MarkerFilter marker="special" onMatch="ACCEPT" />
    </File>
</Appenders>
```