WLContext (Java API Reference for Oracle WebLogic Server)

All Superinterfaces:

javax.naming.Context, RmiContextConstants

All Known Subinterfaces:

TengahContext, WLJMSOBSContext
```
public interface WLContext
extends javax.naming.Context, RmiContextConstants
```
Interface for a WebLogic naming context. This extends javax.naming.Context with several WebLogic-specific environment properties, and methods for deleting one of several objects stored in a pool under one name.

Field Summary

Fields
Modifier and Type	Field	Description
`static java.lang.String`	`ALLOW_EXTERNAL_APP_LOOKUP`	Specifies whether external clients or other applications are allowed to lookup bindings from an application version.
`static java.lang.String`	`ALLOW_GLOBAL_RESOURCE_LOOKUP`	Specifies whether versioned clients or applications are allowed to lookup bindings of global resources.
`static java.lang.String`	`CREATE_INTERMEDIATE_CONTEXTS`	Specifies how to handle non-existent intermediate contexts.
`static java.lang.String`	`DELEGATE_ENVIRONMENT`	Specifies the JNDI environment to use for connecting to a third-party naming service through the WebLogic Server.
`static java.lang.String`	`ENABLE_DEFAULT_USER`	On the client side no default user would not be set.
`static java.lang.String`	`ENABLE_SERVER_AFFINITY`	Specifies if multiple context creation's from the same VM should reuse existing connections or round-robin across all servers in the cluster.
`static java.lang.String`	`IDENTITY_DOMAIN`	Set this property to specify the identity domain for the user.
`static java.lang.String`	`PIN_TO_PRIMARY_SERVER`	If `true`, this property forces the context stub to connect to the primary naming server only (the server currently running at host specified by `Context.PROVIDER_URL`).
`static java.lang.String`	`PROVIDER_RJVM`	Specifies the RJVM to use as the naming server.
`static java.lang.String`	`RELAX_VERSION_LOOKUP`	Specifies the lookup behavior when bindings from the current application version cannot be found.
`static java.lang.String`	`REPLICATE_BINDINGS`	Specifies whether tree modifications are replicated and is only applicable when connecting to WebLogic Servers that are running in a cluster.
`static java.lang.String`	`SSL_CLIENT_CERTIFICATE`	Specifies an RSA private key and a chain of certificates for client authentication.
`static java.lang.String`	`SSL_CLIENT_KEY_PASSWORD`	Specifies the pasword for an encrypted PKCS5/PKCS8 RSA private key.
`static java.lang.String`	`SSL_ROOT_CA_FINGERPRINTS`	Specifies which certificate authorities to trust.
`static java.lang.String`	`SSL_SERVER_NAME`	Specifies an expected name of an SSL server as a String.

Fields inherited from interface javax.naming.Context
APPLET, AUTHORITATIVE, BATCHSIZE, DNS_URL, INITIAL_CONTEXT_FACTORY, LANGUAGE, OBJECT_FACTORIES, PROVIDER_URL, REFERRAL, SECURITY_AUTHENTICATION, SECURITY_CREDENTIALS, SECURITY_PRINCIPAL, SECURITY_PROTOCOL, STATE_FACTORIES, URL_PKG_PREFIXES

Fields inherited from interface weblogic.rmi.RmiContextConstants
CONNECT_TIMEOUT, REQUEST_TIMEOUT, RESPONSE_READ_TIMEOUT, RMI_TIMEOUT

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method	Description
`java.lang.String`	`getNameInNamespace(java.lang.String relativeName)`	Returns the full name of a property, relative to the root of this namespace.
`void`	`unbind(java.lang.String name, java.lang.Object service)`	Unbinds the specified service from the specified name.
`void`	`unbind(javax.naming.Name name, java.lang.Object service)`	Unbinds the specified service from the specified name.

Methods inherited from interface javax.naming.Context
addToEnvironment, bind, bind, close, composeName, composeName, createSubcontext, createSubcontext, destroySubcontext, destroySubcontext, getEnvironment, getNameInNamespace, getNameParser, getNameParser, list, list, listBindings, listBindings, lookup, lookup, lookupLink, lookupLink, rebind, rebind, removeFromEnvironment, rename, rename, unbind, unbind

- Field Detail
  - CREATE_INTERMEDIATE_CONTEXTS
