優化KLog工具文件保存

感謝凱哥的KLog,對我的Android開發給予了很大的幫助。KLog是一款開發中很好用的log工具,功能都很棒,就是在日誌保存這有點瑕疵。最近由於項目需要把log存儲本地中方便後面問題排查,看下KLog的保存只支持單條日誌單個文件保存,這樣很不好,我的需求是實現全局配置後的log保存,並清理清理指定過期時間前的文件,所以我就安裝我的需要修改了源碼,爲了方便自己和大家就寫了這邊文章,歡迎大家點評。

主要修改兩個地方,一是 、修改KLog的初始化方法如下:

/**
     * init Plog
     */
    public synchronized static void init(Application application, boolean debug) {
        mContext = application.getApplicationContext();
        DEBUG = debug;
        //7 day expired
        deleteExpiredLogs(7);
    }

二是、在打印log新裏執行本地文件保存,我自己只需要保存“D”、“E”兩個級別的log。

private static void printLog(int type, String tagStr, Object... objects) {
        if (!DEBUG) {
            return;
        }
        String[] contents = wrapperContent(STACK_TRACE_INDEX_5, tagStr, objects);

        String tag = contents[0];
        String msg = contents[1];
        String headString = contents[2];
        if (type==D||type==E){
            print(type, tagStr, headString, Arrays.toString(objects));
        }
        switch (type) {
            case V:
            case D:
            case I:
            case W:
            case E:
            case A:
                printDefault(type, tag, headString, headString + msg);
                break;
            case J:
                printJson(tag, msg, headString);
                break;
            case X:
                printXml(tag, msg, headString);
                break;
            default:
        }
    }

就是這麼簡單,本地log,studio log兩不誤。還可以不少完善地方,比如可以指定log是否保存,而不是全部強制保存,比如配置保存的日誌級別等,這邊可以工具直接的需要去定製,下面是log工具完整源碼。


/**
 * 說明:
 *
 * @author Pan Yingdao
 * @time : 2019/9/24/024
 */
public class Plog {
    private static final String LINE_SEPARATOR = System.getProperty("line.separator");
    private static final String NULL_TIPS = "Log with null object";
    private static final String TAG = "Plog";
    private static final String SUFFIX = ".java";
    private static final int V = 0x1;
    private static final int D = 0x2;
    private static final int I = 0x3;
    private static final int W = 0x4;
    private static final int E = 0x5;
    private static final int A = 0x6;
    private static final int J = 0x7;
    private static final int X = 0x8;
    private static boolean DEBUG = true;
    private static String mGlobalTag;
    private static boolean mIsGlobalTagEmpty = true;
    @SuppressLint("StaticFieldLeak")
    private static Context mContext;

    /**
     * init Plog
     */
    public synchronized static void init(Application application, boolean debug) {
        mContext = application.getApplicationContext();
        DEBUG = debug;
        //7 day expired
        deleteExpiredLogs(7);
    }

    /**
     * init Plog
     */
    public synchronized static void init(Application application, boolean debug, @Nullable String tag) {
        mContext = application.getApplicationContext();
        DEBUG = debug;
        mGlobalTag = tag;
        mIsGlobalTagEmpty = TextUtils.isEmpty(mGlobalTag);
        //7 day expired
        deleteExpiredLogs(7);
    }

    public static void v(Object msg) {
        printLog(V, null, msg);
    }

    public static void v(String tag, Object... objects) {
        printLog(V, tag, objects);
    }

    public static void d(Object msg) {
        printLog(D, null, msg);
    }

    public static void d(String tag, Object... objects) {
        printLog(D, tag, objects);
    }

    public static void i(Object msg) {
        printLog(I, null, msg);
    }

    public static void i(String tag, Object... objects) {
        printLog(I, tag, objects);
    }

    public static void w(Object msg) {
        printLog(W, null, msg);
    }

    public static void w(String tag, Object... objects) {
        printLog(W, tag, objects);
    }

    public static void e(Object msg) {
        printLog(E, null, msg);
    }

    public static void e(String tag, Object... objects) {
        printLog(E, tag, objects);
    }

    public static void a(Object msg) {
        printLog(A, null, msg);
    }

    public static void a(String tag, Object... objects) {
        printLog(A, tag, objects);
    }

    public static void json(String jsonFormat) {
        printLog(J, null, jsonFormat);
    }

    public static void json(String tag, String jsonFormat) {
        printLog(J, tag, jsonFormat);
    }

    public static void xml(String xml) {
        printLog(X, null, xml);
    }

    private static void printLog(int type, String tagStr, Object... objects) {
        if (!DEBUG) {
            return;
        }
        String[] contents = wrapperContent(tagStr, objects);

        String tag = contents[0];
        String msg = contents[1];
        String headString = contents[2];

        if (type==D||type==E){
            print(type, tagStr, headString, Arrays.toString(objects));
        }
        switch (type) {
            case V:
            case D:
            case I:
            case W:
            case E:
            case A:
                printDefault(type, tag, headString, headString + msg);
                break;
            case J:
                printJson(tag, msg, headString);
                break;
            case X:
                printXml(tag, msg, headString);
                break;
            default:
        }
    }

