Logger (newaer-sdk-proximity API)

java.lang.Object
- com.newaer.sdk.proximity.Logger

```
public class Logger
extends Object
```
This class provides logging facilities for the NewAer SDK. In debug mode it logs using the package and class name. In production mode it logs using the NewAerSDK tag.

Field Summary

Fields
Modifier and Type	Field and Description
`protected static boolean`	`APP_LOGGING` Should app tags be logged?
`protected static String`	`APPLICATION` Used for APPLICATION related logging.
`protected static boolean`	`DEBUG_ENABLED` Are we in DEBUG mode?
`protected static boolean`	`DEBUG_LOG_OVERRIDE`
`protected static int`	`HALF_TAG_LENGTH`
`protected static boolean`	`INFO_ENABLED`
`protected static String[][]`	`LOG_CATEGORY` All the prefixes we know how to shorten.
`protected static int`	`MAX_TAG_LENGTH`
`protected String`	`mCategoryTag` The tag used for this instance.
`protected boolean`	`mIsAppTag` Is this an app level tag? Toggles printing when DEBUG_ENABLED is false;
`protected static String`	`PLATFORM` Used for PLATFORM related logging.
`protected static String`	`SDK_TAG` Used as TAG for all logging when not in Debug mode

Constructor Summary

Constructors
Constructor and Description

Logger(Class<?> cls)
Construct a logger for the given class.

Logger(Class<?> cls, String tag)

Constructors
Constructor and Description
`Logger(Class<?> cls)` Construct a logger for the given class.
`Logger(Class<?> cls, String tag)`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`protected String`	`buildLogString(Object... data)` Builds a string out of a number of objects.
`protected String`	`buildTag(Class<?> cls)` Builds the log tag used for this class.
`void`	`d(Object... data)` Log a number of arguments at debug level.
`void`	`d(String log)` Log a single string at debug level.
`static String`	`devices(Collection<? extends NADevice> devices)`
`void`	`devices(String description, Collection<? extends NADevice> devices)` Log a list of devices with their names and addresses.
`void`	`devices(String description, String subDescription, Collection<? extends NADevice> devices)` Log a list of devices with their names and addresses.
`void`	`e(Object... data)` Log a number of arguments at error level.
`void`	`e(String log)`
`void`	`e(String log, Throwable e)`
`void`	`i(Object... data)` Log a number of arguments at info level.
`void`	`i(String log)` Log a single message at info level.
`static void`	`setAppLogging(boolean appLog)`
`static void`	`setDebugLogging(boolean debug)`
`static void`	`setInfoLogging(boolean debug)`
`void`	`setLogEntriesEnabled(boolean enabled)`
`protected boolean`	`shouldDebugLog()`
`protected boolean`	`shouldInfoLog(int level)`
`boolean`	`shouldLogtoLogEntries()`
`void`	`w(Object... data)` Log a number of arguments at warn level.
`void`	`w(String log)`

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

- Field Detail
  - HALF_TAG_LENGTH
```
protected static final int HALF_TAG_LENGTH
```
    See Also:
    
    Constant Field Values
  - DEBUG_LOG_OVERRIDE
```
protected static boolean DEBUG_LOG_OVERRIDE
```
  - MAX_TAG_LENGTH
```
protected static final int MAX_TAG_LENGTH
```
    See Also:
    
    Constant Field Values
  - SDK_TAG
```
protected static final String SDK_TAG
```
    Used as TAG for all logging when not in Debug mode
    
    See Also:
    
    Constant Field Values
  - PLATFORM
```
protected static final String PLATFORM
```
    Used for PLATFORM related logging.
    
    See Also:
    
    Constant Field Values
  - APPLICATION
```
protected static final String APPLICATION
```
    Used for APPLICATION related logging.
    
    See Also:
    
    Constant Field Values
  - DEBUG_ENABLED
```
protected static final boolean DEBUG_ENABLED
```
    Are we in DEBUG mode?
  - INFO_ENABLED
```
protected static boolean INFO_ENABLED
```
  - mCategoryTag
