de.ipcon.db.mex

Class MEXTransformer

java.lang.Object

de.ipcon.db.mex.MEXTransformer

public class MEXTransformer
extends java.lang.Object

A MEX transformer designed to process template strings containing expressions enclosed in curly braces.

The transformation occurs in two distinct, required phases (passes):

1. Phase 1 (Definitions): Processes expressions to define variables (e.g. {!name=value}).
2. Phase 2 (Expansion): Processes expressions to expand previously defined variables (e.g. {=name}).

The transformer uses a recursive descent parser for curly brace blocks.

Constructor Summary

Constructors

Constructor and Description
MEXTransformer(java.lang.String _source) Constructs a new MEXTransformer instance with the given source string.

Method Summary

Modifier and Type	Method and Description
int	getCursor()
java.lang.StringBuilder	getResult()
java.lang.String	getSource() Fallback evaluator used in the final pass to catch any curly expressions that were not replaced by previous evaluators.
java.lang.String	getVar(java.lang.String name) Retrieves the value of a variable from the context.
int	getVarCount() Returns the number of variables currently stored in the internal map.
void	setCursor(int $4)
void	setResult(java.lang.StringBuilder $5)
void	setSource(java.lang.String $3)
MEXTransformer	setVar(java.lang.String name, java.lang.String value) Sets a variable in the transformer's context.
java.lang.CharSequence	transform() Executes the full two-pass transformation (Pass 1: Definitions, Pass 2: Expansion).
java.lang.CharSequence	transform(MEXTransformerEvaluatorI[] evals) Executes the two core transformation passes, followed by a custom evaluation pass.
java.lang.CharSequence	transform(MEXTransformerEvaluatorI[] evals, boolean lastPass) Executes the two core transformation passes, followed by an optional custom evaluation pass.

Methods inherited from class java.lang.Object

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

Constructor Detail

MEXTransformer

public MEXTransformer(java.lang.String _source)

Constructs a new MEXTransformer instance with the given source string.

Parameters:

_source - The string containing expressions to be transformed.

Method Detail

transform

public java.lang.CharSequence transform()

Executes the full two-pass transformation (Pass 1: Definitions, Pass 2: Expansion). No custom evaluators are run after the core phases.

Returns:

The resulting transformed CharSequence.

transform

public java.lang.CharSequence transform(MEXTransformerEvaluatorI[] evals)

Executes the two core transformation passes, followed by a custom evaluation pass. The custom evaluators are run in a "soft" pass (no LeftOverUnevaluatedFailEvaluator appended).

Parameters:

evals - An array of custom evaluators to run after Phase 2.

Returns:

The resulting transformed CharSequence.

transform

public java.lang.CharSequence transform(MEXTransformerEvaluatorI[] evals,
                                        boolean lastPass)

Executes the two core transformation passes, followed by an optional custom evaluation pass.

Parameters:

evals - An array of custom evaluators to run after Phase 2.

lastPass - If true, the LeftOverUnevaluatedFailEvaluator is appended to evals to ensure all remaining curly blocks signal an error.

Returns:

The resulting transformed CharSequence.

getVarCount

public int getVarCount()

Returns the number of variables currently stored in the internal map.

Returns:

The variable count.

setVar

public MEXTransformer setVar(java.lang.String name,
                             java.lang.String value)

Sets a variable in the transformer's context. If value is null, the variable is removed.

Parameters:

name - The name of the variable.

value - The value to set for the variable. If null, the variable is removed.

Returns:

This transformer instance for method chaining.

getVar

public java.lang.String getVar(java.lang.String name)

Retrieves the value of a variable from the context.

Parameters:

name - The name of the variable to retrieve.

Returns:

The variable's value as a String, or null if the variable is not set.

getSource

public java.lang.String getSource()

Fallback evaluator used in the final pass to catch any curly expressions that were not replaced by previous evaluators. Signals an IllegalArgumentException.

setSource

public void setSource(java.lang.String $3)

getCursor

public int getCursor()

setCursor

public void setCursor(int $4)

getResult

public java.lang.StringBuilder getResult()

setResult

public void setResult(java.lang.StringBuilder $5)