org.faktorips.runtime.model.type

Class PolicyAttribute

java.lang.Object

org.faktorips.runtime.model.type.ModelElement

org.faktorips.runtime.model.type.TypePart

org.faktorips.runtime.model.type.Attribute

org.faktorips.runtime.model.type.PolicyAttribute

All Implemented Interfaces:

IModelElement, IModelTypeAttribute

Direct Known Subclasses:

ConstantPolicyAttribute, DefaultPolicyAttribute

public abstract class PolicyAttribute
extends Attribute

An attribute of a PolicyCmptType.

Nested Class Summary

Nested classes/interfaces inherited from interface org.faktorips.runtime.modeltype.IModelTypeAttribute

IModelTypeAttribute.AttributeType, IModelTypeAttribute.ValueSetType

Constructor Summary

Constructors

Constructor and Description
PolicyAttribute(Type type, IpsAttribute attributeAnnotation, IpsExtensionProperties extensionProperties, Class<?> datatype, boolean changingOverTime)

Method Summary

Modifier and Type	Method and Description
abstract Object	getDefaultValue(IConfigurableModelObject modelObject) Returns the product configured default value of the attribute identified by this model type attribute.
abstract Object	getDefaultValue(IProductComponent source, Calendar effectiveDate) Returns the product configured default value of the attribute identified by this model type attribute.
PolicyCmptType	getModelType() Deprecated. Use getType()
PolicyAttribute	getSuperAttribute() Returns the attribute that is overridden by this attribute if this attribute overrides another one.
PolicyCmptType	getType() Returns the PolicyCmptType this attribute belongs to.
abstract Object	getValue(IModelObject modelObject) Returns the value of the given model object's attribute identified by this model type attribute.
org.faktorips.valueset.ValueSet<?>	getValueSet(IModelObject modelObject) Returns the value set of the given model object's attribute identified by this model type attribute.
abstract org.faktorips.valueset.ValueSet<?>	getValueSet(IModelObject modelObject, IValidationContext context) Returns the value set of the given model object's attribute identified by this model type attribute.
org.faktorips.valueset.ValueSet<?>	getValueSet(IProductComponent source, Calendar effectiveDate) Returns the value set of the given model object's attribute identified by this model type attribute.
abstract org.faktorips.valueset.ValueSet<?>	getValueSet(IProductComponent source, Calendar effectiveDate, IValidationContext context) Returns the value set of the given model object's attribute identified by this model type attribute.
abstract void	setDefaultValue(IConfigurableModelObject modelObject, Object defaultValue) Sets the product configured default value of the attribute identified by this model type attribute.
abstract void	setDefaultValue(IProductComponent target, Calendar effectiveDate, Object defaultValue) Sets the product configured default value of the attribute identified by this model type attribute.
abstract void	setValue(IModelObject modelObject, Object value) Sets the given model object's attribute identified by this model type attribute to the given value.
abstract void	setValueSet(IConfigurableModelObject modelObject, org.faktorips.valueset.ValueSet<?> valueSet) Sets the product configured set of allowed values of the attribute identified by this model type attribute.
abstract void	setValueSet(IProductComponent target, Calendar effectiveDate, org.faktorips.valueset.ValueSet<?> valueSet) Sets the product configured set of allowed values of the attribute identified by this model type attribute.

Methods inherited from class org.faktorips.runtime.model.type.Attribute

createOverwritingAttributeFor, getAttributeKind, getAttributeType, getDatatype, getRelevantProductObject, getValueSetKind, getValueSetType, isChangingOverTime, isOverriding, isProductRelevant, toString

Methods inherited from class org.faktorips.runtime.model.type.TypePart

getMessageHelper, getMessageKey, getTypeName

Methods inherited from class org.faktorips.runtime.model.type.ModelElement

createMessageHelper, getDescription, getDocumentation, getExtensionPropertyIds, getExtensionPropertyValue, getLabel, getName, getRelevantProductObject, invokeField, invokeMethod

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.faktorips.runtime.modeltype.IModelElement

getDescription, getExtensionPropertyIds, getExtensionPropertyValue, getLabel, getName

Constructor Detail

PolicyAttribute

public PolicyAttribute(Type type,
                       IpsAttribute attributeAnnotation,
                       IpsExtensionProperties extensionProperties,
                       Class<?> datatype,
                       boolean changingOverTime)

Method Detail

getType

public PolicyCmptType getType()

Returns the PolicyCmptType this attribute belongs to.

Overrides:

getType in class TypePart

getModelType

@Deprecated
public PolicyCmptType getModelType()

Deprecated. Use getType()

Returns the parent Type

Specified by:

getModelType in interface IModelTypeAttribute

Overrides:

getModelType in class TypePart

getSuperAttribute

public PolicyAttribute getSuperAttribute()

