使用JAX-WS RI生成客户端库和JavaDoc

时间:2012-09-11 20:50:03

标签: java jax-ws

我正在使用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生成客户端类。

0 个答案:

没有答案