```
static final java.lang.String CREATE_INTERMEDIATE_CONTEXTS
```
    Specifies how to handle non-existent intermediate contexts. If this property is true, performing a bind, rebind, or createSubcontext with a name that specifies non-existent intermediate contexts causes those contexts to be created.
    
    See Also:
    
    Constant Field Values
  - DELEGATE_ENVIRONMENT
```
static final java.lang.String DELEGATE_ENVIRONMENT
```
    Specifies the JNDI environment to use for connecting to a third-party naming service through the WebLogic Server. When this property is specified, WLInitialContextFactory uses the WebLogic Server to create a three-tier connection to a third-party naming service. The properties contained in the Hashtable specified by this property are used to create an initial context for the third-party naming service, upon which the original initial context delegates its work to the third-party's initial context.
    
    See Also:
    
    Constant Field Values
  - PROVIDER_RJVM
```
static final java.lang.String PROVIDER_RJVM
```
    Specifies the RJVM to use as the naming server. This can be used as an alternative to Context.PROVIDER_URL. Instead of a URL, this property must specify an RJVM representing the desired server.
    
    See Also:
    
    Constant Field Values
  - REPLICATE_BINDINGS
```
static final java.lang.String REPLICATE_BINDINGS
```
    Specifies whether tree modifications are replicated and is only applicable when connecting to WebLogic Servers that are running in a cluster. By default, any modification to the naming tree is replicated across the cluster, which ensures that any server can act as a naming server for the entire cluster. Setting this property to false changes this behavior and should be done with extreme caution: a value of false means that modifications to the tree caused by bind, unbind, createSubcontext, and destroySubcontext will not be replicated.
    Understand the implications of this property before changing its default value(true).
    
    See Also:
    
    Constant Field Values
  - PIN_TO_PRIMARY_SERVER
```
static final java.lang.String PIN_TO_PRIMARY_SERVER
```
    If true, this property forces the context stub to connect to the primary naming server only (the server currently running at host specified by Context.PROVIDER_URL). This disables fail-over for the context. Only applicable when connecting to WebLogic Servers that are running in a cluster. By default this property is false.
    This setting should be used when a connection to a specific server is required. Note that this setting will only have the desired effect if Context.PROVIDER_URL specifes a host name that maps only to a single server address. It will not work, for example, if the host name maps to multiple server addresses in DNS.
    
    See Also:
    
    Constant Field Values
  - SSL_ROOT_CA_FINGERPRINTS
```
static final java.lang.String SSL_ROOT_CA_FINGERPRINTS
```
    Specifies which certificate authorities to trust. The value for this property should be a set of fingerprints (MD5) of the authorities' certificates encoded either as an array of byte arrays, or a comma-separated string of hex values. If specified, the SSL connection can only be established to a server that presents a certificate chain in which the fingerprint of the root matches one of the fingerprints specified by the value of this property.
    
    See Also:
    
    Constant Field Values
  - SSL_SERVER_NAME
```
static final java.lang.String SSL_SERVER_NAME
```
    Specifies an expected name of an SSL server as a String. It must match the common name field in the certificate presented by the server. This is typically also the WebLogic Server's DNS name, for example, www.weblogic.com.
    
    See Also:
    
    Constant Field Values
  - SSL_CLIENT_CERTIFICATE
```
static final java.lang.String SSL_CLIENT_CERTIFICATE
```
    Specifies an RSA private key and a chain of certificates for client authentication. In a server, it can be set to the special string SERVER to refer to the server's private key and certificate chain. In general, it can be set to an array of InputStreams, the first element of which is a DER-encoded RSA private key, followed by DER-encoded X.509 certificates. All but the first certificate must be an issuer certificate of the preceding certificate. If your key and certificates are encoded using PEM, you can obtain the DER encoding using PEMInputStream.
    
    See Also:
    
    PEMInputStream, Constant Field Values
  - SSL_CLIENT_KEY_PASSWORD
```
static final java.lang.String SSL_CLIENT_KEY_PASSWORD
```
    Specifies the pasword for an encrypted PKCS5/PKCS8 RSA private key. Using an encrypted private key is optional.
    
    See Also:
    
    Constant Field Values
  - ENABLE_SERVER_AFFINITY
