wt.load
Class LocatorFactory

java.lang.Object
  wt.load.LocatorFactory

All Implemented Interfaces:

ApplicationContextChild, Externalizable, Serializable

public class LocatorFactory

extends Object

implements ApplicationContextChild, Externalizable

Produces ObjectLocator objects as well as executes them to locate an object. The LocatorFactory looks for ObjectLocator classes in the service.properties file
The service.properties entries are used as follows:

• ServiceName -- matches SERVICE_NAME of this class.
• ServiceSelector -- matches the locator name supplied to the LocatorFactory.
• RequestorClassName -- always java.lang.Object.
• ServicePriority -- always 0.
• ServiceClassName -- name of class that implements ObjectLocator interface for the specified locator_name.
• ServiceCardinality -- duplicate.

Supported API: false

Extendable: false

See Also:

Serialized Form

Field Summary

private ApplicationContext	applicationContext
private static String	CLASSNAME
static long	EXTERNALIZATION_VERSION_UID
private static LocatorFactory	factory
private static String	LOCATOR_CLASS_SUFFIX
protected static long	OLD_FORMAT_VERSION_UID
private static String	RESOURCE
(package private) static long	serialVersionUID
private static String	SERVICE_NAME Name of service in service.properties files.
private static boolean	VERBOSE

Fields inherited from interface wt.services.applicationcontext.ApplicationContextChild

APPLICATION_CONTEXT

Constructor Summary

LocatorFactory()

Method Summary

ApplicationContext	getApplicationContext() Gets the object for the association that plays role: applicationContext.
private ApplicationContextServices	getApplicationContextServices()
static ObjectLocator	getLocator(String name) Retrieves the locator object given the supplied locator name.
private static LocatorFactory	getLocatorIssuer() returns an instance of the locator factory.
private static ObjectLocator	getObjectLocator(String locator_name) Returns an ObjectLocator by using application context to gather it from service.properties.
static Object	locateObject(String locator_name, String identifier) Finds the desired locator object based on name, then executes the locate method, returning the located object.
static void	main(String[] args)
void	readExternal(ObjectInput input) Reads the non-transient fields of this class from an external source.
private boolean	readOldVersion(ObjectInput input, long readSerialVersionUID, boolean passThrough, boolean superDone) Reads the non-transient fields of this class from an external source, which is not the current version.
protected boolean	readVersion(LocatorFactory thisObject, ObjectInput input, long readSerialVersionUID, boolean passThrough, boolean superDone) Reads the non-transient fields of this class from an external source.
void	setApplicationContext(ApplicationContext a_ApplicationContext) Sets the object for the association that plays role: applicationContext.
void	writeExternal(ObjectOutput output) Writes the non-transient fields of this class to an external source.

Methods inherited from class java.lang.Object

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

Field Detail

RESOURCE

private static final String RESOURCE

See Also:

Constant Field Values

CLASSNAME

private static final String CLASSNAME

SERVICE_NAME

private static final String SERVICE_NAME

Name of service in service.properties files.

See Also:

Constant Field Values

factory

private static LocatorFactory factory

applicationContext

private ApplicationContext applicationContext

serialVersionUID

static final long serialVersionUID

See Also:

Constant Field Values

EXTERNALIZATION_VERSION_UID

public static final long EXTERNALIZATION_VERSION_UID

See Also:

Constant Field Values

OLD_FORMAT_VERSION_UID

protected static final long OLD_FORMAT_VERSION_UID

See Also:

Constant Field Values

VERBOSE

private static final boolean VERBOSE

LOCATOR_CLASS_SUFFIX

private static final String LOCATOR_CLASS_SUFFIX

See Also:

Constant Field Values

Constructor Detail

LocatorFactory

public LocatorFactory()

Method Detail

writeExternal

public void writeExternal(ObjectOutput output)
                   throws IOException

Writes the non-transient fields of this class to an external source.

Supported API: false

Specified by:

writeExternal in interface Externalizable

Parameters:

output -

Throws:

IOException

readExternal

public void readExternal(ObjectInput input)
                  throws IOException,
                         ClassNotFoundException

Reads the non-transient fields of this class from an external source.

Supported API: false

Specified by:

readExternal in interface Externalizable

Parameters:

input -

Throws:

IOException

ClassNotFoundException

readVersion

protected boolean readVersion(LocatorFactory thisObject,
                              ObjectInput input,
                              long readSerialVersionUID,
                              boolean passThrough,
                              boolean superDone)
                       throws IOException,
                              ClassNotFoundException

Reads the non-transient fields of this class from an external source.

Supported API: false

Parameters:

thisObject -

input -

readSerialVersionUID -

passThrough -

superDone -

Returns:

boolean

Throws:

IOException

ClassNotFoundException

readOldVersion

private boolean readOldVersion(ObjectInput input,
                               long readSerialVersionUID,
                               boolean passThrough,
                               boolean superDone)
                        throws IOException,
                               ClassNotFoundException

Reads the non-transient fields of this class from an external source, which is not the current version.

Parameters:

input -

readSerialVersionUID -

passThrough -

superDone -

Returns:

boolean

Throws:

IOException

ClassNotFoundException

getLocator

public static ObjectLocator getLocator(String name)

Retrieves the locator object given the supplied locator name.

Supported API: false

Parameters:

name -

Returns:

ObjectLocator

locateObject

public static Object locateObject(String locator_name,
                                  String identifier)

Finds the desired locator object based on name, then executes the locate method, returning the located object.

Supported API: false

Parameters:

locator_name -

identifier -

Returns:

Object

getApplicationContext

public ApplicationContext getApplicationContext()

Gets the object for the association that plays role: applicationContext.

Supported API: false

Specified by:

getApplicationContext in interface ApplicationContextChild

Returns:

ApplicationContext

setApplicationContext

public void setApplicationContext(ApplicationContext a_ApplicationContext)
                           throws WTPropertyVetoException

Sets the object for the association that plays role: applicationContext.

Supported API: false

Specified by:

setApplicationContext in interface ApplicationContextChild

Parameters:

a_ApplicationContext -

Throws:

WTPropertyVetoException

getLocatorIssuer

private static LocatorFactory getLocatorIssuer()

returns an instance of the locator factory.

getObjectLocator

private static ObjectLocator getObjectLocator(String locator_name)

Returns an ObjectLocator by using application context to gather it from service.properties.

getApplicationContextServices

private ApplicationContextServices getApplicationContextServices()

main

public static void main(String[] args)