Czytanie javadocow

Czytanie javadocow
LU
  • Rejestracja:ponad 11 lat
  • Ostatnio:około 20 godzin
  • Lokalizacja:Gdańsk
0

Czy znacie jakiś fajny sposób czytania javadocow?
Przykładowo mamy bibl. pdfbox.
Pakietów jest dużo, czy można jakimś sprytnym sposobem przefiltrować i znaleźć
te publiczne pakiety / klasy tzn. przeznaczone przez twórców do wykorzystania przed programiste klienta.
Zwykle w bibliotekach jest dziesiątki / setki klas (duzo...), jak znależć te kilka, które tworzą wspólnie "fasadę"?


jarekr000000
  • Rejestracja:ponad 8 lat
  • Ostatnio:33 minuty
  • Lokalizacja:U krasnoludów - pod górą
  • Postów:4707
3

Nie.
Albo biblioteka ma sensowne: readme, getting started, cook book, examples, stack overflow...
Albo płacz.

Do javadoców zagląda się jak wszystkie sposoby zawiodą.

W przypadku tego pdfboxa masz cookbook do wersji 1.8
https://pdfbox.apache.org/1.8/cookbook/documentcreation.html
a dalej trzeba sobie radzić.


jeden i pół terabajta powinno wystarczyć każdemu
edytowany 1x, ostatnio: jarekr000000
jarekr000000
@wartek01: jeśli aby skorzystać zbiblioteki muszę zaglądać do javadoców to w zasadzie od razu ma ona potężny minus. Jeśli sygnatura, a w ostateczności to jedno zdanie z javadoca (first line), które się wyświetla w IDE jako podpowiedź nie wystarcza - to bardzo zły znak.
Wibowit
  • Rejestracja:około 20 lat
  • Ostatnio:około 8 godzin
1

Do JavaDoców to się raczej zagląda jak chcesz się upewnić co dana klasa czy metoda robi w trakcie gdy już piszesz kod. W rzadkich przypadkach (czyli w porządnie dopicowanych JavaDocach) JavaDoc zawiera jakiś konkretny opis architektury przydatny do nauki przed pisaniem kodu, np tutaj w opisie paczki java.util.stream jest wprowadzenie do Streamów z Javy 8: https://docs.oracle.com/javase/8/docs/api/java/util/stream/package-summary.html


"Programs must be written for people to read, and only incidentally for machines to execute." - Abelson & Sussman, SICP, preface to the first edition
"Ci, co najbardziej pragną planować życie społeczne, gdyby im na to pozwolić, staliby się w najwyższym stopniu niebezpieczni i nietolerancyjni wobec planów życiowych innych ludzi. Często, tchnącego dobrocią i oddanego jakiejś sprawie idealistę, dzieli od fanatyka tylko mały krok."
Demokracja jest fajna, dopóki wygrywa twoja ulubiona partia.
edytowany 2x, ostatnio: Wibowit
Shalom
  • Rejestracja:około 21 lat
  • Ostatnio:około 3 lata
  • Lokalizacja:Space: the final frontier
  • Postów:26433
1

@lookacode1 albo szukaj jakiegoś how-to albo szukaj testów w repo, czytanie javadoców raczej niewiele da.


"Nie brookliński most, ale przemienić w jasny, nowy dzień najsmutniejszą noc - to jest dopiero coś!"

Zarejestruj się i dołącz do największej społeczności programistów w Polsce.

Otrzymaj wsparcie, dziel się wiedzą i rozwijaj swoje umiejętności z najlepszymi.