ASM bytecode lib improved

ASM bytecode lib improved

This is a Library to get generics type information and type annotations from java bytecode (class file, jar file, war file, ear file and so on) with the ASM-Bytecode-Lib under consideration generic type arguments, generic type parameters with bound, wildcards with bounds and so on.

Diese Lib verbessert das API der ASM-Bytecode-Lib durch das Bereitstellen eines Baumes im Gegensatz zur Visitor-Arbeitsweise mit den Informationen zu Klassen (Klassen, Interfaces, Enums, Annotationen) (alles, was ein *.class-File erzeugt, auch package-info.class), Annotationen, Feldern und Methoden sowie strukturierter und getypter Informationen zu Typen einschliesslich Generics.

Ziel ist das Erhalten von Informationen über Klassen, Annotationen, Felder, Methoden und Generics ohne das Laden der Klasse, was bei der Benutzung von Reflection notwendig wäre und eventuell aufgrund vorhandenen Initialisierungscodes schwierig sein könnte oder scheitern könnte.

Es werden prinzipiell nur die Informationen geliefert, die auch mit Reflection erreichbar wären, Executables (Methoden, Konstruktoren, statische Initialisierer und Initialisierungs-Ausdrücke von Feldern) werden nicht beachtet.
Für die Bestandteile der Klassen-Signatur (Name, Super-Klasse, Interfaces, Typ-Parameter, Felder, Methoden, Konstruktoren) werden alle im Java-Bytecode enthaltenen Informationen geliefert.
Es können auch Klassen im Scope private oder default(package) untersucht werden, die per Reflection nicht erreichbar sind.
Die zu untersuchenden *.class-Dateien müssen sich nicht im Classpath des untersuchenden Programms liegen.

Bytecode-Manipulation wird von meiner Lib nicht unterstützt.

Ich habe meine Lib unter Java8 entwickelt, aber bewusst keine Java8-Sprach-Features genutzt.
Deshalb sollte meine Lib auch unter Java7 funtionieren.

Die von mir genutzte Version der ASM-Lib liegt im lib-Verzeichnis des Auslieferungs-Zip bei.

Zur Benutzung finden sich entsprechende Code-Beispiele im test-Verzeichnis mit den JUnit4-Tests.

Eventuell wäre die Benutzung der BCEL-Lib günstiger gewesen.

Übrigens sind beide Libs Bestandteil des Java8-JDK.

Intern werden die von dem ASM-Visitoren gelieferten Informationen in einer DOM-Struktur vermerkt und von dieser aus die generischen Typ-Informationen in eine typ-sichere Objekt-Struktur umgewandelt.

Der Code enthält die Java-Klasse InnerOrNestedClassNameResolver zum Auflösen der im Java-Bytecode und als Class-File-Namen verwendeten Dollar-Zeichen-separierten Namen für innere und geschachtelte Java-Klassen (Name mangling - Java - Wikipedia, the free encyclopedia).
Dabei werden vorher die beim Aufruf der zu implementierenden Methode ClassVisitor.html#visitInnerClass gelieferten einzelnen Zuordnungen der Dollar-Zeichen-separierten Namen für innere und geschachtelte Java-Klassen zu punkt-separierten Namen in einer Java-Map aufgesammelt.
Hier werden auch Namenszuordnungen für innere Klassen geliefert, die in der aktuellen Klasse verwendet werden, aber nicht in dieser deklariert sind.
Anhand der übergebenen Zuordnungs-Map werden die Dollar-Zeichen-separierten Namen in punkt-separierte Namen unter Beachtung der korrekten Trennung von Package und Klassen-Name (Java-Klasse Fqn full qualified name) umgewandelt. Die aktuelle Version beherrscht auch die Namens-Auflösung für lokale und anonyme Klassen.

Es können beliebig tief geschachtelte Annotationen gescannt und in eine DOM-Form umgewandelt werden. Dabei werden selbstverständlich auch Annotationen mit @Retention( RetentionPolicy.CLASS ) berücksichtigt.

Die aktuelle Version beherrscht auch Typ-Annotationen. Dabei bin ich auf folgenden Fehler gestossen:
OW2 Forge: Detail: 317773 Wrong typepath for array type annotations
und hoffe, dass dieser bald behoben wird.
Zwischenzeitlich ist im Code ein Workaround eingebaut.

Achtung: Erweiterungen und Fixes stelle ich ohne Historie und ohne Ankündigung hier bereit.
Deshalb am besten immer die letzte Version runterladen.

Lizenzbedingungen:

Die Programme, Quelltexte und Dokumentationen können ohne irgendwelche Bedingungen kostenlos verwendet werden.
Sie sind Freeware und Open Source. Für Fehler und Folgen wird keinerlei Haftung übernommen.

Hinweise zur Fehlerbeseitigung und Verbesserung sind mir willkommen.

Ich freue mich auch über Feedback bezüglich der erfolgreichen Verwendung meiner Sourcen.

Bei Fragen helfe ich gern mit Hinweisen oder zusätzlicher Dokumentation, falls ich dafür Zeit habe.