Aby utworzyć sondę, najpierw należy utworzyć plik źródłowy pakietu Probekit (plik probe). Następnie, w pliku źródłowym pakietu Probekit, należy utworzyć sondę i dodać treść definiującą jej sposób działania.
Aby utworzyć plik źródłowy pakietu Probekit, należy użyć kreatora pliku źródłowego pakietu Probekit. Następnie można utworzyć sondę i wpisać większą część jej definicji przy użyciu tego kreatora lub przejść bezpośrednio do edytora pakietu Probekit. W każdym przypadku należy użyć edytora pakietu Probekit w celu wpisania fragmentu kodu w języku Java.
Szczegółowe informacje na temat poszczególnych części sondy zawiera sekcja Definicje sond.
- Aby utworzyć plik źródłowy pakietu Probekit:
- W widoku Nawigator lub Eksplorator pakietów kliknij prawym przyciskiem myszy projekt Java, który ma zawierać plik źródłowy, a następnie kliknij polecenie .
- Na stronie Wybieranie kreatora rozwiń opcję Profilowanie i rejestrowanie, a następnie wybierz opcję Plik źródłowy pakietu Probekit.
- Kliknij przycisk Dalej.
- W kreatorze Tworzenie nowego pliku sondy, w polu Nazwa pliku wpisz nazwę nowego pliku źródłowego sondy. Rozszerzeniem nazwy pliku w przypadku plików źródłowych pakietu Probekit musi być .probe.
- W polu Folder źródłowy wprowadź folder źródłowy projektu, który będzie zawierał nowy plik źródłowy pakietu Probekit.
Uwaga: Pliki źródłowe pakietu Probekit muszą znajdować się w folderze źródłowym projektu, który jest folderem najwyższego poziomu. Pliki te nie mogą znajdować się w podfolderze.
- Aby teraz zakończyć pracę kreatora i przy użyciu edytora pakietu Probekit utworzyć sondę oraz jej definicję:
- Wybierz opcję Brak treści.
- Kliknij przycisk Zakończ. Nowy plik źródłowy pakietu Probekit zostanie dodany do folderu źródłowego projektu i zgodnie z ustawieniem domyślnym zostanie on automatycznie otwarty w edytorze pakietu Probekit.
- Przejdź do kroku 4.
- Jeśli chcesz w dalszym ciągu korzystać z kreatora ułatwiającego tworzenie definicji sondy:
- Wybierz opcję Sonda metody lub Sonda miejsca wywołania.
- Wybierz wartość Typ fragmentu dla fragmentu, który ma zostać utworzony przez kreatora.
- Kliknij przycisk Dalej.
- Za pomocą przycisków Dodaj i Edytuj zdefiniuj dowolną liczbę elementów danych.
Po dodaniu lub wybraniu elementu kreator wyświetli jego opis.
Uwaga: W przypadku przejścia wstecz i zmodyfikowania typu tworzonej sondy lub typu fragmentu do wstawienia, edytor wyświetli prośbę o usunięcie wszystkich elementów, które nie mają już zastosowania.
- Kliknij przycisk Zakończ. Nowy plik źródłowy pakietu Probekit zostanie dodany do folderu źródłowego projektu i zgodnie z ustawieniem domyślnym zostanie on automatycznie otwarty w edytorze pakietu Probekit.
- Opcjonalnie: Na stronie Ogólne edytora pakietu Probekit w polu Identyfikator wprowadź unikalny identyfikator sondy, w polu Wersja wprowadź numer wersji oraz wprowadź także wartości dla etykiety. Dane te są potrzebne wyłącznie na potrzeby identyfikowania sondy w konfiguracji profilowania.
- Kliknij kartę Sondy.
- Jeśli sonda nie była tworzona przy użyciu kreatora, kliknij prawym przyciskiem myszy lewą stronę edytora pakietu Probekit i wybierz polecenie Dodaj sondę. Nowa sonda powinna zostać utworzona w panelu drzewa na lewym brzegu strony.
- Kliknij prawym przyciskiem myszy sondę na panelu drzewa, a następnie kliknij opcję . Nowy fragment zostanie wyświetlony na panelu drzewa jako element potomny sondy, a na panelu edycji na prawym brzegu strony zostaną wyświetlone pola właściwości tego fragmentu.
- Na panelu edycji wybierz wartość Typ fragmentu, a następnie wpisz kod Java dla fragmentu sondy. Szczegółowe informacje na ten temat zawiera sekcja Typy fragmentów sondy.
- Kontynuuj definiowanie sondy, klikając prawym przyciskiem myszy elementy w drzewie, dodając lub usuwając elementy potomne przy użyciu menu podręcznego i wpisując wartości dla nowych elementów na panelu edycji. W menu podręcznym wyświetlane są tylko te elementy, które są poprawne w przypadku miejsca wybranego w drzewie. Jeśli element jest poprawny, ale nie można już dodać go w wybranym miejscu, jest on wyłączony w menu.
Uwaga: Podczas wpisywania wartości w polu właściwości Dyrektywa importu należy wpisać tylko nazwę pakietu lub klasy do zaimportowania. Nie należy wpisywać parametru import ani średnika (;) na końcu.
- Po zakończeniu definiowania sondy kliknij opcję .
Uwaga: Podczas zapisywania pliku źródłowego pakietu Probekit edytor pakietu Probekit sprawdza składnię wszystkich elementów w języku Java znajdujących się w pliku i zgłasza wszystkie problemy javac. Jeśli wpis powoduje wygenerowanie błędu lub ostrzeżenia, odpowiednia ikona w drzewie zmienia się w ikonę błędu lub ostrzeżenia. Problemy javac są wyświetlane w tabeli u dołu strony Sondy. Aby aktywować element na potrzeby edycji, należy kliknąć go dwukrotnie w tej tabeli.