2019-04-18 Android打印超长日志(格式化日志,提高日志调试效率)

背景

在使用mp4v2库封装mp4文件的时候,怀疑输入的帧数据有问题导致写入文件失败,因为一些原因,被迫必须以十六进制打印写入的帧数据内容。
众所周知,系统的Log方法能打印日志到Logcat中,但是日志长度是受限的,只不过我们一般用不到那么长,最长不会超过 4 * 1024 个字节,超出会被截断,至于究竟限制多少,不在文章讨论范围内,可以参考这个 "终于知道Log显示不全的原因了",我们这里主要是讨论怎么打印的更多。

方法

方法很简单粗暴,既然一个日志写不下,那就再加几个,采用分段打印的方式,简单点来说,就是在自定义的打印日志方法中加一个方法,或者干脆专门创建一个单独的日志类来实现,最终还是使用系统的Log类,不建议使用println等方式绕过系统,虽然显得你能力强,但是有违代码复用的思想。
直接上代码:

package com.vihivision.camerafamilyKey.util;

import android.text.TextUtils;
import android.util.Log;

/**
 * Apr 18, 2019 Create by Martin
 * 日志类,支持普通及超长日志的打印
 * */
public class HHLog {
    private final static int SEGMENT_MAX_SIZE = 3 * 1024;
    private final static int STACK_TRACE_ELEMENT_INDEX = 4;
    private final static int V = 1;
    private final static int D = 2;
    private final static int I = 3;
    private final static int W = 4;
    private final static int E = 5;
    /**
     * 对应Log.e(String tag, String msg)进行打印,日志等级:错误
     * @param tag 标签,可以在logcat工具中被识别
     * @param object 日志内容,需要被打印输出的内容
     * */
    public static void e(String tag, Object object) {
        boolean illegalTag = false;
        boolean illegalObject = false;
        if (TextUtils.isEmpty(tag)) {
            illegalTag = true;
        }
        if (object == null || object.toString().length() == 0) {
            illegalObject = true;
        }
        if (illegalTag || illegalObject) {
            return;
        }
        String message = object.toString();
        int length = message.length();
        if (length <= SEGMENT_MAX_SIZE) {
            formatLog(E, tag, message);
        }else {
            while (message.length() > SEGMENT_MAX_SIZE) {
                String logContent = message.substring(0, SEGMENT_MAX_SIZE);
                message = message.substring(SEGMENT_MAX_SIZE);
                formatLog(E, tag, logContent);
            }
            formatLog(E, tag, message);
        }
    }
    
    /**
     * 对应Log.e(String tag, String msg, Throwable tr)进行打印,日志等级:错误
     * @param tag 标签,可以在logcat工具中被识别
     * @param object 日志内容,需要被打印输出的内容
     * @param thr 异常信息,应一并输出到日志
     * */
    public static void e(String tag, Object object, Throwable thr) {
        //Implementation
    }
    /**
     * 格式化并执行打印
     * @param type 日志等级,包含 5 种:V、D、I、W、E,且只能是这4个
     * @param tag 标签
     * @param object 日志内容
     * */
    private static void formatLog(int type, String tag, Object object) {
        StackTraceElement[] stackTraceElements = Thread.currentThread().getStackTrace();
        String filename = stackTraceElements[STACK_TRACE_ELEMENT_INDEX].getFileName();
        String classStr = stackTraceElements[STACK_TRACE_ELEMENT_INDEX].getClassName();
        String methodStr = stackTraceElements[STACK_TRACE_ELEMENT_INDEX].getMethodName();
        int lineNumber = stackTraceElements[STACK_TRACE_ELEMENT_INDEX].getLineNumber();

        StringBuilder stringBuilder = new StringBuilder();
        stringBuilder.append("[ (").append(filename).append(":").append(lineNumber).append(")#").append(methodStr).append(" ]");

        String messageContent = object.toString();
        stringBuilder.append(messageContent);
        
        switch (type) {
            case V:
                Log.v(tag, stringBuilder.toString());
                break;
            case D:
                Log.d(tag, stringBuilder.toString());
                break;
            case I:
                Log.i(tag, stringBuilder.toString());
                break;
            case W:
                Log.w(tag, stringBuilder.toString());
                break;
            case E:
                Log.e(tag, stringBuilder.toString());
                break;
            default:
                break;
        }

    }
}

代码解析

此处代码是新建了一个日志类HHLog,如果用户已经有一个日志类了,可以直接把类中的代码全部移过去,或者设计合适的设计模式,比如工厂类,由工厂类来统一管理多种日志类,不过实际项目中,建议还是使用一个就好了,设计模式在此处画蛇添足了。

HHLog中公开的静态方法:

    /**
     * 对应Log.e(String tag, String msg)进行打印,日志等级:错误
     * @param tag 标签,可以在logcat工具中被识别
     * @param object 日志内容,需要被打印输出的内容
     * */
    public static void e(String tag, Object object) {……}
   /**
     * 对应Log.e(String tag, String msg, Throwable tr)进行打印,日志等级:错误
     * @param tag 标签,可以在logcat工具中被识别
     * @param object 日志内容,需要被打印输出的内容
     * @param thr 异常信息,应一并输出到日志
     * */
    public static void e(String tag, Object object, Throwable thr) {……}

这里实现的是日志等级为Error的日志打印,开发者可以自行系统Log类中公开的那些静态方法,比如对应日志等级为Verbose、Debug、Info、Warn,每个日志等级都有两个方法,一个是普通的日志信息打印,另一个增加了异常信息Throwable的输出。

HHLog中私有的静态方法:

/**
     * 格式化并执行打印
     * @param type 日志等级,包含 5 种:V、D、I、W、E,且只能是这4个
     * @param tag 标签
     * @param object 日志内容
     * */
    private static void formatLog(int type, String tag, Object object) {……}

这里主要就是格式化输出,获取调用栈内的信息,格式化后添加到日志输出字符串的前部,使日志内容一目了然,其中

stringBuilder.append("[ (").append(filename).append(":").append(lineNumber).append(")#").append(methodStr).append(" ]");

特殊的格式利用了强大的Logcat工具,可以在Logcat中进行日志代码的快速定位,如图:

Logcat工具日志快速定位

点击图中 蓝色字部分 可以快速定位到日志所在代码行,有效提高日志调试效率。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 215,874评论 6 498
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,102评论 3 391
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 161,676评论 0 351
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,911评论 1 290
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,937评论 6 388
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,935评论 1 295
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,860评论 3 416
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,660评论 0 271
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,113评论 1 308
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,363评论 2 331
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,506评论 1 346
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,238评论 5 341
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,861评论 3 325
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,486评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,674评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,513评论 2 368
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,426评论 2 352