Description copied from class: Attribute

Returns the attribute that is overridden by this attribute if this attribute overrides another one. Otherwise returns null.

Overrides:

getSuperAttribute in class Attribute

Returns:

The attribute that is overridden by this attribute.

See Also:

Attribute.isOverriding()

getValue

public abstract Object getValue(IModelObject modelObject)

Returns the value of the given model object's attribute identified by this model type attribute.

Parameters:

modelObject - a model object corresponding to the Type this attribute belongs to

Returns:

the value of the given model object's attribute identified by this model type attribute

Throws:

IllegalArgumentException - if the model object does not have an attribute fitting this model type attribute or that attribute is not accessible for any reason

setValue

public abstract void setValue(IModelObject modelObject,
                              Object value)

Sets the given model object's attribute identified by this model type attribute to the given value. This only works for changeable attributes.

Parameters:

modelObject - a model object corresponding to the Type this attribute belongs to

value - an object of this model type attribute's datatype

Throws:

IllegalArgumentException - if the model object does not have a changeable attribute fitting this model type attribute or that attribute is not accessible for any reason or the value does not fit the attribute's datatype.

UnsupportedOperationException - if invoked on a AttributeKind.CONSTANT attribute.

getDefaultValue

public abstract Object getDefaultValue(IConfigurableModelObject modelObject)

Returns the product configured default value of the attribute identified by this model type attribute. Throws an IllegalStateException if the model object has no getDefaultValue() method for this attribute. This also occurs if the corresponding policy class is not configured by a product class.

Parameters:

modelObject - the configurable model object from which product component and (if necessary) effective date can be retrieved

Throws:

IllegalStateException - if the model object has no getter method for this attribute's default value. This also occurs if the corresponding policy class is not configured by a product class.

IllegalArgumentException - if the invocation of the method that should get the default value for this attribute fails for any reason

See Also:

getDefaultValue(IProductComponent, Calendar)

getDefaultValue

public abstract Object getDefaultValue(IProductComponent source,
                                       Calendar effectiveDate)

Returns the product configured default value of the attribute identified by this model type attribute.

Parameters:

source - the product component to read the attribute default value from.

effectiveDate - the date to determine the product component generation. If null the latest generation is used. Is ignored if the attribute's configuration is not changing over time.

Throws:

UnsupportedOperationException - if invoked on a AttributeKind.CONSTANT attribute.

IllegalStateException - if the model object has no getter method for this attribute's default value. This also occurs if the corresponding policy class is not configured by a product class.

IllegalArgumentException - if the invocation of the method that should get the default value for this attribute fails for any reason

setDefaultValue

public abstract void setDefaultValue(IConfigurableModelObject modelObject,
                                     Object defaultValue)

Sets the product configured default value of the attribute identified by this model type attribute.

Parameters:

modelObject - the configurable model object from which product component and (if necessary) effective date can be retrieved

defaultValue - the new default value

Throws:

UnsupportedOperationException - if invoked on a AttributeKind.CONSTANT attribute.

IllegalStateException - if the model object has no setter method for this attribute's default value. This also occurs if the corresponding policy class is not configured by a product class.

IllegalArgumentException - if the invocation of the method that should set the default value for this attribute fails for any reason

Since:

20.6

setDefaultValue

public abstract void setDefaultValue(IProductComponent target,
                                     Calendar effectiveDate,
                                     Object defaultValue)

Sets the product configured default value of the attribute identified by this model type attribute.

Parameters:

target - the product component to write the attribute default value to

effectiveDate - the date to determine the product component generation. If null the latest generation is used. Is ignored if the attribute's configuration is not changing over time.

defaultValue - the new default value

Throws:

UnsupportedOperationException - if invoked on a AttributeKind.CONSTANT attribute.

IllegalStateException - if the model object has no setter method for this attribute's default value. This also occurs if the corresponding policy class is not configured by a product class.

IllegalArgumentException - if the invocation of the method that should set the default value for this attribute fails for any reason

Since:

20.6

getValueSet

public abstract org.faktorips.valueset.ValueSet<?> getValueSet(IModelObject modelObject,
                                                               IValidationContext context)

Returns the value set of the given model object's attribute identified by this model type attribute.

Note: If the PolicyCmptType this PolicyAttribute belongs to defines an UnrestrictedValueSet including null, no method is generated by Faktor-IPS. Therefore, a value set method in a subclass is not found even if the IModelObject passed to this method is an instance of that subclass. To make sure to get the correct value set, always use IpsModel.getPolicyCmptType(IModelObject) on the actual IModelObject instead of IpsModel.getPolicyCmptType(Class) on the super class.

Parameters:

modelObject - a model object

Throws:

IllegalStateException - if the method that should return a value set for this attribute has too many arguments

