soapsuds(1)                 General Commands Manual                soapsuds(1)

نام (NAME)
       soapsuds - تولیدکننده کدهای کلاینت و WSDL از روی اسمبلی‌های دات‌نت Mono

خلاصه دستور (SYNOPSIS)
       soapsuds [گزینه‌ها] [ورودی‌ها] [خروجی‌ها]

توضیحات (DESCRIPTION)
       ابزار soapsuds برای تولید اسناد WSDL و پروکسی‌های کلاینت جهت سرویس‌های
       Remoting به کار می‌رود.  یک سند WSDL متدهایی را که یک سرویس ارائه می‌دهد
       همراه با طرح‌واره‌های XML تمام ساختارهای داده‌ای ارجاع‌شده توصیف می‌کند. یک
       پروکسی کلاینت کلاسی است که همان متدهای سرویس مربوطه را ارائه می‌دهد، اما
       پیاده‌سازی ندارد و فقط فراخوانی‌ها را به سرویس راه دور (Remote Service)
       فوروارد می‌کند.

       پروکسی‌های کلاینت تولیدشده الزاماً ضروری نیستند، زیرا زمان اجرای برنامه
       (Runtime) می‌تواند به صورت خودکار از روی انواع اصلی سرویس، پروکسی ایجاد
       کند. با این حال، این کار مستلزم توزیع کلاس سرویس بین تمام کلاینت‌ها است.
       در برخی سناریوها رویکرد بهتر استفاده از soapsuds برای تولید یک کلاس
       پروکسی است که رابطی یکسان با سرویس دارد، اما بدون هیچ پیاده‌سازی است.

       ابزار soapsuds می‌تواند از مجموعه‌ای از انواع مشخص‌شده با گزینه -types یک
       سند WSDL تولید کند یا انواع را از یک اسمبلی مشخص‌شده با گزینه
       -inputassemblyfile استخراج نماید. در حالت اخیر، soapsuds طرح‌واره‌های
       مربوط به تمام کلاس‌های قابل سریال‌سازی را در سند WSDL قرار می‌دهد.

       با دریافت یک سند WSDL به عنوان ورودی (یا هر چیزی که بتوان چنین سندی را
       از روی آن تولید کرد)، این ابزار می‌تواند سورس‌کد پروکسی کلاینت را تولید
       کند (با استفاده از گزینه -gc) یا مستقیماً یک اسمبلی تولید کند که پروکسی
       را پیاده‌سازی می‌کند (با استفاده از گزینه -outputassemblyfile).  همچنین
       soapsuds کلاس‌های سریال‌سازی ساختگی را برای تمام انواع تعریف‌شده در
       طرح‌واره تولید می‌کند. با این حال توجه داشته باشید که این کلاس‌ها فاقد
       معناشناسی کلاس‌های اصلی خواهند بود، زیرا تنها ساختار داده‌ای تولید می‌شود.

منابع ورودی (INPUT SOURCES)
       منابع زیر در دسترس هستند (تنها یک مورد می‌تواند مشخص شود):

       -urltoschema:url -url:url
              آدرس اینترنتی (URL) برای دریافت سند WSDL.

       -types:type1,assembly[,serviceEndPoint][;type2,assembly[,serviceEndPoint]]...
              انواعی را مشخص می‌کند که باید برای آن‌ها طرح‌واره یا پروکسی تولید
              شود. اگر نقطه پایانی سرویس (Service Endpoint) ارائه نشود، از
              مقدار ارائه‌شده در گزینه -serviceendpoint استفاده خواهد شد.

       -inputassemblyfile:file , -ia:file
              اسمبلی حاوی انواع داده‌ای برای خروجی گرفتن.

       -inputschemafile:schema , -is:schema
              طرح‌واره‌ای که کلاس‌های پروکسی از روی آن تولید می‌شوند.

گزینه‌های ورودی (INPUT OPTIONS)
       گزینه‌های زیر در دسترس هستند:

       -inputdirectory:directory , -id:directory
              دایرکتوری محل قرارگیری فایل‌های DLL.

       -serviceendpoint:url , -se:url
              آدرس اینترنتی (URL) سرویس که در سند WSDL قرار می‌گیرد.

خروجی‌ها (OUTPUTS)
       گزینه‌های خروجی زیر در دسترس هستند (بیش از یک مورد می‌تواند مشخص شود):

       -outputassemblyfile:file , -oa:file
              کد پروکسی را تولید کرده و آن را در یک اسمبلی با نام ارائه‌شده
              کامپایل می‌کند.

       -outputschemafile:file , -os:file
              یک سند WSDL تولید می‌کند که انواع ارائه‌شده را نمایش می‌دهد.

       -generatecode , -gc
              سورس‌کد پروکسی را برای سند WSDL یا انواع ارائه‌شده تولید می‌کند.

گزینه‌های خروجی (OUTPUT OPTIONS)
       گزینه‌های زیر در دسترس هستند:

       -outputdirectory:directory , -od:directory
              دایرکتوری محل ذخیره فایل‌های تولیدشده.

       -proxynamespace:namespace , -pn:namespace
              فضای نام (Namespace) پروکسی تولیدشده.

       -nowrappedproxy , -nowp
              پروکسی بسته‌بندی‌شده (Wrapped Proxy) تولید نشود.

       -wrappedproxy , -wp
              پروکسی بسته‌بندی‌شده (Wrapped Proxy) تولید شود.

       -strongnamefile:file , -sn:file
              فایل کلید نام قوی (Strong Name File).

گزینه‌های عمومی (GENERAL OPTIONS)
       گزینه‌های زیر در دسترس هستند:

       -nologo
              عدم نمایش لوگو و پیام آغازین برنامه.

       -u:username , -user:username
              نام کاربری برای اتصال به سرور.

       -p:password , -password:password
              گذرواژه برای اتصال به سرور.

       -d:domain , -domain:domain
              دامنه (Domain) برای اتصال به سرور.

       -httpproxyname:name , -hpn:name
              نام پروکسی HTTP.

       -httpproxyport:port , -hpp:port
              درگاه (Port) پروکسی HTTP.

نویسندگان (AUTHORS)
       Lluis Sanchez Gual (lluis@ximian.com)

مجوز (LICENSE)
       این برنامه تحت شرایط مجوز عمومی همگانی گنو (GNU GPL) منتشر شده است.

همچنین ببینید (SEE ALSO)
       wsdl(1), disco(1), mono(1), mcs(1)

                                                                   soapsuds(1)