Jeder Anmerkungstyp hat seine eigene Semantik und unterstützt eine Gruppe von Eigenschaften.
Führen Sie zum Definieren eines neuen Anmerkungstyps die folgenden Verfahren aus:
- Deklarieren Sie in der Datei plugin.xml einen neuen Anmerkungstyp. Verwenden Sie dazu den Erweiterungspunkt com.ibm.rational.test.lt.recorder.core.recorderAnnotation und das Element annotationType.
- Weisen Sie dem Typ eine eindeutige ID zu. Gewöhnlich hat die ID folgendes Format: plug-in-name.typ.
- Weisen Sie dem Typ einen für den Benutzer lesbaren Namen zu. Der Name wird im Aufzeichnungssitzungseditor angezeigt.
Die besten Ergebnisse erzielen Sie, wenn Sie die folgenden optionalen Schritte ausführen:
- Definieren Sie eine Schnittstelle, die eine Zeichenfolgekonstante mit der zuvor definierten Anmerkungstyp-ID enthält.
- Fügen Sie in dieser Schnittstelle für jeden Eigenschaftsnamen, der vom Anmerkungstyp unterstützt wird, eine Zeichenfolgekonstante ein. Geben Sie in den Javadoc-Informationen der Konstante die Bedeutung und den Typ der Eigenschaft an. Bei den Eigenschaftstypen kann es sich um diejenigen handeln, die von den Setter- und Getter-Methoden der Klasse "com.ibm.rational.test.lt.recorder.core.property.AbstractConfiguration" unterstützt werden.
Definieren Sie außerdem einen Label-Provider für den Anmerkungstyp. Ein Label-Provider gibt eine dynamische Bezeichnung auf Grundlage der Anmerkungseigenschaften und ein Bild zurück. Die Bezeichnung und das Symbol werden im Aufzeichnungssitzungseditor angezeigt. Führen Sie zum Definieren eines Label-Providers die folgenden Verfahren aus:
- Deklarieren Sie in der Datei plugin.xml einen neuen Label-Provider für Anmerkungen. Verwenden Sie dazu den Erweiterungspunkt com.ibm.rational.test.lt.recorder.ui.annotationContribution und das Element annotationLabelProvider.
- Geben Sie den vom Label-Provider unterstützten Anmerkungstyp an.
- Definieren Sie eine Implementierungsklasse des Label-Providers. Mit der Implementierungsklasse muss die JFace-Schnittstelle "ILabelProvider" implementiert werden. Bei jedem an diese Schnittstelle übergebenen Objekt handelt es sich immer um eine Instanz der Klasse "com.ibm.rational.test.lt.recorder.core.annotations.RecorderAnnotation".