نام (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