space.lingu.light.LightLogger Maven / Gradle / Ivy
/*
* Copyright (C) 2022 Lingu Light Project
*
* 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.
*/
package space.lingu.light;
import java.util.ArrayList;
import java.util.List;
/**
* Internal logger interface for Light.
*
* If you are using third-party logger,
* you need implements this interface.
*
*
Usage info
*
* - In debug level, it will output the details of the SQL statement executed
* and other useful information for debugging.
* - In info level, it will output some running logs.
* - In error level, it will only output simple error message.
* - In trace level, it will output the stack information of the received Exception.
* (But in most cases Exception is repackaged as {@link LightRuntimeException} and rethrown. )
*
*
* @author RollW
*/
public interface LightLogger {
boolean isDebugEnabled();
void setDebugEnable(boolean isDebug);
void debug(String message);
void debug(String message, Throwable throwable);
void error(String message);
void error(String message, Throwable throwable);
void error(Throwable throwable);
void info(String message);
void info(String message, Throwable throwable);
void trace(String message);
void trace(String message, Throwable throwable);
void trace(Throwable throwable);
void warn(String message);
void warn(String message, Throwable throwable);
static String formatStackTraces(StackTraceElement[] elements) {
// simple implementation for format stack traces
if (elements == null || elements.length == 0){
return "Cannot get current method list.";
}
List stringList = new ArrayList<>();
for (StackTraceElement e : elements){
stringList.add(e.toString());
}
StringBuilder result = new StringBuilder();
int i = 0;
for (String a : stringList){
if (i == stringList.size() - 1){
result.append(a);
} else {
result.append(a).append(",\n\t");
}
i++;
}
return result.toString();
}
}