{"id":12231,"date":"2024-11-19T14:49:52","date_gmt":"2024-11-19T13:49:52","guid":{"rendered":"https:\/\/pomoc.comarch.pl\/cee\/640\/?post_type=ht_kb&#038;p=12231"},"modified":"2025-04-22T12:20:58","modified_gmt":"2025-04-22T10:20:58","slug":"debugowanie-klas-dbgcls","status":"publish","type":"ht_kb","link":"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/documentation\/debugowanie-klas-dbgcls\/","title":{"rendered":"Debugowanie klas (dbgcls)"},"content":{"rendered":"<h3 id=\"wprowadzenie\" >Wprowadzenie<\/h3>\n<p>Debugowanie z\u0142o\u017conych sekwencji program\u00f3w wymaga przetwarzania programu krok po kroku i mo\u017cliwo\u015bci \u015bledzenia wynik\u00f3w poszczeg\u00f3lnych wywo\u0142a\u0144. Java oferuje mo\u017cliwo\u015b\u0107 obs\u0142ugi Wirtualnej Maszyny Javy w taki spos\u00f3b, \u017ce program debuguj\u0105cy \u0142\u0105czy si\u0119 poprzez po\u0142\u0105czenie sieciowe i przejmuje kontrol\u0119 nad Wirtualn\u0105 Maszyn\u0105 Javy. Procedura ta oferuje najlepszy mo\u017cliwy wgl\u0105d w sekwencj\u0119 programu, pod warunkiem, \u017ce:<\/p>\n<ul>\n<li>Wirtualna Maszyna Javy musi dzia\u0142a\u0107 w specjalnym trybie, co mo\u017ce wp\u0142yn\u0105\u0107 na og\u00f3ln\u0105 wydajno\u015b\u0107.<\/li>\n<li>Program do debugowania wymaga szybkiego po\u0142\u0105czenia sieciowego z wirtualn\u0105 maszyn\u0105 Java.<\/li>\n<li>Kroki, kt\u00f3re mo\u017cna prze\u015bledzi\u0107, s\u0105 bardzo ma\u0142e, a analiza z\u0142o\u017conych proces\u00f3w wymaga wielu indywidualnych krok\u00f3w r\u0119cznych.<\/li>\n<\/ul>\n<p>Comarch ERP Enterprise zapewnia specjaln\u0105 opcj\u0119 debugowania, aby rozwi\u0105za\u0107 powy\u017csze problemy:<\/p>\n<ul>\n<li>Instrumentacja doskona\u0142ych klas do korzystania z mechanizmu debugowania (u\u017cycie klasy com.cisag.pgm.util.Debug) przez programist\u0119 aplikacji w czasie programowania.<\/li>\n<li>Definiowanie przez programist\u0119 aplikacji w czasie programowania czas\u00f3w, w kt\u00f3rych maj\u0105 miejsce kluczowe kroki z\u0142o\u017conych sekwencji oraz komunikat debugowania opisuj\u0105cy krok i jego parametry.<\/li>\n<li>Mechanizm pe\u0142nego lub cz\u0119\u015bciowego w\u0142\u0105czania lub wy\u0142\u0105czania rejestrowania komunikat\u00f3w debugowania dla klasy lub zestawu klas podczas dzia\u0142ania serwera aplikacji.<\/li>\n<\/ul>\n<p>Narz\u0119dzie <em>dbgcls<\/em> pozwala na ustawianie poziomu debugowania klasy Java lub przestrzeni nazw na serwerze aplikacji. Ustawiaj\u0105c poziom debugowania, wszystkie komunikaty debugowania klasy, kt\u00f3re maj\u0105 maksymalny poziom, s\u0105 rejestrowane w konsoli lub w pliku log\u00f3w serwera aplikacji (w aplikacji <em>Pliki log\u00f3w<\/em>).<\/p>\n<p>Po ustawieniu poziomu debugowania wy\u015bwietlana jest wersja klasy, kt\u00f3ra jest aktywna w \u015bcie\u017cce klasy. Szczeg\u00f3\u0142owe informacje na temat aktywnych klas mo\u017cna uzyska\u0107 za pomoc\u0105 narz\u0119dzia <a href=\"https:\/\/pomoc.comarch.pl\/cee\/index.php\/documentation\/wyswietlenie-klasy-dspcls\/\"><em>dspcls<\/em><\/a>.<\/p>\n<p>Opr\u00f3cz komunikat\u00f3w debugowania, mo\u017cliwe jest r\u00f3wnie\u017c rejestrowanie wszystkich innych komunikat\u00f3w.<\/p>\n<p>Szczeg\u00f3\u0142owy opis mo\u017cna znale\u017a\u0107 w artykule <em><a href=\"https:\/\/pomoc.comarch.pl\/cee\/index.php\/documentation\/debugowanie-menedzera-wiadomosci-dbgmsgmgr\/\">Debugowanie mened\u017cera wiadomo\u015bci dbgmsgmgr<\/a>.<\/em><\/p>\n<p>Podstawowe definicje zwi\u0105zane z obszarem zarz\u0105dzania systemem dost\u0119pne s\u0105\u00a0<em><a href=\"https:\/\/pomoc.comarch.pl\/cee\/index.php\/documentation\/definicje-zarzadzanie-systemem\/\">tutaj<\/a><\/em>.<\/p>\n<h3 id=\"grupa-docelowa\" >Grupa docelowa<\/h3>\n<ul>\n<li>Administratorzy systemu<\/li>\n<li>Konsultanci techniczni<\/li>\n<\/ul>\n<h3 id=\"opis\" >Opis<\/h3>\n<p>Narz\u0119dzie s\u0142u\u017cy do ustawiania poziomu debugowania klasy Java lub przestrzeni nazw na serwerze aplikacji. Po ustawieniu poziomu debugowania wszystkie komunikaty debugowania klasy, kt\u00f3re maj\u0105 maksymalny ten poziom, s\u0105 rejestrowane w konsoliub w pliku log\u00f3w serwera aplikacji (w aplikacji <em>Pliki log\u00f3w<\/em>).\u00a0W przypadku klas, wersja klasy, kt\u00f3ra jest aktywna w \u015bcie\u017cce klasy, jest r\u00f3wnie\u017c wy\u015bwietlana po ustawieniu poziomu.<\/p>\n<h4 id=\"polecenie\" >Polecenie<\/h4>\n<p>Poni\u017cej znajduje si\u0119 polecenie wraz ze wszystkimi mo\u017cliwymi parametrami.<\/p>\n<table style=\"border-collapse: collapse; width: 100%;\">\n<tbody>\n<tr>\n<td style=\"width: 50%; border-style: outset;\">dbgcls<\/td>\n<td style=\"width: 50%; border-style: outset;\">[-class:&lt;text&gt;][-prefix:&lt;str&gt;][-level:&lt;vs&gt;]<\/p>\n<p>[-listLevels]<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h4 id=\"parametry\" >Parametry<\/h4>\n<p>Parametry polecenia zosta\u0142y wyja\u015bnione w poni\u017cszej tabeli. Parametry w nawiasach kwadratowych s\u0105 opcjonalne, podczas gdy pozosta\u0142e s\u0105 parametrami obowi\u0105zkowymi. Gwiazdka (*) mo\u017ce by\u0107 okre\u015blona jako symbol zast\u0119pczy dla niekt\u00f3rych parametr\u00f3w, aby m\u00f3c wy\u015bwietli\u0107 wszystkie mo\u017cliwe warto\u015bci. Nie wszystkie parametry mog\u0105 by\u0107 okre\u015blone wi\u0119cej ni\u017c jeden raz; tylko te z nast\u0119puj\u0105cym dodatkiem do zmiennych parametr\u00f3w s\u0105 dozwolone do wielokrotnego okre\u015blenia: <em>&lt;str-1&gt; &#8230; &lt;str-n&gt;<\/em>.<\/p>\n<table style=\"border-collapse: collapse; width: 100%; height: 254px;\">\n<tbody>\n<tr style=\"height: 23px;\">\n<td style=\"width: 50%; border-style: outset; height: 23px;\"><strong>Parametr<\/strong><\/td>\n<td style=\"width: 50%; border-style: outset; height: 23px;\"><strong>Opis<\/strong><\/td>\n<\/tr>\n<tr style=\"height: 46px;\">\n<td style=\"width: 50%; border-style: outset; height: 46px;\">[-class:&lt;text&gt;]<\/td>\n<td style=\"width: 50%; border-style: outset; height: 46px;\">Klasa, dla kt\u00f3rej ma zosta\u0107 ustawiony poziom debugowania.<\/td>\n<\/tr>\n<tr style=\"height: 46px;\">\n<td style=\"width: 50%; border-style: outset; height: 46px;\">[-prefix:&lt;str&gt;]<\/td>\n<td style=\"width: 50%; border-style: outset; height: 46px;\">Przestrze\u0144 nazw, dla kt\u00f3rej klas i podmenu ma zosta\u0107 ustawiony poziom debugowania.<\/td>\n<\/tr>\n<tr style=\"height: 93px;\">\n<td style=\"width: 50%; border-style: outset; height: 93px;\">[-level:&lt;vs&gt;]<\/td>\n<td style=\"width: 50%; border-style: outset; height: 93px;\">Poziom debugowania, kt\u00f3ry ma zosta\u0107 ustawiony dla wybranej klasy lub wybranej przestrzeni nazw. Domy\u015bln\u0105 warto\u015bci\u0105 jest 100 (rejestrowanie wszystkich komunikat\u00f3w debugowania).<\/td>\n<\/tr>\n<tr style=\"height: 46px;\">\n<td style=\"width: 50%; border-style: outset; height: 46px;\">[-listLevels]<\/td>\n<td style=\"width: 50%; border-style: outset; height: 46px;\">Wy\u015bwietla list\u0119 wszystkich klas i przestrzeni nazw, dla kt\u00f3rych ustawiono poziom debugowania.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h4 id=\"uprawnienia\" >Uprawnienia<\/h4>\n<p>Uprawnienia mog\u0105 zosta\u0107 przypisane za pomoc\u0105 r\u00f3l uprawnie\u0144 jak r\u00f3wnie\u017c poprzez przyporz\u0105dkowanie organizacji. Szczeg\u00f3\u0142owe informacje mo\u017cna znale\u017a\u0107 w artykule\u00a0<a href=\"https:\/\/pomoc.comarch.pl\/cee\/index.php\/documentation\/uprawnienia\/\"><em>Uprawnienia<\/em><\/a>.<\/p>\n<p>Nie ma specjalnych uprawnie\u0144 dla tego narz\u0119dzia.<\/p>\n<section class=\"document-alert-box example\"><div class=\"document-alert-title\">Przyk\u0142ad<\/div><div class=\"document-alert-content\"><\/p>\n<p>Przyk\u0142ady<\/p>\n<ul>\n<li><strong>w\u0142\u0105czenie debugowanie dla klasy:<\/strong> <em>dbgcls: -class:com.cisag.xyz.app.Class<\/em><\/li>\n<li><strong>wy\u0142\u0105czenie debugowanie dla klasy: <\/strong><em>dbgcls: -class:com.cisag.xyz.app.Class -level:1<\/em><\/li>\n<li><strong>wy\u015bwietlenie list\u0119 wszystkich klas z aktywnym debugowaniem:<\/strong> <em>dbgcls: -listLevels<\/em><\/li>\n<\/ul>\n<p><\/div><\/section>\n","protected":false},"author":18,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","meta":{"footnotes":""},"class_list":["post-12231","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-serwer-aplikacji"],"_links":{"self":[{"href":"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/wp-json\/wp\/v2\/ht_kb\/12231","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/wp-json\/wp\/v2\/ht_kb"}],"about":[{"href":"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/wp-json\/wp\/v2\/users\/18"}],"replies":[{"embeddable":true,"href":"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/wp-json\/wp\/v2\/comments?post=12231"}],"version-history":[{"count":10,"href":"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/wp-json\/wp\/v2\/ht_kb\/12231\/revisions"}],"predecessor-version":[{"id":29092,"href":"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/wp-json\/wp\/v2\/ht_kb\/12231\/revisions\/29092"}],"wp:attachment":[{"href":"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/wp-json\/wp\/v2\/media?parent=12231"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}