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 and Description |
---|---|
String[] |
getNames()
Gets a list of
ContextElement names that can be requested. |
Object |
getValue(String name)
Gets a value for the specified
ContextElement name. |
ContextElement[] |
getValues(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.String[] getNames()
ContextElement
names that can be requested.ContextElement
s that
can be requested, represented as an array of Strings.Object getValue(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(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.