SecurityTokenContextHandler
public interface ContextHandler
ContextHandler
interface provides a way for an internal Weblogic
container to pass additional information to a WebLogic Security Framework call, so that
a security provider can obtain additional context information beyond what is provided
by the arguments to a particular method. A ContextHandler
is essentially
a name/value list and as such, it requires a security provider to know what names to
look for (that is, use of a ContextHandler
requires close cooperation
between the Weblogic container and a security provider). The name/value list is also
called a context element, and is represented by a ContextElement
object.
A ContextHandler
argument is passed into the isAccessAllowed
method of an AccessDecision
, so you can view this method as an example.
As another example, if one was attempting to access a file in a directory, the
name of that file could be passed through a ContextHandler
object.
Modifier and Type | Method | Description |
---|---|---|
java.lang.String[] |
getNames() |
Gets a list of
ContextElement names that can be requested. |
java.lang.Object |
getValue(java.lang.String name) |
Gets a value for the specified
ContextElement name. |
ContextElement[] |
getValues(java.lang.String[] names) |
Gets an array of
ContextElement objects containing values for each of the
named elements that are known. |
int |
size() |
Provides a count of the number of
ContextElement s that the handler
is able to return. |
int size()
ContextElement
s that the handler
is able to return.ContextElement
s that can be
requested. A value of -1
indicates that the
handler is unable to return the exact count.java.lang.String[] getNames()
ContextElement
names that can be requested.ContextElement
s that
can be requested, represented as an array of Strings.java.lang.Object getValue(java.lang.String name)
ContextElement
name.name
- the name of the ContextElement
for which a value
should be returned, represented as a String.Object
that contains the value of the requested name.
If the value of the name
parameter is unknown,
a null
value is returned.ContextElement[] getValues(java.lang.String[] names)
ContextElement
objects containing values for each of the
named elements that are known.names
- the names of the ContextElement
s
to be returned, represented as an array of Strings.ContextElement
object for
each of the named elements found in the names
parameter. The value for the requested element is returned as
a java.lang.Object
. As a result, the caller must
know the data type of the value.
If a name in the names
parameter is unknown, the
name will not appear in the array of ContextElement
objects.