com.massa.mrules.addon

Class DefaultVariablesManager.AbstractVariableAccessor

java.lang.Object

com.massa.mrules.base.AbstractMRulesObject

com.massa.mrules.addon.AbstractAddon

com.massa.mrules.accessor.AbstractReadAccessor

com.massa.mrules.addon.DefaultVariablesManager.AbstractVariableAccessor

All Implemented Interfaces:

IAccessor, IReadAccessor, IAddon, IMRulesObject, Outable, Serializable, Cloneable

Direct Known Subclasses:

DefaultVariablesManager.Date, DefaultVariablesManager.DateTime, DefaultVariablesManager.NullValue, DefaultVariablesManager.Readbase, DefaultVariablesManager.RootReadbase, DefaultVariablesManager.RootWritebase, DefaultVariablesManager.RulesetName, DefaultVariablesManager.Time, DefaultVariablesManager.Writebase

Enclosing class:

DefaultVariablesManager

public abstract static class DefaultVariablesManager.AbstractVariableAccessor
extends AbstractReadAccessor

Base for variable accessors.
This class might be used as a convenience empty implementation for simple accessors.

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from interface com.massa.mrules.accessor.IReadAccessor

IReadAccessor.Standalone

Constructor Summary

Constructors

Constructor and Description
AbstractVariableAccessor()

Method Summary

Modifier and Type	Method and Description
<G,C extends Collection<G>> void	compileCollection(ICompilationContext ctxt, Class<C> expectedType, Class<G> expectedGenericType) Implementation to handle case when expected result is a Collection.
void	compileValue(ICompilationContext ctxt, Class<?> expectedType) Implementation to handle case when expected result is a single value.
boolean	equals(Object o)
abstract Class<?>	getDefaultType(IContext ctxt) Returns default type for this variable if no directive is provided.
CostInfo	getEstimatedReadCost(ICompilationContext ctxt) Estimates the reading complexity, to allow callers to optimize calls.
Class<?>	getGenericCollectionType(IContext ctxt) Returns the Generic type, if value is a collection or an array, evaluated : at compilation time for standard compilation at runtime for light compilation and execution phase or null if the type can't be resolved or value is not a collection.
Class<?>	getType(IContext ctxt) Returns the value's class, evaluated : at compilation time for standard compilation at runtime for light compilation or null if the type can't be resolved.
abstract Object	getVarValue(IExecutionContext ctxt)
int	hashCode()
protected Object	internalGet(IExecutionContext ctxt) Specific addon implementation must be here.
boolean	isShouldBeWrappedToConstantValue() Default implementation returns AbstractReadAccessor.isConstantValue() && !
boolean	isShouldIterate() If this iterator is dedicated to iterate over values, then it should be precised.
void	toString(OuterWithLevel outer) Method used to send String representation of the current object to the OuterWithLevel.

Methods inherited from class com.massa.mrules.accessor.AbstractReadAccessor

castToExpected, clone, compileRead, compileRead, compileRead, compileRead, get, getGenericTypes, isConstantValue, isShouldNotCache

Methods inherited from class com.massa.mrules.addon.AbstractAddon

getInternalCacheIdentifier, isCacheUsed, isInternalCacheIdentifierNeeded, optimize, resetCachedData, setInternalCacheIdentifier, toString, wasRegistered

Methods inherited from class com.massa.mrules.base.AbstractMRulesObject

getDebugInfo, getDescription, getName, setDebugInfo, setDescription, setName

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.massa.mrules.addon.IAddon

getImplementationId, getInternalCacheIdentifier, isCacheUsed, isInternalCacheIdentifierNeeded, optimize, resetCachedData, setInternalCacheIdentifier, wasRegistered

Methods inherited from interface com.massa.mrules.base.IMRulesObject

getDebugInfo, getDescription, getName, setDebugInfo, setDescription, setName

Constructor Detail

AbstractVariableAccessor

public AbstractVariableAccessor()

Method Detail

compileValue

public final void compileValue(ICompilationContext ctxt,
                               Class<?> expectedType)
                        throws MRuleValidationException

Description copied from class: AbstractReadAccessor

Implementation to handle case when expected result is a single value.

Specified by:

compileValue in class AbstractReadAccessor

Throws:

MRuleValidationException

compileCollection

public final <G,C extends Collection<G>> void compileCollection(ICompilationContext ctxt,
                                                                Class<C> expectedType,
                                                                Class<G> expectedGenericType)

Description copied from class: AbstractReadAccessor

Implementation to handle case when expected result is a Collection.

Specified by:

compileCollection in class AbstractReadAccessor

getEstimatedReadCost

public CostInfo getEstimatedReadCost(ICompilationContext ctxt)
                              throws MRuleValidationException

Description copied from interface: IReadAccessor

Estimates the reading complexity, to allow callers to optimize calls. Calls to this method should be done on a compiled accessor, so that all information is available to compute complexity.
Calls to non-compiled instance may return non-accurate results.

Parameters:

ctxt - Compilation context.

Throws:

MRuleValidationException - if validation problem detected.

internalGet

protected Object internalGet(IExecutionContext ctxt)
                      throws MAccessorException

Description copied from class: AbstractReadAccessor

Specific addon implementation must be here.

Specified by:

internalGet in class AbstractReadAccessor

Throws:

MAccessorException

getVarValue

public abstract Object getVarValue(IExecutionContext ctxt)
                            throws MAccessorException

Throws:

MAccessorException

isShouldBeWrappedToConstantValue

public boolean isShouldBeWrappedToConstantValue()

Description copied from class: AbstractReadAccessor

Default implementation returns AbstractReadAccessor.isConstantValue() && ! IReadAccessor.isShouldIterate().

Specified by:

isShouldBeWrappedToConstantValue in interface IReadAccessor

Overrides:

isShouldBeWrappedToConstantValue in class AbstractReadAccessor

toString

public void toString(OuterWithLevel outer)
              throws IOException

Description copied from interface: Outable

Method used to send String representation of the current object to the OuterWithLevel.

Throws:

IOException

getType

public final Class<?> getType(IContext ctxt)

Description copied from interface: IAccessor

Returns the value's class, evaluated :

• at compilation time for standard compilation
• at runtime for light compilation

or null if the type can't be resolved.

getGenericCollectionType

public Class<?> getGenericCollectionType(IContext ctxt)
                                  throws MAccessorException

Description copied from interface: IAccessor

Returns the Generic type, if value is a collection or an array, evaluated :

• at compilation time for standard compilation
• at runtime for light compilation and execution phase

or null if the type can't be resolved or value is not a collection.

Throws:

MAccessorException

getDefaultType

public abstract Class<?> getDefaultType(IContext ctxt)

Returns default type for this variable if no directive is provided.
null value for Context should be handled..

isShouldIterate

public boolean isShouldIterate()

Description copied from interface: IReadAccessor

If this iterator is dedicated to iterate over values, then it should be precised. In this case, the "get" method should return an Iterator, of instances of "getType".
Non-read only accessors should not be iterable. BUT it's not mandatory. In this particular case, the "set" method should be described precisely ...
Please not that returned Iterators should not support the "remove" method.
They also should use MRuleInternalRuntimeException if Exception must be thrown.
This method is not dependent on the compilation process. it can be called before and will return the correct result.

Returns:

false.

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object