Android 自定义日志字符串高性能保存到文件框架实现

1，前语

之前使用了两三个热门的日志保存到文件结构，但还是有自定义麻烦、掉日志的情况，今日给出自完成此项需求的一种方法。

2，正文

2.1，代码完成：

object Log2FileUtils {
    private var fileName3 : File?= null
    private var txtFileName3 : File?= null
    private val strQueue: BlockingQueue<String> = LinkedBlockingQueue()
    private var saveThread3: Thread? = null
    fun tlog(s : String){
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {  //创立文件 android10及以上沙盒机制
            fileName3 =
                File(Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOCUMENTS)
                    .toString() + "/dukerDev/Log")
            if(!fileName3!!.exists()){
                fileName3!!.mkdirs()
            }
            txtFileName3 = File(Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOCUMENTS)
                .toString() + "/dukerDev/Log" + "/${getDateV1()}.txt")//以当天日期创立新的文件
            if(!txtFileName3!!.isFile){
                txtFileName3!!.createNewFile()
            }
        } else {
            fileName3 =
                File(Environment.getExternalStorageDirectory().toString() + "/dukerDev/Log")
            if(!fileName3!!.exists()){
                fileName3!!.mkdirs()
            }
            txtFileName3 =  File(Environment.getExternalStorageDirectory().toString() + "/dukerDev/Log" + "/${getDateV1()}.txt")
            if(!txtFileName3!!.isFile){
                txtFileName3!!.createNewFile()
            }
        }
        val s1 = "${getTimeV3()}: ${s}\n"  //在日志前加上毫秒级时间
        if (!strQueue.offer(s1)) {  //把日志写入到行列
            Log.e("dukerDev","日志写缓冲区已满")
        }
        if(saveThread3 == null || !saveThread3!!.isAlive){//第一次调用时，发动写文件线程
            saveThread3 = Thread(saveRunnable3, "save-thread3").apply { start() }
        }
    }
    private val saveRunnable3 = Runnable {  //写文件专用线程
        try {
            while (true){
                val str = strQueue.take()  //从行列中取日志
                writeToFile(str)
            }
        } catch (e: Exception) {
            Log.e("dukerDev","save3Runnable err ${e.message}")
        }
    }
    private fun writeToFile(s : String) {  //将日志写入到文件
        val buffer: ByteArray = s.toByteArray()
        var out: OutputStream? = null
        try {
            out = FileOutputStream(txtFileName3, true)
            out.write(buffer, 0, buffer.size)
        } catch (ex: java.lang.Exception) {
            Log.e("dukerDev","ex err ${ex.message}")
        } finally {
            try {
                out!!.close()
            } catch (ioEx: IOException) {
                Log.e("dukerDev","ioEx err ${ioEx.message}")
            }
        }
    }
}

fun getDateV1() = SimpleDateFormat("yyyy-MM-dd").format(Date())!!
fun getTimeV3() = SimpleDateFormat("yyyy-MM-dd HH:mm:ss:SSS").format(Date())

2.2，使用：

tlog("dukerDev test01")
Log2FileUtils.tlog("dukerDev test02")

2.3，文件输出：

2022-10-24 10:24:00:000: dukerDev test01
2022-10-24 10:24:00:060: dukerDev test02

2.4，说明：

1，创立文件时是以当天日期命名创立一个新的文件，避免一切日志全写到一个文件，查阅日志不方便
2，日志时间前缀准确到毫秒
3，专用写文件线程，确保性能
4，从行列写入读取，避免写日志时丢失或犯错
5，此东西结构不太适用于特别大数据量的日志写入，特别大数据量能够考虑StringBuilder一次性写入文件

2.5，留意：

1，使用前需请求及动态获取文件读写权限
2，若创立文件或写文件失利，尝试在AndroidManifest.xml文件中增加 android:requestLegacyExternalStorage=”true”

转载请注明出处/post/715798…

不完善或不正确的当地，欢迎大家谈论区提出或弥补