#1875: BeanHelper.java

Umfassendes JavaBean-Introspektions- und Reflektionswerkzeug. Kerninfrastruktur für die ORM/Wicket-Integrationsschicht von ProjectForge — bietet Eigenschaftsnamenauflösung aus Getter/Setter-Methoden, Getter/Setter-Methodensuche mit umfangreichem Caching (fünf interne Caches für die Leistung), Feldannotationserkennung, verschachtelten/indexierten Eigenschaftszugriff, Eigenschaftskopieren mit Differenzerkennung und reflektionsbasierte Objektinstanziierung. Weit verbreitet in allen ProjectForge-Modulen für Wicket-Listensortierung, Formularbindung und DO-zu-DTO-Konvertierung.

Importe

• org.apache.commons.lang3.ArrayUtils — Array-Verkettung für Feld-/Methodensammlung über die Klassenhierarchie hinweg
• org.apache.commons.lang3.StringUtils — Zeichenkettenmanipulation (Großschreibung, Kleinschreibung, Teilen)
• java.lang.annotation.Annotation — Annotationserkennung auf Feldern
• java.lang.reflect.* — Kern-Java-Reflection-API: Field, Method, Constructor, Modifier, Array, InvocationTargetException
• java.util.* — Collections, Iteratoren, Hash-Maps für Caching
• org.slf4j.Logger — Fehlerprotokollierung für Reflektionsfehler

Internes Caching-Architektur

BeanHelper verwendet fünf statische synchronisierte Caches, um wiederholte Reflektionsaufrufe zu vermeiden, die in Java teuer sind. Dies ist entscheidend für Wicket-Listenseiten, bei denen BeanHelper für jede Zelle in einer sortierbaren Datentabelle aufgerufen wird.

Cache	Schlüssel	Wert	Nutzen
declaredFieldsCache	Class	Field[]	Vermeidet erneutes Durchsuchen der Klassenhierarchie nach Feldern
declaredMethodsCache	Class	Method[]	Vermeidet erneutes Durchsuchen der Klassenhierarchie nach Methoden
declaredFieldAnnotationsCache	"Klasse:Feldname"	Annotation[]	Vermeidet erneutes Auflösen annotierter Felder (entscheidend für Wicket-Spaltensortierung)
getterMethodsCache	"Klasse:Feldname"	Method	Vermeidet erneute Suche nach Getter-Methoden
declaredGetterMethodsCache	String	Method[]	Deklariert, aber im bereitgestellten Code scheinbar ungenutzt — könnte anderswo befüllt werden

Schlüsseloperationen

Eigenschaftsnamenauflösung

• determinePropertyName(Method) — Entfernt get/set/is/has-Präfix und wandelt das erste Zeichen in Kleinbuchstaben um
• determineGetter(Class, Feldname, onlyPublicGetter) — Findet Getter-Methode (getX(), isX() für Booleans, hasX() für Booleans), behandelt Brückenmethoden (gibt keine gebrückten synthetischen Methoden zurück)
• determineSetter(Class, Feldname) — Findet Setter mit einem einzelnen Parameter
• determinePropertyType(Class, Feldname) — Ermittelt den Rückgabetyp des Getters (Eigenschaftstyp)

Annotationszugriff

getDeclaredAnnotations(Class, Feldname) unterstützt verschachtelte Eigenschaftspfade (punktgetrennt, z. B. "adresse.stadt.name"), indem die Feldkette durch Reflektion durchlaufen wird, um die Annotationen des Endfelds zu finden. Dies ist essentiell für Wicket-Datentabellen, die verschachtelte Objekteigenschaften mit sortierbaren Spalten anzeigen.

Eigenschaftszugriff (Verschachtelt + Indiziert)

• getProperty(Object, String) — Ruft Getter auf einem Bean auf
• setProperty(Object, String, Object) — Ruft Setter auf
• getIndexedProperty(Object, "prop[3]") — Unterstützt indizierten Zugriff auf Collections/Arrays
• getNestedProperty(Object, "a.b.c") — Durchläuft punktgetrennten Eigenschaftspfad und behandelt Nullwerte elegant (gibt null zurück, wenn ein Zwischenwert null ist)

