com.ibm.websphere.naming
Interface WsnBatchModeContext

All Superinterfaces:

javax.naming.Context

public interface WsnBatchModeContext

extends javax.naming.Context

This interface is a javax.naming.Context extension to provide batch mode processing capabilities. JNDI operations performed with a "batch mode context" are not sent to the name server until the executeBatchedOperations() method is invoked. Batch mode contexts can be used to batch operations to the name server for greater performance since fewer remote calls to the name server will be made.

When a JNDI lookup from the name server returns a javax.naming.Context object (when WebSphere's initial context factory, com.ibm.websphere.naming.WsnInitialContextFactory, is used to obtain the initial context), the context object is not a batch mode context. However, a batch mode version of the context can be obtained. To obtain a batch mode version of the context, cast the Context instance to the interface com.ibm.websphere.naming.WsnOptimizedJndiContext and invoke the method method, getBatchModeContext(). The returned value will be an instance of com.ibm.websphere.naming.WsnBatchModeContext. Take care to not attempt the cast on the initial context instance itself, or on contexts returned from URL lookups such as "java:comp/env". To obtain a WebSphere implementation of javax.naming.Context for the initial context, execute a lookup on the initial context with an empty name. For example,

 Context ctx = (Context) initialContext.lookup("");
 

Batching is supported only if the name server is a WebSphere Application Server implementation.

See Also:

WsnOptimizedJndiContext

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

Method Summary

WsnBatchCompleteResults	executeBatchedOperations() Sends the accumulated batched operations to the server.
javax.naming.Context	getNonBatchModeContext() Creates a non batch mode javax.naming.Context instance which is otherwise a clone of this Context instance.

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

Method Detail

executeBatchedOperations

public WsnBatchCompleteResults executeBatchedOperations()
                                                 throws javax.naming.NamingException

Sends the accumulated batched operations to the server. Processes the results and returns the operations and results in a WsnBatchCompleteResults instance.

Returns:

a WsnBatchCompleteResults which will consist of one WsnBatchResult object for each batch operation requested.

Throws:

javax.naming.NamingException - Some JNDI exception occurred.

See Also:

WsnBatchCompleteResults

getNonBatchModeContext

public javax.naming.Context getNonBatchModeContext()
                                            throws javax.naming.NamingException

Creates a non batch mode javax.naming.Context instance which is otherwise a clone of this Context instance.

Returns:

a non batch mode context clone.

Throws:

javax.naming.NamingException - Some JNDI exception occurred.