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
- 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.
- 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:
- 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).
- Upewnij się, że wszystkie błędy kompilacji zostały poprawione.
- 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.
- Otwórz perspektywę Profilowanie i rejestrowanie (Okna > Otwórz perspektywę > Inne > Profilowanie i rejestrowanie).
-
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).
- 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).
- 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:
- 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).
- Upewnij się, że wszystkie błędy kompilacji zostały poprawione.
- 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.
-
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).
- Otwórz perspektywę Profilowanie i rejestrowanie (Okna > Otwórz perspektywę > Inne > Profilowanie i rejestrowanie).
- 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).
- Rozpocznij monitorowanie agenta rejestrowania HyadesLoggingJava14Sample (<kliknij prawym przyciskiem myszy agenta rejestrowania HyadesLoggingJava14Sample> > Rozpocznij monitorowanie).
- 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).
- Odśwież widok dziennika w perspektywie Profilowanie i rejestrowanie (<kliknij prawym przyciskiem myszy agenta rejestrowania HyadesLoggingJava14Sample > > Odśwież).
(C) Copyright IBM Corporation 2000, 2006.