User Tools

Site Tools


01_user_documentation:07_rgg_xl:02_xl:08_object:01_module:01_declaration

This is an old revision of the document!


Declaration

Modules are declared similarly as classes. Their declaration include:

Modules are declared in XL with the keyword module (different from the java keyword module).

module A(int attr1, Object attr2) extends N { /* body */ } ==> ;

Syntax

Only the Name is non optional in the declaration. Thus, the smallest module declaration is:

module A;

This declaration is equivalent to:

class A extends N {
  public static class Pattern extends UserDefinedPattern {
  private static void signature(@In @Out X node) {}
    ... // suitable implementation of abstract methods
  }
}

The declaration uses an implicit superclass N which is determined by the annotation @DefaultModuleSuperclass of the innermost enclosing declaration which has such an annotation. RGG files have default annotations, one of these is the @DefaultModuleSuperclass. Its value is Node. Thus, by default all module extends Node.

The parametrized pattern is created implicitly and takes the module attributes declared after the name as additional arguments.

Using super attribute

Module declarations may also specify their superclass explicitly, use inherited fields in the pattern, and contain an entire class body:

module B ( super.len, String s) extends A; 
 
//is equivalent to (given the previous declaration of A)
class B extends A {
  String s;
  B(float l, String s) {super(l); this.s = s;}
 
  public static class Pattern extends UserDefinedPattern {
    private static void signature(@In @Out Y node,
                                          float a, String b ) {}
  }
}

Superclass constructor

It is also possible to declare the superclass constructor explicitly.

module C ( super.len ) extends B(len, "VAL") ; 
 
// is equivalent to:
class C extends B {
 
  C(float l) {
    super(l, "VAL"); 
  }
 
  ... // pattern
}

Add expression to the constructor

It is possible to add a list of expression statements to be included in the constructor (using the syntax of with-instance expression lists):

module C ( super.len, super.s ) extends B . ( int i = 0, i++, println(i) ) ; 
 
// is equivalent to:
class C extends B {
 
  C(float l, String s) {
    super(l, s); 
    int i = 0;
    i++;
    println(i);
  }
 
  ... // pattern
}
01_user_documentation/07_rgg_xl/02_xl/08_object/01_module/01_declaration.1756994561.txt.gz · Last modified: 2025/09/04 16:02 by gaetan