Praca z przykładem rejestrowania dla JSR-047

Przykład pokazuje obsługę zdarzeń zgodnych z modelem Common Base Event na platformie TPTP z wykorzystaniem API rejestrowania JSR-047 zaimplementowanych w pakiecie JDK w wersji 1.4.0 lub nowszej (tzn. java.util.logging). Z punktu widzenia użytkownika rekordy dziennika w formacie Common Base Event są zapisywane na konsolę i do agenta rejestrowania.

Jeśli nie zostało to zrobione wcześniej, utwórz przykład wybierając z menu Plik > Nowy > Przykład... > Przykład rejestrowania JSR-047.

Przykład zawiera kod źródłowy Java, zależności (z wyjątkiem klas java.util.logging) oraz plik konfiguracyjny potrzebne do rejestrowania modelu Common Base Event w programie rejestrującym JSR-047 zaimplementowanym w pakiecie JDK w wersji 1.4.0 lub nowszej (tzn. java.util.logging).

Do skompilowania i wykonania tego przykładu jest potrzebne środowisko JRE w wersji 1.4.0 lub nowszej (tzn. java.util.logging).

Założenia

  1. W przypadku uruchamiania tej aplikacji z poziomu perspektywy środowiska roboczego Profilowanie i rejestrowanie, aplikacja lub usługa komponentu Agent Controller jest już skonfigurowana pod kątem korzystania ze środowiska JRE w wersji 1.4.0 lub nowszej.
  2. Zmienna środowiskowa java.util.logging.config.file jest ustawiona na ścieżkę bezwzględną i nazwę pliku konfiguracyjnego mechanizmu rejestrowania JSR-047 (czyli java.util.logging), noszącego nazwę HyadesLoggingJava14Sample.properties. Może to na przykład być <obszar_roboczy>/LoggingJava14Project/cfg/HyadesLoggingJava14Sample.properties.

Uruchamianie

Aby uruchomić ten przykład i automatycznie przyłączyć się do agenta rejestrowania, wykonaj następujące czynności:
  1. Jeśli domyślne środowisko JRE środowiska roboczego nie jest w wersji 1.4.0 lub nowszej, zmodyfikuj nowo utworzony projekt Java (tzn. LoggingJava14Project) pod kątem kompilowania i wykonywania go przy użyciu środowiska JRE w wersji 1.4.0 lub nowszej (Projekt > Właściwości > Ścieżka budowania Java > Biblioteki > JRE_LIB > Usuń > Dodaj bibliotekę > Biblioteka systemowa środowiska JRE > Dalej > Alternatywne środowisko JRE > Zainstalowane środowiska JRE > Dodaj > Katalog główny środowiska JRE > Przeglądaj > [JRE w wersji 1.4.0 lub nowszej] > OK > OK > OK > Zakończ > OK).
  2. Upewnij się, że wszystkie błędy kompilacji zostały poprawione.
  3. Jeśli używana jest autonomiczna instalacja komponentu Agent Controller, upewnij się, że jest ona uruchomiona (krok nieobowiązkowy). Alternatywnie można skorzystać z połączenia bezpośredniego, czyli ograniczonego zestawu usług komponentu Agent Controller dostarczanego ze środowiskiem roboczym.
  4. Otwórz perspektywę Profilowanie i rejestrowanie (Okna > Otwórz perspektywę > Inne > Profilowanie i rejestrowanie).
  5. Z perspektywy Profilowanie i rejestrowanie uruchom nową klasę (Wykonaj > Profiluj... > Utwórz nową konfigurację wykonania typu Aplikacja Java > Jako nazwę projektu podaj nazwę projektu przykładowego > Jako klasę main podaj HyadesLoggingJava14Sample > Przejdź do karty argumentów i ustaw następującą właściwość maszyny wirtualnej: -Djava.util.logging.config.file="<obszar_roboczy>/HyadesLoggingJava14Project/cfg/HyadesLoggingJava14Sample.properties" > Przejdź do karty Monitor > Anuluj wybór opcji "Profilowanie Java " i wybierz opcję "Agent Discoverer" > Profluj).
  6. Agent rejestrowania powinien zostać automatycznie wykryty i przyłączony po kilku sekundach. Wybierz wykrytego agenta rejestrowania i z perspektywy Profilowanie i rejestrowanie otwórz widok dziennika, aby wyświetlić zarejestrowane rekordy dziennika w formacie Common Base Event (Okna > Pokaż widok > Inne... > Profilowanie i rejestrowanie > Widok dziennika > OK).
  7. Odśwież widok dziennika w perspektywie Profilowanie i rejestrowanie (prawym przyciskiem myszy kliknij agenta rejestrowania HyadesLoggingJava14Sample > Odśwież).

