基本使用
基本使用
在正式打印日志之前,你需要确保你使用了正确的 Printer.
输出空消息
所谓”空”消息,指的是你不需要关注它的内容,只需要在这个地方有一行日志输出即可。 空消息在 PLog 中被单列为一个方法,你可以在任何地方直接调用:
PLog.empty();
空消息会以特定的级别和内容输出,你可以在 设置 中修改它们。
输出普通消息
基础打印方法有一组共五个签名类似的方法:
v(String msg, Object... params)
d(String msg, Object... params)
i(String msg, Object... params)
w(String msg, Object... params)
e(String msg, Object... params)
其中, msg 参数支持标准的 String Format,你可以在之后跟上对应个数的实际参数:
PLog.v("This is a verbose log.");
PLog.d("This is a debug log. param is %d, %.2f and %s", 1, 2.413221, "Great");
PLog.i("This is an info log.");
PLog.w("This is a warn log.");
PLog.e("This is an error log.");
打印任意对象
有时候你可能不需要任何额外的消息封装,比如单纯打印一个对象的值,或者一串 JSON :
PLog.objects(obj); //obj can be any type
PLog.objects("{key:"value", another:"Another"}");
链式调用
PLog v2 允许你使用链式调用语法来创建任意复杂的日志需求。 你可以通过任意一种方式创建一个 LogRequest
,然后调用其 print()
方法即可:
//In PLog v2, auto tag is strongly recommended;
//If you really need specify tag somewhere, you should use builder:
new LogRequest()
.tag("InfoTag")
.level(Log.INFO)
.msg("This is an info log using specified tag.")
//DO NOT FORGET TO CALL PRINT!
.print();
关于链式请求上所有参数的含义,请参阅 LogRequest。