GitHub项目地址:https://github.com/shenbibo/Slog
Slog
是一个轻量级的Android
平台的日志库,其是基于对当前开源的日志框架Logger
和Timber
的一个组合与扩展。具有极大的可扩展性,相比于原生Android Log
,有以下新特性。
LogcatTree
适配器。compile 'com.sky.slog:slog:0.4.0'
Slog
一般地在应用的Application
类的onCreate()
方法中调用如下类似代码。
Slog.init(new LogcatTree());
初始化时,至少需要传入一个日志适配器,当然我们也可以添加多个适配器,这个后面详解。
以上是最简单的初始化方式,我们还可以在初始化的时候对日志输出做全局配置,如下。
Slog.init(new LogcatTree()) // 初始化,设置适配器
.showThreadInfo(true) // 设置是否打印日志的线程的信息
.prefixTag("test") // 设置全局日志的前缀
.logPriority(Slog.FULL) // 设置日志输出级别
.methodCount(2) // 显示栈中方法的个数,默认从调用日志接口的方法往stack下计算
.methodOffset(1) // 显示从调用日志打印接口的方法往stack下计算的偏移数
.simpleMode(false); // 设置简单模式,无任何格式,等同于调用logcat,默认值为false.
以上方法的作用与默认值。
方法 | 默认值 | 作用 |
---|---|---|
prefixTag | “Android” | 设置全局日志前缀。 |
logPriority | Slog.FULL | 日志的输出级别,FULL表示可以输出任何级别的日志, NONE,表示不输出任何日志。 |
methodCount | 1 | 设置显示栈中方法到最终组装的日志中的个数,默认从调用日志接口的方法往stack下计算。 |
methodOffset | 0 | 设置从调用日志打印接口的方法往stack下的偏移数。 |
showThreadInfo | false | 设置是否打印日志的线程的信息。 |
simpleMode | false | 设置简单模式,无任何格式,不显示线程信息,方法调用,等同于调用logcat。 |
注意,上表中,如果simpleMode
为true
,则methodCount, methodOffset, showThreadInfo
将无效
另外我们还可以通过Slog.getSetting()
获取Setting
对象之后,在任何时候对全局Log输出配置项进行修改。
使用以下方式初始化Slog
。
Slog.init(LogcatTree()).perfixTag("TestSlog").showThreadInfo(true);
// 打印普通日志
Slog.d("sky debug");
Slog.i("sky info");
// 打印格式化字符串
Slog.d("this is a format string log, str1 = %s, int value2 = %d, boolean3 = %b", "string1", 2, true);
// 打印throwable
Slog.e(new Throwable());
Slog.w(new RuntimeException(), "test log with warn priority = %d", Slog.WARN);
json
和xml
json
和xml
字符串采用的日志级别都是Debug
的。
String jsonEmpty = "";
String jsonEmpty2 = "{}";
String jsonNull = null;
Slog.json(jsonEmpty);
Slog.json(jsonEmpty2);
Slog.json(jsonNull);
String json = "{'xyy1':[{'test1':'test1'},{'test2':'test2'}],'xyy2':{'test3':'test3','test4':'test4'}}";
Slog.json(json);
String jsonArray =
"{ 'employees': [ {'firstName':'John', 'lastName':'Doe'}, {'firstName':'Anna', 'lastName':'Smith'}, "
+ "{'firstName':'Peter', 'lastName':'Jones'}]}";
Slog.json(jsonArray);
xml
字符串String androidXml = "\n" +
" +
" package=\"com.sky.tools\" >\n" +
"\n" +
" +
" android:name=\".application.MainApplication\"\n" +
" android:allowBackup=\"true\"\n" +
" android:icon=\"@mipmap/ic_launcher\"\n" +
" android:label=\"@string/app_name\"\n" +
" android:roundIcon=\"@mipmap/ic_launcher_round\"\n" +
" android:supportsRtl=\"true\"\n" +
" android:theme=\"@style/AppTheme\" >\n" +
" \n" +
" \n" +
" \n" +
"\n" +
" \n" +
" \n" +
" \n" +
" \n" +
"\n" +
" ";
Slog.xml(androidXml);
Slog
支持对对象的打印,其原理是给每个不同的对象类型添加对应的对象解析器,默认提供对数组,集合等解析,支持自定义对象解析器。
null
对象Slog.i(null);
Slog.i("");
// 全局多维对象数组
private static Object[] objectsArray = new Object[]{
new boolean[]{false, true, true, false},
new String[][]{
new String[]{"22", "23", "24"},
new String[]{"123", "456", "789"}},
new int[][][]{new int[][]{
new int[]{666, 555, 444},
new int[]{111, 222, 333, 444}},
new int[][]{
new int[]{1, 2, 3, 4, 5, 6},
new int[]{7878, 6565, 84155, 7542, 0}}}};
// 打印对象数组
Object[] objectArray = new Object[1024];
for (int i = 0; i < objectArray.length; i++) {
objectArray[i] = i;
}
Slog.i(objectArray);
// 打印String
String[] stringArray = new String[1024];
for (int i = 1024; i < stringArray.length + 1024; i++) {
stringArray[i - 1024] = "is " + i;
}
Slog.i(stringArray);
// 打印int数组
int[] intArray = new int[1024];
for (int i = 2048; i < intArray.length + 2048; i++) {
intArray[i - 2048] = i;
}
Slog.i(intArray);
// 打印多维数组
Slog.i(objectsArray);
有如下一个Student
类。
public class Student {
private int number;
private int age;
private String name;
private boolean isBoy;
public Student(int number, int age, String name, boolean isBoy){
this.number = number;
this.age = age;
this.name = name;
this.isBoy = isBoy;
}
public String getName() {
return name;
}
public int getAge() {
return age;
}
public boolean isBoy() {
return isBoy;
}
public int getNumber() {
return number;
}
}
自定义一个Student
对象解析器,所有的对象解析器都必须要实现Parser
接口。
public class StudentParser implements Parser<Student> {
@Override
public Class getParseType() {
return Student.class;
}
@Override
public String parseToString(Student student) {
return student.getName() + " is a " + student.getAge() + " years old " + (student.isBoy() ? "boy" : "girl");
}
}
上面的parseToString
将在解析对象时调用,由它返回被解析的对象最终要表示的字符串内容。
// 没有添加解析器之前
Student s = new Student(12345, 54, "sky", true);
Slog.d(s);
// 添加解析器之后
Slog.addObjectParser(new StudentParser());
Slog.d(s);
Collection
对象这里以Map
举例。
// empty map
Map map = new HashMap<>();
Slog.d(map);
// int map
Map intMap = new ConcurrentHashMap<>();
intMap.put(1, 2);
intMap.put(1543, 2745867);
intMap.put(17687, 27678);
intMap.put(76781, 27678);
intMap.put(1786768, 26786);
Slog.d(intMap);
// Object Map
Map
前面的示例都是不修改输出配置项时打印的日志,但是在很多时候我们可能根据不同的场景,需要采用不同的日志输出配置。
除了前面说的使用Slog.getSetting()
方法获取Setting
对象之后,修改全局输出配置外,Slog
框架还支持指定临时输出配置,只在下次当前线程打印日志时生效一次的方式更改日志输出效果。
具体包括以下几个方法。
Slog.t() // 指定下一次当前线程打印日志的tag,最终输出的日志的Tag组合为: prefixTag-tag
Slog.th() // 指定下一次当前线程打印日志是否显示线程信息
Slog.m() // 指定下一次当前线程打印日志显示的调用stack中方法的数目
Slog.o() // 指定下一次当前线程打印日志显示stack方法时的偏移值
Slog.s() // 指定下一次当前线程打印日志是否采用简单模式输出
上面的配置方法可以单个使用也可以组合使用。
Slog.t("custom22").i("set tag to custom");
Slog.th(false).i("hide the threadInfo");
Slog.m(0).i("test 0 method count print, so hide track");
Slog.m(3).i("test three method count println");
Slog.o(1).i("method offset 1");
Slog.s(true).i("set to simple mode");
Slog.s(false).t("fiveSetting").th(true).m(5).o(2).i("this time set five temp setting for test");
Slog
框架目前只提供一个实现的日志适配器LogcatTree
,本框架支持自定义日志适配器,所有的日志适配器都必须要继承Tree
抽象类或者其子类,为了保证足够的扩展性,我们在Tree
的接口中除了可以接收到封装处理好的日志之外,也可以对原始的日志数据进行处理。
自定义一个FileTree
。
public class FileTree extends Tree {
// ... 还有其他的方法也可以根据需要复写
// 处理对象类型的日志,注意该接口方法,也可以根据原始的`originalObject`参数进行自定义处理
@Override
protected void prepareObjectLog(int priority, String tag, String[] compoundMessages, @Nullable Object originalObject) {
super.prepareObjectLog(priority, tag, compoundMessages, originalObject);
}
// 处理String类型的日志,注意该接口方法,也可以根据原始的`originalMessage`参数进行自定义处理
@Override
protected void prepareStringLog(int priority, String tag, Throwable t, String[] compoundMessages, @Nullable String originalMessages, @Nullable Object... args) {
super.prepareStringLog(priority, tag, t, compoundMessages, originalMessages, args);
}
// 该方法为必须要实现的父类抽象方法
@Override
protected void log(int priority, String tag, String message) {
// ... 省略代码将日志保存到文件中
}
}
将其添加到日志适配器列表中,以后就可以正常使用了。
java
Slog.plantTree(new FileTree());
注意: 在每个日志适配器中,我们可以根据需要最终自己确定将组装之后的日志或者原始日志如何处理。
通过继承LogAssembler
抽象类,我们可以实现自己定义的日志组装器。
public class SimpleLogAssembler extends LogAssembler {
@Override
protected void onFormatModeLogMethodStackTrace(List compoundMessagesList, int methodCount, int stackOffset,
StackTraceElement[] trace) {
for (int i = methodCount; i > 0; i--) {
int stackIndex = i + stackOffset;
if (stackIndex >= trace.length) {
continue;
}
//noinspection StringBufferReplaceableByString
StringBuilder builder = new StringBuilder();
builder.append(getSimpleClassName(trace[stackIndex].getClassName()))
.append(".")
.append(trace[stackIndex].getMethodName())
.append("(")
.append(trace[stackIndex].getFileName())
.append(":")
.append(trace[stackIndex].getLineNumber())
.append(")");
compoundMessagesList.add(builder.toString());
}
}
@Override
protected void onFormatModeLogThreadInfo(List compoundMessagesList, Thread curThread) {
compoundMessagesList.add(Helper.createThreadInfo(curThread));
}
@Override
protected void onFormatModeLogContent(List compoundMessagesList, Throwable t, Object originalObject, Object[] args) {
String[] compoundMessages = compoundMessage(t, originalObject, args);
for (String compoundMessage : compoundMessages) {
String[] splitMessages = compoundMessage.split(LINE_SEPARATOR);
Collections.addAll(compoundMessagesList, splitMessages);
}
}
}
以上三个方法是子类必须要实现的,还有其他的方法子类可以选择性的复写。
以下是调用实例。
Slog.setLogAssembler(new SimpleLogAssembler());
Slog.i("set log assembler to simple");
Slog.m(10).i("simple log assembler set methodCount to 10");
// 设置为null,将使用默认的日志组装器
Slog.setLogAssembler(null);
Slog.i("Slog.setLogAssembler(null), so turn to default log assembler");
另外,我们也可以在初始化时调用Slog.init(Tree, LogAssembler)
方法时进行指定日志组装器。
SlogTest
测试用例集更多的用法可以参考slog/src/androidTest/java/com.sky.slog/SlogTest.java
。
Slog打印日志的基本流程可以归纳为以下几个步骤。
Slog
接口。Priority
)。简单的流程图。
简单的类图。
LogAssembler
,日志组装器的抽象类,负责对日志进行组装,调用分发器将组装好的日志进行分发。LogDispatcher
,日志分发器接口。LogController
,分别实现了TreeManger
,LogDispatcher
接口,通过其分发日志功能,将日志分发到其管理的日志适配器中。本库最终形成,分别参考了以下三个库,本库的设计借鉴了它们的设计思想与代码实现,十分感谢。
Logger
: https://github.com/orhanobut/logger
Timber
: https://github.com/JakeWharton/timber
ViseLog
: https://github.com/xiaoyaoyou1212/ViseLog