The wsimport
tool
generates JAX-WS portable artifacts, such as:
These artifacts can be packaged in a WAR file with the WSDL and
schema documents along with the endpoint implementation to be deployed. ${PRODUCT_NAME} also provides wsimport
ant task, see Wsimport ant
task.
To run on JDK 6 follow these instructions.
wsimport [options] <wsdl>
The following table lists the wsimport
options.
Option |
Description |
---|---|
|
Specify where to place generated output files |
|
Specify external JAX-WS or JAXB binding files or additional schema files (Each |
-B <jaxbOption> | Pass this option to JAXB schema compiler |
-catalog |
Specify catalog file to resolve external entity references, it supports TR9401, XCatalog, and OASIS XML Catalog format. Please read the documentation of catalog and see catalog sample. |
|
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 |
|
Display help |
|
Specify an HTTP proxy server (port defaults to 8080) |
|
Keep generated source code files. It is enabled when -s option. |
-p |
Specifying a target package via this command-line option, overrides any wsdl and schema binding customization for package name and the default package name algorithm defined in the specification |
|
Specify where to place generated source code files. keep is turned on with this option |
|
Output messages about what the compiler is doing |
|
Print version information |
-wsdllocation
<location> |
@WebServiceClient.wsdlLocation value |
-target |
Generate code as per the given JAX-WS specification version. version 2.0 will generate compliant code for JAX-WS 2.0 spec. |
-quiet |
Suppress wsimport output |
-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:password@example.org/stock?wsdl. Default value is $HOME/.metro/auth |
-Xdebug |
Print debug information |
-Xno-addressing-databinding |
Enable binding of W3C EndpointReferenceType to Java |
-Xnocompile |
Do not compile generated Java files |
-XdisableSSLHostnameVerification |
Disbales the SSL Hostname verification while fetching the wsdls. |
Multiple JAX-WS and JAXB binding files can be specified using -b
option and they can be used to customize various things like package
names, bean names, etc. More information on JAX-WS and JAXB binding
files can be found in the customization
documentation.
wsimport -p stockquote http://stockquote.xyz/quote?wsdl
This will generate the Java artifacts and compile them by importing the
http://stockquote.xyz/quote?wsdl.