好用高扩展性的Android平台日志框架Slog
来源:互联网 发布:哪个软件修改照片大小 编辑:程序博客网 时间:2024/05/17 22:49
Slog
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.
以上方法的作用与默认值。
注意,上表中,如果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);
打印错误日志
// 打印throwableSlog.e(new Throwable());Slog.w(new RuntimeException(), "test log with warn priority = %d", Slog.WARN);
打印json
和xml
json
和xml
字符串采用的日志级别都是Debug
的。
打印json字符串
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 = "<?xml version=\"1.0\" encoding=\"utf-8\"?>\n" + "<manifest xmlns:android=\"http://schemas.android.com/apk/res/android\"\n" + " package=\"com.sky.tools\" >\n" + "\n" + " <application\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" + " <activity android:name=\".main.MainActivity\" >\n" + " <intent-filter>\n" + " <action android:name=\"android.intent.action.MAIN\" />\n" + "\n" + " <category android:name=\"android.intent.category.LAUNCHER\" />\n" + " </intent-filter>\n" + " </activity>\n" + " </application>\n" + "\n" + "</manifest>";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);// 打印StringString[] 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<Student> 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 mapMap<Integer, Student> map = new HashMap<>();Slog.d(map);// int mapMap<Integer, Integer> 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 MapMap<Object, String> objectStringMap = new LinkedHashMap<>();objectStringMap.put(new Object(), "11223786");objectStringMap.put(new Object(), "475775486");objectStringMap.put(new Object(), "7856874757");Slog.d(objectStringMap);// student Mapmap.put(12345, new Student(12345, 54, "sky", true));map.put(123456, new Student(123456, 56, "sky2", true));map.put(1234567, new Student(1234567, 15, "sky3", true));map.put(12345678, new Student(12345678, 25, "sky4", true));map.put(1234555, new Student(1234555, 35, "sky5", true));map.put(12345444, new Student(12345444, 45, "sky6", true));Slog.d(map);// map itselfMap map1 = new Hashtable<>();//noinspection CollectionAddedToSelf,uncheckedmap1.put(map1, map1);Slog.d(map1);
指定临时的配置项打印日志
前面的示例都是不修改输出配置项时打印的日志,但是在很多时候我们可能根据不同的场景,需要采用不同的日志输出配置。
除了前面说的使用Slog.getSetting()
方法获取Setting
对象之后,修改全局输出配置外,Slog
框架还支持指定临时输出配置,只在下次当前线程打印日志时生效一次的方式更改日志输出效果。
具体包括以下几个方法。
Slog.t() // 指定下一次当前线程打印日志的tag,最终输出的日志的Tag组合为: prefixTag-tagSlog.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<String> 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<String> compoundMessagesList, Thread curThread) { compoundMessagesList.add(Helper.createThreadInfo(curThread)); } @Override protected void onFormatModeLogContent(List<String> 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
- 好用高扩展性的Android平台日志框架Slog
- Android更好的扩展性更强网络请求框架----okhttp
- 框架和平台的扩展性
- Log、Rlog和Slog的区别
- 模块化的Web新平台 IIS7.5扩展性讨论
- Jeecg平台扩展性不好的地方收集启动。
- Struts框架可扩展性
- android的volley框架使用日志1
- Android下的自定义日志框架
- 超好用的Android日志打印框架--Logger
- 超好用的Android日志打印框架--Logger
- 超好用的Android日志打印框架--Logger
- 空-Android平台的WiFi框架
- android -日志框架
- android平台框架原理
- Android平台日志收集系统
- 【转】MEF 扩展性管理框架
- 关于Android模块化、低耦合、高扩展性的架构设计
- 线程安全的单例模式
- c++语言 全局变量 可声明问题
- 关于svn出现"上次提交后没有更改或添加的文件"的解决方法
- LeetCode 50. Pow(x, n)
- Linux下oracle数据库启动和关闭操作
- 好用高扩展性的Android平台日志框架Slog
- MySQL多实例配置(一)
- <c:forEach>
- 后台对象转json格式字符串
- Python 求两个 list 的交集和差集
- 一系列的注解的解释
- 欢迎使用CSDN-markdown编辑器
- 高并发下线程安全的单例模式(最全最经典)
- #No DCMA# hostsolutions-7折优惠码/VPS/独立服务器/罗马尼亚/无视版权