Skip navigation links

Oracle Internet Directory API Reference
10g(10.1.4)

B15992-01


oracle.ldap.util.jndi
Class ConnectionUtil

java.lang.Object
  extended byoracle.ldap.util.jndi.ConnectionUtil


public class ConnectionUtil
extends java.lang.Object

This class provides a set of static functions to support the creation of JNDI DirContext connecting to OID. SSL connection is also supported.


Constructor Summary
ConnectionUtil()
           

 

Method Summary
static java.lang.String discoverSSLPort(java.lang.String host, java.lang.String port, java.lang.String bindDN, java.lang.String bindPwd)
          Returns the SSL port number from OID.
static javax.naming.ldap.InitialLdapContext getDefaultDirCtx(DiscoveryHelper discObj, java.lang.String bindDN, java.lang.String bindPwd)
          Returns an InitialLdapContext using connect information obtained by calling discover() method of DiscoveryHelper class.
static javax.naming.ldap.InitialLdapContext getDefaultDirCtx(java.lang.String host, java.lang.String port, java.lang.String bindDN, java.lang.String bindPwd)
          Returns a non-SSL InitialLdapContext using the specified info.
static javax.naming.ldap.InitialLdapContext getDefaultDirCtx(java.lang.String host, java.lang.String port, java.lang.String bindDN, java.lang.String bindPwd, long timelimit)
          Returns a non-SSL InitialLdapContext using the specified info - allowing the option to specify a timeout limit.
static javax.naming.ldap.InitialLdapContext getSSLDirCtx(DiscoveryHelper discObj, java.lang.String bindDN, java.lang.String bindPwd)
          Returns a InitialLdapContext using the connect information calling discover() method of DiscoveryHelper class.
static javax.naming.ldap.InitialLdapContext getSSLDirCtx(java.lang.String host, java.lang.String port, java.lang.String bindDN, java.lang.String bindPwd)
          Returns an InitialLdapContext using the connect information provided.
static javax.naming.ldap.InitialLdapContext getSSLDirCtx(java.lang.String host, java.lang.String port, java.lang.String bindDN, java.lang.String bindPwd, java.lang.String sslSocketFactory)
          Returns an InitialLdapContext using the connect information provided - including the SSLSocketFactory implementation.

 

Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

 

Constructor Detail

ConnectionUtil

public ConnectionUtil()

Method Detail

discoverSSLPort

public static java.lang.String discoverSSLPort(java.lang.String host,
                                               java.lang.String port,
                                               java.lang.String bindDN,
                                               java.lang.String bindPwd)
                                        throws javax.naming.NamingException
Returns the SSL port number from OID. This uses the specified info to establish a non-SSL OID connection and fetches the information in configset 0.
Parameters:
host - The hostname where the non-SSL OID is running
port - The port number on which the non-SSL OID is running
bindDN - the bind DN (eg. cn=orcladmin)
bindPwd - the bind password
Throws:
javax.naming.NamingException

getDefaultDirCtx

public static javax.naming.ldap.InitialLdapContext getDefaultDirCtx(java.lang.String host,
                                                                    java.lang.String port,
                                                                    java.lang.String bindDN,
                                                                    java.lang.String bindPwd,
                                                                    long timelimit)
                                                             throws javax.naming.NamingException
Returns a non-SSL InitialLdapContext using the specified info - allowing the option to specify a timeout limit. The timelimit specifies the amount of time the method will wait for a successful connection. A timelimit may be desirable in case of a hang while establishing the connection. For example, binding against an SSL port.
Parameters:
host - host name of the directory server
port - port number of the directory server
bindDN - DN of the bind user
bindPwd - password of the bind user
Returns:
a InitialLdapContext
Throws:
javax.naming.NamingException

getDefaultDirCtx

public static javax.naming.ldap.InitialLdapContext getDefaultDirCtx(java.lang.String host,
                                                                    java.lang.String port,
                                                                    java.lang.String bindDN,
                                                                    java.lang.String bindPwd)
                                                             throws javax.naming.NamingException
Returns a non-SSL InitialLdapContext using the specified info. For SSL connection, please use getSSLDirCtx instead.
Parameters:
host - The hostname where the non-SSL OID is running
port - The port number on which the non-SSL OID is running
bindDN - the bind DN (eg. cn=orcladmin)
bindPwd - the bind password
Returns:
an InitialLdapContext
Throws:
javax.naming.NamingException

getDefaultDirCtx

public static javax.naming.ldap.InitialLdapContext getDefaultDirCtx(DiscoveryHelper discObj,
                                                                    java.lang.String bindDN,
                                                                    java.lang.String bindPwd)
                                                             throws javax.naming.NamingException
Returns an InitialLdapContext using connect information obtained by calling discover() method of DiscoveryHelper class. The corresponding non-SSL OID server must be running. For SSL connection, please use getSSLDirCtx instead
Parameters:
discObj - instance of DiscoveryHelper class
bindDN - the bind DN (eg. cn=orcladmin)
bindPwd - the bind password the domain name required for DNS lookup.
Throws:
javax.naming.NamingException

getSSLDirCtx

public static javax.naming.ldap.InitialLdapContext getSSLDirCtx(java.lang.String host,
                                                                java.lang.String port,
                                                                java.lang.String bindDN,
                                                                java.lang.String bindPwd)
                                                         throws javax.naming.NamingException
Returns an InitialLdapContext using the connect information provided. This connection will operate in the SSL mode The corresponding OID server must be accepting SSL connections.
Parameters:
host - The hostname where the SSL OID is running
port - The port number on which the SSL OID is running
bindDN - the bind DN (eg. cn=orcladmin)
bindPwd - the bind password
Returns:
an SSL InitialLdapContext
Throws:
javax.naming.NamingException

getSSLDirCtx

public static javax.naming.ldap.InitialLdapContext getSSLDirCtx(java.lang.String host,
                                                                java.lang.String port,
                                                                java.lang.String bindDN,
                                                                java.lang.String bindPwd,
                                                                java.lang.String sslSocketFactory)
                                                         throws javax.naming.NamingException
Returns an InitialLdapContext using the connect information provided - including the SSLSocketFactory implementation. This connection will operate in the SSL mode. The corresponding OID server must be accepting SSL connections. The sslSocketFactory parameter expects the class name of a customized SSL Socket Factory implementation.
Parameters:
host - The hostname where the SSL OID is running
port - The port number on which the SSL OID is running
bindDN - the bind DN (eg. cn=orcladmin)
bindPwd - the bind password
sslSocketFactory - the class name of the socket factory implementation to be used by JNDI
Returns:
an SSL InitialLdapContext
Throws:
javax.naming.NamingException

getSSLDirCtx

public static javax.naming.ldap.InitialLdapContext getSSLDirCtx(DiscoveryHelper discObj,
                                                                java.lang.String bindDN,
                                                                java.lang.String bindPwd)
                                                         throws javax.naming.NamingException
Returns a InitialLdapContext using the connect information calling discover() method of DiscoveryHelper class. Use this only if this is SSL connection. The corresponding SSL OID server must be running.
Parameters:
discObj - instance of DiscoveryHelper class
bindDN - the bind DN (eg. cn=orcladmin)
bindPwd - the bind password
Throws:
javax.naming.NamingException

Skip navigation links

Oracle Internet Directory API Reference
10g(10.1.4)

B15992-01


Copyright © 1999, 2006 Oracle. All Rights Reserved.