Package wizx.lang

Defines the language used by the wizard framework.

See:
Description

Class Summary

BooleanValue
Condition	This object represents a Condition.
ExpressionTokenizer	Tokenizes expression text.
ListValue	A value that contains a list of other values.
NumberValue
Page	This object represents a Page.
RecordValue
ShallowVariable	This object represents a Variable of the Wizard
StringValue
Value
Wizard	This object represents a Wizard.

Package wizx.lang Description

Defines the language used by the wizard framework.

Value, Expression and Condition Syntax

Variables in the wizard files can occur as targets or sources of values. A source variable Values in the Wizard language can take on 5 runtime types. Variables are automatically cast to the appropriate runtime type according to the usage. If it is not possible to perform a value type conversion, a default value of the appropriate type is supplied. variables are declared in one of two ways:

• A Priori - Some variables represent values in the underlying settings file. These variables are initialized from the settings file when the wizard is started. When the wizard completes, the values of all the a priori variables are written to the settings file.
• Explicit Declarations - Before the first page is loaded, all variable declaration tags are processed and the variable names are assigned the given values.
• Implicit Declariations - If an uninitialized variable name is encountered while processing a page, the variable is created. If the implicit declaration specifies a value (ie, if the variable is being used as a target of a value), then the value is stored in the variable. If the implicit declaration specifies a source, then the variable is assigned the the value string."" (the empty string value).

The wizard xml format uses the following BNF grammar:

value            ::=  function | variable | constant | (value)

constant         ::=  number.n | string."α" | boolean.true | boolean.false 
                    | object-const | list-const

variable         ::=  name_token | name_token.property-list

property-list    ::=  name_token.property-list | name_token

function         ::=  bool-function | number-function | string-function

number-function  ::=  sum list-const | product list-const 
                    | negate value | divide(value, value) | fix(n, value) 

bool-function    ::=  or list-const | and list-const | not value 
                    | exists variable | equals(value, value) | less(value, value)

string-function  ::=  concat list-const

list-const       ::=  {value-list} | variable | list-const ; list-const

value-list       ::=  value, value-list | value

object-const     ::=  object.[prop-value-list]

prop-value-list  ::=  name_token:value, prop-value-list | name_token : value

name-token       ::=  [a..zA..Z0..9-_]+