Eigene Annotationen schreiben
Fügen Sie Ihren Deklarationen Metadaten hinzu
Eigene Annotationen schreiben ist eine kostenlose Dart Academy-Lektion auf CoddyKit. Dies ist Lektion 2 von 4. Du kannst die komplette Lektion unten kostenlos lesen – dann übst du sie direkt im Browser mit einem integrierten Code-Editor und einem KI-Tutor rund um die Uhr. Sie ist Teil des Dart Academy-Lernpfads, und dein Fortschritt wird über Web und CoddyKit-App synchronisiert. Der Dart Academy-Kurs umfasst insgesamt 4 Lektionen.
Annotationen sind Klassen
Eine benutzerdefinierte Annotation ist einfach eine gewöhnliche Klasse. Wenn Sie @MyTag schreiben, verweisen Sie als Metadaten auf eine Instanz dieser Klasse. 🏷️
Die Klasse definieren
Beginnen Sie mit der Deklaration einer normalen Klasse, die Ihre Metadaten enthält. Hier wird eine einfache Todo-Annotation später eine Meldung und einen Verantwortlichen aufnehmen.
class Todo {
final String message;
const Todo(this.message);
}Die Regel für den const-Konstruktor
Annotationswerte müssen Konstanten zur Compilezeit sein, daher muss der Konstruktor const sein. Ohne ihn können Sie die Klasse nicht als Annotation verwenden.
Ihre Annotation anwenden
Verwenden Sie das Präfix @ mit einer const-Konstruktion. Dieses @Todo-Tag dokumentiert Arbeit, die an der folgenden Methode noch erledigt werden muss.
@Todo('Add validation')
void saveForm() {}Mehrere Felder aufnehmen
Ihre Annotation kann beliebig viele Felder enthalten. Verwenden Sie benannte Parameter im Konstruktor, wenn Ihre Tags klarer und selbsterklärend sein sollen.
class Todo {
final String task;
final String who;
const Todo(this.task, this.who);
}Nur konstante Argumente
Jedes übergebene Argument muss selbst eine Konstante sein. Literale, const-Objekte und Enum-Werte funktionieren, eine Laufzeitvariable jedoch nicht.
Eine Markierung ohne Argumente
Manchmal benötigen Sie nur ein Kennzeichen. Eine const-Instanz ohne Daten dient als reine Markierung, die Sie an Deklarationen anbringen.
class Experimental {
const Experimental();
}
const experimental = Experimental();Praktische Konstanten in Kleinschreibung
Wenn Sie eine const-Instanz in Kleinschreibung bereitstellen, können Aufrufer einfach @experimental statt jedes Mal @Experimental() schreiben.
@experimental
void betaFeature() {}Allein bewirken sie weiterhin nichts
Wie die integrierten Annotationen hat auch Ihre benutzerdefinierte Annotation allein kein Verhalten. Etwas muss sie lesen, damit sie nützlich wird. Das behandeln wir als Nächstes.
Wer Annotationen liest
Zwei Leser sind besonders wichtig: Codegeneratoren zur Buildzeit und Reflection-ähnliche Tools. Beide untersuchen Ihre Tags und verarbeiten die darin gefundenen Metadaten.
Halten Sie Annotationen klein
Gute Annotationen bleiben klein und deklarativ. Speichern Sie einfache Daten statt Logik, damit jedes Tool sie vorhersehbar und sicher lesen kann.
Schnellcheck
Was muss eine Klasse besitzen, damit sie als Annotation verwendet werden kann?
Zusammenfassung
Eine benutzerdefinierte Annotation ist eine Klasse mit einem const-Konstruktor. Wenden Sie sie mit @ an, übergeben Sie konstante Argumente und lassen Sie Tools die Metadaten später lesen. 🎉
Häufig gestellte Fragen
Ist die Lektion „Eigene Annotationen schreiben“ kostenlos?
Ja — der vollständige Text von „Eigene Annotationen schreiben“ ist hier im Web kostenlos zu lesen. Um sie interaktiv zu üben (integrierter Code-Editor und 24/7 KI-Tutor) und den Rest des Dart Academy-Kurses freizuschalten, upgrade auf CoddyKit PRO. Der Dart Academy-Kurs umfasst insgesamt 4 Lektionen.
Was lerne ich in „Eigene Annotationen schreiben“?
Fügen Sie Ihren Deklarationen Metadaten hinzu Du übst Dart Academy mit praktischem Code, den du direkt im Browser ausführst, und ein 24/7 KI-Tutor beantwortet deine Fragen während du die Lektion bearbeitest.
Brauche ich Erfahrung, um Dart Academy zu starten?
Keine Vorkenntnisse erforderlich. Dart Academy auf CoddyKit ist für Anfänger bis fortgeschrittene Lernende strukturiert, sodass du hier starten oder von Anfang an beginnen und in deinem eigenen Tempo voranschreiten kannst. Dies ist Lektion 2 von 4.
Wie lange dauert die Lektion „Eigene Annotationen schreiben“?
Die meisten CoddyKit-Lektionen dauern etwa 5–10 Minuten. Jede ist kompakt und interaktiv, sodass du stetig Fortschritte machst und genau dort weitermachst, wo du aufgehört hast – im Web und in der App.
Kann ich in dieser Dart Academy-Lektion Code schreiben und ausführen?
Ja. Jede Dart Academy-Lektion enthält einen integrierten Code-Editor, sodass du echten Code direkt in deinem Browser schreibst und ausführst und sofort KI-Feedback erhältst — ohne lokale Einrichtung erforderlich.
Alle Lektionen in diesem Kurs
- Integrierte Annotationen: override, deprecated
- Eigene Annotationen schreiben
- Codegenerierung mit build_runner
- json_serializable in der Praxis