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

Question

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

当我包含一些scala库(jar格式)时,返回类型通常是类型scala.collection和其他Scala类型.

使用scala库在Java(在Netbeans中)进行开发时,在尝试查看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.

在分布式jar中包含javadocs(我的代码和scala-library)的最佳方法是什么？

Answer 1

如果您使用 Maven，那么对 Scala 的依赖应该指示插件从存储库中提取 javadoc（以及相关源）。如果您不使用 Maven 进行依赖管理...那么，您应该现在就开始。

顺便说一句，为 Java 公开 Scala 类型并不是一个好的做法。您应该将 Scala 代码包装到标准 Java 中。它将极大地增强代码的可维护性，因为使用您的 jar 的开发人员不必绞尽脑汁将 Java 转换为 Scala 类型。