Intersult: Coder

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 ...
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
Coder Abraxas Coder Intersult Produkte	Coder Abraxas Intersult Java Maven

Version management

Difference between version and

At line 1 changed one line

[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].

[Intersult] [Coder] ist ein Werkzeug zur Analyse und zum Generieren von Code. Wichtige Bestandteile sind:

At line 3 changed 2 lines

!!!Übersicht

Das Projekt enthält im Wesentlichen folgende Klassen, die für den Einstieg wichtig sind:

* __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.

At line 6 removed 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 15 removed 6 lines

!!Anwendung

Beim Generieren von neuen Klassen mit dem Generator werden häufig bestehende Klassen und Systemklassen gebraucht. Diese brauchen nicht "per Hand" gebaut werden, sondern können vom Reflector erzeugt werden.

Darüber hinaus liefert der Reflector einige nützliche Informationen über eine Klasse, die über die Java-Reflection nicht zugreifbar sind. Dazu gehören die Namen von Methoden-Parametern und Kommentare von Klassen und Methoden. Dies wird zum Beispiel vom SOAP-Service [Abraxas] benutzt, um die Service-Aufrufe zu erzeugen.

!!Beispiel

At line 24 removed one line

System.out.println(stringClass.getClassDefinition());

At line 27 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. Die Methode getClassDefinition liefert die Definition, wie sie in der Java-Datei steht, für String:

__Erklärung:__ Der Reflector erzeugt aus der String.class-Klasse eine JavaClass, die erweiterte Methoden enthält, wie zum Beispiel getTypeName und getTypeNameSimple.

At line 29 removed 22 lines

{{{

public final class String implements Serializable, Comparable<T>, CharSequence

}}}

!!Basis-Typen

Die String-Klasse aus dem oberen Beispiel hätte nicht reflektiert werden müssen, da sie zur Grundausstattung des Reflector gehört (tatsächlich wird auch in diesem Fall dieselbe JavaClass zurück geliefert, da jede JavaClass nur einmal existiert).

Folgende Klassen sind bereits enthalten:

{{{

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

}}}

Dazu kommen Annotation-Klassen:

{{{

OVERRIDE, REQUIRED, DEFAULT, NAME, KEY

}}}

At line 54 changed one line

Für die Implementierung eigener [Maven-Plugins|Maven] oder anderer Art von Code-Generierung kann die Klasse com.intersult.code.Generator direkt verwendet werden. Die Verwendung ist dabei sehr einfach:

Für die Implementierung eigener [Maven-Plugins] oder anderer Art von Code-Generierung kann die Klasse com.intersult.code.Generator direkt verwendet werden. Die Verwendung ist dabei sehr einfach:

At line 70 removed 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.

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

Übersicht
Startseite
Das Unternehmen
Produkte
Consulting
Referenzen

Jobmarkt
Jobangebote
Profile

Hilfe
Suche
Seitenindex
Letzte Änderungen
Sichere Verbindung

Systeme
Tickets
Jenkins
Nexus
SVN
Email Client

2091 Aufrufe

referenziert von
Abraxas
Coder
Intersult Produkte