我正在使用 JAX-WS RI 实现一个新的 Web 服务,并试图找出构建客户端库和自动生成 API 文档的最佳方法。
假设我有一个端点实现(com.mysite.webservice.MyServiceEndpoint),如下所示:
@WebService(serviceName = "MyService", endpointInterface = "com.mysite.webservice.MyService")
public class MyServiceEndpoint implements MyService
{
public void myMethod(final com.mysite.webservice.spec.MyObject blah) {
//Do Something
}
}
和引用的接口(com.mysite.webservice.MyService):
@WebService
public interface MyService {
public void myMethod(final MyObject blah);
}
我目前能够通过运行wsgen
生成 WSDL,然后使用我运行的 WSDL 文件wsimport
来生成客户端文件,从而在我的 ant 构建期间生成一个工作客户端。这一切都很好,除了当我在生成的客户端文件上运行 JavaDoc 时,我显然没有得到任何在接口上定义的文档,或者我的规范对象被传递到方法调用中。相反,我直接从我手工编写并拥有 JavaDoc 的接口和规范对象生成文档。我遇到的问题是自动生成的对象与我定义的对象位于不同的包中。(com.mysite.webservice instead
的com.mysite.webservice.spec
)。
那么,两个问题...
1)有没有办法指定我的自动生成的对象将被放入哪个包中?
2) 这是构建客户端/生成文档的最佳方法,还是我忽略了可以使用 JAX-WS RI 完成的更好方法?
3) 是否可以直接从 Java SEI(服务端点实现)和相关的服务器端类而不是从 WSDL 生成客户端类。