Files
mingli-utils/src/main/kotlin/com/mingliqiye/utils/logger/MingLiLogger.kt
T
minglipro 51eb838a36
Gitea Actions Build / Build (push) Canceled after 0s
docs: 补全 src 全部 Kotlin KDoc 与 Java Javadoc,版本升级至 5.5.1
为所有缺失文档的公开声明补充中文 KDoc/Javadoc(含 exception、json、
springboot、tuple 生成类、MediaType 枚举项及测试),仅插入注释不改代码;
gradle.properties VERSIONS 5.4.4 -> 5.5.1。
2026-11-17 21:07:58 +08:00

408 lines
9.6 KiB
Kotlin

/*
* Copyright 2026 mingliqiye
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
* ProjectName mingli-utils
* ModuleName mingli-utils.main
* CurrentFile MingLiLogger.kt
* LastUpdate 2026-11-16 11:35:40
* UpdateUser MingLiPro
*/
package com.mingliqiye.utils.logger
import org.slf4j.Logger
import org.slf4j.Marker
import org.slf4j.helpers.MessageFormatter
/**
* 简易 SLF4J Logger 实现,将各级别日志直接输出到标准输出流。
* 所有日志级别始终启用,消息格式遵循 SLF4J 的 {} 占位符风格。
*
* @param name 日志器名称,输出时作为标识显示
*/
class MingLiLogger(private val name: String) : Logger {
override fun getName(): String {
return name
}
/**
* 始终返回 true,TRACE 级别日志始终启用。
*/
override fun isTraceEnabled(): Boolean {
return true
}
override fun trace(msg: String?) {
msg?.let { toPrintln(it, MingLiLoggerLevel.TRACE) }
}
override fun trace(format: String?, arg: Any?) {
format?.let {
val message = format(it, arg)
toPrintln(message, MingLiLoggerLevel.TRACE)
}
}
override fun trace(format: String?, arg1: Any?, arg2: Any?) {
format?.let {
val message = format(it, arg1, arg2)
toPrintln(message, MingLiLoggerLevel.TRACE)
}
}
override fun trace(format: String?, vararg arguments: Any?) {
format?.let {
val message = formatArray(it, arguments)
toPrintln(message, MingLiLoggerLevel.TRACE)
}
}
override fun trace(msg: String?, t: Throwable?) {
msg?.let {
val message = if (t != null) "$it: ${t.message}" else it
toPrintln(message, MingLiLoggerLevel.TRACE)
}
}
/**
* 始终返回 true,忽略 marker 参数。
*/
override fun isTraceEnabled(marker: Marker?): Boolean {
return true
}
override fun trace(marker: Marker?, msg: String?) {
trace(msg)
}
override fun trace(marker: Marker?, format: String?, arg: Any?) {
trace(format, arg)
}
override fun trace(marker: Marker?, format: String?, arg1: Any?, arg2: Any?) {
trace(format, arg1, arg2)
}
override fun trace(marker: Marker?, format: String?, vararg arguments: Any?) {
trace(format, *arguments)
}
override fun trace(marker: Marker?, msg: String?, t: Throwable?) {
trace(msg, t)
}
/**
* 始终返回 true,DEBUG 级别日志始终启用。
*/
override fun isDebugEnabled(): Boolean {
return true
}
override fun debug(msg: String?) {
msg?.let { toPrintln(it, MingLiLoggerLevel.DEBUG) }
}
override fun debug(format: String?, arg: Any?) {
format?.let {
val message = format(it, arg)
toPrintln(message, MingLiLoggerLevel.DEBUG)
}
}
override fun debug(format: String?, arg1: Any?, arg2: Any?) {
format?.let {
val message = format(it, arg1, arg2)
toPrintln(message, MingLiLoggerLevel.DEBUG)
}
}
override fun debug(format: String?, vararg arguments: Any?) {
format?.let {
val message = formatArray(it, arguments)
toPrintln(message, MingLiLoggerLevel.DEBUG)
}
}
override fun debug(msg: String?, t: Throwable?) {
msg?.let {
val message = if (t != null) "$it: ${t.message}" else it
toPrintln(message, MingLiLoggerLevel.DEBUG)
}
}
/**
* 始终返回 true,忽略 marker 参数。
*/
override fun isDebugEnabled(marker: Marker?): Boolean {
return true
}
override fun debug(marker: Marker?, msg: String?) {
debug(msg)
}
override fun debug(marker: Marker?, format: String?, arg: Any?) {
debug(format, arg)
}
override fun debug(marker: Marker?, format: String?, arg1: Any?, arg2: Any?) {
debug(format, arg1, arg2)
}
override fun debug(marker: Marker?, format: String?, vararg arguments: Any?) {
debug(format, *arguments)
}
override fun debug(marker: Marker?, msg: String?, t: Throwable?) {
debug(msg, t)
}
/**
* 始终返回 true,INFO 级别日志始终启用。
*/
override fun isInfoEnabled(): Boolean {
return true
}
override fun info(msg: String?) {
msg?.let { toPrintln(it, MingLiLoggerLevel.INFO) }
}
override fun info(format: String?, arg: Any?) {
format?.let {
val message = format(it, arg)
toPrintln(message, MingLiLoggerLevel.INFO)
}
}
override fun info(format: String?, arg1: Any?, arg2: Any?) {
format?.let {
val message = format(it, arg1, arg2)
toPrintln(message, MingLiLoggerLevel.INFO)
}
}
override fun info(format: String?, vararg arguments: Any?) {
format?.let {
val message = formatArray(it, arguments)
toPrintln(message, MingLiLoggerLevel.INFO)
}
}
override fun info(msg: String?, t: Throwable?) {
msg?.let {
val message = if (t != null) "$it: ${t.message}" else it
toPrintln(message, MingLiLoggerLevel.INFO)
}
}
/**
* 始终返回 true,忽略 marker 参数。
*/
override fun isInfoEnabled(marker: Marker?): Boolean {
return true
}
override fun info(marker: Marker?, msg: String?) {
info(msg)
}
override fun info(marker: Marker?, format: String?, arg: Any?) {
info(format, arg)
}
override fun info(marker: Marker?, format: String?, arg1: Any?, arg2: Any?) {
info(format, arg1, arg2)
}
override fun info(marker: Marker?, format: String?, vararg arguments: Any?) {
info(format, *arguments)
}
override fun info(marker: Marker?, msg: String?, t: Throwable?) {
info(msg, t)
}
/**
* 始终返回 true,WARN 级别日志始终启用。
*/
override fun isWarnEnabled(): Boolean {
return true
}
override fun warn(msg: String?) {
msg?.let { toPrintln(it, MingLiLoggerLevel.WARN) }
}
override fun warn(format: String?, arg: Any?) {
format?.let {
val message = format(it, arg)
toPrintln(message, MingLiLoggerLevel.WARN)
}
}
override fun warn(format: String?, vararg arguments: Any?) {
format?.let {
val message = formatArray(it, arguments)
toPrintln(message, MingLiLoggerLevel.WARN)
}
}
override fun warn(format: String?, arg1: Any?, arg2: Any?) {
format?.let {
val message = format(it, arg1, arg2)
toPrintln(message, MingLiLoggerLevel.WARN)
}
}
override fun warn(msg: String?, t: Throwable?) {
msg?.let {
val message = if (t != null) "$it: ${t.message}" else it
toPrintln(message, MingLiLoggerLevel.WARN)
}
}
/**
* 始终返回 true,忽略 marker 参数。
*/
override fun isWarnEnabled(marker: Marker?): Boolean {
return true
}
override fun warn(marker: Marker?, msg: String?) {
warn(msg)
}
override fun warn(marker: Marker?, format: String?, arg: Any?) {
warn(format, arg)
}
override fun warn(marker: Marker?, format: String?, arg1: Any?, arg2: Any?) {
warn(format, arg1, arg2)
}
override fun warn(marker: Marker?, format: String?, vararg arguments: Any?) {
warn(format, *arguments)
}
override fun warn(marker: Marker?, msg: String?, t: Throwable?) {
warn(msg, t)
}
/**
* 始终返回 true,ERROR 级别日志始终启用。
*/
override fun isErrorEnabled(): Boolean {
return true
}
override fun error(msg: String?) {
msg?.let { toPrintln(it, MingLiLoggerLevel.ERROR) }
}
override fun error(format: String?, arg: Any?) {
format?.let {
val message = format(it, arg)
toPrintln(message, MingLiLoggerLevel.ERROR)
}
}
override fun error(format: String?, arg1: Any?, arg2: Any?) {
format?.let {
val message = format(it, arg1, arg2)
toPrintln(message, MingLiLoggerLevel.ERROR)
}
}
override fun error(format: String?, vararg arguments: Any?) {
format?.let {
val message = formatArray(it, arguments)
toPrintln(message, MingLiLoggerLevel.ERROR)
}
}
/**
* 输出 ERROR 级别日志,仅输出消息文本,忽略异常参数。
*/
override fun error(msg: String?, t: Throwable?) {
msg?.let {
toPrintln(it, MingLiLoggerLevel.ERROR)
}
}
/**
* 始终返回 true,忽略 marker 参数。
*/
override fun isErrorEnabled(marker: Marker?): Boolean {
return true
}
override fun error(marker: Marker?, msg: String?) {
error(msg)
}
override fun error(marker: Marker?, format: String?, arg: Any?) {
error(format, arg)
}
override fun error(marker: Marker?, format: String?, arg1: Any?, arg2: Any?) {
error(format, arg1, arg2)
}
override fun error(marker: Marker?, format: String?, vararg arguments: Any?) {
error(format, *arguments)
}
override fun error(marker: Marker?, msg: String?, t: Throwable?) {
error(msg, t)
}
/**
* 按指定日志级别格式化并输出日志消息。
*
* @param message 日志消息内容
* @param level 日志级别
*/
fun toPrintln(message: String, level: MingLiLoggerLevel) {
when (level) {
MingLiLoggerLevel.TRACE -> wirteToSteam("[TRACE] [$name] $message\n")
MingLiLoggerLevel.DEBUG -> wirteToSteam("[DEBUG] [$name] $message\n")
MingLiLoggerLevel.INFO -> wirteToSteam("[INFO] [$name] $message\n")
MingLiLoggerLevel.WARN -> wirteToSteam("[WARN] [$name] $message\n")
MingLiLoggerLevel.ERROR -> wirteToSteam("[ERROR] [$name] $message\n")
}
}
/**
* 将字符串以字节形式写入标准输出流。
*
* @param string 要输出的字符串
*/
fun wirteToSteam(string: String) {
System.out.write(string.toByteArray())
}
private fun format(format: String, vararg args: Any?): String {
return formatArray(format, args)
}
private fun formatArray(format: String, arguments: Array<out Any?>): String {
return MessageFormatter.arrayFormat(
format,
arguments
).message
}
}