NetBeans 11 Javadoc не появляется? - PullRequest
4 голосов
/ 16 мая 2019

У меня есть вопрос, очень похожий на Javadoc не отображаются в сетевых компонентах Apache для Java 10 в том смысле, что я не могу добавить поддержку javadoc в мой выпуск Apache Netbeans 11 или проект maven. над которым я работаю.

Вот мой обзор: Platforms

Как видите, javadoc добавляется в раздел URL, но он не отображается в редакторе кода даже после перезапуска.

URL, который я добавил: https://docs.oracle.com/en/java/javase/11/docs/api/index.html

Но это не работает.

Как я могу решить эту проблему?

Ответы [ 2 ]

4 голосов
/ 17 июня 2019

В то время как Netbeans 11 хорошо работает с apt-пакетом Ubuntu 18 "openjdk-11-jdk", когда дело доходит до всплывающего окна-редактора исходного кода NB и функции "show Javadoc" (которая открывает внешний браузер), оба NB функции не работают в стандартной установке Ubuntu.

Поскольку функции Javadoc в NB кажутся очень не похожими на файловую структуру пакета «openjdk-11-jdk» в «/ usr / lib / jvm / java-11-openjdk-…», которая немного отличается от той, которую можно загрузить из zip-файла Openjdk11 расслоение.

Вот решение для работы обеих функций:

  • Загрузите почтовый пакет Openjdk11 для Linux с веб-сайта Openjdk: https://jdk.java.net/archive/
  • Распакуйте его, чтобы его содержимое находилось в папке, например, например "openjdk11"
  • В NB перейдите в меню «Инструменты → Платформы Java». Добавьте новую платформу и выберите разархивированную папку (например, openjdk11). NB находит правильные исходные папки внутри файла src.zip.

Наконец, в свойстве проекта NB замените в "Библиотеки" "Платформа Java" на недавно добавленную платформу Openjdk11, и теперь всплывающее окно JBadoc NB снова работает.

Чтобы также иметь функциональность NB "show Javadoc", выполните этот дополнительный шаг, пожалуйста:

  • Загрузите ZIP-файл Oracle Javadoc11 и распакуйте его.
  • Теперь снова перейдите к диалогу NB "Платформа Java" и. В ранее добавленной платформе «Openjdk11» перейдите на третью вкладку с именем «Javadoc» и добавьте в качестве папок все подпапки «java *» в папке «doc / api /».

Вот и все. Надеюсь, это поможет.

Кстати, теперь NB по-прежнему работает внутри установленной JVM Openjdk11 Ubuntu (из пакета "openjdk-11-jdk") и получит автоматические обновления apt, однако ваши проекты используют для запуска разархивированную JVM. Однако это не так уж и сложно, поскольку NB всегда использует новый экземпляр своей используемой JVM или JVM проекта для запуска проекта.

0 голосов
/ 31 мая 2019

Я еще не видел кого-то, кому удалось добавить Javadoc 11 в Netbeans 11.

Но есть обходной путь, который, кажется, работает для многих классов JDK, но не для всех. Если кто-нибудь знает, как решить эту проблему для всех классов JDK, скажите, пожалуйста, спасибо.

Вот обходной путь, хорошо работающий под Ubuntu 18 Linux с Openjdk11 из репозитория Ubuntu, и, вероятно, также под другими платформами:


Во-первых, странно, как мы вообще должны добавлять Javadoc. В меню NB Инструменты → Платформы Java есть вкладка Источники и Javadoc .

1) Сначала я попытался использовать вкладку Javadoc , и мне пришлось добавить все папки, начинающиеся с «java». из основной папки "javadoc / api /" из распакованного пакета Javadoc11. Таким образом, некоторые функции JDK показывают правильную всплывающую справку Javadoc, однако многие функции просто показывают пустое пространство, как, например, когда в Netbeans я ввожу:

BigInteger big;
big. _

Затем появляется всплывающее окно со списком всех функций BigInteger, но каждый их Javadoc пуст.

Итак, я попробовал другой подход:


2) Из того же меню NB Инструменты → Платформы Java во вкладке Javadoc Я удалил все записи и использовал другую вкладку Источники где я добавил все папки, начинающиеся с "java". из распакованного исходного пакета Java11 (файл src.zip).

Таким образом, для многих других классов и функций JDK их всплывающее окно отлично работает, как, например, упомянутое BigInterger.

Однако для некоторых классов из пакета java.sql и, возможно, для других тоже я не могу заставить его работать. Например я ввожу в NB:

java.sql.Statement stat;
stat. _

Затем я получаю всплывающее окно со списком всех функций, но для многих есть сообщение Javadoc not found во всплывающем окне. Понравились эти функции:

stat.addBatch(…)
stat.execute(…)
stat.executeUpdate(…)
etc.

Однако для следующих функций во всплывающем окне отображается правильный Javadoc:

stat.cancel(…)
stat.close(…)
stat.executeBatch(…)
etc.
...