    private static String[] wrapperContent2(String tagStr, Object... objects) {
        final int stackTraceIndex = 5;
        final String suffix = ".java";
        StackTraceElement[] stackTrace = Thread.currentThread().getStackTrace();
        StackTraceElement targetElement = stackTrace[stackTraceIndex];
        String className = targetElement.getClassName();
        String[] classNameInfo = className.split("\\.");
        if (classNameInfo.length > 0) {
            className = classNameInfo[classNameInfo.length - 1] + suffix;
        }
        if (className.contains("$")) {
            className = className.split("\\$")[0] + suffix;
        }
        String methodName = targetElement.getMethodName();
        int lineNumber = targetElement.getLineNumber();
        if (lineNumber < 0) {
            lineNumber = 0;
        }
        String methodNameShort = methodName.substring(0, 1).toUpperCase() + methodName.substring(1);
        String tag = (tagStr == null ? className : tagStr);
        if (TextUtils.isEmpty(tag)) {
            tag = TAG;
        }
        String msg = (objects == null) ? NULL_TIPS : getObjectsString(objects);
        String headString = "[ (" + className + ":" + lineNumber + ")#" + methodNameShort + " ] ";
        return new String[]{tag, msg, headString};
    }

    private static String[] wrapperContent(String tagStr, Object... objects) {

        StackTraceElement[] stackTrace = Thread.currentThread().getStackTrace();
        StackTraceElement targetElement = stackTrace[5];
        String className = targetElement.getClassName();
        String[] classNameInfo = className.split("\\.");
        if (classNameInfo.length > 0) {
            className = classNameInfo[classNameInfo.length - 1] + SUFFIX;
        }

        if (className.contains("$")) {
            className = className.split("\\$")[0] + SUFFIX;
        }

        String methodName = targetElement.getMethodName();
        int lineNumber = targetElement.getLineNumber();

        if (lineNumber < 0) {
            lineNumber = 0;
        }

        String tag = (tagStr == null ? className : tagStr);

        if (mIsGlobalTagEmpty && TextUtils.isEmpty(tag)) {
            tag = TAG;
        } else if (!mIsGlobalTagEmpty) {
            tag = mGlobalTag;
        }

        String msg = (objects == null) ? NULL_TIPS : getObjectsString(objects);
        String headString = "[ (" + className + ":" + lineNumber + ")#" + methodName + " ] ";

        return new String[]{tag, msg, headString};
    }

    private static String getObjectsString(Object... objects) {
        if (objects.length > 1) {
            StringBuilder stringBuilder = new StringBuilder();
            stringBuilder.append("\n");
            for (int i = 0; i < objects.length; i++) {
                Object object = objects[i];
                if (object == null) {
                    stringBuilder.append("Param").append("[").append(i).append("]").append(" = ").append("null").append("\n");
                } else {
                    stringBuilder.append("Param").append("[").append(i).append("]").append(" = ").append(object.toString()).append("\n");
                }
            }
            return stringBuilder.toString();
        } else {
            Object object = objects[0];
            return object == null ? "null" : object.toString();
        }
    }

    private static void printDefault(int type, String tag, String headString, String msg) {
        int index = 0;
        int maxLength = 4000;
        int countOfSub = msg.length() / maxLength;
        if (countOfSub > 0) {
            for (int i = 0; i < countOfSub; i++) {
                String sub = msg.substring(index, index + maxLength);
                print(type, tag, headString, sub);
                index += maxLength;
            }
            print(type, tag, headString, msg.substring(index));
        } else {
            print(type, tag, headString, msg);
        }
    }

    private static void print(int type, String tag, String headString, String msg) {
        switch (type) {
            case V:
//                log2File("V", tag, msg);
                Log.v(tag, msg);
                break;
            case D:
                log2File2("D", tag, msg, headString, getLogFileName(new Date()));
                Log.d(tag, msg);
                break;
            case I:
//                log2File("I", tag, msg);
                Log.i(tag, msg);
                break;
            case W:
//                log2File("W", tag, msg);
                Log.w(tag, msg);
                break;
            case E:
//                log2File("E", tag, msg, null);
                File file = new File(MY_LOG_URL);
                if (!file.exists()) {
                    KLog.e("創建log: " + file.mkdirs());
                }
                log2File2("E", MY_LOG_URL, msg, headString, getLogFileName(new Date()));
                Log.e(tag, msg);
                break;
            case A:
//                log2File2("A", tag, msg, getLogFileName(new Date()));
                Log.wtf(tag, msg);
                break;
            default:
        }
    }