Eigenschaftskopieren (copyProperties)

Kopiert angegebene Eigenschaften vom Quell- zum Zielobjekt und gibt true zurück, wenn sich eine Eigenschaft tatsächlich geändert hat. Unterstützt:

• Collection-Vergleich: Elementweise Gleichheitsprüfung (reihenfolgeabhängig, unter Verwendung von Iteratoren)
• Array-Vergleich: Verwendet Arrays.equals()
• Skalarvergleich: Verwendet Objects.equals() (nullsicher)
• WhitespaceEqualsNull-Modus: Behandelt leere/fehlende Zeichenketten als äquivalent (kopiert nur, wenn beide nicht leer und unterschiedlich sind)

Reflektionshilfsprogramme

• getAllDeclaredFields(Class) — Gibt alle Felder einschließlich geerbter zurück, durchläuft die Superklassenkette
• getAllDeclaredMethods(Class) — Gibt alle Methoden einschließlich geerbter zurück
• getDeclaredPropertyFields(Class) — Gibt nur nicht-transiente, nicht-statische, nicht-finale Felder zurück (tatsächliche persistente Eigenschaften)
• getFieldValue(Object, Class/String, Feldname) — Liest Feldwert via Reflektion (setAccessible für private Felder)
• newInstance(Class, ...) — Mehrere Überladungen für reflektive Objektkonstruktion mit verschiedenen Konstruktorsignaturen
• invoke(Object, Method, args) — Generischer Methodenaufruf mit Fehlerbehandlung

Testmodus-Funktion

Das TEST_MODE-Flag (gesteuert durch enterTestMode()/exitTestMode()) unterdrückt die Fehlerprotokollierung während der Testausführung. Dies ermöglicht Tests, Reflektionsoperationen zu versuchen, die voraussichtlich fehlschlagen, ohne die Testprotokolle mit Stacktraces zu verschmutzen. Die Methoden logInstantiationException() beachten dieses Flag.

Entwurfsentscheidungen

1. Aggressives Caching: Fünf Caches existieren, weil Reflektion langsam ist und BeanHelper auf heißen Pfaden aufgerufen wird (Wicket-Datentabellen-Rendering und -Sortierung)
2. Brückenmethoden-Filterung: determineGetter() überspringt Brückenmethoden (synthetische Methoden, die vom Compiler für generische Typlöschung erstellt wurden), um die tatsächlich implementierte Methode zurückzugeben
3. Nullsichere Traversierung: getNestedProperty() gibt an jedem Punkt der Kette null zurück, an dem ein Zwischenwert null ist, anstatt eine NPE zu werfen
4. Konstruktorzugänglichkeit: newInstance() ruft constructor.setAccessible(true) auf, um Klassen mit privaten Konstruktoren zu instanziieren
5. Keine externe Bean-Bibliothek: Trotz der Abhängigkeit von commons-beanutils im Gradle-Build implementiert BeanHelper seine eigene Eigenschaftsauflösung anstatt Apache BeanUtils direkt zu verwenden — wahrscheinlich aus Leistungs- und Cache-Kontrollgründen

868d6abb7 2025 -> 2026
63081666f Quelltextdatei-Header: 2024 -> 2025.
a73905c14 Korrigiere Tippfehler in projectforge/*-Verzeichnissen Gefunden via codespell
694987647 Migration stuff in progress... (alle Tests aller Pakete: OK).
ae50b2522 BeanHelper.getProperty unterstützt jetzt verschachtelte Eigenschaften durch einfache Verwendung von new PropertyUtils.
b6092df09 Copyright 2023 -> 2024
ab45d51fa Copyright 2001-2022 -> 2001-2023.
0203e3261 AbstractListPage: langlaufende Abfragen: Änderung der Sortierreihenfolge zeigt Ergebnisliste ohne Suchbutton. BeanHelper: viele Caches für schnellere Sortierung in Wicket-Ergebnislisten.