oracle.apps.fnd.applcore.flex.runtime
Class ApplicationIdentifier

java.lang.Object
  oracle.apps.fnd.applcore.flex.runtime.ApplicationIdentifier

public final class ApplicationIdentifier
extends java.lang.Object

An object that identifies an application.

Nested Class Summary

class

ApplicationIdentifier.ApplicationNotFoundException Thrown when the information of an application cannot be found.

Method Summary

static void	disableCache() Disables the static cache of the last requested instance.
static void	enableCache() Enables the static cache of the last requested instance.
java.lang.String	getBaseLanguage() Gets the base language of the system.
java.lang.Long	getId() Gets the ID.
java.util.List<java.lang.String>	getInstalledLanguages() Gets the list of codes of the installed languages.
static ApplicationIdentifier	getInstance(ConnectionIdentifier connIdent, java.lang.Long appId) Gets an instance of this class.
static ApplicationIdentifier	getInstance(ConnectionIdentifier connIdent, java.lang.String appIdentStr) Gets an instance of this class.
static ApplicationIdentifier	getInstance(java.lang.String connIdentStr, java.lang.Long appId) Gets an instance of this class.
static ApplicationIdentifier	getInstance(java.lang.String connIdentStr, java.lang.String appIdentStr) Gets an instance of this class.
java.lang.String	getName() Gets the name.
java.lang.String	getShortName() Gets the short name.
static java.lang.String	toIdentifier(java.lang.Long id) Returns a String identifier for an application ID.
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Method Detail

enableCache

public static final void enableCache()

Enables the static cache of the last requested instance. The caller of this method should call disableCache later to ensure that the latest changes from the database can be reflected. This static cache is useful when the same connection/application combination is accessed multiple times in a process. The application information, including the list of installed languages typically does not change often.

See Also:

disableCache()

disableCache

public static void disableCache()

Disables the static cache of the last requested instance.

See Also:

enableCache()

getInstance

public static ApplicationIdentifier getInstance(ConnectionIdentifier connIdent,
                                                java.lang.String appIdentStr)

Gets an instance of this class.

Parameters:

connIdent - the connection identifier; null may be passed if it is absolutely certain that a lookup will not happen; otherwise an IllegalStateException may be thrown by one of the accessors.

appIdentStr - the application identifier String; this String may be an application short name or an application ID prefixed with "@#".

Returns:

an instance of this class

getInstance

public static ApplicationIdentifier getInstance(ConnectionIdentifier connIdent,
                                                java.lang.Long appId)

Gets an instance of this class.

Parameters:

connIdent - the connection identifier; null may be passed if it is absolutely certain that a lookup will never happen; otherwise an IllegalStateException may be thrown by one of the accessors.

appId - the application ID

Returns:

an instance of this class

getInstance

public static ApplicationIdentifier getInstance(java.lang.String connIdentStr,
                                                java.lang.String appIdentStr)

Gets an instance of this class.

Parameters:

connIdentStr - the connection identifier String

appIdentStr - the application identifier String; this String may be an application short name or an application ID prefixed with "@#".

Returns:

an instance of this class

See Also:

ConnectionIdentifier.getInstance(String)

getInstance

public static ApplicationIdentifier getInstance(java.lang.String connIdentStr,
                                                java.lang.Long appId)

Gets an instance of this class.

Parameters:

connIdentStr - the connection identifier String

appId - the application ID

Returns:

an instance of this class

See Also:

ConnectionIdentifier.getInstance(String)

getShortName

public java.lang.String getShortName()

Gets the short name.

Returns:

the short name

Throws:

ApplicationIdentifier.ApplicationNotFoundException - if the short name is not available and the information of the application cannot be found

getId

public java.lang.Long getId()

Gets the ID.

Returns:

the ID

Throws:

ApplicationIdentifier.ApplicationNotFoundException - if the ID is not available and the the information of the application cannot be found

getName

public java.lang.String getName()

Gets the name.

Returns:

the name

Throws:

ApplicationIdentifier.ApplicationNotFoundException - if the name is not available and the information of the application cannot be found

getInstalledLanguages

public java.util.List<java.lang.String> getInstalledLanguages()

Gets the list of codes of the installed languages.

Returns:

the list of language codes

getBaseLanguage

public java.lang.String getBaseLanguage()

Gets the base language of the system.

Returns:

the base language code

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

toIdentifier

public static java.lang.String toIdentifier(java.lang.Long id)

Returns a String identifier for an application ID. The number is converted into a String and then prefixed with "@#".

Parameters:

id - the application ID

Returns:

the String identifier accepted by the constructor of this class

Throws:

java.lang.IllegalArgumentException - if the given ID is null