rt.jar com.sun.istack.internal packages

Question

jre поставляется со многими библиотеками в rt.jar, один из которых является com.sun.istack.internal *. Мне нужна документация com.sun.istack.internal.Nullable ( , которую я нашел в Google CacheBuilder ), и сначала я подумал, что нужно пойти на docs.oracle.com, чтобы найти его документацию, и там я ничего не нашел об этом. Затем пошла в исходную папку, полученную с помощью jdk, и я не нашел объект com name в указанной папке. Затем я взглянул на выпуск jre7 и взглянул на все пакеты и класс и не нашел упоминания о Nullable. Хотя у SO был один mention of it, но ничего конкретного. Я все еще озадачен тем, где, если нужно, получить его документацию и src. Я даже посмотрел документальную документацию sun api у оракула, но об этом не упоминалось. где оракул документирует там политику о портированных пакетах, и они являются стандартными или нестандартными. Они должны были документировать это где-то, это просто, что я занимаю слишком много времени, чтобы добраться туда.

Пожалуйста, укажите меня там.

EDIT: На самом деле javax.annotation.Nullable используется в google CacheBuilder, а не com.sun.istack.internal.Nullable. Также для тех, кто может столкнуться с этой проблемой: javax.annotation.Nullable не является частью Java SE на данный момент и переносится в jsr305 jar. Поэтому, если вы планируете использовать CacheBuilder или просто просматриваете его код, добавьте jsr305 jar в свой путь к классу, иначе eclipse запутаться и укажет вам на com.sun.istack.intenal.Nullable, когда вы наведете курсор на Nullable ,

Answer 1

Вот ссылка на исходный код:

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

(Эта ссылка может сломаться в будущем, но вы должны быть в состоянии найти эквивалент, используя поиск Google.)

Причина, по которой вы не можете найти исходный код или javadocs в стандартных дистрибутивах JDK/JRE, заключается в том, что это класс INTERNAL. Существует давняя стратегия Oracle/Sun, препятствующая разработчикам писать код, зависящий от внутренних классов Java.

FWIW - это всего лишь аннотация, и смысл в значительной степени означает название класса.

---

UPDATE - По-видимому, реальная причина этой путаницы в том, что вы не включили банку JSR305 в вашем buildpath. Это зависимость от CacheBuilder. Завершение класса Eclipse делает все возможное ... но не удается.

Answer 2

Guava не использует com.sun.istack.internal.Nullable. Все, что не зарегистрировано в официальном Java Java javadoc, является внутренним кодом и не должно использоваться в приложениях.

Возможно, вы ищете javax.annotation.Nullable, который является частью JSR305.