Skapa prober

När du skapar en prob måste du först skapa en Probekit-källfil (.probe-fil). Därefter skapar du proben i Probkit-källfilen och lägger till det innehåll som definierar hur proben fungerar.

Du måste använda guiden för prob-källfil när du ska skapa en sådan. Du kan fortsätta att använda guiden till att skapa proben och skriva det mesta av probdefinitionen, eller också går du direkt till Probekit-redigeraren. I båda fallen måste du använda Probekit-redigeraren till att skriva Java-kodfragmentet för koden.

Detaljerad information om probens olika delar finns i Probdefinitioner.

  1. Så här skapar du Probekit-källfilen:
    1. I navigeringsvyn eller Paketutforskaren högerklickar du på det projekt där källfilen ska finnas, klicka därefter på Nytt > Övrigt. Projektet måste vara ett Java-projekt.
    2. På sidan Välj en guide utökar du Profilering och loggning och väljer Probekit-källfil.
    3. Klicka på Nästa.
    4. I guiden Skapa en probfil anger du ett namn på den nya probkällfilen i fältet Filnamn. Filnamnstillägget för Probekit-källfilen måste vara .probe.
    5. I fältet Källmapp anger du en projektkällmapp där den nya Probekit-källfilen ska finnas.
      Obs! Probekit-källfiler måste finnas på den översta nivån i projektkällmappen. De får inte finnas i en undermapp.
  2. Om du vill avsluta guiden nu och använda Probekit-redigeraren till att skapa proben och dess definitioner:
    1. Välj Inget innehåll.
    2. Klicka på Slutför. Den nya Probekit-källfilen läggs till i projektkällmappen och öppnas (som standard) automatiskt i Probekit-redigeraren.
    3. Fortsätt med steg 4.
  3. Om du vill fortsätta använda guiden som hjälp när du skapar probdefinitionen:
    1. Välj Metodprob eller Callsite-prob.
    2. Välj värdet för Fragmenttyp för det fragment som du vill att guiden ska skapa.
    3. Klicka på Nästa.
    4. Med knapparna Lägg till och Redigera definierar du önskat antal dataposter. När du lägger till eller väljer ett objekt visas en beskrivning av det i guiden.
      Obs! Om du vill gå tillbaka och ändra typ för den prob som skapas eller fragmenttypen som ska infogas uppmanas du att ta bort de objekt som inte längre gäller.
    5. Klicka på Slutför. Den nya Probekit-källfilen läggs till i projektkällmappen och öppnas (som standard) automatiskt i Probekit-redigeraren.
  4. Valfritt: På sidan Allmänt i Probekit-redigeraren anger du en unik ID-sträng för proben i fältet ID och ett versionsnummer i fältet Version, samt värden för en etikett. Dessa data är bara till för identifiering.
  5. Klicka på fliken Prober.
  6. Om du inte använde guiden till att skapa proben högerklickar du till vänster i Probekit-redigeraren på Lägg till prob. Den nya proben ska ny skapas i trädfönstret till vänster på sidan.
  7. Högerklicka på proben i trädfönstret och klicka sedan på Nytt > Fragment. Det nya fragmentet visas i trädfönstret som ett underordnat objekt till proben, och fragmentets egenskapsfält visas till höger i redigeringsfönstret.
  8. Välj ett värde för Fragmenttyp i redigeringsfönstret och ange sedan Java-koden för probfragmentet. Mer detaljerad information finns i Probfragmenttyper.
  9. Fortsätt definiera proben genom att högerklicka på objekt i trädet och använd snabbmenyn till att läggatill/ta bort underordnade objekt, och skriv värden för de nya objekten i redigeringsfönstret. I snabbmenyn visas bara de objekt som är giltiga för den plats som är markerad i trädet. Om ett objekt är giltigt men inte längre kan läggas till på den markerade platsen avaktiveras objektet på menyn.
    Obs! När du skriver ett värde i egenskapsfältet Importdirektiv skriver du bara namnet på paketet eller klassen som du vill importera. Skriv inte nyckelordet import eller det avslutande semikolontecknet (;).
  10. När du är klar med definitionen av proben klickar du på Arkiv > Spara.
    Obs! När du sparar Probekit-källfilen kontrolleras syntaxen för alla Java-element i filen och eventuella javac-problem rapporteras. Om det finns ett fel eller en varning för en post ändras motsvarande ikon i trädet till fel- eller varningsikonen. Javac-problem visas i tabellen längst ned på sidan Prober. Dubbelklicka på ett objekt i den här tabellen om du vill arbeta med redigeringsfunktioner för det objektet.
Närliggande begrepp
Samla in probdata: Grundläggande användning
Närliggande referens
Probekit-redigeraren
Probekit-exempel