Dieser Assistent leitet Sie durch die Schritte, die erforderlich sind, um Muster für reguläre Ausdrücke zwecks Steuerung einer API-Verwendungsanalyse zu erstellen.
Führen Sie die folgenden Schritte aus, um den Assistenten zu aktivieren:
| Option |
Beschreibung |
Standardwert |
|---|---|---|
| Mustertypen | Diese Liste enthält alle Muster, die mit dem Assistenten erstellt werden können. | Erstes Element in der Liste |
| Beschreibung | Zeigt die vom Benutzer lesbare Beschreibung des in der Liste Mustertypen ausgewählten Mustertyps. |
Auf der ersten Seite des Assistenten können Sie auswählen, welcher Mustertyp erstellt werden soll. Eine Beschreibung der einzelnen Muster soll Ihnen bei der Auswahl helfen. Wählen Sie einfach ein Muster aus, und dessen Beschreibung wird im Feld Beschreibung angezeigt.
Bei der Ausführung einer API-Verwendungsanalyse werden sämtliche Ordner und Archive in einem Produktpaket durchsucht. Dadurch wird sichergestellt, dass alle Klassendateien analysiert werden. Unter Umständen kann es sein, dass ein Produktpaket ein Archiv mit alten Versionen von (beispielsweise) Klassendateien enthält, die sich nicht analysieren lassen. In einem solchen Fall kann ein Archivmuster verwendet werden, um bestimmte oder alle Archive zu ignorieren, die einem angegebenen regulären Ausdruck entsprechen.
| Option |
Beschreibung |
Standardwert |
|---|---|---|
| Produktpaketname | Der vollständige symbolische Name des Produktpakets, auf das dieses Muster angewandt werden soll.
Beispiel: org.eclipse.pde.api.tools. |
Leer |
| Archivname | Der vollständige Name oder reguläre Ausdruck der Archive, auf die das Muster angewandt werden soll.
Beispiel: *.jar - hierdurch werden alle verschachtelten JAR-Dateien ignoriert. |
Leer |
Beim Extrahieren von Verweisen für die Analyse verwendet die Suchmaschine für API-Verwendung Metadaten aus dem Produktpaket, um zu ermitteln, ob ein Verweis intern ist oder nicht. Unter Umständen kann es vorkommen, dass ein Produktpaket nicht entsprechend konfiguriert wurde, um ordnungsgemäß beschreiben zu können, welche Klassen intern sind und welche nicht. Mithilfe eines Paketmusters können Sie diese fehlerhaften Produktpakete erweitern (und zwar nur für die Zwecke der Suchmaschine; das Produktpaket selbst wird in keinerlei Hinsicht geändert), um zu beschreiben, was intern ist und was nicht.
| Option |
Beschreibung |
Standardwert |
|---|---|---|
| Muster | Das Muster für reguläre Ausdrücke, mit dem Pakete abgeglichen werden sollen.
Beispiel: .*\.internal\..*. |
Leer |
| API-Muster | Gibt an, ob Pakete, die mit dem Muster übereinstimmen, als API gelten sollen oder nicht. | Markiert |
Nach Abschluss einer API-Verwendungsanalyse liegt unter Umständen eine immense Datenmenge vor, die durchsucht werden muss. Mithilfe eines Berichtskonvertierungsmuster können Sie die in den HTML-Berichten dargestellten Informationen zu Verweisen jedoch so eingrenzen, dass nur diejenigen Informationen angezeigt werden, an denen Sie ein Interesse haben. Zu diesem Zweck können Sie Ausschlussmuster zur Bereinigung der gemeldeten Verweise erstellen.
| Option |
Beschreibung |
Standardwert |
|---|---|---|
| Filterverweise zu diesem Muster | Ermöglicht Ihnen das Ignorieren von Berichtsverweisen zu diesem Muster.
Lautet das Muster beispielsweise org\.eclipse\.jdt\..* würden bei Auswahl dieser Option keine Verweise auf JDT gemeldet werden. |
Ausgewählt |
| Filterverweise von diesem Muster | Ermöglicht Ihnen das Ignorieren von Berichtsverweisen von diesem Muster.
Lautet das Muster beispielsweise org\.eclipse\.jdt\..* würden bei Auswahl dieser Option keine Verweise von JDT gemeldet werden. |
|
| Muster | Das Muster für reguläre Ausdrücke. | Leer |

Aktion 'Konfiguration für API-Tools'
Menü 'PDE-Tools'
API-Verwendungsberichte