com.massa.mrules.context.compile

Class MExecutionContextConverter

java.lang.Object

com.massa.mrules.context.compile.MExecutionContextConverter

All Implemented Interfaces:

ICompilationContext, IContext

public class MExecutionContextConverter
extends Object
implements ICompilationContext

Allows to wrap a ICompilationContext in order to simulate an Execution context.
This will be useful during compilation phase, if a component has to call methods on subcomponents, requiring an Execution context provided as a parameter.
This utility is mainly for internal use.

Field Summary

Fields inherited from interface com.massa.mrules.context.compile.ICompilationContext

DEFAULT_COMPILE_LOGGER_NAME, DEFAULT_OPTIMIZE_LOGGER_NAME

Constructor Summary

Constructors

Constructor and Description
MExecutionContextConverter(IExecutionContext c, CompilationLevel compilationLevel)

Method Summary

Modifier and Type	Method and Description
void	clearRegisteredAddons() Clears all registered Addons.
void	compile() Convenience method to compile AND optimize the AbstractMRuleExecutionSet of this context with this context.
IExecutionContext	convertToExecutionContext() Allows to convert this compilation context to a "fake" execution context.
<A extends IAddon> AddonInfo	getAddonInfo(A addon)
List<IAddon>	getAllAddons() Gets all addons encountered during compilation process.
Set<IAddon>	getAllUniqueAddons() Gets all unique addons encountered during compilation process.
ICacheActivationResolver	getCacheActivationResolver()
CompilationLevel	getCompilationLevel() Returns requested CompilationLevel
IMRuleExecutionSet	getExecutionSet()
MBeanUtils.ImportHolder	getImports() Returns local imports for this context's ruleset.
Log	getLog() Get logger/
Phase	getPhase() Returns: Phase.COMPILE or Phase.OPTIMIZE for ICompilationContext Phase.EXECUTE for IExecutionContext
Object	getProperty(Object key) Allows to retrieve properties shared between components during compilation process.
Class<?>	getReadBaseType() Returns base object type for property read access.
ICompilationContext	getRootContext() In case of sub context usage, this allows to access the root context.
<T extends IMRulesSecurityManager> T	getSecurityManager(Class<T> managerClass) Searches in security managers the one corresponding to the provided identifying class.
TypedMap	getVariables() Returns a Map of: variables types encountered during compilation.
Class<?>	getWriteBaseType() Returns base object type for property write access.
void	init() INTERNAL USE ONLY: Called by rule engine to initialize and check before compilation.
boolean	isCacheEnabled(String feature) Tells if cache is enabled for a specific feature.
boolean	isOptimizationEnabled() Allows to completely disable optimization process.
boolean	registerAddon(IAddon parent, IAddon addon) Registers any encountered IAddon during compilation process.
void	registerAddonRecursively(IAddon parent, IAddon addon) Registers this Addon and all it's sub addons.
void	removeProperty(Object key) Allows to remove shared properties.
void	setCacheActivationResolver(ICacheActivationResolver cacheActivationResolver)
void	setCompilationLevel(CompilationLevel compilationLevel) CompilationLevel to use for compilation.
void	setExecutionSet(IMRuleExecutionSet executionSet)
void	setLoggerName(String name) Allows to override logger name for an execution / a compilation.
void	setOptimizationEnabled(boolean optimizationEnabled) Is optimization process enabled?
void	setPhase(Phase phase) Sets current phase: COMPILE or OPTIMIZE.
void	setProperty(Object key, Object value) Allows to store properties to share between components during compilation process.

Methods inherited from class java.lang.Object

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

Constructor Detail

MExecutionContextConverter

public MExecutionContextConverter(IExecutionContext c,
                                  CompilationLevel compilationLevel)

Method Detail

getPhase

public Phase getPhase()

Description copied from interface: IContext

Returns:

• Phase.COMPILE or Phase.OPTIMIZE for ICompilationContext
• Phase.EXECUTE for IExecutionContext

Specified by:

getPhase in interface IContext

setPhase

public void setPhase(Phase phase)

Description copied from interface: ICompilationContext

Sets current phase: COMPILE or OPTIMIZE.
Internal use only.

Specified by:

