我创建了一个 Web 服务并希望为 API 生成文档。所以我查看了Enunciate下载了 maven enunciate 插件。但是,我在编译时收到以下错误,因为 web 服务注释在我的 POJO 实现的接口类上,而不是 POJO 本身。
我不想通过向 POJO 添加注释来弄乱 POJO。 工件 org.mortbay.jetty:maven-jetty-plugin:检查来自中央的更新 [信息] [阐明:文档{执行:默认}] [INFO] 初始化发音。 [INFO] 调用发音:生成步骤... [警告] 验证结果有错误。 /Users/vkumar/IdeaProjects/identity-service/trunk/src/main/java/com/foobar/ids/service/IDService.java:17:[jersey] Jersey 不支持将接口作为根资源。 @Path 参数需要应用于实现类。 公共接口 IDService { ^ 1 个错误 [信息] --------------------------------------------- -------------------------
pom.xml 片段在这里
<plugin>
<groupId>org.codehaus.enunciate</groupId>
<artifactId>maven-enunciate-plugin</artifactId>
<!-- check for the latest version -->
<version>1.20</version>
<executions>
<execution>
<goals>
<goal>docs</goal>
</goals>
<configuration>
<!-- the directory where to put the docs -->
<docsDir>${project.build}/docs </docsDir>
</configuration>
</execution>
</executions>
</plugin>