com.sun.xacml.finder.impl
Class SelectorModule

java.lang.Object
  com.sun.xacml.finder.AttributeFinderModule
      com.sun.xacml.finder.impl.SelectorModule

public class SelectorModule

extends AttributeFinderModule

This module implements the basic behavior of the AttributeSelectorType, looking for attribute values in the physical request document using the given XPath expression. This is implemented as a separate module (instead of being implemented directly in AttributeSelector so that programmers can remove this functionality if they want (it's optional in the spec), so they can replace this code with more efficient, specific code as needed, and so they can easily swap in different XPath libraries.

Note that if no matches are found, this module will return an empty bag (unless some error occurred). The AttributeSelector is still deciding what to return to the policy based on the MustBePresent attribute.

This module uses the Xalan XPath implementation, and supports only version 1.0 of XPath. It is a fully functional, correct implementation of XACML's AttributeSelector functionality, but is not designed for environments that make significant use of XPath queries. Developers for any such environment should consider implementing their own module.

Since:

1.0

Constructor Summary

SelectorModule()

Method Summary

EvaluationResult	findAttribute(String path, Node namespaceNode, URI type, EvaluationCtx context, String xpathVersion) Tries to find attribute values based on the given selector data.
boolean	isSelectorSupported() Returns true since this module supports retrieving attributes based on the data provided in an AttributeSelectorType.

Methods inherited from class com.sun.xacml.finder.AttributeFinderModule

findAttribute, getIdentifier, getSupportedDesignatorTypes, getSupportedIds, invalidateCache, isDesignatorSupported

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SelectorModule

public SelectorModule()

Method Detail

isSelectorSupported

public boolean isSelectorSupported()

Returns true since this module supports retrieving attributes based on the data provided in an AttributeSelectorType.

Overrides:

isSelectorSupported in class AttributeFinderModule

Returns:

true

findAttribute

public EvaluationResult findAttribute(String path,
                                      Node namespaceNode,
                                      URI type,
                                      EvaluationCtx context,
                                      String xpathVersion)

Tries to find attribute values based on the given selector data. The result, if successful, always contains a BagAttribute, even if only one value was found. If no values were found, but no other error occurred, an empty bag is returned.

Overrides:

findAttribute in class AttributeFinderModule

Parameters:

path - the XPath expression to search against

namespaceNode - the DOM node defining namespace mappings to use, or null if mappings come from the context root

type - the datatype of the attributes to find

context - the representation of the request data

xpathVersion - the XPath version to use

Returns:

the result of attribute retrieval, which will be a bag of attributes or an error