Robię program, który ma prezentować jak działa pewna klasa. Chciałbym, żeby ten program min. wyświetlał niektóre metody tej klasy (to już mam) oraz komentarze JavaDoc tych metod (tekst pomiędzy /** */ bezpośrednio nad metodą). Czy można to jakoś w miarę prosto osiągnąć?
0
0
Komentarze są usuwane w procesie kompilacji. Jeżeli jednak załączysz do programu kod źródłowy klasy to można to swobodnie wybrać.
Inna opcja polega na "zdroworozsądkowym" parsowaniu załączonego JavaDoca. Ma on dość standardową strukturę więc mająca nazwę klasy (nazwa pliku) i nazwę metody (nazwa anchora html) można to sobie wyciągnąć.
0
Jeżeli jednak załączysz do programu kod źródłowy klasy to można to swobodnie wybrać.
No powiedzmy, że załączam kod źródłowy tej klasy. I teraz masz na myśli, że mam go odpowiednio sparsować, wyszukując fragmentów, które pasują do wyrażenia regularnego reprezentującego komentarz, a następnie przeanalizować fragment bezpośrenio pod każdym wykrytym komentarzem, żeby sprawdzić, czy dotyczy on tej metody, o którą chodzi? Prościej się już nie da?
0
@DooM77, to jest najprostsza metoda z jaka miałem do czynienia. Kiedyś pisałem taki parser dla JavaScriptu, a tam masz identyczne reguły komentowania.
Uświadomiłem sobie, że można spróbować zrobić to jeszcze inaczej. Jednak nie miałem nigdy do czynienia z tą metodą. DO produkcji JavaDoców używa się czegoś co się nazywa Doclet. Trzeba by przeszukać API powinna być tam już gotowa metoda, która na podstawiepliku źródlowego powinna zwrócić komentarze do klas, pól, metod.