setPhase in interface ICompilationContext

getReadBaseType

public Class<?> getReadBaseType()

Description copied from interface: IContext

Returns base object type for property read access.

Specified by:

getReadBaseType in interface IContext

getWriteBaseType

public Class<?> getWriteBaseType()

Description copied from interface: IContext

Returns base object type for property write access.

Specified by:

getWriteBaseType in interface IContext

getVariables

public TypedMap getVariables()

Description copied from interface: IContext

Returns a Map of:

• variables types encountered during compilation.
• variables declared during execution, with their types if possible.

This Map will automatically be cleared at each compilation or launch.

Specified by:

getVariables in interface IContext

getLog

public Log getLog()

Description copied from interface: IContext

Get logger/

Specified by:

getLog in interface IContext

getImports

public MBeanUtils.ImportHolder getImports()

Description copied from interface: IContext

Returns local imports for this context's ruleset.

Specified by:

getImports in interface IContext

getSecurityManager

public <T extends IMRulesSecurityManager> T getSecurityManager(Class<T> managerClass)
                                                        throws MRulesSecurityException

Description copied from interface: IContext

Searches in security managers the one corresponding to the provided identifying class.

Specified by:

getSecurityManager in interface IContext

Throws:

MRulesSecurityException

setLoggerName

public void setLoggerName(String name)

Description copied from interface: IContext

Allows to override logger name for an execution / a compilation.
Set to null or empty String to reset to default. Default is ICompilationContext.DEFAULT_COMPILE_LOGGER_NAME or ICompilationContext.DEFAULT_OPTIMIZE_LOGGER_NAME or IExecutionContext.DEFAULT_LOGGER_NAME.
Use a suffix (i.e. ".suffix" starting with a dot) to add the suffix at the end of the default.
Otherwise, specify the full logger name.

Specified by:

setLoggerName in interface IContext

compile

public void compile()
             throws MRuleValidationException

Description copied from interface: ICompilationContext

Convenience method to compile AND optimize the AbstractMRuleExecutionSet of this context with this context.

Specified by:

compile in interface ICompilationContext

Throws:

MRuleValidationException

init

public void init()
          throws MRuleValidationException

Description copied from interface: ICompilationContext

INTERNAL USE ONLY: Called by rule engine to initialize and check before compilation.

Specified by:

init in interface ICompilationContext

Throws:

MRuleValidationException

getCompilationLevel

public CompilationLevel getCompilationLevel()

Description copied from interface: ICompilationContext

Returns requested CompilationLevel

Specified by:

getCompilationLevel in interface ICompilationContext

setCompilationLevel

public void setCompilationLevel(CompilationLevel compilationLevel)

Description copied from interface: ICompilationContext

CompilationLevel to use for compilation.

Specified by:

setCompilationLevel in interface ICompilationContext

getAddonInfo

public <A extends IAddon> AddonInfo getAddonInfo(A addon)

Specified by:

getAddonInfo in interface ICompilationContext

Returns:

Addon Info for provided Addon.

registerAddon

public boolean registerAddon(IAddon parent,
                             IAddon addon)

Description copied from interface: ICompilationContext

Registers any encountered IAddon during compilation process. If this specific instance has already been registered, this method does nothing.
If no similar IAddon has been registered, this method creates addon info for it.
If another similar IAddon has been registered, this method updates addon info and returns the same instance as provided.
Please note that only compiled addons should be provided to this method.
The hook IAddon.wasRegistered(ICompilationContext, IAddon, AddonInfo) is called at the end of the registration if registration is successful (i.e. if Addon was not already registered). Since 1.4.0, this method does not deduplicate anymore and so returns same instance as provided. This behaviour might change in future version so returned value should not be ignored. Since 1.5.0, An instance of IAddon is no more responsible for registering it's own sub-addons, as it's done automatically. The registration process is no more responsible for eventual deduplication, encapsulation, ... So the return type has been changed to boolean instead of formerly IAddon.

Specified by:

registerAddon in interface ICompilationContext

Parameters:

parent - Parent from which the addon was registered or [null | self] for root Addon.

addon - The addon to registered.

Returns:

true if registering successful, false if already registered.

registerAddonRecursively

