com.goldencode.p2j.persist

Class DynamicValidationHelper

java.lang.Object

com.goldencode.p2j.persist.DynamicConversionHelper

com.goldencode.p2j.persist.DynamicValidationHelper

public class DynamicValidationHelper
extends DynamicConversionHelper

Helper class for dynamic validation expressions conversion.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private static class	DynamicValidationHelper.ValExprCacheKey Class that keys the JAST tree generated from the validation expression.
private static class	DynamicValidationHelper.WorkArea Container of context-local data.

Field Summary

Fields

Modifier and Type	Field and Description
private static ExpiryCache<DynamicValidationHelper.ValExprCacheKey,JavaAst>	cache Cache for JASTs generated from validation expressions.
private static java.lang.String	DYN_GEN_VAL_EXPR_CLASS The name of the generated java class.
private static ContextLocal<DynamicValidationHelper.WorkArea>	local Context-local data.
private static CentralLogger	LOG Logger.
static java.lang.String	VAL_EXPR_VAR_NAME Name of the variable which replaces the validated field reference in the validation expression.
private static java.util.concurrent.atomic.AtomicLong	valexpCounter Counter for converted validation expressions.

Constructor Summary

Constructors

Constructor and Description
DynamicValidationHelper()

Method Summary

Modifier and Type	Method and Description
private static void	addToCache(DynamicValidationHelper.ValExprCacheKey cacheKey, JavaAst javaAst) Add generated JAST to the cache.
private static void	displayConversionError(java.lang.Exception exc, java.lang.String operation, java.lang.String progressCode) Display conversion error.
static void	initializeCache() Initializes the cache using CacheManager.
private static DynamicValidationHelper.WorkArea	locate() Locate the context-local DynamicValidationHelper.WorkArea instance.
static JastValidationExpr	parseValidationExpression(QueryWrapper query, RecordBuffer validatedBuffer, java.lang.String validatedProperty, java.lang.String validateExpression) Worker for parsing a given validation expression string and returning a JastValidationExpr instance.
private static void	replaceParams(ProgressAst progressAst, java.lang.String validatedBufferName, java.lang.String validatedField) Replace field references in the Progress code AST: references to the validated field are replaced with a variable which is used as a parameter when executing validation expression; reference to buffer's fields other than the currently validated field are replaced with unknown values, warning is shown; reference to fields of other buffers raise error.

Methods inherited from class com.goldencode.p2j.persist.DynamicConversionHelper

injectVariable, injectVariable, locateBuffer, prepareDynamicTables, prepareTree

Methods inherited from class java.lang.Object

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

Field Detail

valexpCounter

private static final java.util.concurrent.atomic.AtomicLong valexpCounter

Counter for converted validation expressions.

VAL_EXPR_VAR_NAME

public static final java.lang.String VAL_EXPR_VAR_NAME

Name of the variable which replaces the validated field reference in the validation expression.

See Also:

Constant Field Values

DYN_GEN_VAL_EXPR_CLASS

private static final java.lang.String DYN_GEN_VAL_EXPR_CLASS

The name of the generated java class.

See Also:

Constant Field Values

LOG

private static final CentralLogger LOG

Logger.

local

private static final ContextLocal<DynamicValidationHelper.WorkArea> local

Context-local data.

cache

private static ExpiryCache<DynamicValidationHelper.ValExprCacheKey,JavaAst> cache

Cache for JASTs generated from validation expressions. Cache management uses an aging and usage algorithm to chose entries to be dropped when the maximum capacity is reached.

Constructor Detail

DynamicValidationHelper

public DynamicValidationHelper()

Method Detail

initializeCache

public static void initializeCache()

Initializes the cache using CacheManager. The default value of the cache is used when there is no size available from the configuration.

parseValidationExpression

public static JastValidationExpr parseValidationExpression(QueryWrapper query,
                                                           RecordBuffer validatedBuffer,
                                                           java.lang.String validatedProperty,
                                                           java.lang.String validateExpression)

Worker for parsing a given validation expression string and returning a JastValidationExpr instance.

Parameters:

query - Query which iterates the records in the validated buffer.

validatedBuffer - Validated buffer.

validatedProperty - Property name of the validated field.

validateExpression - Validation expression.

Returns:

JastValidationExpr instance representing the given validation expression.

replaceParams

private static void replaceParams(ProgressAst progressAst,
                                  java.lang.String validatedBufferName,
                                  java.lang.String validatedField)

Replace field references in the Progress code AST:

• references to the validated field are replaced with a variable which is used as a parameter when executing validation expression;
• reference to buffer's fields other than the currently validated field are replaced with unknown values, warning is shown;
• reference to fields of other buffers raise error.

Parameters:

progressAst - Progress code AST to be modified.

validatedBufferName - Fully qualified legacy name of the validated buffer.

validatedField - Legacy name of the validated field.

addToCache

private static void addToCache(DynamicValidationHelper.ValExprCacheKey cacheKey,
                               JavaAst javaAst)

Add generated JAST to the cache.

Parameters:

cacheKey - Cache key.

javaAst - Generate JAST.

displayConversionError

private static void displayConversionError(java.lang.Exception exc,
                                           java.lang.String operation,
                                           java.lang.String progressCode)

Display conversion error.

Parameters:

exc - Exception caused by the conversion error.

operation - Name of the conversion stage at which the error occurred.

progressCode - Progress code being converted.

locate

private static DynamicValidationHelper.WorkArea locate()

Locate the context-local DynamicValidationHelper.WorkArea instance.

Returns:

See above.