Как включить javadoc кода Scala при распространении библиотечных Jars?

Этот вопрос связан с вызовом кода scala из кода java.

Когда я включаю некоторую библиотеку scala (в формате jar), возвращаемые типы часто имеют тип scala.collection и другие типы Scala.

При разработке на Java (в Netbeans) с использованием библиотек scala я получаю следующую «ошибку» при попытке просмотреть документацию для типов Scala.

Javadoc not found. Either Javadoc documentation for this item does not
exist or you have not added specified Javadoc in the Java Platform Manager
or the Library Manager.

как лучше всего включить javadocs (моего кода и scala-библиотеки) в распределенные jar-файлы?


person Jus12    schedule 07.06.2011    source источник


Ответы (1)


Если вы используете maven, зависимость от Scala должна указывать плагину на получение документации javadoc (и источника в этом случае) из репозитория. Если вы не используете maven для управления зависимостями ... Что ж, вам следует начать сейчас.

Кстати, раскрытие типов Scala для Java - не лучшая практика. Вам следует обернуть свой Scala-код в стандартную Java. Это значительно улучшит ремонтопригодность кода, поскольку разработчикам, использующим ваши jar-файлы, не придется ломать голову, переводя Java в типы Scala.

person Cloves Almeida    schedule 14.06.2011
comment
Я могу обернуть примитивные типы Scala в Java, но для некоторых типов в моем собственном коде Scala это будет довольно утомительно. - person Jus12; 15.06.2011