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



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

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

       wsimport [ options ] wsdl


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

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

توضیحات (DESCRIPTION)
       دستور 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



گزینه‌ها (OPTIONS)
       -d directory
              محل قرارگیری فایل‌های خروجی تولیدشده را مشخص می‌کند.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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



همچنین ببینید (SEE ALSO)
       • 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

JDK 8                          21 November 2013                    wsimport(1)