    private static void printJson(String tag, String msg, String headString) {
        String message;
        try {
            final int jsonIndent = 4;
            if (msg.startsWith("{")) {
                JSONObject jsonObject = new JSONObject(msg);
                message = jsonObject.toString(jsonIndent);
            } else if (msg.startsWith("[")) {
                JSONArray jsonArray = new JSONArray(msg);
                message = jsonArray.toString(jsonIndent);
            } else {
                message = msg;
            }
        } catch (JSONException e) {
            message = msg;
        }
        Log.d(tag, "╔═══════════════════════════════════════════════════════════════════════════════════════");
        message = headString + LINE_SEPARATOR + message;
        String[] lines = message.split(LINE_SEPARATOR);
        for (String line : lines) {
            Log.d(tag, "║ " + line);
        }
        Log.d(tag, "╚═══════════════════════════════════════════════════════════════════════════════════════");
    }

    private static void printXml(String tag, String xml, String headString) {
        if (xml != null) {
            xml = formatXml(xml);
            xml = headString + "\n" + xml;
        } else {
            xml = headString + NULL_TIPS;
        }
        Log.d(tag, "╔═══════════════════════════════════════════════════════════════════════════════════════");
        String[] lines = xml.split(LINE_SEPARATOR);
        for (String line : lines) {
            if (!(TextUtils.isEmpty(line) || "\n".equals(line) || "\t".equals(line) || TextUtils.isEmpty(line.trim()))) {
                Log.d(tag, "║ " + line);
            }
        }
        Log.d(tag, "╚═══════════════════════════════════════════════════════════════════════════════════════");
    }

    private static String formatXml(String inputXml) {
        try {
            Source xmlInput = new StreamSource(new StringReader(inputXml));
            StreamResult xmlOutput = new StreamResult(new StringWriter());
            Transformer transformer = TransformerFactory.newInstance().newTransformer();
            transformer.setOutputProperty(OutputKeys.INDENT, "yes");
            transformer.setOutputProperty("{http://xml.apache.org/xslt}indent-amount", "2");
            transformer.transform(xmlInput, xmlOutput);
            return xmlOutput.getWriter().toString().replaceFirst(">", ">\n");
        } catch (Exception e) {
            e.printStackTrace();
            return inputXml;
        }
    }

    private static String getLogFileName(Date date) {
        SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd", Locale.getDefault());
        return sdf.format(date) + ".txt";
    }

    private static synchronized void log2File2(String level, String path, String msg, String headString, String fileName) {
        Date now = new Date();
        SimpleDateFormat sdf = new SimpleDateFormat("HH:mm:ss", Locale.getDefault());
        String fileName2 = path + ((fileName == null) ? getLogFileName(now) : fileName);

        File file = new File(fileName2);
        OutputStream outputStream = null;

        try {

            outputStream = new FileOutputStream(file, true);

            StringBuilder sb = new StringBuilder();
            sb.append(level);
            sb.append(" ");
            sb.append(sdf.format(now));
            sb.append(" ");
            sb.append(headString);
            sb.append(" ");
            sb.append(msg);
            sb.append("\n");
            StringWriter sw = new StringWriter();
            sb.append(sw.toString());
            sb.append("\n");
            byte[] data = sb.toString().getBytes();
            for (byte datum : data) {
                outputStream.write(datum);
            }
            outputStream.flush();
            outputStream.close();
        } catch (Exception e) {
            Log.e(TAG, "添加日誌異常", e);
        } finally {
            if (outputStream != null) {
                try {                 
                    outputStream.close();
                } catch (IOException e) {
                    Log.e(TAG, "關閉日誌文件異常", e);
                }
            }
        }
    }


    /**
     * 檢查是否有需要清理文件
     */
    private static void deleteExpiredLogs(int day) {
        File dir = new File(MY_LOG_URL);
        File[] subFiles = dir.listFiles();
        if (subFiles != null) {
            int logFileCnt = 0;
            int expiredLogFileCnt = 0;
            //one day
            final int dayMilliseconds = 24 * 60 * 60 * 1000;
            //day * dayMilliseconds 表示7天的毫秒值
            long expiredTimeMillis = System.currentTimeMillis() - (day * dayMilliseconds);
            for (File file : subFiles) {
                ++logFileCnt;
                KLog.e("文件最後修改時間", file.lastModified());
                KLog.e("比較時間", expiredTimeMillis);
                if (file.lastModified() < expiredTimeMillis) {
                    ++expiredLogFileCnt;
                    boolean deleteResult = file.delete();
                    if (deleteResult) {
                        e(TAG, "Delete expired log files successfully:" + file.getName());
                        Log.e(TAG, "刪除過期日誌:文件總數=" + (subFiles.length) + ", 日誌文件數=" + logFileCnt + ", " +
                                "過期日誌文件數=" + expiredLogFileCnt);
                    } else {
                        e(TAG, "Delete expired log files failure:" + file.getName());
                    }
                } else {
                    KLog.e("當前log文件沒有過期", file.getName());
                }
            }
        }
    }

}

 

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章