CONTENTS | PREV | NEXT JNDI API


Appendix 1:
JNDI Standard Environment Properties

 

JNDI Environment Properties 1

Environment Configuration

java.naming.applet

(Context.APPLET)

An instance of java.applet.Applet whose applet parameters are used to obtain some environment properties.
See Chapter 6 for details. No default.

Program Configuration 2

java.naming.factory.initial

(Context.INITIAL_CONTEXT_FACTORY)

Class name of initial context factory to use.

See InitialContext .

No default.

java.naming.factory.object

(Context.OBJECT_FACTORIES)

Colon-separated list of class names of object factory classes to use.

See NamingManager.getObjectInstance() and DirectoryManager.getObjectInstance() .

Defaults to empty list.

java.naming.factory.state

(Context.STATE_FACTORIES)

Colon-separated list of class names of state factory classes to use.

See NamingManager.getStateToBind() and DirectoryManager.getStateToBind() .

Defaults to empty list.

java.naming.factory.control

(LdapContext.CONTROL_FACTORIES)

Colon-separated list of class names of response control factory classes to use.

See ControlFactory.getControlInstance() .

Defaults to empty list.

java.naming.factory.url.pkgs

(Context.URL_PKG_PREFIXES)

Colon-separated list of package prefixes to use when loading in URL context factories. com.sun.jndi.url is always added to end of list.

See NamingManager.getURLContext() .

Defaults to empty list.


Access Configuration 3

java.naming.provider.url

(Context.PROVIDER_URL)

Specifies configuration information for provider to use.

Defaults to provider default, using provider's own configuration or discovery protocols.

java.naming.dns.url

(Context.DNS_URL)

Specifies the DNS host and domain names.

No default.


Service-Related

java.naming.authoritative

(Context.AUTHORITATIVE)

Specifies the authoritativeness of the service requested. If "true", specifies most authoritative source is to be used (e.g., bypass any caches, or bypass replicas in some systems). Otherwise, source need not be (but can be) authoritative.

Defaults to "false".

java.naming.batchsize

(Context.BATCHSIZE)

Specifies the preferred batch size to use when returning data via the service's protocol. This is a hint to the provider to return the results of operations in batches of the specified size, so that the provider can optimize its performance and usage of resources. It does not affect the total number or size of the data returned.

Defaults to provider default.

java.naming.referral

(Context.REFERRAL)

Specifies that referrals encountered by the service provider are to be followed automatically. If "follow", follow referrals automatically. If "ignore", ignore referrals encountered. If "throw", throw ReferralException when a referral is encountered.

Defaults to provider default.


Security

java.naming.security.protocol

(Context.SECURITY_PROTOCOL)

Security protocol to use for service.

Defaults to provider default.

java.naming.security.authentication

(Context.SECURITY_AUTHENTICATION)

Takes values "none", "simple", "strong", or a provider-specific string (e.g., "CRAM-MD5 DIGEST-MD5 EXTERNAL").

Defaults to provider default.

java.naming.security.principal

(Context.SECURITY_PRINCIPAL)

Identity of principal (e.g., user) for the authentication scheme.

Defaults to provider default.

java.naming.security.credentials

(Context.SECURITY_CREDENTIALS)

Principal's credentials for the authentication scheme.

The particular type of credentials is determined by the authentication scheme chosen. Examples of different types of credentials are passwords, keys, and certificates.

Defaults to provider default.


Internationalization

java.naming.language

(Context.LANGUAGE)

Specifies a colon-separated list of preferred language to use with this service (e.g., "en-US", "fr", "fr-CH", "ja-JP-kanji").

Languages are specified using tags defined in RFC 1766.

Defaults to provider default.

 

1. The Context and LdapContext interfaces define constants for these property names. The names of the constants are shown in parentheses below the property's string names.

2. These properties may be set in the Java runtime's system properties or in an applet's parameter list.

3. These properties may be set in the Java runtime's system properties or in an applet's parameter list.


CONTENTS | PREV | NEXT
Copyright ©1997-1999 Sun Microsystems, Inc. All Rights Reserved.