oracle.lite.resource

Class ResourceManager

java.lang.Object

oracle.lite.resource.ResourceCache

oracle.lite.resource.ResourceManager

public final class ResourceManager
extends ResourceCache

Instance of this class manages all resource objects in the repository. In order to access resources, you must call 'initialize' method of this class and later obtain an instance of this class by invoking 'getInstance' method.

For example:

 import oracle.lite.resource.*;
 
 ResourceManager.initialize ("jdbc:oracle:thin:@mobile_server:1521:orcl",
                             "mobileadmin", "manager);
 
 ResourceManager rm = ResourceManager.getInstance();
 
 rm.destroy(); // Cleanup
 

Field Summary

Fields inherited from class oracle.lite.resource.ResourceCache

ADDRESS, APPLICATION, COMMAND, DEVICE, GROUP, LANGUAGE, OBSOLETE, PLATFORM, PROVIDER, ROLE, UNKNOWN, USER

Method Summary

Methods

Modifier and Type	Method and Description
static void	destroy() Cleanup ResourceManager by closing all open JDBC connections and releasing cached objects.
Application	getApplication(java.lang.String name) Retrieve a specific Application object given a application id.
Device	getDevice(java.lang.String devId) Retrieve a specific device object given a device id.
Device	getDeviceByUdid(java.lang.String udid) Retrieve a specific iOS device object given a udid.
java.util.Vector	getDevices() Retrieve all devices from the repository.
static boolean	getFlushOnCommit()
Group	getGroup(java.lang.String name) Retrieve a Group object from the repository.
static ResourceManager	getInstance() Retrieve the lone instance of ResourceManager class.
Language	getLanguage(java.lang.String lang) Retrieve language object given an abbreviated language code.
java.util.Vector	getLanguages() Retrieve all supported languages
Platform	getMatchingPlatform(java.lang.String type) Get best matching platform given a device type.
java.util.Enumeration	getObsoletedPlatforms() Get the enumerated list of obsoleted plaforms.
Platform	getPlatform(java.lang.String id) Retrieve a specific Device Platform object.
Platform	getPlatformByName(java.lang.String name) Retrieve a specific Device Platform object given a platform name.
Platform	getPlatformByNameAndLanguage(java.lang.String name, java.lang.String lang) Retrieve a specific Platform object given a name and language code.
Platform	getPlatformByType(java.lang.String type) Retrieve a specific Device Platform object given a platform type.
java.util.Enumeration	getPlatforms() Retrieve a all device platform objects from the repository.
java.util.Vector	getPlatforms(int state) Get all Platform object after sorting them in ascending order.
Provider	getProvider(java.lang.String id) Retrieve a specific Provider given its ID.
java.util.Enumeration	getProviders(java.lang.String type) Retrieve all registered providers of the given 'type'.
Role	getRole(java.lang.String name) Retrieve a Role object from the repository.
java.lang.String	getUpgradePlatformType(java.lang.String identifier) Get the upgradeable Type for the given platform Name/Type.
User	getUser(java.lang.String name) Retrieve a specific user object from the repository.
User	getUserById(java.lang.String id) Retrieve a specific user object from repository given a user id.
java.util.Vector	getUsers() Retrieves all User objects from the Mobile Server repository.
java.util.Vector	getUsers(java.lang.String filter) Retrieve all User objects from the repository after applying a filter.
static void	initialize(java.sql.Connection conn) Initialize Mobile Server repository ResourceManager
static void	initialize(java.lang.String connStr) Initialize Mobile Server repository ResourceManager
static void	initialize(java.lang.String url, java.lang.String uid, java.lang.String pwd) Initialize Mobile Server repository ResourceManager
static void	setFlushOnCommit(boolean flag)

Methods inherited from class oracle.lite.resource.ResourceCache

addToCache, clearCache, commit, createStatement, elements, get, getAutoCommit, getConnection, getConnectionInfo, getFromCache, isEmpty, objects, print, put, put, remove, removeFromCache, setAutoCommit, synchronize

Methods inherited from class java.lang.Object

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

Method Detail

destroy

public static void destroy()

Cleanup ResourceManager by closing all open JDBC connections and releasing cached objects. This method must be called by the same thread that initialized the ResourceManager.

getApplication

public Application getApplication(java.lang.String name)
                           throws ResourceException

Retrieve a specific Application object given a application id.

Parameters:

name - Application name

Returns:

oracle.lite.resource.Application instance

Throws:

ResourceException

getDevice

public Device getDevice(java.lang.String devId)
                 throws ResourceException

Retrieve a specific device object given a device id.

Parameters:

devId - Device Id

Returns:

oracle.lite.resource.Device object

Throws:

ResourceException

getDeviceByUdid

public Device getDeviceByUdid(java.lang.String udid)
                       throws ResourceException

Retrieve a specific iOS device object given a udid.

Parameters:

udid - iOS Device udid

Returns:

oracle.lite.resource.Device object

Throws:

ResourceException

getDevices

public java.util.Vector getDevices()
                            throws ResourceException

Retrieve all devices from the repository. Performance of this method depends on number of devices in the DMS repository.

Returns:

java.util.Vector object

Throws:

ResourceException

getFlushOnCommit

public static boolean getFlushOnCommit()

getGroup

public Group getGroup(java.lang.String name)
               throws ResourceException

Retrieve a Group object from the repository.

Parameters:

name - Group name

Throws:

ResourceException

getInstance

public static ResourceManager getInstance()

Retrieve the lone instance of ResourceManager class.

Returns:

ResourceManager instance

getLanguage

public Language getLanguage(java.lang.String lang)
                     throws ResourceException

Retrieve language object given an abbreviated language code.

Parameters:

lang - Language abbreviation (E.g. US, JA).

Returns:

oracle.lite.resource.Language object

Throws:

oracle.lite.resource.ResourceException

ResourceException

getLanguages

public java.util.Vector getLanguages()

Retrieve all supported languages

Returns:

java.util.Vector containig all supprted Languages

getMatchingPlatform

public Platform getMatchingPlatform(java.lang.String type)
                             throws ResourceException

Get best matching platform given a device type.

Parameters:

type - Device type.

Returns:

Matching Platform object or null if one could not found.

Throws:

ResourceException

getObsoletedPlatforms

public java.util.Enumeration getObsoletedPlatforms()
                                            throws ResourceException

Get the enumerated list of obsoleted plaforms. Used by ResourceManager.java and o.l.w.admin.setup.SetupPageData

Throws:

ResourceException

getPlatform

public Platform getPlatform(java.lang.String id)
                     throws ResourceException

Retrieve a specific Device Platform object.

Parameters:

id - Platform Id

Returns:

oracle.lite.resource.Platform object

Throws:

ResourceException

getPlatformByName

public Platform getPlatformByName(java.lang.String name)
                           throws ResourceException

Retrieve a specific Device Platform object given a platform name.

Parameters:

name - Device platform name

Returns:

oracle.lite.resource.Platform object

Throws:

ResourceException

getPlatformByNameAndLanguage

public Platform getPlatformByNameAndLanguage(java.lang.String name,
                                    java.lang.String lang)
                                      throws ResourceException

Retrieve a specific Platform object given a name and language code.

Parameters:

name - Device platform name (partial name)

lang - Language code

Returns:

oracle.lite.resource.Platform object

Throws:

ResourceException

getPlatformByType

public Platform getPlatformByType(java.lang.String type)
                           throws ResourceException

Retrieve a specific Device Platform object given a platform type.

Parameters:

type - Device platform type

Returns:

oracle.lite.resource.Platform object

Throws:

ResourceException

getPlatforms

public java.util.Enumeration getPlatforms()
                                   throws ResourceException

Retrieve a all device platform objects from the repository.

Returns:

java.util.Enumeration object

Throws:

ResourceException

getPlatforms

public java.util.Vector getPlatforms(int state)
                              throws ResourceException

Get all Platform object after sorting them in ascending order.

Parameters:

state - 0 All enabled Platforms. 1 All disabled Platforms 2 All Platforms

Throws:

ResourceException

getProvider

public Provider getProvider(java.lang.String id)
                     throws ResourceException

Retrieve a specific Provider given its ID.

Parameters:

id - Provider Id.

Returns:

oracle.lite.resource.Provider instance

Throws:

oracle.lite.resource.ResourceException

ResourceException

getProviders

public java.util.Enumeration getProviders(java.lang.String type)
                                   throws ResourceException

Retrieve all registered providers of the given 'type'. If value of 'type' is null, this method will return all Provider objects.

Parameters:

type - Provider Type (E.g. 'NETWORK', 'MESSAGE' etc).

Returns:

Enumeration object containing all provider objects.

Throws:

ResourceException

getRole

public Role getRole(java.lang.String name)
             throws ResourceException

Retrieve a Role object from the repository.

Parameters:

name - Role name

Throws:

ResourceException

getUpgradePlatformType

public java.lang.String getUpgradePlatformType(java.lang.String identifier)

Get the upgradeable Type for the given platform Name/Type. upgradeable Platform type scenarios A --> '' = A A --> B = B If there is an upgradeable type, return the new type Else return the same platform Type

getUser

public User getUser(java.lang.String name)
             throws ResourceException

Retrieve a specific user object from the repository.

Parameters:

name - User Name.

Returns:

oracle.lite.resource.User object

Throws:

ResourceException

getUserById

public User getUserById(java.lang.String id)
                 throws ResourceException

Retrieve a specific user object from repository given a user id.

Parameters:

id - User's internal id.

Returns:

oracle.lite.resource.User instance

Throws:

ResourceException

getUsers

public java.util.Vector getUsers()
                          throws ResourceException

Retrieves all User objects from the Mobile Server repository.

Returns:

java.util.Vector object containing User objects

Throws:

ResourceException

getUsers

public java.util.Vector getUsers(java.lang.String filter)
                          throws ResourceException

Retrieve all User objects from the repository after applying a filter.

Parameters:

filter - Search string

Returns:

java.util.Vector object containing User objects

Throws:

oracle.lite.resource.ResourceException

ResourceException

initialize

public static void initialize(java.sql.Connection conn)
                       throws java.lang.Exception

Initialize Mobile Server repository ResourceManager

Parameters:

conn - JDBC Connection object

Throws:

lava.lang.Exception

java.lang.Exception

initialize

public static void initialize(java.lang.String connStr)
                       throws java.lang.Exception

Initialize Mobile Server repository ResourceManager

Parameters:

connStr - Connection string (/@)

Throws:

lava.lang.Exception

java.lang.Exception

initialize

public static void initialize(java.lang.String url,
              java.lang.String uid,
              java.lang.String pwd)
                       throws java.lang.Exception

Initialize Mobile Server repository ResourceManager

Parameters:

url - JDBC url

uid - JDBC User Name

pwd - JDBC User's password

Throws:

lava.lang.Exception

java.lang.Exception

setFlushOnCommit

public static void setFlushOnCommit(boolean flag)