public void registerAddonRecursively(IAddon parent,
                                     IAddon addon)

Description copied from interface: ICompilationContext

Registers this Addon and all it's sub addons.
This methods handles addons or Collections of addons declared via PersistantProperties. If sub addons are declared differently (via Maps for instance) the IAddon.wasRegistered(ICompilationContext, IAddon, AddonInfo) hook has to be implemented.

Specified by:

registerAddonRecursively in interface ICompilationContext

Parameters:

parent - Parent from which the addon was registered or [null | self] for root Addon.

addon - The addon to registered recursively.

See Also:

ICompilationContext.registerAddon(IAddon, IAddon)

clearRegisteredAddons

public void clearRegisteredAddons()

Description copied from interface: ICompilationContext

Clears all registered Addons.

Specified by:

clearRegisteredAddons in interface ICompilationContext

getAllUniqueAddons

public Set<IAddon> getAllUniqueAddons()

Description copied from interface: ICompilationContext

Gets all unique addons encountered during compilation process. Two identical instances will not be contained twice.

Specified by:

getAllUniqueAddons in interface ICompilationContext

getAllAddons

public List<IAddon> getAllAddons()

Description copied from interface: ICompilationContext

Gets all addons encountered during compilation process. The same instance will not be contained twice, but two identical instances might be present.

Specified by:

getAllAddons in interface ICompilationContext

getProperty

public Object getProperty(Object key)

Description copied from interface: ICompilationContext

Allows to retrieve properties shared between components during compilation process.

Specified by:

getProperty in interface ICompilationContext

setProperty

public void setProperty(Object key,
                        Object value)

Description copied from interface: ICompilationContext

Allows to store properties to share between components during compilation process.

Specified by:

setProperty in interface ICompilationContext

removeProperty

public void removeProperty(Object key)

Description copied from interface: ICompilationContext

Allows to remove shared properties.

Specified by:

removeProperty in interface ICompilationContext

getCacheActivationResolver

public ICacheActivationResolver getCacheActivationResolver()

Specified by:

getCacheActivationResolver in interface ICompilationContext

setCacheActivationResolver

public void setCacheActivationResolver(ICacheActivationResolver cacheActivationResolver)

Specified by:

setCacheActivationResolver in interface ICompilationContext

isCacheEnabled

public boolean isCacheEnabled(String feature)

Description copied from interface: ICompilationContext

Tells if cache is enabled for a specific feature.
If a ruleset is compiled with disabled cache for a feature, it must be recompiled to reactivate it.
Convenience method to interrogate cache activation resolver.

Specified by:

isCacheEnabled in interface ICompilationContext

Parameters:

feature - Feature for which to check cache activation

isOptimizationEnabled

public boolean isOptimizationEnabled()

Description copied from interface: ICompilationContext

Allows to completely disable optimization process.

Specified by:

isOptimizationEnabled in interface ICompilationContext

setOptimizationEnabled

public void setOptimizationEnabled(boolean optimizationEnabled)

Description copied from interface: ICompilationContext

Is optimization process enabled?

Specified by:

setOptimizationEnabled in interface ICompilationContext

convertToExecutionContext

public IExecutionContext convertToExecutionContext()

Description copied from interface: ICompilationContext

Allows to convert this compilation context to a "fake" execution context.
The returned instance might have unsupported features. For example, read base and write base are null, as the compilation context only knows their types, but does not contain instances.

Specified by:

convertToExecutionContext in interface ICompilationContext

getExecutionSet

public IMRuleExecutionSet getExecutionSet()

Specified by:

getExecutionSet in interface IContext

See Also:

IContext.getExecutionSet()

setExecutionSet

public void setExecutionSet(IMRuleExecutionSet executionSet)

Specified by:

setExecutionSet in interface IContext

See Also:

IContext.setExecutionSet(com.massa.mrules.set.IMRuleExecutionSet)

getRootContext

public ICompilationContext getRootContext()

Description copied from interface: IContext

In case of sub context usage, this allows to access the root context.
Calling this method on the root context returns the root context.

Specified by:

getRootContext in interface ICompilationContext

Specified by:

getRootContext in interface IContext

Returns:

The root context