This page (revision-11) was last changed on 23-Oct-2013 10:34 by Dieter Käppel

This page was created on 26-Apr-2012 12:34 by Dieter Käppel

Only authorized users are allowed to rename pages.

Only authorized users are allowed to delete pages.

Page revision history

Version Date Modified Size Author Changes ... Change note
11 23-Oct-2013 10:34 6 KB Dieter Käppel to previous
10 23-Oct-2013 10:34 6 KB Dieter Käppel to previous | to last
9 26-Apr-2012 13:37 6 KB Dieter Käppel to previous | to last
8 26-Apr-2012 13:37 6 KB Dieter Käppel to previous | to last
7 26-Apr-2012 13:36 6 KB Dieter Käppel to previous | to last
6 26-Apr-2012 13:35 3 KB Dieter Käppel to previous | to last
5 26-Apr-2012 12:56 3 KB Dieter Käppel to previous | to last
4 26-Apr-2012 12:50 3 KB Dieter Käppel to previous | to last
3 26-Apr-2012 12:50 2 KB Dieter Käppel to previous | to last
2 26-Apr-2012 12:39 2 KB Dieter Käppel to previous | to last
1 26-Apr-2012 12:34 1 KB Dieter Käppel to last

Page References

Incoming links Outgoing links

Version management

Difference between version and

At line 1 changed one line
[Intersult] [Coder] ist ein Werkzeug zur Analyse und zum Generieren von Code. Wichtige Bestandteile sind:
[Intersult] [Coder] ist ein Werkzeug zur Analyse und zum Generieren von Java-Code. Das Projekt wird von [Abraxas] verwendet, um die Konvertierung von XML nach [Java] und umgekehrt durchzuführen. Ziel des Projekts ist die einfache Nutzbarkeit durch [Convention over Configuration].
At line 3 changed 2 lines
* __Reflector:__ Stellt ein erweitertes Reflection für Java-Klassen zur Verfügung mit der Unterstüzung von Argumentnamen (bei Methoden), Generics, Annotations und Kommentaren.
* __Generator:__ Generiert Code aus erstellten JavaClass-Dateien und schreibt diesen in Dateien.
!!!Übersicht
Das Projekt enthält im Wesentlichen folgende Klassen, die für den Einstieg wichtig sind:
At line 6 added 4 lines
* __Reflector:__ Diese Klasse stellt eine erweiterte Reflection für Java-Klassen dar. Features sind Unterstüzung von Argumentnamen (bei Methoden), Generics, Annotations und Kommentare.
* __Generator:__ Generiert den Code für Java-Klassen aus JavaClass-Instanzen. JavaClass-Objekte können durch den Reflector aus bestehenden Code erzeugt werden oder komplett dynamisch angelegt werden. Der Generator schreibt das Ergebnis dann in Java-Dateien, die gut formatiert und compilierbar sind.
* __Instance:__ Es können Instanzen von Klassen erzeugt werden, die nicht vom ClassLoader geladen wurden. Dabei handelt es sich natürlich nicht um "echte" Instanzen, sondern Objekte vom Typ com.intersult.code.Instance.
At line 11 changed one line
!Anwendung
!!Anwendung
At line 16 changed one line
!Beispiel
!!Beispiel
At line 24 added one line
System.out.println(stringClass.getClassDefinition());
At line 22 changed one line
__Erklärung:__ Der Reflector erzeugt aus der String.class-Klasse eine JavaClass, die erweiterte Methoden enthält, wie zum Beispiel getTypeName und getTypeNameSimple.
__Erklärung:__ Der Reflector erzeugt aus der String.class-Klasse eine JavaClass, die erweiterte Methoden enthält, wie zum Beispiel getTypeName und getTypeNameSimple. Die Methode getClassDefinition liefert die Definition, wie sie in der Java-Datei steht, für String:
At line 24 changed one line
!Basis-Typen
{{{
public final class String implements Serializable, Comparable<T>, CharSequence
}}}
!!Basis-Typen
At line 30 changed one line
WILDCARD, OBJECT, STRING, VOID, ATOMIC_VOID, SHORT, ATOMIC_SHORT, INTEGER, ATOMIC_INTEGER, LONG, ATOMIC_LONG, BOOLEAN, ATOMIC_BOOLEAN, BYTE, ATOMIC_BYTE, DOUBLE, ATOMIC_DOUBLE, FLOAT, ATOMIC_FLOAT, BIG_DECIMAL, CLASS, DATE, URI, URL, QNAME, LIST, SERIALIZABLE, BASE64
WILDCARD, OBJECT, STRING, VOID, ATOMIC_VOID, SHORT, ATOMIC_SHORT,
INTEGER, ATOMIC_INTEGER, LONG, ATOMIC_LONG, BOOLEAN, ATOMIC_BOOLEAN,
BYTE, ATOMIC_BYTE, DOUBLE, ATOMIC_DOUBLE, FLOAT, ATOMIC_FLOAT,
BIG_DECIMAL, CLASS, DATE, URI, URL, QNAME, LIST, SERIALIZABLE,
BASE64
At line 70 added 34 lines
!!Methods
Das Hinzufügen einer Methode inklusive Code kann zum Beispiel so aussehen:
{{{
JavaMethod equals = javaClass.addMethod("equals");
equals.setReturnType(Reflector.INSTANCE.ATOMIC_BOOLEAN);
equals.addAnnotation(Reflector.INSTANCE.OVERRIDE.newInstance());
JavaVariable object = new JavaVariable(Reflector.INSTANCE.OBJECT);
equals.getParameters().add(object);
equals.getCode().add("if (" + object.getVariableName() + " == null || !(" + object.getVariableName() +
" instanceof " + javaClass.getTypeNameSimple(false) + "))");
equals.getCode().add("\treturn false;");
equals.getCode().add("if (this == " + object.getVariableName() + ")");
equals.getCode().add("\treturn true;");
JavaVariable field = javaClass.getFields().get("field");
equals.getCode().add("return " + field.getGetter() + "().equals(((" + javaClass.getTypeName(false) + ")" +
object.getVariableName() + ")." + field.getGetter() + "());");
}}}
!!Beans und Properties
In Java werden Felder mit Gettern und Settern zugegriffen. Die Methoden dazu heißen Accessors und können mit einer Methode hinzugefügt werden:
{{{
Accessor accessor = javaClass.addAccessor(Reflector.INSTANCE.STRING, "name");
}}}
!!!Instance
Hat man eine JavaClass vorliegen, bekommt man über die Methode getType() das Java-Class-Objekt zurück. Mit newInstance() bekommt man eine neue Instanz. Dieser Fall liegt immer vor, wenn die JavaClass vom Reflector bezogen wurde.
Eine JavaClass kann allerdings auch aus dem Code erzeugt werden, also über den Konstruktor new JavaClass("<package>", "<name>"). In diesem Fall kann eine Instance durch die Methode newInstance() der Klasse JavaClass erzeugt werden. Es handelt sich natürlich um keine echte Java-Instanz, sondern um ein Objekt vom Typ com.intersult.code.Instance.
!!!Annotations
Instance wird auch bei der Verwendung von Annotations benutzt. Die Code-Generierung arbeitet ja mit JavaClass-Objekten, da diese aus dem Code heraus gebaut werden können. Instanzen werden benötigt, da eine Annotation-Klasse instantiiert wird, sobald sie an einer Stelle im Code mit dem @-Operator angebracht wird.