|
JavaTM 2 Platform Std. Ed. v1.3.1 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--javax.naming.Reference
This class represents a reference to an object that is found outside of the naming/directory system.
Reference provides a way of recording address information about objects which themselves are not directly bound to the naming/directory system.
A Reference consists of an ordered list of addresses and class information about the object being referenced. Each address in the list identifies a communications endpoint for the same conceptual object. The "communications endpoint" is information that indicates how to contact the object. It could be, for example, a network address, a location in memory on the local machine, another process on the same machine, etc. The order of the addresses in the list may be of significance to object factories that interpret the reference.
Multiple addresses may arise for various reasons, such as replication or the object offering interfaces over more than one communication mechanism. The addresses are indexed starting with zero.
A Reference also contains information to assist in creating an instance of the object to which this Reference refers. It contains the class name of that object, and the class name and location of the factory to be used to create the object. The class factory location is a space-separated list of URLs representing the class path used to load the factory. When the factory class (or any class or resource upon which it depends) needs to be loaded, each URL is used (in order) to attempt to load the class.
A Reference instance is not synchronized against concurrent access by multiple threads. Threads that need to access a single Reference concurrently should synchronize amongst themselves and provide the necessary locking.
RefAddr
,
StringRefAddr
,
BinaryRefAddr
, Serialized FormField Summary | |
protected Vector |
addrs
Contains the addresses contained in this Reference. |
protected String |
classFactory
Contains the name of the factory class for creating an instance of the object to which this Reference refers. |
protected String |
classFactoryLocation
Contains the location of the factory class. |
protected String |
className
Contains the fully-qualified name of the class of the object to which this Reference refers. |
Constructor Summary | |
Reference(String className)
Constructs a new reference for an object with class name 'className'. |
|
Reference(String className,
RefAddr addr)
Constructs a new reference for an object with class name 'className' and an address. |
|
Reference(String className,
RefAddr addr,
String factory,
String factoryLocation)
Constructs a new reference for an object with class name 'className', the class name and location of the object's factory, and the address for the object. |
|
Reference(String className,
String factory,
String factoryLocation)
Constructs a new reference for an object with class name 'className', and the class name and location of the object's factory. |
Method Summary | |
void |
add(int posn,
RefAddr addr)
Adds an address to the list of addresses at index posn. |
void |
add(RefAddr addr)
Adds an address to the end of the list of addresses. |
void |
clear()
Deletes all addresses from this reference. |
Object |
clone()
Makes a copy of this reference using its class name list of addresses, class factory name and class factory location. |
boolean |
equals(Object obj)
Determines whether obj is a reference with the same addresses (in same order) as this reference. |
RefAddr |
get(int posn)
Retrieves the address at index posn. |
RefAddr |
get(String addrType)
Retrieves the first address that has the address type 'addrType'. |
Enumeration |
getAll()
Retrieves an enumeration of the addresses in this reference. |
String |
getClassName()
Retrieves the class name of the object to which this reference refers. |
String |
getFactoryClassLocation()
Retrieves the location of the factory of the object to which this reference refers. |
String |
getFactoryClassName()
Retrieves the class name of the factory of the object to which this reference refers. |
int |
hashCode()
Computes the hash code of this reference. |
Object |
remove(int posn)
Deletes the address at index posn from the list of addresses. |
int |
size()
Retrieves the number of addresses in this reference. |
String |
toString()
Generates the string representation of this reference. |
Methods inherited from class java.lang.Object |
finalize, getClass, notify, notifyAll, wait, wait, wait |
Field Detail |
protected String className
Class.getName()
protected Vector addrs
protected String classFactory
protected String classFactoryLocation
Constructor Detail |
public Reference(String className)
className
- The non-null class name of the object to which
this reference refers.public Reference(String className, RefAddr addr)
className
- The non-null class name of the object to
which this reference refers.addr
- The non-null address of the object.public Reference(String className, String factory, String factoryLocation)
className
- The non-null class name of the object to which
this reference refers.factory
- The possibly null class name of the object's factory.factoryLocation
- The possibly null location from which to load
the factory (e.g. URL)ObjectFactory
,
NamingManager.getObjectInstance(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable)
public Reference(String className, RefAddr addr, String factory, String factoryLocation)
className
- The non-null class name of the object to
which this reference refers.factory
- The possibly null class name of the object's factory.factoryLocation
- The possibly null location from which
to load the factory (e.g. URL)addr
- The non-null address of the object.ObjectFactory
,
NamingManager.getObjectInstance(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable)
Method Detail |
public String getClassName()
public String getFactoryClassName()
public String getFactoryClassLocation()
public RefAddr get(String addrType)
addrType
- The non-null address type for which to find the address.public RefAddr get(int posn)
posn
- The index of the address to retrieve.ArrayIndexOutOfBoundsException
- If posn not in the specified
range.public Enumeration getAll()
public int size()
public void add(RefAddr addr)
addr
- The non-null address to add.public void add(int posn, RefAddr addr)
posn
- The 0-based index of the list to insert addr.addr
- The non-null address to add.ArrayIndexOutOfBoundsException
- If posn not in the specified
range.public Object remove(int posn)
posn
- The 0-based index of in address to delete.ArrayIndexOutOfBoundsException
- If posn not in the specified
range.public void clear()
public boolean equals(Object obj)
equals
in class Object
obj
- The possibly null object to check.public int hashCode()
hashCode
in class Object
public String toString()
toString
in class Object
public Object clone()
clone
in class Object
java.lang.Object
CloneNotSupportedException
- if the object's class does not
support the Cloneable
interface. Subclasses
that override the clone
method can also
throw this exception to indicate that an instance cannot
be cloned.OutOfMemoryError
- if there is not enough memory.Cloneable
|
JavaTM 2 Platform Std. Ed. v1.3.1 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Java, Java 2D, and JDBC are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries.
Copyright 1993-2001 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.