Class TorqueGenGroovy
java.lang.Object
org.apache.torque.generator.template.groovy.TorqueGenGroovy
This class acts as an interface to the Torque generator from the
templates. It lets the user access Torque generator properties from the
templates, and allows to execute certain action from within the templates.
-
Constructor Summary
ConstructorsConstructorDescriptionTorqueGenGroovy(GroovyOutlet outlet, ControllerState controllerState) Constructs a generator interface within the given controllerState. -
Method Summary
Modifier and TypeMethodDescriptionbooleanbooleanOption(String key) Returns the option with the given key as boolean value.Returns the current controller state.static intReturns a counter value which is increased each time this function is accessed.getModel()Returns the current model.Returns the option with the given key.Returns the currently processed source file.getVariable(String key) Returns the variable with the given key.intReturns the option with the given key as int value.mergepoint(String mergepointName) Processes the mergepoint with the given name.now()Returns the current date.Returns the option with the given key.static voidResets the counter accessible thoughgetCounter()back to 1.voidsetVariable(String key, Object value) Sets a variable.voidsetVariable(String key, Object value, String scope) Sets a variable.
-
Constructor Details
-
TorqueGenGroovy
Constructs a generator interface within the given controllerState.- Parameters:
outlet- the outlet in which this generator interface will be used, not null.controllerState- the controller context.- Throws:
NullPointerException- if outlet or controllerState are null.
-
-
Method Details
-
mergepoint
Processes the mergepoint with the given name.- Parameters:
mergepointName- the name of the mergepoint.- Returns:
- the output generated by the mergepoint.
- Throws:
GeneratorException- if the mergepoint could not be processed completely.
-
getControllerState
Returns the current controller state.- Returns:
- The current controller state, never null.
-
getModel
Returns the current model. This method is shorthand forgetControllerState().getModel()- Returns:
- the current source element, never null.
-
option
Returns the option with the given key. The key can either be a name prefixed with a namespace, or a name without namespace, in which case the namespace of the currently active outlet is used. In the case that the option is not set in this namespace, the parent namespaces are searched recursively. If the option is not set in any of the parent namespaces, null is returned.- Parameters:
key- the key for the option to retrieve.- Returns:
- the option for the given key.
-
getOption
Returns the option with the given key. The key can either be a name prefixed with a namespace, or a name without namespace, in which case the namespace of the currently active outlet is used. In the case that the option is not set in this namespace, the parent namespaces are searched recursively. If the option is not set in any of the parent namespaces, null is returned.- Parameters:
key- the key for the option to retrieve.- Returns:
- the option for the given key.
-
booleanOption
Returns the option with the given key as boolean value. The key can either be a name prefixed with a namespace, or a name without namespace, in which case the namespace of the currently active outlet is used. In the case that the option is not set in this namespace, the parent namespaces are searched recursively. If the option is not set in any of the parent namespaces, false is returned.- Parameters:
key- the key for the option to retrieve.- Returns:
- the option for the given key, converted to a boolean
-
intOption
Returns the option with the given key as int value. The key can either be a name prefixed with a namespace, or a name without namespace, in which case the namespace of the currently active outlet is used. In the case that the option is not set in this namespace, the parent namespaces are searched recursively. If the option is not set in any of the parent namespaces or empty, 0 is returned.- Parameters:
key- the key for the option to retrieve.- Returns:
- the option for the given key, converted to a boolean
-
getVariable
Returns the variable with the given key. The key can either be a name prefixed with a namespace, or a name without namespace, in which case the namespace of the currently active outlet is used. In the case that the variable is not set in this namespace, the parent namespaces are searched recursively. If the variable is not set in any of the parent namespaces, null is returned.- Parameters:
key- the key for the variable to retrieve.- Returns:
- the variable for the given key, or null if the variable is not set or explicitly set to null.
-
setVariable
Sets a variable. The key can be given with or without namespace; in the latter case, the variable is set in the namespace of the currently active outlet. The Scope of the variable is this outlet and its children.- Parameters:
key- the name of the variable, not nullvalue- the value of the variable, may be null.- Throws:
NullPointerException- if key or scope is null.IllegalArgumentException- if the key is no valid QualifiedName.
-
setVariable
Sets a variable. The key can be given with or without namespace; in the latter case, the variable is set in the namespace of the currently active outlet.- Parameters:
key- the name of the variable, not null.value- the value of the variable, may be null.scope- the scope of the variable, not null.- Throws:
NullPointerException- if key or scope is null.IllegalArgumentException- if the key is no valid QualifiedName.
-
getSourceFile
Returns the currently processed source file.- Returns:
- the source file which is currently processed.
-
now
Returns the current date.- Returns:
- the current date, not null.
-
getCounter
public static int getCounter()Returns a counter value which is increased each time this function is accessed. Start value is 1. IfresetCounteris not called, the returned value is unique over the generation process.- Returns:
- the counter value.
-
resetCounter
public static void resetCounter()Resets the counter accessible thoughgetCounter()back to 1.
-