我正在使用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);
}
我目前能够在我的ant构建期间通过运行wsgen
生成WSDL来生成工作客户端,然后使用该WSDL文件运行wsimport
来生成客户端文件。这一切都很好,除了当我在生成的客户端文件上运行JavaDoc时,我显然得不到我在接口上定义的文档,或者我的规范对象被传递给方法调用。相反,我直接从我手工编写的接口和规范对象生成文档,并使用JavaDoc。我遇到的问题是自动生成的对象与我定义的包不同。 (com.mysite.webservice instead
)的com.mysite.webservice.spec
。
所以,有两个问题......
1)有没有办法指定我的自动生成对象将放入哪个包?
2)这是构建客户端/生成文档的最佳方法,还是我忽略了使用JAX-WS RI可以实现的更好方法?
3)是否可以直接从Java SEI(服务端点实现)和关联的服务器端类而不是从WSDL生成客户端类。