Package org.ow2.authzforce.core.pdp.api.value

Class ImmutableAttributeValueFactoryRegistry

java.lang.Object

org.ow2.authzforce.core.pdp.api.BasePdpExtensionRegistry<AttributeValueFactory<?>>

org.ow2.authzforce.core.pdp.api.value.ImmutableAttributeValueFactoryRegistry

All Implemented Interfaces:

PdpExtensionRegistry<AttributeValueFactory<?>>, AttributeValueFactoryRegistry

public final class ImmutableAttributeValueFactoryRegistry
extends BasePdpExtensionRegistry<AttributeValueFactory<?>>
implements AttributeValueFactoryRegistry

Immutable AttributeValueFactoryRegistry.

Version:

$Id: $

Nested Class Summary

Nested classes/interfaces inherited from interface org.ow2.authzforce.core.pdp.api.PdpExtensionRegistry

PdpExtensionRegistry.PdpExtensionComparator<E extends PdpExtension>

Constructor Summary

Constructors

Constructor	Description
ImmutableAttributeValueFactoryRegistry(Collection<? extends AttributeValueFactory<?>> attributeValueFactories)	Constructor for BaseDatatypeFactoryRegistry.

Method Summary

Modifier and Type	Method	Description
StringParseableValue.Factory<?>	getCompatibleFactory(Class<? extends Serializable> rawValueClass)	Get value factory that can handle a given class of Java values
AttributeBag<?>	newAttributeBag(Collection<? extends Serializable> rawVals)	Same as AttributeValueFactoryRegistry.newAttributeBag(Collection, AttributeSource) but with attributeValueSource set to AttributeSources.REQUEST
AttributeBag<?>	newAttributeBag(Collection<? extends Serializable> rawVals, AttributeSource attributeValueSource)	Creates an AttributeBag (bag of AttributeValues) from collection of raw values using best compatible AttributeValueFactory available in this registry; compatible means that it supports the raw value types as input types.
AttributeValue	newAttributeValue(Serializable rawValue)	Creates an AttributeValue from raw value using best compatible AttributeValueFactory available in this registry; compatible means that it supports rawValue.getClass() as input type
ConstantExpression<? extends AttributeValue>	newExpression(String datatypeId, List<Serializable> content, Map<QName,String> otherAttributes, Optional<XPathCompilerProxy> xPathCompiler)	Create internal model's AttributeValue expression

Methods inherited from class org.ow2.authzforce.core.pdp.api.BasePdpExtensionRegistry

getExtension, getExtensions, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.ow2.authzforce.core.pdp.api.PdpExtensionRegistry

getExtension, getExtensions

Constructor Detail

ImmutableAttributeValueFactoryRegistry

public ImmutableAttributeValueFactoryRegistry(Collection<? extends AttributeValueFactory<?>> attributeValueFactories)

Constructor for BaseDatatypeFactoryRegistry.

Parameters:

attributeValueFactories - attribute value factories

Method Detail

newExpression

public ConstantExpression<? extends AttributeValue> newExpression(String datatypeId,
                                                                  List<Serializable> content,
                                                                  Map<QName,String> otherAttributes,
                                                                  Optional<XPathCompilerProxy> xPathCompiler)
                                                           throws IllegalArgumentException

Create internal model's AttributeValue expression

Specified by:

newExpression in interface AttributeValueFactoryRegistry

Parameters:

datatypeId - attribute datatype ID

content - raw value's mixed content, e.g. an element might be a String for text, or Element for XML element in the case of core XACML (XML) implemented with JAXB framework; or possibly Number or Boolean in the case of JSON Profile of XACML implemented with common JSON frameworks. This list is a singleton in most cases.

otherAttributes - (mandatory) other XML attributes of the value node, may be empty if none (but not null)

xPathCompiler - XPath compiler for evaluating/compiling any XPath expression in value. Undefined if XPath support disabled.

Returns:

expression, e.g. ConstantExpression for constant AttributeValues, or something like XPathExpression for context-dependent xpathExpression-type of AttributeValues (quite similar to AttributeSelector)

Throws:

IllegalArgumentException - value datatype unknown/not supported, or if value cannot be parsed into the value's defined datatype

