rt.jar com.sun.istackinternal packages

Question

jre zawiera wiele bibliotek w rt.jar, z których jednym jest com.sun.istack.internal *. Potrzebowałem dokumentacji com.sun.istack.internal.Nullable ( , którą znalazłem, używaną przez google w jej CacheBuilder ) i najpierw pomyślałem, aby przejść do docs.oracle.com, aby znaleźć jego dokumentację i tam nie znalazłem nic o tym. Następnie poszedłem do folderu źródłowego z jdk i nie znalazłem nazwy podmiotu w tym folderze. Następnie przyjrzałem się wersji jre7 i przyjrzałem się wszystkim paczkom i klasom i nie znalazłem tam wzmianki o Nullable. Chociaż SO miał jeden mention of it, ale nic konkretnego. Wciąż jestem zaintrygowany, skąd wziąć jego dokumentację i src, jeśli to konieczne. Nawet wyglądałem na legendarną dokumentację Sun api w wyroczni, ale nic o tym nie wspomniałem. gdzie oracle dokumentuje zasady dotyczące pakietów przeniesionych i ich standard lub nie-standard. Musi to udokumentować gdzieś po prostu, że poświęcam zbyt dużo czasu, aby się tam dostać.

Proszę wskazać mi tam.

EDYCJA: W rzeczywistości javax.annotation.Nullable jest używany w google CacheBuilder, a nie com.sun.istack.internal.Nullable. Również dla kogoś, kto może napotkać ten problem: javax.annotation.Nullable nie jest obecnie częścią Java SE i jest przenoszony w słoju jsr305. Więc jeśli planujesz użyć CacheBuilder lub po prostu przechodząc przez jego kod, dodaj jar jsr305 w ścieżce klasy, w przeciwnym razie eclipse się pomyli i wskaże ci com.sun.istack.intenal.Nullable, gdy tylko najedziesz kursorem na Nullable .

Answer 1

Tu jest link do kodu źródłowego:

• http://grepcode.com/file/repository.grepcode.com/java/root/jdk/openjdk/8u40-b25/com/sun/istack/internal/Nullable.java/

(Ten link może pęknąć w przyszłości, ale powinieneś być w stanie znaleźć odpowiednik za pomocą wyszukiwarki Google).

Powodem, dla którego nie można znaleźć kodu źródłowego lub javadocs w standardowych dystrybucjach JDK/JRE jest to, że jest to klasa INTERNAL. Istnieje długoletnia polityka Oracle/Sun zniechęcająca programistów do pisania kodu, który jest zależny od wewnętrznych klas Java.

FWIW - to tylko adnotacja, a znaczenie jest tym, co sugeruje nazwa klasy.

---

UPDATE - Wydaje się, że prawdziwą przyczyną tego zamieszania jest to, że nie zawiera w swoim słoik JSR305 buildpath. Jest to zależność dla CacheBuilder. Realizacja nazwy klasy Eclipse działa najlepiej, ale kończy się niepowodzeniem.

Answer 2

Guava nie używa com.sun.istack.internal.Nullable. Wszystko, co nie jest udokumentowane w oficjalnym javadoc Java SE, jest wewnętrznym kodem i nie powinno być używane w aplikacjach.

Prawdopodobnie szukasz javax.annotation.Nullable, która jest częścią JSR305.