com.neovisionaries.android.app

Class App

java.lang.Object

com.neovisionaries.android.app.App

public class App
extends Object

A class to manage global information of the application. init(Context) method must be called before use.

Author:

Takahiko Kawasaki

See Also:

BaseApplication

Method Summary

Modifier and Type	Method and Description
String	getApplicationLabel() Get the application label of this application.
android.content.Context	getContext() Get the application context.
String	getCountry() Get the current country.
Preferences	getDefaultPreferences() Get the Preferences instance that wraps the default shared preferences.
static App	getInstance() Get the singleton instance of this class.
String	getLanguage() Get the current language.
Locale	getLocale() Get the current locale.
Preferences	getPreferences() Get the Preferences instance that is supposed to be used globally for this application.
String	getVersionName() Get the version name of this application.
static App	init(android.content.Context context) Initialize this class.
boolean	isRestarting() Check whether this application is in the process of restart.
boolean	isStopping() Check whether this application is in the process of termination.
void	setRestarting(boolean restarting) Set the restart state of this application.
void	setStopping(boolean stopping) Set the termination state of this application.

Methods inherited from class java.lang.Object

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

Method Detail

init

public static App init(android.content.Context context)

Initialize this class. This static method must be called before use of getInstance() method. Otherwise, getInstance() will throw IllegalStateException.

It is recommended to call this static method in an implementation of onCreate() method of a subclass of Application. In the case, the subclass should be specified as the value of android:name attribute of application tag in AndroidManifest.xml. The easiest way to do it is to use BaseApplication class whose onCreate() method calls App.init(this).

In particular, items below are performed.

• Set "java.net.preferIPv4Stack" to true if the system property is not set, and set "java.net.preferIPv6Addresses" to false if the system property is not set. These are done as a workaround against Issue 9431. Without this workaround, "java.net.SocketException: Bad address family" would be thrown on a device which does not support IPv6.

Parameters:

context - The application context.

Returns:

A newly created instance of App that has been initialized with the given context. getInstance() will return the same instance.

Throws:

IllegalArgumentException - The argument is null.

getInstance

public static App getInstance()

Get the singleton instance of this class. init(Context) method must be called before use of this method. Otherwise, IllegalStateException is thrown.

Returns:

The singleton instance of this class.

getContext

public android.content.Context getContext()

Get the application context.

Returns:

The object passed to init(Context) is returned.

getApplicationLabel

public String getApplicationLabel()

Get the application label of this application.

Returns:

The value returned from PackageManager.getApplicationLabel().

getVersionName

public String getVersionName()

Get the version name of this application.

Returns:

The value of PackageInfo.versionName.

getPreferences

public Preferences getPreferences()

Get the Preferences instance that is supposed to be used globally for this application.

Returns:

A Preferences instance which holds a private (MODE_PRIVATE) SharedPreferences instance which has been initialized with the application context passed to init(Context) method and the application name as the SharedPreferences instance's name.

getDefaultPreferences

public Preferences getDefaultPreferences()

Get the Preferences instance that wraps the default shared preferences.

Returns:

A Preferences instance that wraps the default shared preferences.

Since:

1.11

getLocale

public Locale getLocale()

Get the current locale.

getLanguage

public String getLanguage()

Get the current language.

Returns:

An alpha-2 code defined ISO-639.

See Also:

ISO 639 Language Code List

getCountry

public String getCountry()

Get the current country.

Returns:

An uppercase ISO 3166 2-letter code.

See Also:

ISO 3166-1 alpha-2 Country Code List

isStopping

public boolean isStopping()

Check whether this application is in the process of termination.

setStopping

public void setStopping(boolean stopping)

Set the termination state of this application.

isRestarting

public boolean isRestarting()

Check whether this application is in the process of restart.

Since:

1.7

setRestarting

public void setRestarting(boolean restarting)

Set the restart state of this application.

Since:

1.7