'\" t
.\" Copyright (c) 2005, 2013, Oracle and/or its affiliates. All rights reserved.
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
.\"
.\" This code is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License version 2 only, as
.\" published by the Free Software Foundation.
.\"
.\" This code is distributed in the hope that it will be useful, but WITHOUT
.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
.\" FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
.\" version 2 for more details (a copy is included in the LICENSE file that
.\" accompanied this code).
.\"
.\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.\"
.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
.\" or visit www.oracle.com if you need additional information or have any
.\" questions.
.\"
.\"     Arch: generic
.\"     Software: JDK 8
.\"     Date: 21 November 2013
.\"     SectDesc: Java Web Services Tools
.\"     Title: wsimport.1
.\"
.if n .pl 99999
.TH wsimport 1 "21 November 2013" "JDK 8" "Java Web Services Tools"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------

.SH "نام (NAME)"
wsimport \- تولید آرتیفکت‌های قابل‌حمل JAX-WS برای بسته‌بندی در فایل WAR و ارائه تسک Ant (نسخه ۸)
.SH "خلاصه دستور (SYNOPSIS)"
.sp     
.nf     

\fBwsimport\fR [ \fIoptions\fR ] \fIwsdl\fR
.fi     
.sp     
.TP     
\fIoptions\fR
گزینه‌های خط فرمان\&. بخش گزینه‌ها را ببینید\&.
.TP     
\fIwsdl\fR
فایلی که حاوی توصیف ماشین‌خوان از نحوه فراخوانی وب‌سرویس، پارامترهای مورد انتظار آن و ساختارهای داده بازگشتی است\&.
.SH "توضیحات (DESCRIPTION)"
دستور \f3wsimport\fR آرتیفکت‌های قابل‌حمل JAX-WS زیر را تولید می‌کند\&. این آرتیفکت‌ها را می‌توان به همراه اسناد WSDL و اسکیما و پیاده‌سازی نقطه پایانی (Endpoint) در یک فایل WAR بسته‌بندی و مستقر کرد\&. دستور \f3wsimport\fR همچنین یک تسک Ant برای \f3wsimport\fR ارائه می‌دهد؛ برگه ابزارها را در صفحه Wsimport Ant Task در نشانی http://jax-ws\&.java\&.net/nonav/2\&.1\&.1/docs/wsimportant\&.html مشاهده کنید\&.
.TP 0.2i    
\(bu
رابط نقطه پایانی سرویس (Service Endpoint Interface یا SEI)
.TP 0.2i    
\(bu
سرویس (Service)
.TP 0.2i    
\(bu
کلاس استثنا (Exception) نگاشت‌شده از \f3wsdl:fault\fR (در صورت وجود)
.TP 0.2i    
\(bu
بین پاسخ ناهمگام (Async Response Bean) برگرفته از پیام پاسخ \f3wsdl:message\fR (در صورت وجود)
.TP 0.2i    
\(bu
انواع مقادیر تولیدشده توسط JAXB (کلاس‌های جاوای نگاشت‌شده از انواع اسکیما)
.PP
برای اجرای دستور، می‌توانید به روش‌های زیر عمل کنید:
.PP
\fIاوراکل سولاریس/لینوکس (Oracle Solaris/Linux)\fR:
.sp     
.nf     
\f3/bin/wsimport\&.sh \-help\fP
.fi     
.nf     
\f3\fP
.fi     
.sp     
\fIویندوز (Windows)\fR:
.sp     
.nf     
\f3\ebin\ewsimport\&.bat \-help\fP
.fi     
.nf     
\f3\fP
.fi     
.sp     
.SH "گزینه‌ها (OPTIONS)"
.TP
-d \fIdirectory\fR
.br
محل قرارگیری فایل‌های خروجی تولیدشده را مشخص می‌کند\&.
.TP
-b \fIpath\fR
.br
فایل‌های پیونددهی (Binding) خارجی JAX-WS یا JAXB را مشخص می‌کند\&. چندین فایل پیونددهی JAX-WS و JAXB را می‌توان با گزینه \f3-b\fR مشخص نمود\&. می‌توانید از این فایل‌ها برای سفارشی‌سازی نام بسته‌ها، نام بین‌ها و موارد دیگر استفاده کنید\&. برای کسب اطلاعات بیشتر درباره فایل‌های پیونددهی JAX-WS و JAXB، برگه \fIراهنمای کاربران\fR را در صفحه سفارشی‌سازی WSDL در نشانی http://jax-ws\&.java\&.net/nonav/2\&.1\&.1/docs/wsimportant\&.html ببینید\&.
.TP
-B \fIjaxbOption\fR
.br
گزینه \f3jaxbOption\fR را به کامپایلر اسکیمای JAXB ارسال می‌کند\&.
.TP
-catalog
.br
یک فایل کاتالوگ را برای رفع ارجاعات موجودیت‌های خارجی مشخص می‌کند\&. گزینه \f3-catalog\fR از قالب‌های TR9401، XCatalog و کاتالوگ OASIS XML پشتیبانی می‌کند\&. برگه \fIراهنمای کاربران\fR را در صفحه پشتیبانی کاتالوگ در نشانی http://jax-ws\&.java\&.net/nonav/2\&.1\&.1/docs/catalog-support\&.html مشاهده کنید\&.
.TP
-extension
.br
افزونه‌های اختصاصی ارائه‌دهنده را مجاز می‌سازد\&. استفاده از افزونه‌ها ممکن است منجر به برنامه‌هایی شود که غیرقابل‌حمل هستند یا با سایر پیاده‌سازی‌ها کار نمی‌کنند\&.
.TP
-help
.br
یک پیام راهنما برای دستور \f3wsimport\fR نمایش می‌دهد\&.
.TP
-httpproxy: \fIhost\fR:\fIport\fR
.br
یک سرور پروکسی HTTP را مشخص می‌کند\&. مقدار پیش‌فرض 8080 است\&.
.TP
-keep
.br
فایل‌های تولیدشده را نگه می‌دارد\&.
.TP
-p \fIname\fR
.br
نام بسته (package) مقصد را تعیین می‌کند تا سفارشی‌سازی‌های پیونددهی WSDL و اسکیما، و الگوریتم پیش‌فرض تعریف‌شده در مشخصات لغو شود\&.
.TP
-s \fIdirectory\fR
.br
محل قرارگیری فایل‌های منبع تولیدشده را مشخص می‌کند\&.
.TP
-verbose
.br
پیام‌های کامپایلر را نمایش می‌دهد\&.
.TP
-version
.br
اطلاعات نسخه انتشار را چاپ می‌کند\&.
.TP
-wsdllocation \fIlocation\fR
.br
مقدار \f3@WebServiceClient\&.wsdlLocation\fR را مشخص می‌کند\&.
.TP
-target
.br
کد را بر اساس نسخه مشخص‌شده از استانداردهای JAX-WS تولید می‌کند\&. نسخه 2\&.0 کدهای منطبق با مشخصات JAX-WS 2.0 را تولید می‌کند\&.
.TP
-quiet
.br
خروجی دستور \f3wsimport\fR را بی‌صدا می‌کند\&.
.PP
می‌توان چندین فایل پیونددهی \f3JAX-WS\fR و \f3JAXB\fR را با استفاده از گزینه \f3-b\fR مشخص کرد و از آن‌ها برای سفارشی‌سازی موارد گوناگون مانند نام بسته‌ها و نام بین‌ها بهره برد\&. اطلاعات بیشتر درباره فایل‌های پیونددهی \f3JAX-WS\fR و \f3JAXB\fR را می‌توانید در مستندات سفارشی‌سازی در نشانی https://jax-ws\&.dev\&.java\&.net/nonav/2\&.1\&.1/docs/customizations\&.html بیابید\&.
.SH "گزینه‌های غیراستاندارد (NONSTANDARD OPTIONS)"
.TP
-XadditionalHeaders
.br
سرفصل‌هایی (Headers) را که به پیام درخواست یا پاسخ مقید نشده‌اند، به پارامترهای متد جاوا نگاشت می‌کند\&.
.TP
-Xauthfile \fIfile\fR
.br
شناسه WSDL URI که فایل حاوی اطلاعات احراز هویت را مشخص می‌کند\&. این URI در قالب زیر است:

http://\fIuser-name\fR:\f3password\fR@\fIhost-name\fR/\fIweb-service-name\fR>?wsdl\&.
.TP
-Xdebug
.br
اطلاعات اشکال‌زدایی را چاپ می‌کند\&.
.TP
-Xno-addressing-databinding
.br
پیوند داده‌های W3C EndpointReferenceType به جاوا را فعال می‌کند\&.
.TP
-Xnocompile
.br
فایل‌های جاوای تولیدشده را کامپایل نمی‌کند\&.
.SH "مثال‌ها (EXAMPLES)"
مثال زیر آرتیفکت‌های جاوا را با وارد کردن \f3http://stockquote\&.example\&.com/quote?wsdl\fR تولید و کامپایل می‌کند:
.sp     
.nf     
\f3wsimport \-p stockquote http://stockquote\&.example\&.com/quote?wsdl\fP
.fi     
.nf     
\f3\fP
.fi     
.sp     
.SH "همچنین ببینید (SEE ALSO)"
.TP 0.2i    
\(bu
wsgen(1)
.TP 0.2i    
\(bu
برگه ابزارها در صفحه Wsimport Ant Task در http://jax-ws\&.java\&.net/nonav/2\&.1\&.1/docs/wsimportant\&.html
.TP 0.2i    
\(bu
برگه \fIراهنمای کاربران\fR در صفحه Catalog Support در http://jax-ws\&.java\&.net/nonav/2\&.1\&.1/docs/catalog-support\&.html
.TP 0.2i    
\(bu
برگه \fIراهنمای کاربران\fR در صفحه WSDL Customization در http://jax-ws\&.java\&.net/nonav/2\&.1\&.1/docs/wsimportant\&.html
.RE
.br
'pl 8.5i
'bp