| java.lang.Object javax.naming.spi.NamingManager javax.naming.spi.DirectoryManager
DirectoryManager | public class DirectoryManager extends NamingManager (Code) | | The DirectoryManager class cannot be instantiated. All its
methods are static. The methods are used by service providers for accessing
object and state factories and for determining continuation contexts.
The Name and Hashtable arguments passed to the
DirectoryManager methods remain owned purely by the calling
method. They must not be changed or referenced.
Multithreaded access to this class must be safe.
|
Method Summary | |
public static DirContext | getContinuationDirContext(CannotProceedException cpe) Create the next DirContext when using federation so that
the DirContext operation can be reinvoked. | public static Object | getObjectInstance(Object o, Name n, Context c, Hashtable, ?> h, Attributes a) Create an object using an object factory. | public static DirStateFactory.Result | getStateToBind(Object o, Name n, Context c, Hashtable, ?> h, Attributes a) Get the state of an Object. |
getContinuationDirContext | public static DirContext getContinuationDirContext(CannotProceedException cpe) throws NamingException(Code) | | Create the next DirContext when using federation so that
the DirContext operation can be reinvoked. This should
work similarly to NamingManager.getContinuationContext
except that a reference to a DirContext is returned.
This method is also responsible for setting the property denoted by the
CPE string to be the supplied
CannotProceedException for that environment.
Parameters: cpe - the CannotProceedException generated by theDirContext of the previous naming system whenit can proceed no further. the next DirContext when using federation throws: NamingException - if the resolved object is not set or if aDirContext cannot be obtained from it eitherdirectly or indirectly. |
getObjectInstance | public static Object getObjectInstance(Object o, Name n, Context c, Hashtable, ?> h, Attributes a) throws Exception(Code) | | Create an object using an object factory. Returns a new
Object or the supplied Object o if one
cannot be created.
The behaviour is like that for the getObjectInstance
method of NamingManager however it should be noted that
the intermediate object factory may be either of type
DirObjectFactory or of type ObjectFactory ;
in the former case, the supplied Attributes must be passed
when getting the object, otherwise the supplied Attributes
are ignored.
Parameters: o - An object which may provide reference or location information.May be null. Parameters: n - The name of the Object relative to the defaultinitial context (or relative to the Context c if it issupplied) Parameters: c - The Context to which the Name is relative Parameters: h - a Hashtable containing environment propertiesand values - may be null Parameters: a - Attributes - if some or all of the attributesof Object o are already known they can besupplied so that the factory does not have to do the work oflooking them up. the created object throws: NamingException - if one is encountered throws: Exception - if any other exception is encountered |
getStateToBind | public static DirStateFactory.Result getStateToBind(Object o, Name n, Context c, Hashtable, ?> h, Attributes a) throws NamingException(Code) | | Get the state of an Object. Returns a DirStateFactory .
Result which cannot be null. It contains the attributes and object to be
bound, either of which may be null. Once returned the caller is the owner
of it. The behaviour is like that for the getStateToBind
method of NamingManager however it should be noted that
the intermediate state factory may be of type
DirStateFactory rather than just StateFactory
in which case it should also use the supplied Attributes
when getting the state.
Parameters: o - An object which may provide reference or location information.May be null. Parameters: n - The name of the Object relative to the defaultinitial context (or relative to the Context c if it issupplied) Parameters: c - The Context to which the Name isrelative Parameters: h - a Hashtable containing environment propertiesand values - may be null Parameters: a - Attributes - if some or all of the attributesof Object o are already known they can besupplied so that the factory does not have to do the work oflooking them up. the state of the object throws: NamingException - if one is encountered |
Methods inherited from javax.naming.spi.NamingManager | public static Context getContinuationContext(CannotProceedException cpe) throws NamingException(Code)(Java Doc) public static Context getInitialContext(Hashtable, ?> h) throws NoInitialContextException, NamingException(Code)(Java Doc) public static Object getObjectInstance(Object o, Name n, Context c, Hashtable, ?> h) throws NamingException, Exception(Code)(Java Doc) public static Object getStateToBind(Object o, Name n, Context c, Hashtable, ?> h) throws NamingException(Code)(Java Doc) public static Context getURLContext(String schema, Hashtable, ?> envmt) throws NamingException(Code)(Java Doc) public static boolean hasInitialContextFactoryBuilder()(Code)(Java Doc) public static void setInitialContextFactoryBuilder(InitialContextFactoryBuilder icfb) throws IllegalStateException, SecurityException, NamingException(Code)(Java Doc) public static synchronized void setObjectFactoryBuilder(ObjectFactoryBuilder ofb) throws IllegalStateException, SecurityException, NamingException(Code)(Java Doc)
|
|
|