|
Oracle Fusion Middleware Oracle WebLogic Server 10.3.1 API Reference 11g Release 1 (10.3.1) Part Number E13941-02 |
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectweblogic.jndi.WLInitialContextFactoryDelegate
public class WLInitialContextFactoryDelegate
The WLInitialContextFactoryDelegate creates initial contexts for accessing the WebLogic naming service locally or remotely via t3. 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:
Environment env = new Environment(); env.setProviderURL("t3://weblogicServer:7001"); Context ctx = new env.getInitialContext();Note that here we've depended on the built-in defaults for the initial context factory and a WebLogic user/password. We've supplied the provider URL since it doesn't match the default.
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();There is no need to specify a factory or a URL. By default, the server will use WLInitialContextFactory and connect to the local naming service. Use one of the techniques described above to create a context using special properties on the server.
Context
,
InitialContext
,
WLContext
,
Environment
Constructor Summary | |
---|---|
WLInitialContextFactoryDelegate()
Default constructor. |
Method Summary | |
---|---|
Context |
getInitialContext(Environment environment,
String contextName)
Returns a subcontext of the initial context with the specified name. |
Context |
getInitialContext(Environment env,
String subCtxName,
weblogic.rmi.spi.HostID hostID)
Creates a new context given the context environment. |
Context |
getInitialContext(Hashtable env)
Creates an InitialContext. |
Remote |
getInitialReference(Environment env,
Class implClass)
Returns a remote reference to the initial reference with the specified id. |
static WLInitialContextFactoryDelegate |
theOne()
|
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public WLInitialContextFactoryDelegate()
Method Detail |
---|
public static final WLInitialContextFactoryDelegate theOne()
public final Context getInitialContext(Hashtable env) throws NamingException
getInitialContext
in interface InitialContextFactory
env
- Environment used for creating the context
NamingException
- if the context cannot be createdpublic final Context getInitialContext(Environment env, String subCtxName, weblogic.rmi.spi.HostID hostID) throws NamingException
getInitialContext
in interface weblogic.jndi.spi.EnvironmentFactory
env
- Environment used for creating the contextsubCtxName
- Name of subcontext to return (or null)hostID
- host ID to ignore while getting initial context if
the url specified maps to a cluster.
NamingException
- if the context cannot
be createdpublic Remote getInitialReference(Environment env, Class implClass) throws NamingException
weblogic.jndi.spi.EnvironmentFactory
getInitialReference
in interface weblogic.jndi.spi.EnvironmentFactory
env
- environment to use.implClass
- of the singleton to retrieve
NamingException
- if the remote object cannot be obtainedpublic Context getInitialContext(Environment environment, String contextName) throws NamingException
weblogic.jndi.spi.EnvironmentFactory
getInitialContext
in interface weblogic.jndi.spi.EnvironmentFactory
environment
- environment to usecontextName
- of the context to retrieve
NamingException
- if the initial context cannot be obtained
|
Documentation is available at http://download.oracle.com/docs/cd/E12839_01/web.1111/wls.htm Copyright 1996, 2009, Oracle and/or its affiliates. All rights reserved. Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners. Oracle Fusion Middleware Oracle WebLogic Server 10.3.1 API Reference 11g Release 1 (10.3.1) Part Number E13941-02 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |