scpc.model.support

Class EvalHelper<T>

java.lang.Object

scpc.model.support.EvalHelper<T>

Type Parameters:

T - type of real cart item.

Direct Known Subclasses:

JsEvalHelper, SpelEvalHelper

public abstract class EvalHelper<T>
extends java.lang.Object

A formula evaluator to help analysis.
公式解譯工具

Author:

Kent Yeh

Field Summary

Fields

Modifier and Type	Field and Description
protected static java.util.regex.Pattern	JS_NAME_LOCATOR
protected static java.util.regex.Pattern	JS_NAME_VALIDATOR

Constructor Summary

Constructors

Constructor and Description
EvalHelper()

Method Summary

Methods

Modifier and Type	Method and Description
EvalHelper<T>	bindVaribles(IRule<T> rule)
EvalHelper<T>	bindVaribles(IRule<T> rule, SingleItem<T> item) Bind rule and item into evaluation context.
abstract EvalHelper<T>	bindVarValue(java.lang.String variable, java.lang.Object value) Bind variable with value into context.
abstract <R> R	eval(java.lang.String formula) Evaluate formula as numeric or boolean.
abstract java.lang.String	getPreviousRulePrefix() A prefix string add on comman variable to represent a previous rule's variable.
abstract java.lang.String	getVarContainsCount() Variable name of which represent the number of items that could applicable to this rule.
abstract java.lang.String	getVarRegularPrice() Variable name of regular price.
abstract java.lang.String	getVarSalePrice() Variable name of sale price.
abstract java.lang.String	getVarSerialNum() Variable name of which represent the sequence of the same applicable items.
abstract java.lang.String	getVarSumOfContainsRegularPrice() Variable name of which represent the summary regular price of applicable items.
abstract java.lang.String	getVarSumOfContainsSalePrice() Variable name of which represent the summary sale price of applicable items.
abstract java.lang.String	getVarSumOfSerialRegularPrice() Variable name of which represent the summary regular price of the same applicable items.
abstract java.lang.String	getVarSumOfSerialSalePrice() Variable name of which represent the summary sale price of the same applicable items.
protected abstract void	purgeBind() Clear all binding variable in context.
void	validateJSVariable() Check all variables name are qualified javascript name.
static java.lang.String	validJSVarName(java.lang.String javaScriptVVariableName) Check a variable name is a qualified javascript name.

Methods inherited from class java.lang.Object

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

Field Detail

JS_NAME_LOCATOR

protected static final java.util.regex.Pattern JS_NAME_LOCATOR

JS_NAME_VALIDATOR

protected static final java.util.regex.Pattern JS_NAME_VALIDATOR

Constructor Detail

EvalHelper

public EvalHelper()

Method Detail

bindVaribles

public EvalHelper<T> bindVaribles(IRule<T> rule)

validJSVarName

public static java.lang.String validJSVarName(java.lang.String javaScriptVVariableName)
                                       throws javax.script.ScriptException

Check a variable name is a qualified javascript name.
檢查變數是否為合格的JavaScript命名

Parameters:

javaScriptVVariableName - the vaiable name

Returns:

javaScriptVVariableName

Throws:

javax.script.ScriptException - Exception prone when a variable name is not qualified.

bindVaribles

public EvalHelper<T> bindVaribles(IRule<T> rule,
                         SingleItem<T> item)

Bind rule and item into evaluation context.
將促販規則與商品綁定到後評估的環境

Parameters:

rule -

item -

Returns:

this evaluator.

validateJSVariable

public void validateJSVariable()
                        throws javax.script.ScriptException

Check all variables name are qualified javascript name.
查查所有變數是都是合格的Java Script變數

Throws:

javax.script.ScriptException - Exception prone when any one variable name is not qualified.

getPreviousRulePrefix

public abstract java.lang.String getPreviousRulePrefix()

A prefix string add on comman variable to represent a previous rule's variable.
變數前綴以表示該變數為前連規則之變數

Returns:

getVarSalePrice

public abstract java.lang.String getVarSalePrice()

Variable name of sale price.
售價的變數名稱

Returns:

getVarRegularPrice

public abstract java.lang.String getVarRegularPrice()

Variable name of regular price.
原價的變數名稱

Returns:

getVarSerialNum

public abstract java.lang.String getVarSerialNum()

Variable name of which represent the sequence of the same applicable items.
同品項的序號

Returns:

getVarContainsCount

public abstract java.lang.String getVarContainsCount()

Variable name of which represent the number of items that could applicable to this rule.
符合此規則的品項數量的變數

Returns:

getVarSumOfContainsRegularPrice

public abstract java.lang.String getVarSumOfContainsRegularPrice()

Variable name of which represent the summary regular price of applicable items.
符合此規則的品項原價小計的變數

Returns:

getVarSumOfContainsSalePrice

public abstract java.lang.String getVarSumOfContainsSalePrice()

Variable name of which represent the summary sale price of applicable items.
符合此規則的品項售價小計的變數

Returns:

getVarSumOfSerialRegularPrice

public abstract java.lang.String getVarSumOfSerialRegularPrice()

Variable name of which represent the summary regular price of the same applicable items.
符合此規則的同品項原價小計的變數

Returns:

getVarSumOfSerialSalePrice

public abstract java.lang.String getVarSumOfSerialSalePrice()

Variable name of which represent the summary sale price of the same applicable items.
符合此規則的同品項售價小計的變數

Returns:

bindVarValue

public abstract EvalHelper<T> bindVarValue(java.lang.String variable,
                         java.lang.Object value)

Bind variable with value into context.
評估的環境中綁定變數與值

Parameters:

variable -

value -

Returns:

purgeBind

protected abstract void purgeBind()

Clear all binding variable in context.
清除評估環境中所有的變數

eval

public abstract <R> R eval(java.lang.String formula)
                throws javax.script.ScriptException

Evaluate formula as numeric or boolean.
將公式估值為數值或布林

Type Parameters:

R - return type

Parameters:

formula -

Returns:

Throws:

javax.script.ScriptException - Exception prone when a formula is not qualified.