wsimport(1) Java Web Services Tools wsimport(1)

wsimport - تولید آرتیفکت‌های قابل‌حمل JAX-WS برای بسته‌بندی در فایل WAR و ارائه تسک Ant (نسخه ۸)

wsimport [ options ] wsdl
گزینه‌های خط فرمان. بخش گزینه‌ها را ببینید.
فایلی که حاوی توصیف ماشین‌خوان از نحوه فراخوانی وب‌سرویس، پارامترهای مورد انتظار آن و ساختارهای داده بازگشتی است.

دستور wsimport آرتیفکت‌های قابل‌حمل JAX-WS زیر را تولید می‌کند. این آرتیفکت‌ها را می‌توان به همراه اسناد WSDL و اسکیما و پیاده‌سازی نقطه پایانی (Endpoint) در یک فایل WAR بسته‌بندی و مستقر کرد. دستور wsimport همچنین یک تسک Ant برای wsimport ارائه می‌دهد؛ برگه ابزارها را در صفحه Wsimport Ant Task در نشانی http://jax-ws.java.net/nonav/2.1.1/docs/wsimportant.html مشاهده کنید.

•
رابط نقطه پایانی سرویس (Service Endpoint Interface یا SEI)
•
سرویس (Service)
•
کلاس استثنا (Exception) نگاشت‌شده از wsdl:fault (در صورت وجود)
•
بین پاسخ ناهمگام (Async Response Bean) برگرفته از پیام پاسخ wsdl:message (در صورت وجود)
•
انواع مقادیر تولیدشده توسط JAXB (کلاس‌های جاوای نگاشت‌شده از انواع اسکیما)

برای اجرای دستور، می‌توانید به روش‌های زیر عمل کنید:

اوراکل سولاریس/لینوکس (Oracle Solaris/Linux):

/bin/wsimport.sh -help

ویندوز (Windows):

\bin\wsimport.bat -help


محل قرارگیری فایل‌های خروجی تولیدشده را مشخص می‌کند.

فایل‌های پیونددهی (Binding) خارجی JAX-WS یا JAXB را مشخص می‌کند. چندین فایل پیونددهی JAX-WS و JAXB را می‌توان با گزینه -b مشخص نمود. می‌توانید از این فایل‌ها برای سفارشی‌سازی نام بسته‌ها، نام بین‌ها و موارد دیگر استفاده کنید. برای کسب اطلاعات بیشتر درباره فایل‌های پیونددهی JAX-WS و JAXB، برگه راهنمای کاربران را در صفحه سفارشی‌سازی WSDL در نشانی http://jax-ws.java.net/nonav/2.1.1/docs/wsimportant.html ببینید.

گزینه jaxbOption را به کامپایلر اسکیمای JAXB ارسال می‌کند.

یک فایل کاتالوگ را برای رفع ارجاعات موجودیت‌های خارجی مشخص می‌کند. گزینه -catalog از قالب‌های TR9401، XCatalog و کاتالوگ OASIS XML پشتیبانی می‌کند. برگه راهنمای کاربران را در صفحه پشتیبانی کاتالوگ در نشانی http://jax-ws.java.net/nonav/2.1.1/docs/catalog-support.html مشاهده کنید.

افزونه‌های اختصاصی ارائه‌دهنده را مجاز می‌سازد. استفاده از افزونه‌ها ممکن است منجر به برنامه‌هایی شود که غیرقابل‌حمل هستند یا با سایر پیاده‌سازی‌ها کار نمی‌کنند.

یک پیام راهنما برای دستور wsimport نمایش می‌دهد.

یک سرور پروکسی HTTP را مشخص می‌کند. مقدار پیش‌فرض 8080 است.

فایل‌های تولیدشده را نگه می‌دارد.

نام بسته (package) مقصد را تعیین می‌کند تا سفارشی‌سازی‌های پیونددهی WSDL و اسکیما، و الگوریتم پیش‌فرض تعریف‌شده در مشخصات لغو شود.

محل قرارگیری فایل‌های منبع تولیدشده را مشخص می‌کند.

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

اطلاعات نسخه انتشار را چاپ می‌کند.

مقدار @WebServiceClient.wsdlLocation را مشخص می‌کند.

کد را بر اساس نسخه مشخص‌شده از استانداردهای JAX-WS تولید می‌کند. نسخه 2.0 کدهای منطبق با مشخصات JAX-WS 2.0 را تولید می‌کند.

خروجی دستور wsimport را بی‌صدا می‌کند.

می‌توان چندین فایل پیونددهی JAX-WS و JAXB را با استفاده از گزینه -b مشخص کرد و از آن‌ها برای سفارشی‌سازی موارد گوناگون مانند نام بسته‌ها و نام بین‌ها بهره برد. اطلاعات بیشتر درباره فایل‌های پیونددهی JAX-WS و JAXB را می‌توانید در مستندات سفارشی‌سازی در نشانی https://jax-ws.dev.java.net/nonav/2.1.1/docs/customizations.html بیابید.


سرفصل‌هایی (Headers) را که به پیام درخواست یا پاسخ مقید نشده‌اند، به پارامترهای متد جاوا نگاشت می‌کند.

شناسه WSDL URI که فایل حاوی اطلاعات احراز هویت را مشخص می‌کند. این URI در قالب زیر است:

http://user-name:password@host-name/web-service-name>?wsdl.


اطلاعات اشکال‌زدایی را چاپ می‌کند.

پیوند داده‌های W3C EndpointReferenceType به جاوا را فعال می‌کند.

فایل‌های جاوای تولیدشده را کامپایل نمی‌کند.

مثال زیر آرتیفکت‌های جاوا را با وارد کردن http://stockquote.example.com/quote?wsdl تولید و کامپایل می‌کند:

wsimport -p stockquote http://stockquote.example.com/quote?wsdl

•
wsgen(1)
•
برگه ابزارها در صفحه Wsimport Ant Task در http://jax-ws.java.net/nonav/2.1.1/docs/wsimportant.html
•
برگه راهنمای کاربران در صفحه Catalog Support در http://jax-ws.java.net/nonav/2.1.1/docs/catalog-support.html
•
برگه راهنمای کاربران در صفحه WSDL Customization در http://jax-ws.java.net/nonav/2.1.1/docs/wsimportant.html
21 November 2013 JDK 8