TinyLog是Java的简单轻量级日志记录框架。
我们可以将tinylog与Java，Kotlin，Scala和Android应用程序一起使用。

TinyLog日志记录框架的好处

• 避免Logger初始化的样板代码。
  tinylog中的Logger类是静态的，可直接用于记录消息。

• 支持其他流行的JVM语言，例如Kotlin和Scala。

• 也支持使用logcat的android应用程序。

• tinylog罐子重量轻且尺寸小。
  tinylog 2.x版本的API jar为48 kb，实现jar为72 kb。

• 可以使用JDBC和DataSource将输出发送到控制台，文件，数据库。

• 配置文件非常简单。
  对于基于控制台的简单日志记录，我们不需要任何配置文件。

• 它是免费和开源的。
  完整的项目代码托管在GitHub上。

• 根据他们自己的基准测试，它们比Log4J日志记录框架快得多。

• 不依赖于任何其他API和框架。

• 支持创建标签以对日志消息进行分类。
  这对于从庞大的日志文件中过滤日志消息非常有用。

• 懒惰日志记录支持仅在需要日志记录时才推迟昂贵的计算。

TinyLog日志入门

我们必须在项目类路径中包含以下jar。
这些是撰写本教程时tinylog框架的最新版本。

• tinylog-api-2.0.0-RC1.jar
• tinylog-impl-2.0.0-RC1.jar

大多数时候，我们使用Maven或者Gradle进行项目构建和依赖管理。

Minelog的Maven依赖关系

<dependency>
	<groupId>org.tinylog</groupId>
	<artifactId>tinylog-api</artifactId>
	<version>2.0.0-RC1</version>
</dependency>
<dependency>
	<groupId>org.tinylog</groupId>
	<artifactId>tinylog-impl</artifactId>
	<version>2.0.0-RC1</version>
</dependency>

tinylog的Gradle依赖关系

implementation 'org.tinylog:tinylog-api:2.0.0-RC1'
implementation 'org.tinylog:tinylog-impl:2.0.0-RC1'

上面的实现jar适用于基于JVM的应用程序。
对于Kotlin，Scala，Android，SLF4J和JCL，有单独的实现jar。
您必须包括基于项目类型的实施JAR。

使用tinylog记录器

将所需的jar添加到项目类路径后，我们可以使用其Logger类编写日志消息。

下图显示了我的Eclipse项目结构。

TinyLog示例项目

这是我使用tinylog Logger进行记录的类。

Employee.java：一个简单的模型类，其中包含一些属性及其使用getter-setter方法。

package com.theitroad.tinylog;

import org.tinylog.Logger;

public class Employee {

	private int id;
	private String name;

	public String getName() {
		Logger.debug("Returning employee name " + this.name);
		return name;
	}

	public void setName(String name) {
		Logger.info("Setting employee name " + name);
		this.name = name;
	}

	public int getId() {
		Logger.debug("Returning employee id " + this.id);
		return id;
	}

	public void setId(int id) {
		Logger.info("Setting employee id " + id);
		this.id = id;
	}
}

EmployeeService.java：一个简单的服务类，提供了一种创建Employee对象的方法。

package com.theitroad.tinylog;

import org.tinylog.Logger;

public class EmployeeService {

	public Employee createEmployee(int i, String n) {
		Logger.info("Creating Employee with ID = " + i + " and Name = " + n);
		Employee emp = new Employee();
		emp.setId(i);
		emp.setName(n);
		return emp;
	}
	
}

EmployeeMain.java：运行我们的简单项目的主类。

package com.theitroad.tinylog;

import org.tinylog.Logger;

public class EmployeeMain {

	public static void main(String[] args) {		
		Logger.debug("Program Started");
		
		EmployeeService empService = new EmployeeService();

		Employee emp = empService.createEmployee(10, "hyman");

		System.out.println("Employee ID = " + emp.getId());
		System.out.println("Employee Name = " + emp.getName());

		Logger.debug("Program Finished");
	}
}

当我们运行上述程序时，它将生成以下输出。
请注意，我们目前尚未创建tinylog配置文件。

TinyLog日志记录示例输出控制台

TinyLog记录级别

记录器支持五个记录级别–跟踪，调试，信息，警告和错误。
默认值和最低优先级为"跟踪"。
最高优先级是"错误"。
我们可以在配置文件中设置日志记录级别。
设置级别和更高优先级的日志消息将被记录。

TinyLog配置文件

TinyLog在类路径中寻找tinylog.properties文件，以配置日志记录选项。
我们通常在资源目录中创建此文件。
让我们创建第一个tinylog配置文件。

tinylog.properties：

writer        = console
writer.format = {date: HH:mm:ss.SSS} {tag} {level}: {message}

当我们再次运行主程序时，输出为：

12:22:47.073  DEBUG: Program Started
12:22:47.076  INFO: Creating Employee with ID = 10 and Name = hyman
12:22:47.076  INFO: Setting employee id 10
12:22:47.077  INFO: Setting employee name hyman
12:22:47.077  DEBUG: Returning employee id 10
Employee ID = 10
12:22:47.077  DEBUG: Returning employee name hyman
Employee Name = hyman
12:22:47.077  DEBUG: Program Finished

请注意，日志消息遵循配置文件中提到的格式。

TinyLog标签

我们可以使用以下代码在代码中设置Logger标签。

Logger.tag("MAIN").debug("Program Started");

Logger.tag("MAIN").debug("Program Finished");

更新的日志消息将包含以下几行。

12:26:12.831 MAIN DEBUG: Program Started
...
12:26:12.835 MAIN DEBUG: Program Finished

我们可以设置一个writer标签来记录具有该标签的消息，其他消息将被writer忽略。

writer     = console
writer.tag = SYSTEM

通过将标签设置为"-"，我们可以忽略所有标签，仅记录未加标签的消息。

writer     = console
writer.tag = 

TinyLog配置，可将消息记录到日志文件中

这是一个将消息记录到tinylog.txt文件中的简单示例。

writer       =  file
writer.file  = tinylog.txt
writer.level = info
writer.format = {date: HH:mm:ss.SSS} {tag} {level}: {message}

TinyLog也支持读取环境变量。
例如，我们可以使用以下格式指定要在主目录中生成的日志文件。

writer.file = ${HOME}/tinylog.txt

我们还可以使用#{key}格式在TinyLog配置中读取系统属性。

writer.format = #{user.name}: {message}

滚动文件编写器配置

writer       = rolling file
writer.file  = tinylog{count}.txt
writer.level = info
writer.format = {date: HH:mm:ss.SSS} {tag} {level}: {message}

扩展TingLog

TinyLog是可扩展的。
我们可以实现" org.tinylog.writers.Writer"接口并将其注册为服务。
同样，我们可以实现org.tinylog.policies.Policy接口来创建自定义策略并进行注册。