Package org.apache.torque.generator.template.groovy

# Klasse TorqueGenGroovy

java.lang.Object
org.apache.torque.generator.template.groovy.TorqueGenGroovy

public class TorqueGenGroovy extends Object
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.

- ## Konstruktorübersicht

  Konstruktoren
  Konstruktor
  Beschreibung
  `TorqueGenGroovy(GroovyOutlet outlet, ControllerState controllerState)`
  Constructs a generator interface within the given controllerState.

- ## Methodenübersicht

  Modifizierer und Typ
  Methode
  Beschreibung
  `boolean`
  `booleanOption(String key)`
  Returns the option with the given key as boolean value.
  `ControllerState`
  `getControllerState()`
  Returns the current controller state.
  `static int`
  `getCounter()`
  Returns a counter value which is increased each time this function is accessed.
  `Object`
  `getModel()`
  Returns the current model.
  `Object`
  `getOption(String key)`
  Returns the option with the given key.
  `File`
  `getSourceFile()`
  Returns the currently processed source file.
  `Object`
  `getVariable(String key)`
  Returns the variable with the given key.
  `int`
  `intOption(String key)`
  Returns the option with the given key as int value.
  `String`
  `mergepoint(String mergepointName)`
  Processes the mergepoint with the given name.
  `Date`
  `now()`
  Returns the current date.
  `Object`
  `option(String key)`
  Returns the option with the given key.
  `static void`
  `resetCounter()`
  Resets the counter accessible though `getCounter()` back to 1.
  `void`
  `setVariable(String key, Object value)`
  Sets a variable.
  `void`
  `setVariable(String key, Object value, String scope)`
  Sets a variable.

  ### Von Klasse geerbte Methoden java.lang.Object

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

- ## Konstruktordetails

  - ### TorqueGenGroovy

    public TorqueGenGroovy(GroovyOutlet outlet, ControllerState controllerState)
    Constructs a generator interface within the given controllerState.
    Parameter:
      `outlet` - the outlet in which this generator interface will be used, not null.
      `controllerState` - the controller context.
    Löst aus:
      `NullPointerException` - if outlet or controllerState are null.

- ## Methodendetails

  - ### mergepoint

    public String mergepoint(String mergepointName) throws GeneratorException
    Processes the mergepoint with the given name.
    Parameter:
      `mergepointName` - the name of the mergepoint.
    Gibt zurück:
      the output generated by the mergepoint.
    Löst aus:
      `GeneratorException` - if the mergepoint could not be processed completely.

  - ### getControllerState

    public ControllerState getControllerState()
    Returns the current controller state.
    Gibt zurück:
      The current controller state, never null.

  - ### getModel

    public Object getModel()
    Returns the current model. This method is shorthand for `getControllerState().getModel()`
    Gibt zurück:
      the current source element, never null.

  - ### option

    public Object option(String key)
    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.
    Parameter:
      `key` - the key for the option to retrieve.
    Gibt zurück:
      the option for the given key.

  - ### getOption

    public Object getOption(String key)
    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.
    Parameter:
      `key` - the key for the option to retrieve.
    Gibt zurück:
      the option for the given key.

  - ### booleanOption

    public boolean booleanOption(String key)
    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.
    Parameter:
      `key` - the key for the option to retrieve.
    Gibt zurück:
      the option for the given key, converted to a boolean

  - ### intOption

    public int intOption(String key)
    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.
    Parameter:
      `key` - the key for the option to retrieve.
    Gibt zurück:
      the option for the given key, converted to a boolean

  - ### getVariable

    public Object getVariable(String key)
    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.
    Parameter:
      `key` - the key for the variable to retrieve.
    Gibt zurück:
      the variable for the given key, or null if the variable is not set or explicitly set to null.

  - ### setVariable

    public void setVariable(String key, Object value)
    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.
    Parameter:
      `key` - the name of the variable, not null
      `value` - the value of the variable, may be null.
    Löst aus:
      `NullPointerException` - if key or scope is null.
      `IllegalArgumentException` - if the key is no valid QualifiedName.

  - ### setVariable

    public void setVariable(String key, Object value, String scope)
    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.
    Parameter:
      `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.
    Löst aus:
      `NullPointerException` - if key or scope is null.
      `IllegalArgumentException` - if the key is no valid QualifiedName.

  - ### getSourceFile

    public File getSourceFile()
    Returns the currently processed source file.
    Gibt zurück:
      the source file which is currently processed.

  - ### now

    public Date now()
    Returns the current date.
    Gibt zurück:
      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. If `resetCounter` is not called, the returned value is unique over the generation process.
    Gibt zurück:
      the counter value.

  - ### resetCounter

    public static void resetCounter()
    Resets the counter accessible though `getCounter()` back to 1.