Overview  Package   Class  Use  Deprecated  Index
Home >> All >> com >> sun >> xacml >> [ finder overview ]	PREV CLASS  NEXT CLASS
SUMMARY:  JAVADOC |  SOURCE |  DOWNLOAD | NESTED | FIELD | CONSTR | METHOD	DETAIL: FIELD | CONSTR | METHOD

---

com.sun.xacml.finder
Class AttributeFinderModule  

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

---

public abstract class AttributeFinderModule

extends java.lang.Object

This is the abstract class that all AttributeFinder modules extend. All methods have default values to represent that the given feature isn't supported by this module, so module writers needs only implement the methods for the features they're supporting.

Since:

1.0

---

Constructor Summary

AttributeFinderModule()

 

Method Summary
com.sun.xacml.cond.EvaluationResult	findAttribute(java.lang.String contextPath, org.w3c.dom.Node namespaceNode, java.net.URI attributeType, com.sun.xacml.EvaluationCtx context, java.lang.String xpathVersion)           Tries to find attribute values based on the given selector data.
com.sun.xacml.cond.EvaluationResult	findAttribute(java.net.URI attributeType, java.net.URI attributeId, java.net.URI issuer, java.net.URI subjectCategory, com.sun.xacml.EvaluationCtx context, int designatorType)           Tries to find attribute values based on the given designator data.
java.lang.String	getIdentifier()           Returns this module's identifier.
java.util.Set	getSupportedDesignatorTypes()           Returns a Set of Integers that represent which AttributeDesignator types are supported (eg, Subject, Resource, etc.), or null meaning that no particular types are supported.
java.util.Set	getSupportedIds()           Returns a Set of URIs that represent the attributeIds handled by this module, or null if this module doesn't handle any specific attributeIds.
void	invalidateCache()           This is an experimental method that asks the module to invalidate any cache values it may contain.
boolean	isDesignatorSupported()           Returns true if this module supports retrieving attributes based on the data provided in an AttributeDesignatorType.
boolean	isSelectorSupported()           Returns true if this module supports retrieving attributes based on the data provided in an AttributeSelectorType.

 

Methods inherited from class java.lang.Object

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

 

Constructor Detail

AttributeFinderModule

public AttributeFinderModule()

Method Detail

getIdentifier

public java.lang.String getIdentifier()

Returns this module's identifier. A module does not need to provide a unique identifier, but it is a good idea, especially in support of management software. Common identifiers would be the full package and class name (the default if this method isn't overridden), just the class name, or some other well-known string that identifies this class.

---

isDesignatorSupported

public boolean isDesignatorSupported()

Returns true if this module supports retrieving attributes based on the data provided in an AttributeDesignatorType. By default this method returns false.

---

isSelectorSupported

public boolean isSelectorSupported()

Returns true if this module supports retrieving attributes based on the data provided in an AttributeSelectorType. By default this method returns false.

---

getSupportedDesignatorTypes

public java.util.Set getSupportedDesignatorTypes()

Returns a Set of Integers that represent which AttributeDesignator types are supported (eg, Subject, Resource, etc.), or null meaning that no particular types are supported. A return value of null can mean that this module doesn't support designator retrieval, or that it supports designators of all types. If the set is non-null, it should contain the values specified in the AttributeDesignator *_TARGET fields.

---

getSupportedIds

public java.util.Set getSupportedIds()

Returns a Set of URIs that represent the attributeIds handled by this module, or null if this module doesn't handle any specific attributeIds. A return value of null means that this module will try to resolve attributes of any id.

---

invalidateCache

public void invalidateCache()

This is an experimental method that asks the module to invalidate any cache values it may contain. This is not used by any of the core processing code, but it may be used by management software that wants to have some control over these modules. Since a module is free to decide how or if it caches values, and whether it is capable of updating values once in a cache, a module is free to intrepret this message in any way it sees fit (including igoring the message). It is preferable, however, for a module to make every effort to clear any dynamically cached values it contains.

This method has been introduced to see what people think of this functionality, and how they would like to use it. It may be removed in future versions, or it may be changed to a more general message-passing system (if other useful messages are identified).

Since:

1.2

---

findAttribute

public com.sun.xacml.cond.EvaluationResult findAttribute(java.net.URI attributeType,
                                                         java.net.URI attributeId,
                                                         java.net.URI issuer,
                                                         java.net.URI subjectCategory,
                                                         com.sun.xacml.EvaluationCtx context,
                                                         int designatorType)

Tries to find attribute values based on the given designator data. The result, if successful, must always contain a BagAttribute, even if only one value was found. If no values were found, but no other error occurred, an empty bag is returned. This method may need to invoke the context data to look for other attribute values, so a module writer must take care not to create a scenario that loops forever.

---

findAttribute

public com.sun.xacml.cond.EvaluationResult findAttribute(java.lang.String contextPath,
                                                         org.w3c.dom.Node namespaceNode,
                                                         java.net.URI attributeType,
                                                         com.sun.xacml.EvaluationCtx context,
                                                         java.lang.String xpathVersion)

Tries to find attribute values based on the given selector data. The result, if successful, must always contain a BagAttribute, even if only one value was found. If no values were found, but no other error occurred, an empty bag is returned. This method may need to invoke the context data to look for other attribute values, so a module writer must take care not to create a scenario that loops forever.

---

Overview  Package   Class  Use  Deprecated  Index
Home >> All >> com >> sun >> xacml >> [ finder overview ]	PREV CLASS  NEXT CLASS
SUMMARY:  JAVADOC |  SOURCE |  DOWNLOAD | NESTED | FIELD | CONSTR | METHOD	DETAIL: FIELD | CONSTR | METHOD

---