分发库 Jars 时如何包含 scala 代码的 javadoc？

Question

这个问题与从java代码调用scala代码有关。

当我包含一些 scala 库（jar 格式）时，返回类型通常是 scala.collection 类型和其他 Scala 类型。

使用 scala 库在 Java（在 Netbeans 中）进行开发时，在尝试查看 Scala 类型的文档时出现以下“错误”。

找不到Javadoc。此项目的任何 Javadoc 文档都没有
存在或您尚未在 Java 平台管理器中添加指定的 Javadoc
或图书馆管理员。

在分布式 jar 中包含 javadocs（我的代码和 scala 库）的最佳方式是什么？

Answer 1

如果您使用 maven，则对 Scala 的依赖项应该指示插件从存储库中提取 javadocs（以及相关的源代码）。如果您没有使用 maven 进行依赖管理....那么，您应该从现在开始。

顺便说一句，为 Java 公开 Scala 类型不是一个好习惯。您应该将 Scala 代码包装到标准 Java 中。这将极大地增强代码的可维护性，因为使用您的 jar 的开发人员不必费力地将 Java 转换为 Scala 类型。