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	setValue(IModelObject modelObject, Object value) Sets the given model object's attribute identified by this model type attribute to the given value.

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 IllegalArgumentException 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

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. Throws an IllegalArgumentException 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:

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.

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

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.

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. Throws an IllegalArgumentException if the model object has no getAllowedValues() method for this attribute. This also occurs if the corresponding policy class is not configured by a product class.

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.

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. Throws an IllegalArgumentException if the model object has no getAllowedValues() method for this attribute. This also occurs if the corresponding policy class is not configured by a product class.

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.