Guiden API-brugsmønstre

Med denne guide får du hjælp til at oprette regulære udtryksmønstre til styring af en analyse af API-brug.

Sådan aktiveres guiden:

  1. Skift til skillebladet Mønstre, mens du opretter en ny startkonfiguration til en rapport over API-brug.
  2. Klik på knappen Tilføj... på skillebladet.

Indstilling

Beskrivelse

Standard

Mønstertyper Denne liste viser alle de mønstre, der kan oprettes med guiden. Første element på lsiten
Beskrivelse Viser beskrivelsen i klar tekst af den mønstertype, der er valgt på listen Mønstertyper.  

Den første side i guiden giver mulighed for at vælge den type mønster, du vil oprette. Der er beskrivelser til alle mønstrene, så det er nemmere at vælge. Markér mønsteret, så vises beskrivelsen i feltet Beskrivelse.

Guiden API-brugsmønster - side til valg af mønster

Arkivmønstre

Når analysen af API-brug er udført, scannes alle foldere og arkiver i et bundt for at sikre, at alle klassefiler er analyseret. I nogle tilfælde kan et bundt indeholde et arkiv med gamle versioner af eksempelvis klassefiler, som du ikke ønsker at analysere. I så fald kan du bruge et arkivmønster til fuldstændigt at ignorere et bestemt arkiv eller alle arkiver, der matcher et bestemt regulært udtryk.

Indstilling

Beskrivelse

Standard

Bundtnavn Det fuldstændige symbolske navn på det bundt, som mønsteret skal anvendes på. Eksempel: org.eclipse.pde.api.tools. tom
Arkivnavn Det fuldstændige navn eller regulære udtryk for arkivet eller arkiverne, som mønsteret skal anvendes på. Eksempel: *.jar - som ignorerer alle indlejrede JAR-filer. tom

Guiden API-brugsmønster - opret arkivmønstre

Pakkemønstre

Når søgeprogrammet til API-brug udtrækker referencer til analyse, bruger det metadata fra bundtet til at afgøre, om en reference er intern eller ej. I nogle tilfælde er et bundt ikke konfigureret til at beskrive korrekt, hvilke klasser der er interne, og hvilke der ikke er. Du kan bruge et pakkemønster til at forbedre disse forkert formaterede bundter - kun fra søgeprogrammets synspunkt: det faktiske bundt ændres ikke på nogen måde - for at beskrive, hvad der er internt, og hvad der ikke er.

Indstilling

Beskrivelse

Standard

Mønster Det regulære udtryksmønster, som pakkerne skal matches op imod. Eksempel: .*\.internal\..*. tom
API-mønster Om mønsteret skal betragte matchende pakker som API eller ej. markeret

Guiden API-brugsmønster - opret pakkemønstre

Mønstre for rapportkonvertering

Når en analyse af API-brug er fuldført, kan der være en hel masse oplysninger, som skal gennemgås. Men med et mønster til rapportkonvertering kan du reducere de referenceoplysninger, der vises i HTML-rapporter, så kun det, du er interesseret i, vises. Hvis du vil gøre det, kan du oprette udeladelsesmønstre, som bruges til at fjerne de referencer, der rapporteres.

Indstilling

Beskrivelse

Standard

Filtrér referencer til dette mønster Giver mulighed for at ignorere rapporteringsreferencer til mønsteret. Hvis mønsteret f.eks. er org\.eclipse\.jdt\..*, og du vælger denne indstilling, bliver der ikke rapporteret nogen referencer til JDT. valgt
Filtrér referencer fra dette mønster Giver mulighed for at ignorere rapporteringsreferencer til mønsteret. Hvis mønsteret f.eks. er org\.eclipse\.jdt\..*, og du vælger denne indstilling, bliver der ikke rapporteret nogen referencer fra JDT.  
Mønster Det regulære udtryksmønster. tom

Guiden API-brugsmønster - opret mønstre til rapportkonvertering

Relaterede opgaver

Konfigurér API-værktøjer

Relaterede referencer

Funktionen Konfigurér API-værktøjer
Menuen PDE-værktøjer
Rapporter over API-brug