PLog

java.lang.Object
- org.mym.plog.PLog

```
public final class PLog
extends Object
```
Entry of all library public API; you can set configurations and launch log requests using this class with only a static method call.

Since:

1.0.0

Method Summary

All Methods Static Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`static void`	`appendPrinter(Printer printer)` Append an extra printer to currently printer collection.
`static LogRequest`	`category(Category category)`
`static LogRequest`	`category(String category)`
`static void`	`d(String msg, Object... params)`
`static void`	`e(String msg, Object... params)`
`static void`	`empty()` Print a predefined message using a predefined level.
`static PLogConfig`	`getCurrentConfig()` Get current config, useful for temporarily change config and backup then.
`static void`	`i(String msg, Object... params)`
`static void`	`init(PLogConfig config)` Init PLog using customized config.
`static void`	`json(JSONObject jsonObject)` Deprecated. use `objects(Object...)` instead.
`static LogRequest`	`level(int level)`
`static void`	`objects(Object... params)` A recommended helper method useful when you just want to print objects using default format.
`static void`	`prepare(Printer... printers)` Prepare printers; this method should always be called on application start because you should set your own onIntercept logic using `Printer` interface.
`static void`	`printStackTraceHere()` A helper method to print a PLOG call stack trace here.
`static LogRequest`	`tag(String tag)`
`static void`	`throwable(Throwable throwable)` Print exceptions in WARN level.
`static void`	`v(String msg, Object... params)`
`static void`	`w(String msg, Object... params)`
`static void`	`wtf(Throwable throwable)` What a Terrible Failure: Report an exception that should never happen.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Method Detail
  - init
```
public static void init(PLogConfig config)
```
    Init PLog using customized config.
  - getCurrentConfig
```
@NonNull
public static PLogConfig getCurrentConfig()
```
    Get current config, useful for temporarily change config and backup then. Another scenario is to debug this library, or using in extend libraries.
    
    Returns:
    
    Current config; or default config if init(PLogConfig) is not called yet.
    
    Since:
    
    1.3.0
    
    See Also:
    
    init(PLogConfig)
  - category
```
public static LogRequest category(String category)
```
  - category
```
public static LogRequest category(@NonNull
                                  Category category)
```
  - level
```
public static LogRequest level(int level)
```
  - tag
```
public static LogRequest tag(@NonNull
                             String tag)
```
  - v
```
public static void v(String msg,
                     Object... params)
```
  - d
```
public static void d(String msg,
                     Object... params)
```
  - i
```
public static void i(String msg,
                     Object... params)
```
  - w
```
public static void w(String msg,
                     Object... params)
```
  - e
```
public static void e(String msg,
                     Object... params)
```
  - empty
```
public static void empty()
```
    Print a predefined message using a predefined level.
    
    See Also:
    
    PLogConfig.Builder.emptyMsg(String), PLogConfig.Builder.emptyMsgLevel(int)
  - printStackTraceHere
```
public static void printStackTraceHere()
```
    A helper method to print a PLOG call stack trace here.
    
    Since:
    
    2.0.0-beta4
  - objects
```
public static void objects(Object... params)
```
    A recommended helper method useful when you just want to print objects using default format. The log level for this method is defined as
```
Log.DEBUG
```
    .
    Parameters:
    
    params - objects to print.
  - json
```
public static void json(JSONObject jsonObject)
```
    Deprecated. use objects(Object...) instead.
    
    Print out json string representing by a JSONObject.
    
    Since:
    
    2.0.0
  - throwable
```
public static void throwable(Throwable throwable)
```
    Print exceptions in WARN level.
  - wtf
```
public static void wtf(Throwable throwable)
```
    What a Terrible Failure: Report an exception that should never happen.
  - prepare
```
public static void prepare(Printer... printers)
```
    Prepare printers; this method should always be called on application start because you should set your own onIntercept logic using Printer interface.
```
     
 PLog.prepare(new DebugPrinter(BuildConfig.DEBUG));
     
 
```
    Note that calling this method will clear all printers set before.
    Parameters:
    
    printers - printers to print logs; they are parallel from each other.
  - appendPrinter
```
public static void appendPrinter(@NonNull
                                 Printer printer)
```
    Append an extra printer to currently printer collection.
    
    Parameters:
    
    printer - cannot be null

Class PLog

Method Summary

Methods inherited from class java.lang.Object

Method Detail

init

getCurrentConfig

category

category

level

tag

v

d

i

w

e

empty

printStackTraceHere

objects

json

throwable

wtf

prepare

appendPrinter