快捷導(dǎo)航

Kotlin中日志的使用方法詳解

更新時(shí)間：2021年03月18日 10:08:31 作者：氷泠

這篇文章主要給大家介紹了關(guān)于Kotlin中日志的使用方法，文中通過示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧

1 引言

想必學(xué)過Java的人都知道一個(gè)@Slf4j使用得多么的舒服：

@Slf4j
public class TestController{
 @GetMapping("/test")
 public String test(){
  log.debug("debug");  
  return "test";
 }
}

但是很不幸在Kotlin中并沒有這種注解，因此，本文給出了一種類似@Slf4j注解在Kotlin中的使用方法，以及介紹一個(gè)100%使用Kotlin編寫的日志庫。

2 動(dòng)手寫@Slf4j

很簡(jiǎn)單，先上代碼：

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

@Target(AnnotationTarget.CLASS)
@Retention(AnnotationRetention.RUNTIME)
annotation class Slf4j{
 companion object{
  val <reified T> T.log: Logger
  inline get() = LoggerFactory.getLogger(T::class.java)
 }
}

逐行解釋如下：

@Target：與Java中的@Target類似，注解的目標(biāo)，這里是類
@Retention：與Java中的@Retention類似，運(yùn)行時(shí)保留
annotation class：聲明一個(gè)注解
companion object：伴生對(duì)象
val <reified T> T.log:Logger：聲明一個(gè)Logger類型的泛型對(duì)象
inline get() = LoggerFactory.getLogger(T::class.java)：聲明getter為內(nèi)聯(lián)，聲明為內(nèi)聯(lián)才能使用T，這樣才能傳遞給后面的getLogger，T::class.java相當(dāng)于Java中的T.class，也就是getLogger(T::class.java)相當(dāng)于getLogger(SomeClass.class)

使用很簡(jiǎn)單：

@RestController
@Slf4j
class TestController {
  @GetMapping("/test")
  fun test():String{
    log.warn("cc")
    return "test"
  }
}

直接類上加一個(gè)注解，就可以使用log.info/log.warn之類的方法了。

3 kotlin-logging

上面介紹了注解的使用方法，如果不想使用注解的話，可以使用別人的庫，比如kotlin-logging。

kotlin-logging是一個(gè)100%使用Kotlin編寫的輕度封裝了slf4j的開源日志庫，已經(jīng)收獲1.4k的star：

依賴如下：

<dependency>
  <groupId>io.github.microutils</groupId>
  <artifactId>kotlin-logging-jvm</artifactId>
  <version>2.0.6</version>
</dependency>

Gradle：

implementation 'io.github.microutils:kotlin-logging-jvm:2.0.6'

引入時(shí)，只需要在對(duì)應(yīng)的類中創(chuàng)建一個(gè)屬性即可：

private val logger = KotlinLogging.logger {}

使用時(shí)，直接調(diào)用其中的info/debug/error等即可：

import mu.KotlinLogging
private val logger = KotlinLogging.logger {} 
class FooWithLogging {
  val message = "world"
  fun bar() {
    logger.debug { "hello $message" }
  }
}

4 兩者結(jié)合使用

當(dāng)然，也可以將注解與kotlin-logging結(jié)合一下使用，首先，筆者簡(jiǎn)單地看了一下KotlinLogging的接口：

提供了三個(gè)對(duì)外的logger方法，參數(shù)分別是：

函數(shù)
字符串
org.slf4j.Logger

對(duì)外沒有提供類似getLogger(Class<?> clazz)這樣的用類作為參數(shù)的方法，因此，需要通過泛型獲取到具體類的名字并使用第二種方法構(gòu)造mu.KLogger：

import mu.KotlinLogging
import org.slf4j.Logger

@Target(AnnotationTarget.CLASS)
@Retention(AnnotationRetention.RUNTIME)
annotation class Slf4j{
  companion object{
    val <reified T> T.log: Logger
    inline get() = KotlinLogging.logger{T::class.java.name}
  }
}

使用方法同上，直接加一個(gè)@Slf4j即可使用。