weblogic.jndi
Class WLInitialContextFactory

java.lang.Object
  weblogic.jndi.WLInitialContextFactory

All Implemented Interfaces:

InitialContextFactory

Direct Known Subclasses:

TengahInitialContextFactory

public class WLInitialContextFactory
extends Object
implements InitialContextFactory

The WLInitialContextFactory creates initial contexts for accessing the WebLogic naming service. It can also be used to create a multitier connection to another naming service through a WebLogic Server.

To create a WebLogic context from a client, your code must minimally specify this factory as the initial context factory, and the URL of a WebLogic Server in the JNDI environment, as properties passed to the constructor of InitialContext. Here's an example of the minimal setup required to establish a context:

   Hashtable env = new Hashtable(5);
   env.put(Context.INITIAL_CONTEXT_FACTORY,
           "weblogic.jndi.WLInitialContextFactory");
   env.put(Context.PROVIDER_URL,
           "t3://weblogicServer:7001");
   Context ctx = new InitialContext(env);

For a complete list of standard JNDI properties, see the contants defined in javax.naming.Context. For a list of WebLogic-specific properties, see the constants defined in weblogic.jndi.WLContext.

An Environment object can be used as a type-safe alternative to specifying properties in a Hashtable. Environment comes with a set of built-in defaults:

• If you don't set an initial context factory, the default is to use WLInitialContextFactory.
• If you don't set a principal and password, the default is to use guest/guest.
• If you don't set a server URL, the default is to use "t3://localhost:7001".

   Environment env = new Environment();
   env.setProviderURL("t3://weblogicServer:7001");
   Context ctx = new env.getInitialContext();

Creating a context from within a server-side object is simpler. You need not specify any properties; those are set for you by the Server. Here's the same example code written for getting a context from within a server-side object:

   Context ctx = new InitialContext(); 

See Also:

Context, InitialContext, WLContext, Environment

WLInitialContextFactory

public WLInitialContextFactory()

Default constructor.

getInitialContext

public final Context getInitialContext(Hashtable env)
                                throws NamingException

Creates an InitialContext. These properties affect how the context is created and to what naming service the context refers.

• java.naming.provider.url. String that specifies the URL of the WebLogic server that will provide the name service. Defaults to t3://localhost:7001 if unset. You can also set this property with the Environment.setProviderURL() method.
• java.naming.provider.delegate.environment. Optional java.util.Hashtable object that can be used to specify the use of a third-party naming service. It contains all the properties needed to create the third-party InitialContext on the WebLogic Server. If this property is specified, the WebLogic Server acts as a router to the third-party name service. Conceptually, the WebLogic Server creates an InitialContext using these properties and then provides the caller with a local context that delegates to this remote context. If this property is specified, the properties java.naming.security.principal and java.naming.security.credentials are ignored.
• java.naming.security.principal. String that specifies the identity of the principal (user) for security purposes. Defaults to "guest".
• java.naming.security.credentials. String that specifies the password for the principal or, alternatively, an Object that implements the weblogic.security.acl.UserInfo interface. If it is a UserInfo object, the property javax.naming.security.principal is ignored. Defaults to "guest".

Specified by:

getInitialContext in interface InitialContextFactory

Parameters:

env - Environment used for creating the context

Returns:

javax.naming.Context

Throws:

NamingException - if the context cannot be created