Można też uruchomić przykład i ręcznie przyłączyć się do agenta rejestrowania. W tym celu wykonaj następujące czynności:

  1. Jeśli domyślne środowisko JRE środowiska roboczego nie jest w wersji 1.4.0 lub nowszej, zmodyfikuj nowo utworzony projekt Java (tzn. LoggingJava14Project) pod kątem kompilowania i wykonywania go przy użyciu środowiska JRE w wersji 1.4.0 lub nowszej (Projekt > Właściwości > Ścieżka budowania Java > Biblioteki > JRE_LIB > Usuń > Dodaj bibliotekę > Biblioteka systemowa środowiska JRE > Dalej > Alternatywne środowisko JRE > Zainstalowane środowiska JRE > Dodaj > Katalog główny środowiska JRE > Przeglądaj > [JRE w wersji 1.4.0 lub nowszej] > OK > OK > OK > Zakończ > OK).
  2. Upewnij się, że wszystkie błędy kompilacji zostały poprawione.
  3. Jeśli używana jest autonomiczna instalacja komponentu Agent Controller, upewnij się, że jest ona uruchomiona (krok nieobowiązkowy). Alternatywnie można skorzystać z połączenia bezpośredniego, czyli ograniczonego zestawu usług komponentu Agent Controller dostarczanego ze środowiskiem roboczym.
  4. Wykonaj przykładową klasę z perspektywy Java (Wykonaj > Wykonaj... > Utwórz nową konfigurację wykonania typu Aplikacja Java > Klasa main > Szukaj... > HyadesLoggingJava14Sample > OK > Przejdź do karty argumentów i ustaw następującą właściwość maszyny wirtualnej: -Djava.file="file:/<obszar_roboczy>/HyadesLoggingJava14Project/cfg/HyadesLoggingJava14Sample.properties" > Wykonaj).
  5. Otwórz perspektywę Profilowanie i rejestrowanie (Okna > Otwórz perspektywę > Inne > Profilowanie i rejestrowanie).
  6. Przyłącz się do agenta rejestrowania HyadesLoggingJava14Sample w perspektywie Profilowanie i rejestrowanie (Wykonaj > Profiluj... > Przyłącz - Proces Java > Nowa > Karta Host > Jeśli nie jest używana autonomiczna instalacja komponentu Agent Controller, wybierz opcję Lokalne połączenie bezpośrednie. W przeciwnym razie podaj poprawną nazwę hosta i port. > Karta Agenty > Dwukrotnie kliknij agenta HyadesLoggingJava14Sample > Wybierz kartę Miejsce docelowe > Projekt profilowania > Przeglądaj... > HyadesLoggingJava14Sample > OK > Profiluj).
  7. Rozpocznij monitorowanie agenta rejestrowania HyadesLoggingJava14Sample (<kliknij prawym przyciskiem myszy agenta rejestrowania HyadesLoggingJava14Sample> > Rozpocznij monitorowanie).
  8. Otwórz widok dziennika w perspektywie Profilowanie i rejestrowanie, aby wyświetlić zarejestrowane rekordy dziennika modelu Common Base Event (Okna > Pokaż widok > Inne > Profilowanie i rejestrowanie > Widok dziennika > OK).
  9. Odśwież widok dziennika w perspektywie Profilowanie i rejestrowanie (<kliknij prawym przyciskiem myszy agenta rejestrowania HyadesLoggingJava14Sample > > Odśwież).