|
Oracle Fusion Middleware Java API Reference for Oracle WebLogic Server 12c (12.2.1) Part Number E55141-01 P4 Change 1723563 on 2015/10/09 |
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object
weblogic.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:
The Environment object offers some convenience "setter" methods that provide type-safety (and less chance of typos). Here's how you would write the same example using an Environment object:
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
Method Summary | |
---|---|
Context |
getInitialContext(Environment environment, String contextName) |
Context |
getInitialContext(Environment env, String subCtxName, HostID hostID) Creates a new context given the context environment. |
Context |
getInitialContext(Hashtable env) Creates an InitialContext. |
Remote |
getInitialReference(Environment env, Class implClass) |
static WLInitialContextFactoryDelegate |
theOne() |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Method Detail |
---|
public static WLInitialContextFactoryDelegate theOne()
public final Context getInitialContext(Hashtable env) throws NamingException
getInitialContext
in interface InitialContextFactory
env
- Environment used for creating the contextNamingException
- if the context cannot be createdpublic final Context getInitialContext(Environment env, String subCtxName, HostID hostID) throws NamingException
env
- Environment used for creating the contextsubCtxName
- Name of subcontext to return (or null)NamingException
- if the context cannot be createdpublic Remote getInitialReference(Environment env, Class implClass) throws NamingException
NamingException
public Context getInitialContext(Environment environment, String contextName) throws NamingException
NamingException
|
Copyright 1996, 2015, 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 Java API Reference for Oracle WebLogic Server 12c (12.2.1) Part Number E55141-01 P4 Change 1723563 on 2015/10/09 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |