jax-ws wsimport 命令详解

通过 -b  参数可以指定多个 JAX-WS 和 JAXB 的绑定文件 ，这可以用来定制各种选项： 包名, 类名, 等. 

更多的使用细节可以查看：http://jax-ws.java.net/nonav/2.2.7/docs/ch04.html#tools-wsimport

 

Option	Description
-d	指定输出目录
-b	指定JAXWS或者JAXB的绑定文件，可以多个
-B	指定JAXB的参数，透传给JAXB命令
-catalog	绑定外部WSDL或XSD，解决外部WSDL或者XSD引用
-extension	Allow vendor extensions (functionality not specified by the specification). Use of extensions may result in applications that are not portable or may not interoperate with other implementations.
-help	显示帮助
-httpproxy::	指定一个HTTP代理
-keep	保留源文件
-p	指定包名
-s	指定源代码存放目录
-encoding	指定编码格式，例如UTF-8
-verbose	指定输出命令执行的详细信息
-version	显示版本
-fullversion	显示详细的版本信息
-clientjar	Creates the jar file of the generated artifacts along with the WSDL metadata required for invoking the web service.
-wsdllocation	@WebServiceClient.wsdlLocation value.
-target	指定JAX-WS的版本，默认是 2.2.
-quiet	静默执行该命令，不在屏幕输出信息
-XadditionalHeaders	Map the headers not bound to request or response message to Java method parameters.
-Xauthfile	File to carry authorization information in the format http://username:[email protected]/stock?wsdl. Default value is $HOME/.metro/auth
-Xdebug	显示DEBUG信息
-XdisableAuthenticator	Disables Authenticator used by JAX-WS RI, -Xauthfile option will be ignored if -XdisableAuthenticatoris set.
-Xno-addressing-databinding	不使用JDK的Addressing，生成自己的EndpointReferenceType
-Xnocompile	不编译生成的源码
-XdisableSSLHostnameVerification	Disbales the SSL Hostname verification while fetching the wsdls.

 

wsimport不区分cient端和server端，发布出来就是一套代码

【举例】

wsimport -b jaxws_binding.xml -catalog jaxws_catalog.xml -Xno-addressing-databinding -extension -keep -d server\bin -s server\src example.wsdl

【说明】

Ø  如果需要指定引用本地wsdl或者xsd文件，需要加上-catalog参数:

wsimport –catalog catalogfile.xml -keep -d bin -s src wsdl/HelloService.wsdl

 

Ø  如果需要加入数据绑定，加上 –b参数:

wsimport –b bindingfile.xml –catalog catalogfile.xml -keep -d bin -s src wsdl/HelloService.wsdl

 

Ø  如果需要避免发布的时候还需要去找 http://www.w3.org/2005/08/addressing/ws-addr.xsd 及相关的xsd，加上参数-Xno-addressing-databinding –extension

其中：如果不指定 -Xno-addressing-databinding参数，将使用JDK自带的 addressing，

 

wsimport –b bindingfile.xml –catalog catalogfile.xml -Xno-addressing-databinding –extension -keep -d bin -s src wsdl/HelloService.wsdl

 

Ø  -b 绑定文件的配置例子：