getCompatibleFactory

public StringParseableValue.Factory<?> getCompatibleFactory(Class<? extends Serializable> rawValueClass)

Description copied from interface: AttributeValueFactoryRegistry

Get value factory that can handle a given class of Java values

Specified by:

getCompatibleFactory in interface AttributeValueFactoryRegistry

Parameters:

rawValueClass - class of the raw value

Returns:

compatible attribute value factory; null if none

newAttributeValue

public AttributeValue newAttributeValue(Serializable rawValue)
                                 throws IllegalArgumentException,
                                        UnsupportedOperationException

Description copied from interface: AttributeValueFactoryRegistry

Creates an AttributeValue from raw value using best compatible AttributeValueFactory available in this registry; compatible means that it supports rawValue.getClass() as input type

Specified by:

newAttributeValue in interface AttributeValueFactoryRegistry

Parameters:

rawValue - raw value to be converted to AttributeValue

Returns:

corresponding AttributeValue in internal model for (XACML) policy evaluation

Throws:

IllegalArgumentException - if rawValue is of the right type but actual value content is not valid for the selected (the best compatible available) AttributeValueFactory. For example, some factories for numeric (e.g. integer, double) input may not support all kinds of integer (from -Infinity to +Infinity) but only in a limited range.

UnsupportedOperationException - if rawValue.getClass() is not an input type supported by any AttributeValueFactory in this registry

newAttributeBag

public AttributeBag<?> newAttributeBag(Collection<? extends Serializable> rawVals,
                                       AttributeSource attributeValueSource)
                                throws UnsupportedOperationException,
                                       IllegalArgumentException

Description copied from interface: AttributeValueFactoryRegistry

Creates an AttributeBag (bag of AttributeValues) from collection of raw values using best compatible AttributeValueFactory available in this registry; compatible means that it supports the raw value types as input types. Beware that a bag has a single (XACML) datatype, so all value types must correspond to a single (XACML) datatype. Therefore, to prevent unexpected behavior, rawVals should all have the same concrete type. In other words, mixing different concrete Java types may cause IllegalArgumentException. For example, do not mix Integer (likely to be mapped to XACML integer) and Double (likely to be mapped to XACML double).

Specified by:

newAttributeBag in interface AttributeValueFactoryRegistry

Parameters:

rawVals - raw values to be converted to AttributeBag

attributeValueSource - attribute value source

Returns:

corresponding AttributeBag in internal model for (XACML) policy evaluation

Throws:

UnsupportedOperationException - if one of the rawValues does not have a type supported by any AttributeValueFactory as input type in this registry

IllegalArgumentException - if one of the rawValues is of the right type but actual value content is not valid for the selected (the best compatible available) AttributeValueFactory (for example, some factories for numeric input, e.g. integer or double, may not support all kinds of integer (from -Infinity to +Infinity) but only in a limited range); or rawValues do not have a common type that can be mapped to a common (XACML) AttributeValue datatype, i.e. the input type mixing is not allowed by the factory.

newAttributeBag

public AttributeBag<?> newAttributeBag(Collection<? extends Serializable> rawVals)
                                throws UnsupportedOperationException,
                                       IllegalArgumentException

Description copied from interface: AttributeValueFactoryRegistry

Same as AttributeValueFactoryRegistry.newAttributeBag(Collection, AttributeSource) but with attributeValueSource set to AttributeSources.REQUEST

Specified by:

newAttributeBag in interface AttributeValueFactoryRegistry

Parameters:

rawVals - raw values to be converted to AttributeBag

Returns:

corresponding AttributeBag in internal model for (XACML) policy evaluation

Throws:

UnsupportedOperationException - if one of the rawValues does not have a type supported by any AttributeValueFactory as input type in this registry

IllegalArgumentException - if one of the rawValues is of the right type but actual value content is not valid for the selected (the best compatible available) AttributeValueFactory (for example, some factories for numeric input, e.g. integer or double, may not support all kinds of integer (from -Infinity to +Infinity) but only in a limited range); or rawValues do not have a common type that can be mapped to a common (XACML) AttributeValue datatype, i.e. the input type mixing is not allowed by the factory.