wsgen(1)                    Java Web Services Tools                   wsgen(1)



نام (NAME)
       wsgen - کلاس پیاده‌سازی نقطه پایانی وب‌سرویس (SEI) را می‌خواند و تمام
       مصنوعات لازم برای استقرار و فراخوانی وب‌سرویس را تولید می‌کند.

خلاصه دستور (SYNOPSIS)

       wsgen [ options ] SEI


       options
              گزینه‌های خط فرمان. به بخش گزینه‌ها مراجعه کنید.

       SEI    کلاس پیاده‌سازی نقطه پایانی وب‌سرویس (SEI) که باید خوانده شود.

توضیحات (DESCRIPTION)
       دستور wsgen مصنوعات قابل‌حمل JAX-WS را که در وب‌سرویس‌های JAX-WS استفاده
       می‌شوند تولید می‌کند. این ابزار کلاس نقطه پایانی وب‌سرویس را می‌خواند و
       تمام مصنوعات مورد نیاز برای استقرار و فراخوانی وب‌سرویس را تولید
       می‌نماید. نسخه مرجع JAXWS 2.1.1 RI همچنین یک تسک Ant برای wsgen ارائه
       می‌دهد؛ به زبانه Tools در صفحه JAX-WS (wsgen) در آدرس http://jax-
       ws.java.net/nonav/2.1.1/docs/wsgenant.html مراجعه کنید.

       برای اجرای دستور wsgen، مراحل زیر را انجام دهید:

       export JAXWS_HOME=/pathto/jaxws-ri
       $JAXWS_HOME/bin/wsgen.sh -help



گزینه‌ها (OPTIONS)
       -classpath path
              مکان فایل‌های کلاس ورودی.

       -cp path
              مکان فایل‌های کلاس ورودی.

       -d directory
              مکان قرار دادن فایل‌های خروجی تولیدشده.

       -extension
              اجازه دادن به افزونه‌های ارائه‌دهنده (vendor extensions). استفاده
              از این افزونه‌ها ممکن است منجر به برنامه‌هایی شود که قابل‌حمل
              نیستند یا با پیاده‌سازی‌های دیگر کار نمی‌کنند.

       -help
              نمایش یک پیام راهنما درباره دستور wsgen.

       -keep
              نگه‌داشتن فایل‌های تولیدشده.

       -r directory
              این گزینه به همراه گزینه -wsdl برای مشخص کردن مکان قرارگیری
              فایل‌های منبع (resource) تولیدشده، مانند WSDLها به‌کار می‌رود.

       -s directory
              مکان قرار دادن فایل‌های کد منبع تولیدشده.

       -verbose
              نمایش پیام‌های کامپایلر.

       -version
              چاپ اطلاعات نسخه انتشار.

       -wsdl [ :protocol ]
              دستوری اختیاری که یک فایل WSDL را جهت بررسی پیش از استقرار نقطه
              پایانی تولید می‌کند. فایل‌های WSDL حاوی توصیفی ماشین‌خوان از نحوه
              فراخوانی سرویس، پارامترهای مورد انتظار آن و ساختارهای داده
              بازگردانده‌شده هستند.

              دستور wsgen به‌طور پیش‌فرض فایل WSDL تولید نمی‌کند. مقدار protocol
              اختیاری است و برای تعیین پروتکل مورد استفاده در مقیدسازی WSDL
              (wsdl:binding) به‌کار می‌رود. پروتکل‌های معتبر شامل soap1.1 و
              Xsoap1.2 هستند. مقدار پیش‌فرض soap1.1 است. پروتکل Xsoap1.2
              استاندارد نیست و تنها به همراه گزینه -extension قابل استفاده
              است.

       -servicename name
              تنها همراه با گزینه -wsdl برای تعیین یک نام خاص سرویس WSDL
              (wsdl:service) جهت درج در WSDL تولیدی استفاده می‌شود؛ برای نمونه:
              -servicename "{http://mynamespace/}MyService".

       -portname name
              تنها همراه با گزینه -wsdl برای تعیین یک نام خاص درگاه WSDL
              (wsdl:port) جهت درج در WSDL تولیدی استفاده می‌شود؛ برای نمونه:
              -portname "{http://mynamespace/}MyPort".

مثال‌ها (EXAMPLES)
       مثال زیر کلاس‌های پوشش‌دهنده (wrapper) را برای StockService دارای
       حاشیه‌نویسی‌های @WebService درون پوشه stock تولید می‌کند.

       wsgen -d stock -cp myclasspath stock.StockService


       مثال زیر یک WSDL و طرح‌واره (schema) بر پایه SOAP 1.1 را برای کلاس
       stock.StockService با حاشیه‌نویسی‌های @WebService تولید می‌کند.

       wsgen -wsdl -d stock -cp myclasspath stock.StockService


       مثال زیر یک WSDL بر پایه SOAP 1.2 تولید می‌کند.

       wsgen -wsdl:Xsoap1.2 -d stock -cp myclasspath stock.StockService


       نکته: نیازی به تولید WSDL در زمان توسعه ندارید زیرا محیط زمان اجرای
       JAXWS هنگام استقرار سرویس، یک WSDL برای شما تولید می‌کند.

همچنین ببینید (SEE ALSO)
       • wsimport(1)

       • زبانه Tools در صفحه JAX-WS (wsgen) در http://jax-
         ws.java.net/nonav/2.1.1/docs/wsgenant.html

JDK 8                          21 November 2013                       wsgen(1)