Package com.zeroc.Ice
Interface ImplicitContext
public interface ImplicitContext
An interface to associate implict contexts with communicators.
When you make a remote invocation without an explicit context parameter,
Ice uses the per-proxy context (if any) combined with the
ImplicitContext
associated with the communicator.
Ice provides several implementations of ImplicitContext
. The implementation
used depends on the value of the Ice.ImplicitContext
property.
None
(default)- No implicit context at all.
PerThread
- The implementation maintains a context per thread.
Shared
- The implementation maintains a single context shared by all threads.
ImplicitContext
also provides a number of operations to create, update or retrieve
an entry in the underlying context without first retrieving a copy of the entire
context. These operations correspond to a subset of the java.util.Map
methods,
with java.lang.Object
replaced by string
and null replaced by the empty-string.-
Method Summary
Modifier and TypeMethodDescriptionboolean
containsKey
(String key) Check if this key has an associated value in the underlying context.Get the value associated with the given key in the underlying context.Get a copy of the underlying context.Create or update a key/value entry in the underlying context.Remove the entry for the given key in the underlying context.void
setContext
(Map<String, String> newContext) Set the underlying context.
-
Method Details
-
getContext
Get a copy of the underlying context.- Returns:
- A copy of the underlying context.
-
setContext
Set the underlying context.- Parameters:
newContext
- The new context.
-
containsKey
Check if this key has an associated value in the underlying context.- Parameters:
key
- The key.- Returns:
- True if the key has an associated value, False otherwise.
-
get
Get the value associated with the given key in the underlying context. Returns an empty string if no value is associated with the key.containsKey(java.lang.String)
allows you to distinguish between an empty-string value and no value at all.- Parameters:
key
- The key.- Returns:
- The value associated with the key.
-
put
Create or update a key/value entry in the underlying context.- Parameters:
key
- The key.value
- The value.- Returns:
- The previous value associated with the key, if any.
-
remove
Remove the entry for the given key in the underlying context.- Parameters:
key
- The key.- Returns:
- The value associated with the key, if any.
-