author | ysuenaga |
Fri, 29 Sep 2017 20:57:48 +0900 | |
changeset 47569 | 28f78d145691 |
parent 47216 | 71c04702a3d5 |
permissions | -rw-r--r-- |
21743 | 1 |
'\" t |
31876
91b22707521a
8131105: Header Template for nroff man pages *.1 files contains errors
mfang
parents:
21743
diff
changeset
|
2 |
.\" Copyright (c) 2005, 2013, Oracle and/or its affiliates. All rights reserved. |
91b22707521a
8131105: Header Template for nroff man pages *.1 files contains errors
mfang
parents:
21743
diff
changeset
|
3 |
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
91b22707521a
8131105: Header Template for nroff man pages *.1 files contains errors
mfang
parents:
21743
diff
changeset
|
4 |
.\" |
91b22707521a
8131105: Header Template for nroff man pages *.1 files contains errors
mfang
parents:
21743
diff
changeset
|
5 |
.\" This code is free software; you can redistribute it and/or modify it |
91b22707521a
8131105: Header Template for nroff man pages *.1 files contains errors
mfang
parents:
21743
diff
changeset
|
6 |
.\" under the terms of the GNU General Public License version 2 only, as |
91b22707521a
8131105: Header Template for nroff man pages *.1 files contains errors
mfang
parents:
21743
diff
changeset
|
7 |
.\" published by the Free Software Foundation. |
91b22707521a
8131105: Header Template for nroff man pages *.1 files contains errors
mfang
parents:
21743
diff
changeset
|
8 |
.\" |
91b22707521a
8131105: Header Template for nroff man pages *.1 files contains errors
mfang
parents:
21743
diff
changeset
|
9 |
.\" This code is distributed in the hope that it will be useful, but WITHOUT |
91b22707521a
8131105: Header Template for nroff man pages *.1 files contains errors
mfang
parents:
21743
diff
changeset
|
10 |
.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or |
91b22707521a
8131105: Header Template for nroff man pages *.1 files contains errors
mfang
parents:
21743
diff
changeset
|
11 |
.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License |
91b22707521a
8131105: Header Template for nroff man pages *.1 files contains errors
mfang
parents:
21743
diff
changeset
|
12 |
.\" version 2 for more details (a copy is included in the LICENSE file that |
91b22707521a
8131105: Header Template for nroff man pages *.1 files contains errors
mfang
parents:
21743
diff
changeset
|
13 |
.\" accompanied this code). |
91b22707521a
8131105: Header Template for nroff man pages *.1 files contains errors
mfang
parents:
21743
diff
changeset
|
14 |
.\" |
91b22707521a
8131105: Header Template for nroff man pages *.1 files contains errors
mfang
parents:
21743
diff
changeset
|
15 |
.\" You should have received a copy of the GNU General Public License version |
91b22707521a
8131105: Header Template for nroff man pages *.1 files contains errors
mfang
parents:
21743
diff
changeset
|
16 |
.\" 2 along with this work; if not, write to the Free Software Foundation, |
91b22707521a
8131105: Header Template for nroff man pages *.1 files contains errors
mfang
parents:
21743
diff
changeset
|
17 |
.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. |
91b22707521a
8131105: Header Template for nroff man pages *.1 files contains errors
mfang
parents:
21743
diff
changeset
|
18 |
.\" |
91b22707521a
8131105: Header Template for nroff man pages *.1 files contains errors
mfang
parents:
21743
diff
changeset
|
19 |
.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA |
91b22707521a
8131105: Header Template for nroff man pages *.1 files contains errors
mfang
parents:
21743
diff
changeset
|
20 |
.\" or visit www.oracle.com if you need additional information or have any |
91b22707521a
8131105: Header Template for nroff man pages *.1 files contains errors
mfang
parents:
21743
diff
changeset
|
21 |
.\" questions. |
91b22707521a
8131105: Header Template for nroff man pages *.1 files contains errors
mfang
parents:
21743
diff
changeset
|
22 |
.\" |
21743 | 23 |
.\" Arch: generic |
24 |
.\" Software: JDK 8 |
|
25 |
.\" Date: 21 November 2013 |
|
26 |
.\" SectDesc: Java Web Services Tools |
|
27 |
.\" Title: wsimport.1 |
|
28 |
.\" |
|
29 |
.if n .pl 99999 |
|
30 |
.TH wsimport 1 "21 November 2013" "JDK 8" "Java Web Services Tools" |
|
31876
91b22707521a
8131105: Header Template for nroff man pages *.1 files contains errors
mfang
parents:
21743
diff
changeset
|
31 |
.\" ----------------------------------------------------------------- |
91b22707521a
8131105: Header Template for nroff man pages *.1 files contains errors
mfang
parents:
21743
diff
changeset
|
32 |
.\" * Define some portability stuff |
91b22707521a
8131105: Header Template for nroff man pages *.1 files contains errors
mfang
parents:
21743
diff
changeset
|
33 |
.\" ----------------------------------------------------------------- |
91b22707521a
8131105: Header Template for nroff man pages *.1 files contains errors
mfang
parents:
21743
diff
changeset
|
34 |
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
91b22707521a
8131105: Header Template for nroff man pages *.1 files contains errors
mfang
parents:
21743
diff
changeset
|
35 |
.\" http://bugs.debian.org/507673 |
91b22707521a
8131105: Header Template for nroff man pages *.1 files contains errors
mfang
parents:
21743
diff
changeset
|
36 |
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html |
91b22707521a
8131105: Header Template for nroff man pages *.1 files contains errors
mfang
parents:
21743
diff
changeset
|
37 |
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
91b22707521a
8131105: Header Template for nroff man pages *.1 files contains errors
mfang
parents:
21743
diff
changeset
|
38 |
.ie \n(.g .ds Aq \(aq |
91b22707521a
8131105: Header Template for nroff man pages *.1 files contains errors
mfang
parents:
21743
diff
changeset
|
39 |
.el .ds Aq ' |
91b22707521a
8131105: Header Template for nroff man pages *.1 files contains errors
mfang
parents:
21743
diff
changeset
|
40 |
.\" ----------------------------------------------------------------- |
91b22707521a
8131105: Header Template for nroff man pages *.1 files contains errors
mfang
parents:
21743
diff
changeset
|
41 |
.\" * set default formatting |
91b22707521a
8131105: Header Template for nroff man pages *.1 files contains errors
mfang
parents:
21743
diff
changeset
|
42 |
.\" ----------------------------------------------------------------- |
91b22707521a
8131105: Header Template for nroff man pages *.1 files contains errors
mfang
parents:
21743
diff
changeset
|
43 |
.\" disable hyphenation |
91b22707521a
8131105: Header Template for nroff man pages *.1 files contains errors
mfang
parents:
21743
diff
changeset
|
44 |
.nh |
91b22707521a
8131105: Header Template for nroff man pages *.1 files contains errors
mfang
parents:
21743
diff
changeset
|
45 |
.\" disable justification (adjust text to left margin only) |
91b22707521a
8131105: Header Template for nroff man pages *.1 files contains errors
mfang
parents:
21743
diff
changeset
|
46 |
.ad l |
91b22707521a
8131105: Header Template for nroff man pages *.1 files contains errors
mfang
parents:
21743
diff
changeset
|
47 |
.\" ----------------------------------------------------------------- |
91b22707521a
8131105: Header Template for nroff man pages *.1 files contains errors
mfang
parents:
21743
diff
changeset
|
48 |
.\" * MAIN CONTENT STARTS HERE * |
91b22707521a
8131105: Header Template for nroff man pages *.1 files contains errors
mfang
parents:
21743
diff
changeset
|
49 |
.\" ----------------------------------------------------------------- |
2 | 50 |
|
21743 | 51 |
.SH NAME |
52 |
wsimport \- Generates JAX-WS portable artifacts that can be packaged in a web application archive (WAR) file and provides an Ant task\&. |
|
53 |
.SH SYNOPSIS |
|
54 |
.sp |
|
55 |
.nf |
|
56 |
||
57 |
\fBwsimport\fR [ \fIoptions\fR ] \fIwsdl\fR |
|
58 |
.fi |
|
59 |
.sp |
|
60 |
.TP |
|
61 |
\fIoptions\fR |
|
62 |
The command-line options\&. See Options\&. |
|
63 |
.TP |
|
64 |
\fIwsdl\fR |
|
65 |
The file that contains the machine-readable description of how the web service can be called, what parameters it expects, and what data structures it returns\&. |
|
66 |
.SH DESCRIPTION |
|
67 |
The \f3wsimport\fR command generates the following JAX-WS portable artifacts\&. These artifacts can be packaged in a WAR file with the WSDL and schema documents and the endpoint implementation to be deployed\&. The \f3wsimport\fR command also provides a \f3wsimport\fR Ant task, see the Tools tab of the Wsimport Ant Task page at http://jax-ws\&.java\&.net/nonav/2\&.1\&.1/docs/wsimportant\&.html |
|
68 |
.TP 0.2i |
|
69 |
\(bu |
|
70 |
Service Endpoint Interface (SEI) |
|
71 |
.TP 0.2i |
|
72 |
\(bu |
|
73 |
Service |
|
74 |
.TP 0.2i |
|
75 |
\(bu |
|
76 |
Exception class is mapped from \f3wsdl:fault\fR (if any) |
|
77 |
.TP 0.2i |
|
78 |
\(bu |
|
79 |
Async Response Bean is derived from response \f3wsdl:message\fR (if any) |
|
80 |
.TP 0.2i |
|
81 |
\(bu |
|
82 |
JAXB generated value types (mapped java classes from schema types) |
|
83 |
.PP |
|
84 |
To start the \f3wsgen\fR command, do the following: |
|
85 |
.PP |
|
86 |
\fIOracle Solaris/Linux\fR: |
|
87 |
.sp |
|
88 |
.nf |
|
89 |
\f3/bin/wsimport\&.sh \-help\fP |
|
90 |
.fi |
|
91 |
.nf |
|
92 |
\f3\fP |
|
93 |
.fi |
|
94 |
.sp |
|
95 |
\fIWindows\fR: |
|
96 |
.sp |
|
97 |
.nf |
|
98 |
\f3\ebin\ewsimport\&.bat \-help\fP |
|
99 |
.fi |
|
100 |
.nf |
|
101 |
\f3\fP |
|
102 |
.fi |
|
103 |
.sp |
|
104 |
.SH OPTIONS |
|
105 |
.TP |
|
106 |
-d \fIdirectory\fR |
|
2692 | 107 |
.br |
21743 | 108 |
Specifies where to place generated output files\&. |
109 |
.TP |
|
110 |
-b \fIpath\fR |
|
111 |
.br |
|
112 |
Specifies external JAX-WS or JAXB binding files\&. Multiple JAX-WS and JAXB binding files can be specified with the \f3-b\fR option\&. You can use these files to customize package names, bean names, and so on\&. For more information about JAX-WS and JAXB binding files, see the \fIUsers Guide\fR tab of WSDL Customization at http://jax-ws\&.java\&.net/nonav/2\&.1\&.1/docs/wsimportant\&.html |
|
113 |
.TP |
|
114 |
-B \fIjaxbOption\fR |
|
115 |
.br |
|
116 |
Passes the \f3jaxbOption\fR option to the JAXB schema compiler\&. |
|
117 |
.TP |
|
118 |
-catalog |
|
119 |
.br |
|
120 |
Specifies a catalog file to resolve external entity references\&. The \f3-catalog\fR option supports the TR9401, XCatalog, and OASIS XML Catalog formats\&. See the \fIUsers Guide\fR tab of the Catalog Support page at http://jax-ws\&.java\&.net/nonav/2\&.1\&.1/docs/catalog-support\&.html |
|
121 |
.TP |
|
122 |
-extension |
|
123 |
.br |
|
124 |
Allows vendor extensions\&. Use of extensions can result in applications that are not portable or that do not work with other implementations\&. |
|
125 |
.TP |
|
126 |
-help |
|
127 |
.br |
|
128 |
Displays a help message for the \f3wsimport\fR command\&. |
|
129 |
.TP |
|
130 |
-httpproxy: \fIhost\fR:\fIport\fR |
|
131 |
.br |
|
132 |
Specifies an HTTP proxy server\&. The default is 8080\&. |
|
133 |
.TP |
|
134 |
-keep |
|
135 |
.br |
|
136 |
Keeps generated files\&. |
|
137 |
.TP |
|
138 |
-p \fIname\fR |
|
139 |
.br |
|
140 |
Specifies a target package \fIname\fR to override the WSDL and schema binding customizations, and the default algorithm defined in the specification\&. |
|
141 |
.TP |
|
142 |
-s \fIdirectory\fR |
|
143 |
.br |
|
144 |
Specifies where to place generated source files\&. |
|
145 |
.TP |
|
146 |
-verbose |
|
147 |
.br |
|
148 |
Displays compiler messages\&. |
|
149 |
.TP |
|
150 |
-version |
|
151 |
.br |
|
152 |
Prints release information\&. |
|
153 |
.TP |
|
154 |
-wsdllocation \fIlocation\fR |
|
155 |
.br |
|
156 |
Specifies the \f3@WebServiceClient\&.wsdlLocation\fR value\&. |
|
157 |
.TP |
|
158 |
-target |
|
9573 | 159 |
.br |
21743 | 160 |
Generates code according to the specified JAX-WS specification version\&. Version 2\&.0 generates compliant code for the JAX-WS 2\&.0 specification\&. |
161 |
.TP |
|
162 |
-quiet |
|
9573 | 163 |
.br |
21743 | 164 |
Suppresses the \f3wsimport\fR command output\&. |
165 |
.PP |
|
166 |
Multiple \f3JAX-WS\fR and \f3JAXB\fR binding files can be specified using the \f3-b\fR option, and they can be used to customize various things such as package names and bean names\&. More information about \f3JAX-WS\fR and \f3JAXB\fR binding files can be found in the customization documentation at https://jax-ws\&.dev\&.java\&.net/nonav/2\&.1\&.1/docs/customizations\&.html |
|
167 |
.SH NONSTANDARD\ OPTIONS |
|
168 |
.TP |
|
169 |
-XadditionalHeaders |
|
9573 | 170 |
.br |
21743 | 171 |
Maps headers not bound to a request or response message to Java method parameters\&. |
172 |
.TP |
|
173 |
-Xauthfile \fIfile\fR |
|
9573 | 174 |
.br |
21743 | 175 |
The WSDL URI that specifies the file that contains authorization information\&. This URI is in the following format: |
176 |
||
177 |
http://\fIuser-name\fR:\f3password\fR@\fIhost-name\fR/\fIweb-service-name\fR>?wsdl\&. |
|
178 |
.TP |
|
179 |
-Xdebug |
|
9573 | 180 |
.br |
21743 | 181 |
Prints debugging information\&. |
182 |
.TP |
|
183 |
-Xno-addressing-databinding |
|
9573 | 184 |
.br |
21743 | 185 |
Enables binding of W3C EndpointReferenceType to Java\&. |
186 |
.TP |
|
187 |
-Xnocompile |
|
9573 | 188 |
.br |
21743 | 189 |
Does not compile the generated Java files\&. |
190 |
.SH EXAMPLE |
|
191 |
The following example generates the Java artifacts and compiles the artifacts by importing \f3http://stockquote\&.example\&.com/quote?wsdl\fR |
|
192 |
.sp |
|
193 |
.nf |
|
194 |
\f3wsimport \-p stockquote http://stockquote\&.example\&.com/quote?wsdl\fP |
|
195 |
.fi |
|
196 |
.nf |
|
197 |
\f3\fP |
|
198 |
.fi |
|
199 |
.sp |
|
200 |
.SH SEE\ ALSO |
|
201 |
.TP 0.2i |
|
202 |
\(bu |
|
203 |
wsgen(1) |
|
204 |
.TP 0.2i |
|
205 |
\(bu |
|
206 |
The Tools tab of Wsimport Ant Task page http://jax-ws\&.java\&.net/nonav/2\&.1\&.1/docs/wsimportant\&.html |
|
207 |
.TP 0.2i |
|
208 |
\(bu |
|
209 |
The \fIUsers Guide\fR tab of Catalog Support page http://jax-ws\&.java\&.net/nonav/2\&.1\&.1/docs/catalog-support\&.html |
|
210 |
.TP 0.2i |
|
211 |
\(bu |
|
212 |
The \fIUsers Guide\fR tab of WSDL Customization page http://jax-ws\&.java\&.net/nonav/2\&.1\&.1/docs/wsimportant\&.html |
|
31876
91b22707521a
8131105: Header Template for nroff man pages *.1 files contains errors
mfang
parents:
21743
diff
changeset
|
213 |
.RE |
91b22707521a
8131105: Header Template for nroff man pages *.1 files contains errors
mfang
parents:
21743
diff
changeset
|
214 |
.br |
91b22707521a
8131105: Header Template for nroff man pages *.1 files contains errors
mfang
parents:
21743
diff
changeset
|
215 |
'pl 8.5i |
91b22707521a
8131105: Header Template for nroff man pages *.1 files contains errors
mfang
parents:
21743
diff
changeset
|
216 |
'bp |