'\" 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: wsgen.1
.\"
.if n .pl 99999
.TH wsgen 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)"
wsgen \- کلاس پیاده‌سازی نقطه پایانی وب‌سرویس (SEI) را می‌خواند و تمام مصنوعات لازم برای استقرار و فراخوانی وب‌سرویس را تولید می‌کند\&.
.SH "خلاصه دستور (SYNOPSIS)"
.sp     
.nf     

\fBwsgen\fR [ \fIoptions\fR ] \fISEI\fR
.fi     
.sp     
.TP     
\fIoptions\fR
گزینه‌های خط فرمان\&. به بخش گزینه‌ها مراجعه کنید\&.
.TP     
\fISEI\fR
کلاس پیاده‌سازی نقطه پایانی وب‌سرویس (SEI) که باید خوانده شود\&.
.SH "توضیحات (DESCRIPTION)"
دستور \f3wsgen\fR مصنوعات قابل‌حمل JAX-WS را که در وب‌سرویس‌های JAX-WS استفاده می‌شوند تولید می‌کند\&. این ابزار کلاس نقطه پایانی وب‌سرویس را می‌خواند و تمام مصنوعات مورد نیاز برای استقرار و فراخوانی وب‌سرویس را تولید می‌نماید\&. نسخه مرجع JAXWS 2\&.1\&.1 RI همچنین یک تسک Ant برای \f3wsgen\fR ارائه می‌دهد؛ به زبانه \fITools\fR در صفحه JAX-WS (wsgen) در آدرس http://jax-ws\&.java\&.net/nonav/2\&.1\&.1/docs/wsgenant\&.html مراجعه کنید\&.
.PP
برای اجرای دستور \f3wsgen\fR، مراحل زیر را انجام دهید:
.sp     
.nf     
\f3export JAXWS_HOME=/pathto/jaxws\-ri\fP
.fi     
.nf     
\f3$JAXWS_HOME/bin/wsgen\&.sh \-help\fP
.fi     
.nf     
\f3\fP
.fi     
.sp     
.SH "گزینه‌ها (OPTIONS)"
.TP
-classpath \fIpath\fR
.br
مکان فایل‌های کلاس ورودی\&.
.TP
-cp \fIpath\fR
.br
مکان فایل‌های کلاس ورودی\&.
.TP
-d \fIdirectory\fR
.br
مکان قرار دادن فایل‌های خروجی تولیدشده\&.
.TP
-extension
.br
اجازه دادن به افزونه‌های ارائه‌دهنده (vendor extensions)\&. استفاده از این افزونه‌ها ممکن است منجر به برنامه‌هایی شود که قابل‌حمل نیستند یا با پیاده‌سازی‌های دیگر کار نمی‌کنند\&.
.TP
-help
.br
نمایش یک پیام راهنما درباره دستور \f3wsgen\fR\&.
.TP
-keep
.br
نگه‌داشتن فایل‌های تولیدشده\&.
.TP
-r \fIdirectory\fR
.br
این گزینه به همراه گزینه \f3-wsdl\fR برای مشخص کردن مکان قرارگیری فایل‌های منبع (resource) تولیدشده، مانند WSDLها به‌کار می‌رود\&.
.TP
-s \fIdirectory\fR
.br
مکان قرار دادن فایل‌های کد منبع تولیدشده\&.
.TP
-verbose
.br
نمایش پیام‌های کامپایلر\&.
.TP
-version
.br
چاپ اطلاعات نسخه انتشار\&.
.TP
-wsdl [ :protocol ] \fI\fR
.br
دستوری اختیاری که یک فایل WSDL را جهت بررسی پیش از استقرار نقطه پایانی تولید می‌کند\&. فایل‌های WSDL حاوی توصیفی ماشین‌خوان از نحوه فراخوانی سرویس، پارامترهای مورد انتظار آن و ساختارهای داده بازگردانده‌شده هستند\&.

دستور \f3wsgen\fR به‌طور پیش‌فرض فایل WSDL تولید نمی‌کند\&. مقدار \f3protocol\fR اختیاری است و برای تعیین پروتکل مورد استفاده در مقیدسازی WSDL (\f3wsdl:binding\fR) به‌کار می‌رود\&. پروتکل‌های معتبر شامل \f3soap1\&.1\fR و \f3Xsoap1\&.2\fR هستند\&. مقدار پیش‌فرض \f3soap1\&.1\fR است\&. پروتکل \f3Xsoap1\&.2\fR استاندارد نیست و تنها به همراه گزینه \f3-extension\fR قابل استفاده است\&.
.TP
-servicename \fIname\fR
.br
تنها همراه با گزینه \f3-wsdl\fR برای تعیین یک نام خاص سرویس WSDL (\f3wsdl:service\fR) جهت درج در WSDL تولیدی استفاده می‌شود؛ برای نمونه: \f3-servicename "{http://mynamespace/}MyService"\fR\&.
.TP
-portname \fIname\fR
.br
تنها همراه با گزینه \f3-wsdl\fR برای تعیین یک نام خاص درگاه WSDL (\f3wsdl:port\fR) جهت درج در WSDL تولیدی استفاده می‌شود؛ برای نمونه: \f3-portname "{http://mynamespace/}MyPort"\fR\&.
.SH "مثال‌ها (EXAMPLES)"
مثال زیر کلاس‌های پوشش‌دهنده (wrapper) را برای \f3StockService\fR دارای حاشیه‌نویسی‌های \f3@WebService\fR درون پوشه stock تولید می‌کند\&.
.sp     
.nf     
\f3wsgen \-d stock \-cp myclasspath stock\&.StockService\fP
.fi     
.nf     
\f3\fP
.fi     
.sp     
مثال زیر یک WSDL و طرح‌واره (schema) بر پایه SOAP 1\&.1 را برای کلاس \f3stock\&.StockService\fR با حاشیه‌نویسی‌های \f3@WebService\fR تولید می‌کند\&.
.sp     
.nf     
\f3wsgen \-wsdl \-d stock \-cp myclasspath stock\&.StockService\fP
.fi     
.nf     
\f3\fP
.fi     
.sp     
مثال زیر یک WSDL بر پایه SOAP 1\&.2 تولید می‌کند\&.
.sp     
.nf     
\f3wsgen \-wsdl:Xsoap1\&.2 \-d stock \-cp myclasspath stock\&.StockService \fP
.fi     
.nf     
\f3\fP
.fi     
.sp     
\fIنکته:\fR نیازی به تولید WSDL در زمان توسعه ندارید زیرا محیط زمان اجرای JAXWS هنگام استقرار سرویس، یک WSDL برای شما تولید می‌کند\&.
.SH "همچنین ببینید (SEE ALSO)"
.TP 0.2i    
\(bu
wsimport(1)
.TP 0.2i    
\(bu
زبانه \fITools\fR در صفحه JAX-WS (wsgen) در http://jax-ws\&.java\&.net/nonav/2\&.1\&.1/docs/wsgenant\&.html
.RE
.br
'pl 8.5i
'bp