com.goldencode.p2j.pattern

Class CommonAstSupport

java.lang.Object

com.goldencode.p2j.pattern.AbstractPatternWorker

com.goldencode.p2j.pattern.CommonAstSupport

All Implemented Interfaces:

PatternWorker

final class CommonAstSupport
extends AbstractPatternWorker

Provides common symbol resolution and function support for AST processing. An instance of this class is loaded by default by the pattern engine, since the functionality provided is required by nearly every ruleset.

The implementations of variables and user functions are contained within a number of public, inner classes. They must be public in order for their members to be accessible via reflection (without policy file changes). They are registered just after construction with the AstSymbolResolver provided by the PatternEngine. They are accessed by instances of the Rule class via logical expressions at runtime.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	CommonAstSupport.Library Implementation of basic symbol resolution and comparison-type user function services specific to AST processing.
private static class	CommonAstSupport.WorkArea Context local work area.

Field Summary

Fields

Modifier and Type	Field and Description
private static ContextLocal<CommonAstSupport.WorkArea>	context Context local work area.
private PatternEngine	engine The engine which created this worker.
private static ConversionStatus	LOG Logger.

Constructor Summary

Constructors

Constructor and Description
CommonAstSupport(PatternEngine engine) Default constructor which defines the symbol libraries to be registered.

Method Summary

Modifier and Type	Method and Description
void	finish() Hook to provide termination processing for a pattern worker.
private java.lang.reflect.Constructor	matchConstructor(java.lang.reflect.Constructor[] candidates, java.lang.Class[] signature, boolean strict) Try to match a constructor from the list of candidates, based upon a parameter signature.
static int	resolveRuntimeAnnotationKey(java.lang.String key) Resolve the numeric key for the specified annotation.

Methods inherited from class com.goldencode.p2j.pattern.AbstractPatternWorker

getCopy, getLibrary, getResolver, getSource, isConditionalRuleSets, isFlagActivated, isRuntimeQueryMode, registerTree, resolveConstant, setLibrary

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.goldencode.p2j.pattern.PatternWorker

initialize, leaveAst, visitAst

Field Detail

LOG

private static final ConversionStatus LOG

Logger.

context

private static final ContextLocal<CommonAstSupport.WorkArea> context

Context local work area.

engine

private final PatternEngine engine

The engine which created this worker.

Constructor Detail

CommonAstSupport

CommonAstSupport(PatternEngine engine)

Default constructor which defines the symbol libraries to be registered.

Parameters:

engine - The engine which created this worker.

Method Detail

resolveRuntimeAnnotationKey

public static int resolveRuntimeAnnotationKey(java.lang.String key)

Resolve the numeric key for the specified annotation.

Parameters:

key - The string annotation.

Returns:

The numeric key for this annotation.

finish

public void finish()

Hook to provide termination processing for a pattern worker.

matchConstructor

private java.lang.reflect.Constructor matchConstructor(java.lang.reflect.Constructor[] candidates,
                                                       java.lang.Class[] signature,
                                                       boolean strict)

Try to match a constructor from the list of candidates, based upon a parameter signature.

Parameters:

candidates - An array of constructors from which to select a match.

signature - The parameter signature to be matched among the candidate constructors.

strict - true to conduct a strict match of primitive numeric arguments, else false. In a strict match, a primitive, numeric parameter type (or its wrapper class type) will match only the same primitive, numeric parameter type (or its wrapper class type). In a non-strict match, any primitive, numeric parameter type (or its wrapper class type) will match any other primitive, numeric parameter type (or its wrapper class type). The assumption in the non-strict case is that with enough wrapping/unwrapping and casting, any numeric type can be converted to any other numeric type (though information may be lost in narrowing conversions).

Returns:

The matching Constructor instance (if any), or null if no match was found.

Throws:

java.lang.IllegalArgumentException - if more than one suitable matching constructor was detected (indicating ambiguity).