```
static final java.lang.String ENABLE_SERVER_AFFINITY
```
    Specifies if multiple context creation's from the same VM should reuse existing connections or round-robin across all servers in the cluster. By default, context creation's would round-robin across all servers in a cluster. This property takes affect only when a cluster url is specified. If a specific server url is used, context creation would always connect to that server. Only applicable when connecting to WebLogic Servers that are running in a cluster.
    
    See Also:
    
    Constant Field Values
  - RELAX_VERSION_LOOKUP
```
static final java.lang.String RELAX_VERSION_LOOKUP
```
    Specifies the lookup behavior when bindings from the current application version cannot be found. If the property is set to true, the currently active version will be returned, if any. If the property is set to false, a NameNotFoundException will be returned.
    The default value of the property is false. Users should exercise discretion and ensure that components of different application versions are compatible when setting the property to true.
    
    See Also:
    
    Constant Field Values
  - ALLOW_EXTERNAL_APP_LOOKUP
```
static final java.lang.String ALLOW_EXTERNAL_APP_LOOKUP
```
    Specifies whether external clients or other applications are allowed to lookup bindings from an application version.
    The default value of the property is false. Users should exercise discretion when setting the property to true, as this may potentially cause in-flight work not being tracked properly and application versions to be retired prematurely.
    
    See Also:
    
    Constant Field Values
  - ALLOW_GLOBAL_RESOURCE_LOOKUP
```
static final java.lang.String ALLOW_GLOBAL_RESOURCE_LOOKUP
```
    Specifies whether versioned clients or applications are allowed to lookup bindings of global resources.
    The default value of the property is false. Users should exercise discretion when setting the property to true, and ensure that simultaneous access of the global resources are either tolerated or handled properly by the application.
    
    See Also:
    
    Constant Field Values
  - ENABLE_DEFAULT_USER
```
static final java.lang.String ENABLE_DEFAULT_USER
```
    On the client side no default user would not be set. To enable the previous behavior this property needs to be set either at the command line or through the InitialContext interface.
    
    See Also:
    
    Constant Field Values
  - IDENTITY_DOMAIN
```
static final java.lang.String IDENTITY_DOMAIN
```
    Set this property to specify the identity domain for the user. An identity domain is a logical namespace for users and groups, typically representing a discrete set of users and groups in a physical store. The identity domain is used when authenticating the user via an identity domain aware authentication provider.
    
    See Also:
    
    Constant Field Values
- Method Detail
  - getNameInNamespace
```
java.lang.String getNameInNamespace(java.lang.String relativeName)
                             throws javax.naming.NamingException
```
    Returns the full name of a property, relative to the root of this namespace.
    
    Parameters:
    
    relativeName - Property name relative to this context
    
    Returns:
    
    Full name of property
    
    Throws:
    
    javax.naming.NamingException - if a failure occurs
  - unbind
```
void unbind(javax.naming.Name name,
            java.lang.Object service)
     throws javax.naming.NamingException
```
    Unbinds the specified service from the specified name.
    
    Parameters:
    
    name - Name of service to unbind (as a Name object)
    
    service - Service object to be unbound
    
    Throws:
    
    javax.naming.NamingException - if the service is not available
  - unbind
```
void unbind(java.lang.String name,
            java.lang.Object service)
     throws javax.naming.NamingException
```
    Unbinds the specified service from the specified name.
    
    Parameters:
    
    name - Name of service to unbind (as a String)
    
    service - Service object to be unbound
    
    Throws:
    
    javax.naming.NamingException - if the service is not available

Interface WLContext

Field Summary

Fields inherited from interface javax.naming.Context

Fields inherited from interface weblogic.rmi.RmiContextConstants

Method Summary

Methods inherited from interface javax.naming.Context

Field Detail

CREATE_INTERMEDIATE_CONTEXTS

DELEGATE_ENVIRONMENT

PROVIDER_RJVM

REPLICATE_BINDINGS

PIN_TO_PRIMARY_SERVER

SSL_ROOT_CA_FINGERPRINTS

SSL_SERVER_NAME

SSL_CLIENT_CERTIFICATE

SSL_CLIENT_KEY_PASSWORD

ENABLE_SERVER_AFFINITY

RELAX_VERSION_LOOKUP

ALLOW_EXTERNAL_APP_LOOKUP

ALLOW_GLOBAL_RESOURCE_LOOKUP

ENABLE_DEFAULT_USER

IDENTITY_DOMAIN

Method Detail

getNameInNamespace

unbind

unbind