Wprowadzenie
Debugowanie złożonych sekwencji programów wymaga przetwarzania programu krok po kroku i możliwości śledzenia wyników poszczególnych wywołań. Java oferuje możliwość obsługi Wirtualnej Maszyny Javy w taki sposób, że program debugujący łączy się poprzez połączenie sieciowe i przejmuje kontrolę nad Wirtualną Maszyną Javy. Procedura ta oferuje najlepszy możliwy wgląd w sekwencję programu, pod warunkiem, że:
- Wirtualna Maszyna Javy musi działać w specjalnym trybie, co może wpłynąć na ogólną wydajność.
- Program do debugowania wymaga szybkiego połączenia sieciowego z wirtualną maszyną Java.
- Kroki, które można prześledzić, są bardzo małe, a analiza złożonych procesów wymaga wielu indywidualnych kroków ręcznych.
Comarch ERP Enterprise zapewnia specjalną opcję debugowania, aby rozwiązać powyższe problemy:
- Instrumentacja doskonałych klas do korzystania z mechanizmu debugowania (użycie klasy com.cisag.pgm.util.Debug) przez programistę aplikacji w czasie programowania.
- Definiowanie przez programistę aplikacji w czasie programowania czasów, w których mają miejsce kluczowe kroki złożonych sekwencji oraz komunikat debugowania opisujący krok i jego parametry.
- Mechanizm pełnego lub częściowego włączania lub wyłączania rejestrowania komunikatów debugowania dla klasy lub zestawu klas podczas działania serwera aplikacji.
Narzędzie dbgcls pozwala na ustawianie poziomu debugowania klasy Java lub przestrzeni nazw na serwerze aplikacji. Ustawiając poziom debugowania, wszystkie komunikaty debugowania klasy, które mają maksymalny poziom, są rejestrowane w konsoli lub w pliku logów serwera aplikacji (w aplikacji Pliki logów).
Po ustawieniu poziomu debugowania wyświetlana jest wersja klasy, która jest aktywna w ścieżce klasy. Szczegółowe informacje na temat aktywnych klas można uzyskać za pomocą narzędzia dspcls.
Oprócz komunikatów debugowania, możliwe jest również rejestrowanie wszystkich innych komunikatów.
Podstawowe definicje związane z obszarem zarządzania systemem dostępne są tutaj.
Grupa docelowa
- Administratorzy systemu
- Konsultanci techniczni
Opis
Narzędzie służy do ustawiania poziomu debugowania klasy Java lub przestrzeni nazw na serwerze aplikacji. Po ustawieniu poziomu debugowania wszystkie komunikaty debugowania klasy, które mają maksymalny ten poziom, są rejestrowane w konsoliub w pliku logów serwera aplikacji (w aplikacji Pliki logów). W przypadku klas, wersja klasy, która jest aktywna w ścieżce klasy, jest również wyświetlana po ustawieniu poziomu.
Polecenie
Poniżej znajduje się polecenie wraz ze wszystkimi możliwymi parametrami.
| dbgcls | [-class:<text>]
[-prefix:<str>] [-level:<vs>] [-listLevels] |
Parametry
Parametry polecenia zostały wyjaśnione w poniższej tabeli. Parametry w nawiasach kwadratowych są opcjonalne, podczas gdy pozostałe są parametrami obowiązkowymi. Gwiazdka (*) może być określona jako symbol zastępczy dla niektórych parametrów, aby móc wyświetlić wszystkie możliwe wartości. Nie wszystkie parametry mogą być określone więcej niż jeden raz; tylko te z następującym dodatkiem do zmiennych parametrów są dozwolone do wielokrotnego określenia: <str-1> … <str-n>.
| Parametr | Opis |
| [-class:<text>] | Klasa, dla której ma zostać ustawiony poziom debugowania. |
| [-prefix:<str>] | Przestrzeń nazw, dla której klas i podmenu ma zostać ustawiony poziom debugowania. |
| [-level:<vs>] | Poziom debugowania, który ma zostać ustawiony dla wybranej klasy lub wybranej przestrzeni nazw. Domyślną wartością jest 100 (rejestrowanie wszystkich komunikatów debugowania). |
| [-listLevels] | Wyświetla listę wszystkich klas i przestrzeni nazw, dla których ustawiono poziom debugowania. |
Uprawnienia
Nie ma specjalnych uprawnień dla tego narzędzia.
Przykłady
- włączenie debugowanie dla klasy: dbgcls: -class:com.cisag.xyz.app.Class
- wyłączenie debugowanie dla klasy: dbgcls: -class:com.cisag.xyz.app.Class -level:1
- wyświetlenie listę wszystkich klas z aktywnym debugowaniem: dbgcls: -listLevels