IllegalArgumentException - if the invocation of the method that should return a value set for this attribute fails for any reason

getValueSet

public org.faktorips.valueset.ValueSet<?> getValueSet(IModelObject modelObject)

Returns the value set of the given model object's attribute identified by this model type attribute.

Note: If the PolicyCmptType this PolicyAttribute belongs to defines an UnrestrictedValueSet including null, no method is generated by Faktor-IPS. Therefore, a value set method in a subclass is not found even if the IModelObject passed to this method is an instance of that subclass. To make sure to get the correct value set, always use IpsModel.getPolicyCmptType(IModelObject) on the actual IModelObject instead of IpsModel.getPolicyCmptType(Class) on the super class.

This method uses a default IValidationContext.

Parameters:

modelObject - a model object

Throws:

UnsupportedOperationException - if invoked on a AttributeKind.CONSTANT attribute.

IllegalStateException - if the method that should return a value set for this attribute has too many arguments

IllegalArgumentException - if the invocation of the method that should return a value set for this attribute fails for any reason

getValueSet

public abstract org.faktorips.valueset.ValueSet<?> getValueSet(IProductComponent source,
                                                               Calendar effectiveDate,
                                                               IValidationContext context)

Returns the value set of the given model object's attribute identified by this model type attribute. Returns an UnrestrictedValueSet if there is no method that returns a value set for this attribute.

Parameters:

source - the product component to read an attribute value set from. Must correspond to the Type this attribute belongs to.

effectiveDate - the date to determine the product component generation. If null the latest generation is used. Is ignored if the attribute's configuration is not changing over time.

Throws:

UnsupportedOperationException - if invoked on a AttributeKind.CONSTANT attribute.

IllegalStateException - if the method that should return a value set for this attribute has too many arguments

IllegalArgumentException - if the invocation of the method that should return a value set for this attribute fails for any reason

getValueSet

public org.faktorips.valueset.ValueSet<?> getValueSet(IProductComponent source,
                                                      Calendar effectiveDate)

Returns the value set of the given model object's attribute identified by this model type attribute. Returns an UnrestrictedValueSet if there is no method that returns a value set for this attribute.

This method uses a default IValidationContext.

Parameters:

source - the product component to read an attribute value set from. Must correspond to the Type this attribute belongs to.

effectiveDate - the date to determine the product component generation. If null the latest generation is used. Is ignored if the attribute's configuration is not changing over time.

Throws:

UnsupportedOperationException - if invoked on a AttributeKind.CONSTANT attribute.

IllegalStateException - if the method that should return a value set for this attribute has too many arguments

IllegalArgumentException - if the invocation of the method that should return a value set for this attribute fails for any reason

setValueSet

public abstract void setValueSet(IConfigurableModelObject modelObject,
                                 org.faktorips.valueset.ValueSet<?> valueSet)

Sets the product configured set of allowed values of the attribute identified by this model type attribute.

Caution: as generics are erased at runtime, it is possible to set a ValueSet of a mismatched type with this method, for example an OrderedValueSet<String> for an attribute with Attribute.getDatatype() Integer, which will result in a ClassCastException on later method calls.

Parameters:

modelObject - the configurable model object from which product component and (if necessary) effective date can be retrieved

valueSet - the new value set

Throws:

UnsupportedOperationException - if invoked on a AttributeKind.CONSTANT attribute.

ClassCastException - if the type of value set does not match the property's configuration

IllegalStateException - if the model object has no setter method for this attribute's value set. This also occurs if the corresponding policy class is not configured by a product class.

IllegalArgumentException - if the invocation of the method that should set the value set for this attribute fails for any reason

Since:

20.6

setValueSet

public abstract void setValueSet(IProductComponent target,
                                 Calendar effectiveDate,
                                 org.faktorips.valueset.ValueSet<?> valueSet)

Sets the product configured set of allowed values of the attribute identified by this model type attribute.

Caution: as generics are erased at runtime, it is possible to set a ValueSet of a mismatched type with this method, for example an OrderedValueSet<String> for an attribute with Attribute.getDatatype() Integer, which will result in a ClassCastException on later method calls.

Parameters:

target - the product component to write the attribute value set to. Must correspond to the Type this attribute belongs to.

effectiveDate - the date to determine the product component generation. If null the latest generation is used. Is ignored if the attribute's configuration is not changing over time.

valueSet - the new value set

Throws:

UnsupportedOperationException - if invoked on a AttributeKind.CONSTANT attribute.

ClassCastException - if the type of value set does not match the property's configuration

IllegalStateException - if the model object has no setter method for this attribute's value set. This also occurs if the corresponding policy class is not configured by a product class.

IllegalArgumentException - if the invocation of the method that should set the value set for this attribute fails for any reason

Since:

20.6