com.novell.admin.ns

Class AdminNamespaceFactory

java.lang.Object

com.novell.admin.ns.AdminNamespaceFactory

public class AdminNamespaceFactory
extends java.lang.Object

This Factory creates an instance of the NDSNamespaceImpl and the LDAPNamespaceImpl.

Field Summary

Fields

Modifier and Type	Field and Description
static int	LDAP_NAMESPACE A LDAP namespace implementation
static int	NDS_NAMESPACE A NDS (NDAP) namespace implementation

Constructor Summary

Constructors

Constructor and Description
AdminNamespaceFactory()

Method Summary

Modifier and Type	Method and Description
static AdminNamespace	createAdminNamespace(int NamespaceType) Create an instance of the desired namespace type.
static java.lang.String	getNDSConnectedAddressFromID(java.lang.String treeAddressID) A static method to get the address that is connected to for the given IP address or name.
static java.lang.String	getNDSTreeNameFromID(java.lang.String treeAddressID) A static method to get the tree name from a IP address or name using the NDSNamespace implementation.
static void	initializeSecureNCPTrees(boolean IWillNotUseThisMethod, NDSNamespace ndsns, java.lang.String[] treeList)

Methods inherited from class java.lang.Object

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

Field Detail

LDAP_NAMESPACE

public static final int LDAP_NAMESPACE

A LDAP namespace implementation

See Also:

Constant Field Values

NDS_NAMESPACE

public static final int NDS_NAMESPACE

A NDS (NDAP) namespace implementation

See Also:

Constant Field Values

Constructor Detail

AdminNamespaceFactory

public AdminNamespaceFactory()

Method Detail

createAdminNamespace

public static AdminNamespace createAdminNamespace(int NamespaceType)
                                           throws SPIException

Create an instance of the desired namespace type.

Parameters:

NamespaceType - type to create AdminNamespaceFactory.LDAP_NAMESPACE AdminNamespaceFactory.NDS_NAMESPACE

Returns:

an instance of the requested namespace implementation else null

Throws:

SPIException

getNDSTreeNameFromID

public static java.lang.String getNDSTreeNameFromID(java.lang.String treeAddressID)
                                             throws SPIException

A static method to get the tree name from a IP address or name using the NDSNamespace implementation.

Parameters:

treeAddressID - - This can be a valid IP address like "151.155.163.120" or it can be an IP address that contains the port number as part of it like "151.155.163.120:524". It can also be a valid host name in the form "java.sun.com" or something that could be resolved through the java InetAddress.getByName(name) functionality. DNS names and names in the machines "hosts" files should be resolved. It does not make sense to pass a treename in for this value because why call it if you already have it

Returns:

The tree name or null if an internal error occurs or it cannot be determined

Throws:

SPIException

getNDSConnectedAddressFromID

public static java.lang.String getNDSConnectedAddressFromID(java.lang.String treeAddressID)
                                                     throws SPIException

A static method to get the address that is connected to for the given IP address or name. So, if you already have an IP address, it would not make much sense to call this routine. In general this would be called when you have a tree name - not an already known IP address

Parameters:

treeAddressID - - This can be a valid IP address like "151.155.163.120" or it can be an IP address that contains the port number as part of it like "151.155.163.120:524". It can also be a valid host name in the form "java.sun.com" or something that could be resolved through the java InetAddress.getByName(name) functionality. DNS names and names in the machines "hosts" files should be resolved. If an IP address cannot be determined that way, it will also take the treeAddressID string and see if the underlying API (JClient/DClient) can connect as if it was a tree name.

Returns:

The connected to address which MAY be an IP address or null if an internal error occured or it could not determine the address

Throws:

SPIException

initializeSecureNCPTrees

public static void initializeSecureNCPTrees(boolean IWillNotUseThisMethod,
                                            NDSNamespace ndsns,
                                            java.lang.String[] treeList)
                                     throws SPIException

Parameters:

IWillNotUseThisMethod - - a value that if someone looks at this routine to find out what this parameter they will know it WILL NOT BE supported and go away - actually removed - with no warning or any type of communication. if true then you have agreed to not use this method and will be totally responsible for things not working when this goes away. If false it will throw an exception.

ndsns - the NDSNamespaceImpl to initialize as SecureNCP with the treeList

treeList - an array of tree names so that ALL JCContext's connected to these trees will use Secure NCP. The treenames should not have any leading or trailing "."'s It is just the treenames. If this matches any of the treenames in secureNCPTreeHashMap, then this context will be setup to use SecureNCPUsers. Users need to be careful with this because if any Netware or non eDir 8.8 servers exist in the tree and are resolved to, the connection will be closed by the underlying NCP calls and put into the bad address cache.

Throws:

SPIException