# JLogging

**Repository Path**: jianggujin/JLogging

## Basic Information

- **Project Name**: JLogging
- **Description**: Java日志工具，自动加载已有的日志包，相当于日志工具的适配器
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2018-08-31
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

#  第一部分 简介

`JLogging`是Java日志工具，自动加载已有的日志包，相当于日志工具的适配器 。

# 第二部分 开始使用

使用`JLogging`可以直接下载源代码编译或者下载已经编译的`jar`文件，如果您是使用`maven`来构建项目，也可以直接在`pom.xml`中添加`JLogging`的坐标：

[![Maven central](https://maven-badges.herokuapp.com/maven-central/com.jianggujin/JLogging/badge.svg)](https://maven-badges.herokuapp.com/maven-central/com.jianggujin/JLogging)

```xml
<!-- http://mvnrepository.com/artifact/com.jianggujin/JLogging -->
<dependency>
    <groupId>com.jianggujin</groupId>
    <artifactId>JLogging</artifactId>
    <version>最新版本</version>
</dependency>
```

最新的版本可以从[Maven仓库](http://mvnrepository.com/artifact/com.jianggujin/JLogging)或者[码云](https://gitee.com/jianggujin)获取。

## 2.1 一个例子

```java
JLog logger = JLogFactory.getLog(getClass());
logger.info("this is test log.");
```

`JLogging`会按照顺序尝试加载项目中已有的日志工具，加载顺序为如下：

1. slf4j
2. commons-logging
3. log4j
4. jdk logging
5. stdout
6. no logging

只要检测到有一个工具包可以使用则`JLogging`初始化完成，如果我们想打破这种顺序，`JLogging`也支持直接指定上述的任意一种日志实现，我们可以在获得日志之前执行`JLogFactory`的`use*`方法。

```java
void useSlf4jLogging();
void useCommonsLogging();
void useLog4JLogging();
void useJdkLogging();
void useStdOutLogging();
void useNoLogging()
```

如果内置的默认实现无法满足需求，也可以通过实现`com.jianggujin.logging.JLog`接口定制自己的日志工具，最后想要我们自定义的日志生效，我们只需要执行`JLogFactory`的`useCustomLogging()`方法即可。