Vytváření sond

Chcete-li vytvořit sondu, nejdříve vytvořte zdrojový soubor pro Probekit (soubor sondy). Poté ve zdrojovém souboru pro Probekit vytvořte sondu a přidejte obsah definující funkci sondy.

Chcete-li vytvořit zdrojový soubor pro Probekit, musíte použít průvodce zdrojovým souborem pro Probekit. Pomocí průvodce můžete také vytvořit sondu a zapsat větší část definice sondy, nebo můžete přejít přímo do editoru Probekit. V obou případech musíte použít editor Probekit k zápisu fragmentu kódu Java pro daný kód.

Podrobné informace o různých částech sondy viz Definice sond.

  1. Chcete-li vytvořit zdrojový soubor Probekit:
    1. V pohledu Navigátor nebo Průzkumník balíčků klepněte pravým tlačítkem myši na svůj projekt Java, který má obsahovat zdrojový soubor, a poté klepněte na Nový > Jiné.
    2. Na stránce Vybrat průvodce rozbalte položku Profilování a protokolování a vyberte Zdrojový soubor pro Probekit.
    3. Klepněte na Další.
    4. V průvodci Vytvořit nový soubor sondy zadejte název pro nový zdrojový soubor sondy do pole Název souboru. Přípona názvu souboru u zdrojových souborů pro Probekit musí být .probe.
    5. V poli Zdrojová složka zadejte zdrojovou složku projektu, která má obsahovat nový zdrojový soubor Probekit.
      Poznámka: Zdrojové soubory Probekit se musí zobrazovat v nejvyšší úrovni zdrojové složky projektu, nemohou být v podsložce.
  2. Chcete-li nyní opustit průvodce a použít editor Probekit k vytvoření sondy a její definice:
    1. Zvolte Žádný obsah.
    2. Klepněte na Dokončit. Nový zdrojový soubor Probekit se přidá do zdrojové složky projektu a ve výchozím nastavení se automaticky otevře v editoru Probekit.
    3. Pokračujte krokem 4.
  3. Chcete-li pokračovat pomocí průvodce při vytváření definice sondy:
    1. Zvolte Sonda Method nebo Sonda Callsite.
    2. Zvolte hodnotu Typ fragmentu pro fragment, který má průvodce vytvořit.
    3. Klepněte na Další.
    4. Pomocí tlačítek Přidat a Upravit definujte libovolný požadovaný počet datových položek. Pokud přidáte nebo vyberete položku, průvodce zobrazí její popis.
      Poznámka: Pokud se vrátíte zpět a změníte typ vytvářené sondy nebo typ fragmentu, který se má vložit, editor vás požádá o zrušení všech položek, které již neplatí.
    5. Klepněte na Dokončit. Nový zdrojový soubor Probekit se přidá do zdrojové složky projektu a ve výchozím nastavení se automaticky otevře v editoru Probekit.
  4. Volitelné: Na stránce Obecné editoru Probekit zadejte řetězec jedinečného ID pro sondu do pole ID, číslo verze do pole Verze a hodnoty pro štítek. Tyto údaje jsou určeny pouze pro vaše použití při identifikaci sondy v konfiguraci profilování.
  5. Klepněte na kartu Sondy.
  6. Pokud jste k vytvoření sondy nepoužili průvodce, klepněte pravým tlačítkem myši na levé straně editoru Probekit a vyberte Přidat sondu. Nová sonda by měla být vytvořena v levém podokně stromu na levé straně stránky.
  7. Klepněte pravým tlačítkem myši na sondu v podokně stromu, potom klepněte na Nový > Fragment. Nový fragment se zobrazí v podokně stromu jako podřízený prvek sondy a pole vlastností pro fragment se zobrazí v podokně úprav na pravé straně stránky.
  8. V podokně úprav zvolte hodnotu Typ fragmentu a poté zadejte kód Java pro fragment sondy. Specifické informace viz Typy fragmentů sond.
  9. Pokračujte v definování sondy klepnutím pravým tlačítkem myši na položky ve stromu, použitím místní nabídky k přidání či odebrání podřízených položek a zadáním hodnot pro nové položky v podokně úprav. Místní nabídka zobrazuje pouze položky, které jsou platné pro umístění zvolené ve stromu. Pokud je položka platná, ale nelze ji dále přidávat do zvoleného umístění, položka není v nabídce zpřístupněna.
    Poznámka: Pokud zadáváte hodnotu do pole vlastností Importovat direktivu, zadejte pouze název balíčku nebo třídy, které chcete importovat. Nezadávejte klíčové slovo import nebo koncový středník (;).
  10. Po dokončení definování sondy klepněte na volby Soubor > Uložit.
    Poznámka: Pokud uložíte zdrojový soubor Probekit, editor Probekit zkontroluje syntaxi všech prvků Java v souboru a ohlásí jakékoli problémy s javac. Pokud dojde k jakékoli chybě nebo varování pro dané zadání, odpovídající ikona ve stromu se změní na chybovou nebo varovnou ikonu. Problémy s Javac se zobrazí v tabulce u spodního okraje stránky Sondy. Dvojím klepnutím na danou položku v tabulce přejdete k její úpravě.
Související pojmy
Shromažďování dat sond: Základní použití
Související odkazy
Editor Probekit
Příklady Probekit