1wsimport(1)                 Java Web Services Tools                wsimport(1)
2
3
4

NAME

6       wsimport - Generates JAX-WS portable artifacts that can be packaged in
7       a web application archive (WAR) file and provides an Ant task.
8

SYNOPSIS

10       wsimport [ options ] wsdl
11
12
13       options
14              The command-line options. See Options.
15
16       wsdl   The file that contains the machine-readable description of how
17              the web service can be called, what parameters it expects, and
18              what data structures it returns.
19

DESCRIPTION

21       The wsimport command generates the following JAX-WS portable artifacts.
22       These artifacts can be packaged in a WAR file with the WSDL and schema
23       documents and the endpoint implementation to be deployed. The wsimport
24       command also provides a wsimport Ant task, see the Tools tab of the
25       Wsimport Ant Task page at http://jax-
26       ws.java.net/nonav/2.1.1/docs/wsimportant.html
27
28       · Service Endpoint Interface (SEI)
29
30       · Service
31
32       · Exception class is mapped from wsdl:fault (if any)
33
34       · Async Response Bean is derived from response wsdl:message (if any)
35
36       · JAXB generated value types (mapped java classes from schema types)
37
38       To start the wsgen command, do the following:
39
40       Oracle Solaris/Linux:
41
42       /bin/wsimport.sh -help
43
44       Windows:
45
46       \bin\wsimport.bat -help
47
48

OPTIONS

50       -d directory
51              Specifies where to place generated output files.
52
53       -b path
54              Specifies external JAX-WS or JAXB binding files. Multiple JAX-WS
55              and JAXB binding files can be specified with the -b option. You
56              can use these files to customize package names, bean names, and
57              so on. For more information about JAX-WS and JAXB binding files,
58              see the Users Guide tab of WSDL Customization at http://jax-
59              ws.java.net/nonav/2.1.1/docs/wsimportant.html
60
61       -B jaxbOption
62              Passes the jaxbOption option to the JAXB schema compiler.
63
64       -catalog
65              Specifies a catalog file to resolve external entity references.
66              The -catalog option supports the TR9401, XCatalog, and OASIS XML
67              Catalog formats. See the Users Guide tab of the Catalog Support
68              page at http://jax-ws.java.net/nonav/2.1.1/docs/catalog-
69              support.html
70
71       -extension
72              Allows vendor extensions. Use of extensions can result in
73              applications that are not portable or that do not work with
74              other implementations.
75
76       -help
77              Displays a help message for the wsimport command.
78
79       -httpproxy: host:port
80              Specifies an HTTP proxy server. The default is 8080.
81
82       -keep
83              Keeps generated files.
84
85       -p name
86              Specifies a target package name to override the WSDL and schema
87              binding customizations, and the default algorithm defined in the
88              specification.
89
90       -s directory
91              Specifies where to place generated source files.
92
93       -verbose
94              Displays compiler messages.
95
96       -version
97              Prints release information.
98
99       -wsdllocation location
100              Specifies the @WebServiceClient.wsdlLocation value.
101
102       -target
103              Generates code according to the specified JAX-WS specification
104              version. Version 2.0 generates compliant code for the JAX-WS 2.0
105              specification.
106
107       -quiet
108              Suppresses the wsimport command output.
109
110       Multiple JAX-WS and JAXB binding files can be specified using the -b
111       option, and they can be used to customize various things such as
112       package names and bean names. More information about JAX-WS and JAXB
113       binding files can be found in the customization documentation at
114       https://jax-ws.dev.java.net/nonav/2.1.1/docs/customizations.html
115

NONSTANDARD OPTIONS

117       -XadditionalHeaders
118              Maps headers not bound to a request or response message to Java
119              method parameters.
120
121       -Xauthfile file
122              The WSDL URI that specifies the file that contains authorization
123              information. This URI is in the following format:
124
125              http://user-name:password@host-name/web-service-name>?wsdl.
126
127       -Xdebug
128              Prints debugging information.
129
130       -Xno-addressing-databinding
131              Enables binding of W3C EndpointReferenceType to Java.
132
133       -Xnocompile
134              Does not compile the generated Java files.
135

EXAMPLE

137       The following example generates the Java artifacts and compiles the
138       artifacts by importing http://stockquote.example.com/quote?wsdl
139
140       wsimport -p stockquote http://stockquote.example.com/quote?wsdl
141
142

SEE ALSO

144       · wsgen(1)
145
146       · The Tools tab of Wsimport Ant Task page http://jax-
147         ws.java.net/nonav/2.1.1/docs/wsimportant.html
148
149       · The Users Guide tab of Catalog Support page http://jax-
150         ws.java.net/nonav/2.1.1/docs/catalog-support.html
151
152       · The Users Guide tab of WSDL Customization page http://jax-
153         ws.java.net/nonav/2.1.1/docs/wsimportant.html
154
155
156
157JDK 8                          21 November 2013                    wsimport(1)