|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--com.ibm.websphere.naming.PROPS
Constants defined by the WebSphere Naming implementation which can be set by users to control the behavior of various features.
Field Summary | |
static java.lang.String |
GENERIC_URL_INITIAL_CONTEXT_FACTORY
Constant for the generic URL initial context factory in WebSphere. |
static java.lang.String |
GENERIC_URL_PACKAGE
Constant for the property name which is used to specify the package name to the generic URL initial context factory. |
static java.lang.String |
GENERIC_URL_SCHEMEID
Constant for the property name which is used to specify the scheme ID to the generic URL initial context factory. |
static java.lang.String |
HOSTNAME_NORMALIZER
Constant for the property name which is used to specify the name of the java class to be used for hostname normalization processing. |
static java.lang.String |
INITIAL_CONTEXT_FACTORY
WebSphere's initial context factory classname. |
static java.lang.String |
INITIAL_CONTEXT_FACTORY_LEGACY
Deprecated. In WebSphere version 4.0, this factory was replaced by INITIAL_CONTEXT_FACTORY and will be removed some time in the future. |
static java.lang.String |
JNDI_CACHE_MAX_ENTRY_LIFE
Constant for the property name which is used to control the "time to live" for individual JNDI cache entries. |
static int |
JNDI_CACHE_MAX_ENTRY_LIFE_DEFAULT
Constant for the default value for the property JNDI_CACHE_MAX_ENTRY_LIFE . |
static java.lang.String |
JNDI_CACHE_MAX_LIFE
Constant for the property name which is used to control the "time to live" for the contents of a JNDI cache as a whole. |
static int |
JNDI_CACHE_MAX_LIFE_DEFAULT
Constant for the default value for the property JNDI_CACHE_MAX_LIFE . |
static java.lang.String |
JNDI_CACHE_NAME
Constant for the property name which is used to select the JNDI cache to be used by a new initial context instance. |
static java.lang.String |
JNDI_CACHE_NAME_DEFAULT
Constant for the default value for the property JNDI_CACHE_NAME . |
static java.lang.String |
JNDI_CACHE_OBJECT
Constant for the property name which is used to control connection to a cache when a new initial context is instantiated. |
static java.lang.String |
JNDI_CACHE_OBJECT_CLEARED
Constant for the JNDI_CACHE_OBJECT property value used to
enable JNDI caching such that an existing cache is cleared of its contents when the
new initial context is instantiated. |
static java.lang.String |
JNDI_CACHE_OBJECT_DEFAULT
Constant for the default value for the property JNDI_CACHE_OBJECT . |
static java.lang.String |
JNDI_CACHE_OBJECT_NONE
Constant for the JNDI_CACHE_OBJECT property value
used to disable JNDI caching. |
static java.lang.String |
JNDI_CACHE_OBJECT_POPULATED
Constant for the JNDI_CACHE_OBJECT property value used to
enable JNDI caching such that an existing cache is used as is. |
static java.lang.String |
NAME_SPACE_ROOT
Constant for the property name which is used to control the logical WebSphere name space root to use when a new initial context is instantiated. |
static java.lang.String |
NAME_SPACE_ROOT_BOOTSTRAP_HOST
Constant for the NAME_SPACE_ROOT property value used to create an
initial context based on the bootsrap host root. |
static java.lang.String |
NAME_SPACE_ROOT_LEGACY
Constant for the NAME_SPACE_ROOT property value used to create an
initial context based on the legacy domain root. |
static java.lang.String |
NAME_SPACE_ROOT_TREE_INFRASTRUCTURE
Constant for the NAME_SPACE_ROOT property value used to create an
initial context based on the overall root of the entire name tree. |
static java.lang.String |
NAME_SYNTAX
Constant for the property name passed when creating an initial context which is used to identify the syntax for parsing the string form of JNDI names. |
static java.lang.String |
NAME_SYNTAX_INS
Constant for the NAME_SYNTAX property value
used to parse names in INS name syntax. |
static java.lang.String |
NAME_SYNTAX_JNDI
Constant for the NAME_SYNTAX property value
used to parse names in "JNDI" name syntax. |
static java.lang.String |
ORB_TO_USE_FACTORY
Property used to pass a factory, when creating an initial context, that will be used for creating an instance of an ORB object. |
static java.lang.String |
ORB_TO_USE_INSTANCE
Property used to pass an instance of an ORB object when creating an initial context. |
Methods inherited from class java.lang.Object |
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
public static final java.lang.String INITIAL_CONTEXT_FACTORY
The value for this constant is "com.ibm.websphere.naming.WsnInitialContextFactory".
public static final java.lang.String INITIAL_CONTEXT_FACTORY_LEGACY
INITIAL_CONTEXT_FACTORY
and will be removed some time in the future.
The value for this constant is "com.ibm.ejs.ns.jndi.CNInitialContextFactory".
public static final java.lang.String NAME_SPACE_ROOT
The value for this constant is "com.ibm.websphere.naming.namespaceroot".
NAME_SPACE_ROOT_LEGACY
,
NAME_SPACE_ROOT_BOOTSTRAP_HOST
,
NAME_SPACE_ROOT_TREE_INFRASTRUCTURE
public static final java.lang.String NAME_SPACE_ROOT_LEGACY
NAME_SPACE_ROOT
property value used to create an
initial context based on the legacy domain root. This is the default value.
The value for this constant is "legacydomainroot".
NAME_SPACE_ROOT
,
NAME_SPACE_ROOT_BOOTSTRAP_HOST
,
NAME_SPACE_ROOT_TREE_INFRASTRUCTURE
public static final java.lang.String NAME_SPACE_ROOT_BOOTSTRAP_HOST
NAME_SPACE_ROOT
property value used to create an
initial context based on the bootsrap host root.
The value for this constant is "bootstraphostroot".
NAME_SPACE_ROOT
,
NAME_SPACE_ROOT_LEGACY
,
NAME_SPACE_ROOT_TREE_INFRASTRUCTURE
public static final java.lang.String NAME_SPACE_ROOT_TREE_INFRASTRUCTURE
NAME_SPACE_ROOT
property value used to create an
initial context based on the overall root of the entire name tree.
This value is intended for use by the WebSphere Naming Service itself and
typically would not be used by users of WebSphere.
The value for this constant is "treeinfrastructureroot".
NAME_SPACE_ROOT
,
NAME_SPACE_ROOT_LEGACY
,
NAME_SPACE_ROOT_BOOTSTRAP_HOST
public static final java.lang.String ORB_TO_USE_INSTANCE
Normally a WebSphere JNDI Context will use the ORB instance shared by all
WebSphere code. This property may be used when
creating an initial context using WebSphere's
INITIAL_CONTEXT_FACTORY
if it is desired to have the WebSphere JNDI
Context objects use the specified ORB instance instead. The object passed in must be
an instance of org.omg.CORBA.ORB.
When this property is used it takes precedence over any
setting of ORB_TO_USE_FACTORY
.
The value for this constant is "org.omg.CORBA.ORB".
ORB_TO_USE_FACTORY
public static final java.lang.String ORB_TO_USE_FACTORY
Normally a WebSphere JNDI Context will use the ORB instance shared by all
WebSphere code. This property may be used when
creating an initial context using WebSphere's
INITIAL_CONTEXT_FACTORY
if it is desired to have the WebSphere JNDI
Context objects use a different ORB instance.
This property identifies the name of a class that has a static method
with the signature:
public static org.omg.CORBA.ORB getORB();
This method will be used to obtain an ORB instance.
This property will be honored unless ORB_TO_USE_INSTANCE
is set, it which case that property will take precedence.
The value for this constant is "com.ibm.CORBA.ORBInit".
ORB_TO_USE_INSTANCE
public static final java.lang.String JNDI_CACHE_OBJECT
The value for this constant is "com.ibm.websphere.naming.jndicache.cacheobject".
JNDI_CACHE_OBJECT_POPULATED
,
JNDI_CACHE_OBJECT_CLEARED
,
JNDI_CACHE_OBJECT_NONE
public static final java.lang.String JNDI_CACHE_OBJECT_POPULATED
JNDI_CACHE_OBJECT
property value used to
enable JNDI caching such that an existing cache is used as is. Other initial context
instances which do not use caching are not affected. WebSphere contexts returned from
lookups on the new initial context also will use JNDI caching. This value is the
default value.
The value for this constant is "populated".
JNDI_CACHE_OBJECT
,
JNDI_CACHE_OBJECT_CLEARED
,
JNDI_CACHE_OBJECT_NONE
public static final java.lang.String JNDI_CACHE_OBJECT_CLEARED
JNDI_CACHE_OBJECT
property value used to
enable JNDI caching such that an existing cache is cleared of its contents when the
new initial context is instantiated. Other initial context instances may be sharing
this same cache instance. Other initial context instances which do not use caching
are not affected. WebSphere contexts returned from lookups on the new initial context
also will use JNDI caching.
The value for this constant is "cleared".
JNDI_CACHE_OBJECT
,
JNDI_CACHE_OBJECT_POPULATED
,
JNDI_CACHE_OBJECT_NONE
public static final java.lang.String JNDI_CACHE_OBJECT_NONE
JNDI_CACHE_OBJECT
property value
used to disable JNDI caching. Other initial context instances which use caching are not
affected. WebSphere contexts returned from lookups on the new initial context also
will not use JNDI caching.
The value for this constant is "none".
JNDI_CACHE_OBJECT
,
JNDI_CACHE_OBJECT_POPULATED
,
JNDI_CACHE_OBJECT_CLEARED
public static final java.lang.String JNDI_CACHE_OBJECT_DEFAULT
JNDI_CACHE_OBJECT
.
(For more information on default connection behavior, see the description of the
property JNDI_CACHE_OBJECT_POPULATED
.
The value for this constant is "populated".
JNDI_CACHE_OBJECT_POPULATED
,
JNDI_CACHE_OBJECT
public static final java.lang.String JNDI_CACHE_NAME
JNDI_CACHE_NAME_DEFAULT
is reserved
as the default, which causes the value of the javax.naming.Context.PROVIDER_URL
property to be used as the cache name.
The value for this constant is "com.ibm.websphere.naming.jndicache.cachename".
JNDI_CACHE_NAME_DEFAULT
public static final java.lang.String JNDI_CACHE_NAME_DEFAULT
JNDI_CACHE_NAME
.
For more information, see the description for the constant, JNDI_CACHE_NAME
.
The value for this constant is "providerURL".
JNDI_CACHE_NAME
public static final java.lang.String JNDI_CACHE_MAX_LIFE
An individual cache entry's time to live can alse be affected by the property
JNDI_CACHE_MAX_ENTRY_LIFE
.
The value for this constant is "com.ibm.websphere.naming.jndicache.maxcachelife".
JNDI_CACHE_MAX_LIFE_DEFAULT
,
JNDI_CACHE_MAX_ENTRY_LIFE
public static final int JNDI_CACHE_MAX_LIFE_DEFAULT
JNDI_CACHE_MAX_LIFE
.
This value indicates that the max cache life is indefinite.
For more information on max cache life, see the description for the property
JNDI_CACHE_MAX_LIFE
.
The value for this constant is 0.
JNDI_CACHE_MAX_LIFE
public static final java.lang.String JNDI_CACHE_MAX_ENTRY_LIFE
A cache entry's time to live can alse be affected by the property
JNDI_CACHE_MAX_LIFE
.
The value for this constant is "com.ibm.websphere.naming.jndicache.maxentrylife".
JNDI_CACHE_MAX_ENTRY_LIFE_DEFAULT
,
JNDI_CACHE_MAX_LIFE
public static final int JNDI_CACHE_MAX_ENTRY_LIFE_DEFAULT
JNDI_CACHE_MAX_ENTRY_LIFE
.
This value indicates that the time to live for inividual cache entries is indefinite.
For more information on max cache life, see the description for the property
JNDI_CACHE_MAX_ENTRY_LIFE
.
The value for this constant is 0.
JNDI_CACHE_MAX_ENTRY_LIFE
public static final java.lang.String NAME_SYNTAX
NAME_SYNTAX_JNDI
or
NAME_SYNTAX_INS
.
When using INS syntax, the string form of names are parsed according to the OMG CosNaming Interoperable Naming Specification, with the characters forward slash ("/"), backward slash ("\") and dot (".") each have special meaning. In JNDI syntax, only the forward slash ("/") and backward slash ("\") have special meaning.
The forward slash ("/") is used to separate components in a compound name, the dot (".") is used to separate "id" and "kind" fields of a CosNaming NameComponent, and a backward slash ("\") can be used to escape any of the special characters so that they are interpreted literally.
When a CosNaming name server is being used with JNDI syntax, a JNDI name component maps to the "id" field of a CosNaming NameComponent, and there is no way to have anything other than an empty "kind" field. When INS syntax is used, a JNDI name component can have zero or one unescaped dot (".") characters, and if one is present it is used to delimit the "id" and "kind" fields of the CosNaming NameComponent.
For a typical WebSphere application, JNDI syntax would normally be used. However, if your WebSphere application is interoperating with CORBA based applications, and those applications are using a CosNaming Name Server where both "id" and "kind" fields are utilized in names, INS syntax must be used to allow interoperability between the WebSphere and CORBA applications use of the name space.
The value for this constant is "com.ibm.websphere.naming.name.syntax".
NAME_SYNTAX_JNDI
,
NAME_SYNTAX_INS
public static final java.lang.String NAME_SYNTAX_JNDI
NAME_SYNTAX
property value
used to parse names in "JNDI" name syntax. This is the default value.
For more information of name syntaxes, see the description for the property
NAME_SYNTAX
.
The value for this constant is "jndi".
NAME_SYNTAX
,
NAME_SYNTAX_INS
public static final java.lang.String NAME_SYNTAX_INS
NAME_SYNTAX
property value
used to parse names in INS name syntax.
For more information of name syntaxes, see the description for the property
NAME_SYNTAX
.
The value for this constant is "ins".
NAME_SYNTAX
,
NAME_SYNTAX_JNDI
public static final java.lang.String GENERIC_URL_INITIAL_CONTEXT_FACTORY
WebSphere provides a framework which allows users to have their own singleton in process name space using a user defined URL scheme name. The name space is local to a process and is shared by all threads in the process.
In order to create an instance of an in process URL name space, you must
use new InitialContext with the property "java.naming.factory.initial"
set to the value of this constant and the properties
GENERIC_URL_SCHEMEID
and GENERIC_URL_PACKAGE
must
also be set. In order for this to work, you must provide
a subclass of com.ibm.websphere.naming.genericURLContextFactory
that follows the JNDI naming convention
"some.package.name.myschemeid.myschemeidURLContextFactory".
This subclass only needs to implement a no argument constructor which calls
its parent constructor - super(schemeid).
The value of this constant is "com.ibm.websphere.naming.genericURLInitialContextFactory".
GENERIC_URL_SCHEMEID
,
GENERIC_URL_PACKAGE
public static final java.lang.String GENERIC_URL_SCHEMEID
The value of this constant is "com.ibm.websphere.naming.generic.url.schemeid".
GENERIC_URL_INITIAL_CONTEXT_FACTORY
,
GENERIC_URL_PACKAGE
public static final java.lang.String GENERIC_URL_PACKAGE
The value of this constant is "com.ibm.websphere.naming.generic.url.package".
GENERIC_URL_INITIAL_CONTEXT_FACTORY
,
GENERIC_URL_SCHEMEID
public static final java.lang.String HOSTNAME_NORMALIZER
The com.ibm.websphere.naming.hostnameNormalizer
interface defines methods for normalizing the hostname so that it is consistent in case
and form. WebSphere provides a default implementation of this interface, but if you wish to
supply your own, set this property to the name of your implementing class.
It is recommended that you set this in a jndi.properties file which is in your classpath, for example
com.ibm.websphere.naming.hostname.normalizer=com.mycompany.mySpecialHostnameNormalizer
The value of this constant is "com.ibm.websphere.naming.hostname.normalizer".
com.ibm.websphere.naming.hostnameNormalizer
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |