Klasse QUI\QDOM einen semantisch passenderen Namen geben
Für eine Person, die QUIQQER nicht kennt, deutet das "DOM" vermutlich auf das aus dem Web bekannte "Document Object Model" hin.
Laut Definition ist das Document Object Model...
[...] eine Spezifikation einer Programmierschnittstelle, welche HTML- oder XML-Dokumente als eine Baumstruktur darstellt, in der jeder Knoten ein Objekt ist, welches einen Teil des Dokumentes repräsentiert, z. B. einen Absatz, eine Überschrift, ein Video oder etwa eine Tabellenzelle.
Ein Laie könnte also denken, dass man durch das Erweitern dieser Klasse eine Art Baumstruktur mit Eltern und Kindern aufbauen möchte/kann (ähnlich wie die DOMNode oder DOMDocument Klassen von PHP).
Das ist aber ein Trugschluss, da die QDOM
-Klasse primär dazu genutzt wird, um in einer Klasse beliebige Werte zu speichern, auszulesen und zu entfernen.
Einige semantisch passendere Namen wären für mich: AttributeContainer
, AttributeStore
, oder AttributeBag
.
Vorgehen zum Umbenennen der Klasse:
- Klasse auf deprecated setzen
- Klasse mit neuem Namen erstellen, die diese Klasse erweitert
- Beim nächsten großen Breaking Change Update (QUIQQER 2.0):
- Die Logik aus der
QDOM
Klasse in die neue Klasse kopieren - Die Erweiterung der
QDOM
Klasse aus der neuen Klasse entfernen - Die
QDOM
Klasse löschen
- Die Logik aus der