```
protected final String mCategoryTag
```
    The tag used for this instance.
  - mIsAppTag
```
protected boolean mIsAppTag
```
    Is this an app level tag? Toggles printing when DEBUG_ENABLED is false;
  - APP_LOGGING
```
protected static boolean APP_LOGGING
```
    Should app tags be logged?
  - LOG_CATEGORY
```
protected static final String[][] LOG_CATEGORY
```
    All the prefixes we know how to shorten. Note that order matters here. Longer prefixes must come before shorter.
- Constructor Detail
  - Logger
```
public Logger(Class<?> cls)
```
    Construct a logger for the given class.
    
    Parameters:
    
    cls - The class we will be logging for.
  - Logger
```
public Logger(Class<?> cls,
              String tag)
```
- Method Detail
  - setDebugLogging
```
public static void setDebugLogging(boolean debug)
```
  - setInfoLogging
```
public static void setInfoLogging(boolean debug)
```
  - setAppLogging
```
public static void setAppLogging(boolean appLog)
```
  - buildTag
```
protected String buildTag(Class<?> cls)
```
    Builds the log tag used for this class.
    
    Parameters:
    
    cls - The class to build a tag for.
    
    Returns:
    
    the log tag to be used for this class.
  - shouldInfoLog
```
protected boolean shouldInfoLog(int level)
```
  - shouldDebugLog
```
protected boolean shouldDebugLog()
```
  - shouldLogtoLogEntries
```
public boolean shouldLogtoLogEntries()
```
  - setLogEntriesEnabled
```
public void setLogEntriesEnabled(boolean enabled)
```
  - d
```
public void d(String log)
```
    Log a single string at debug level.
    
    Parameters:
    
    log - the message to log.
  - d
```
public void d(Object... data)
```
    Log a number of arguments at debug level.
    
    Parameters:
    
    data - the objects to combine into one string and then log.
  - i
```
public void i(String log)
```
    Log a single message at info level.
    
    Parameters:
    
    log - the message to log.
  - i
```
public void i(Object... data)
```
    Log a number of arguments at info level.
    
    Parameters:
    
    data - the objects to combine into one string and then log.
  - w
```
public void w(String log)
```
  - w
```
public void w(Object... data)
```
    Log a number of arguments at warn level.
    
    Parameters:
    
    data - the objects to combine into one string and then log.
  - e
```
public void e(String log)
```
  - e
```
public void e(Object... data)
```
    Log a number of arguments at error level.
    
    Parameters:
    
    data - the objects to combine into one string and then log.
  - e
```
public void e(String log,
              Throwable e)
```
  - devices
```
public void devices(String description,
                    String subDescription,
                    Collection<? extends NADevice> devices)
```
    Log a list of devices with their names and addresses.
    
    Parameters:
    
    description - a description of these devices.
    
    subDescription - a sub descripition of these devices.
    
    devices - the List of devices.
  - devices
```
public static String devices(Collection<? extends NADevice> devices)
```
  - devices
```
public void devices(String description,
                    Collection<? extends NADevice> devices)
```
    Log a list of devices with their names and addresses.
    
    Parameters:
    
    description - a description of these devices.
    
    devices - the List of devices.
  - buildLogString
```
protected String buildLogString(Object... data)
```
    Builds a string out of a number of objects.
    
    Parameters:
    
    data - the objects to build.
    
    Returns:
    
    a string version of the objects all concatenated together.

Class Logger

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

HALF_TAG_LENGTH

DEBUG_LOG_OVERRIDE

MAX_TAG_LENGTH

SDK_TAG

PLATFORM

APPLICATION

DEBUG_ENABLED

INFO_ENABLED

mCategoryTag

mIsAppTag

APP_LOGGING

LOG_CATEGORY

Constructor Detail

Logger

Logger

Method Detail

setDebugLogging

setInfoLogging

setAppLogging

buildTag

shouldInfoLog

shouldDebugLog

shouldLogtoLogEntries

setLogEntriesEnabled

d

d

i

i

w

w

e

e

e

devices

devices

devices

buildLogString