ch.qos.logback.core.android

Class SystemPropertiesProxy

java.lang.Object

ch.qos.logback.core.android.SystemPropertiesProxy

public class SystemPropertiesProxy
extends java.lang.Object

A proxy to get Android's global system properties (as opposed to the default process-level system properties). Settings from `adb setprop` can be accessed from this class.

Method Summary

Modifier and Type	Method and Description
java.lang.String	get(java.lang.String key, java.lang.String def) Get the value for the given key in the Android system properties
java.lang.Boolean	getBoolean(java.lang.String key, boolean def) Get the value for the given key in the Android system properties, returned as a boolean.
static SystemPropertiesProxy	getInstance() Gets the singleton instance for this class
void	setClassLoader(java.lang.ClassLoader cl) Sets the classloader to lookup the class for android.os.SystemProperties

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getInstance

public static SystemPropertiesProxy getInstance()

Gets the singleton instance for this class

Returns:

the singleton

setClassLoader

public void setClassLoader(java.lang.ClassLoader cl)
                    throws java.lang.ClassNotFoundException,
                           java.lang.SecurityException,
                           java.lang.NoSuchMethodException

Sets the classloader to lookup the class for android.os.SystemProperties

Parameters:

cl - desired classloader

Throws:

java.lang.ClassNotFoundException - android.os.SystemProperties class not found

java.lang.SecurityException - security manager does not allow class loading

java.lang.NoSuchMethodException - get/getBoolean method does not exist

get

public java.lang.String get(java.lang.String key,
                            java.lang.String def)
                     throws java.lang.IllegalArgumentException

Get the value for the given key in the Android system properties

Parameters:

key - the key to lookup

def - a default value to return

Returns:

an empty string if the key isn't found

Throws:

java.lang.IllegalArgumentException - if the key exceeds 32 characters

getBoolean

public java.lang.Boolean getBoolean(java.lang.String key,
                                    boolean def)
                             throws java.lang.IllegalArgumentException

Get the value for the given key in the Android system properties, returned as a boolean. Values 'n', 'no', '0', 'false' or 'off' are considered false. Values 'y', 'yes', '1', 'true' or 'on' are considered true. (case insensitive). If the key does not exist, or has any other value, then the default result is returned.

Parameters:

key - the key to lookup

def - a default value to return

Returns:

the key parsed as a boolean, or def if the key isn't found or is not able to be parsed as a boolean.

Throws:

java.lang.IllegalArgumentException - if the key exceeds 32 characters