.\"
.\" soapsuds manual page.
.\" (C) 2003 Novell, Inc.
.\" Author:
.\"   Lluis Sanchez Gual (lluis@ximian.com)
.\"
.TH soapsuds 1
.SH "نام (NAME)"
soapsuds \- تولیدکننده کدهای کلاینت و WSDL از روی اسمبلی‌های دات‌نت Mono
.SH "خلاصه دستور (SYNOPSIS)"
.PP
.B soapsuds
[\fIگزینه‌ها\fR] [\fIورودی‌ها\fR] [\fIخروجی‌ها\fR]
.SH "توضیحات (DESCRIPTION)"
ابزار
.I soapsuds
برای تولید اسناد WSDL و پروکسی‌های کلاینت جهت سرویس‌های Remoting به کار می‌رود.
یک سند WSDL متدهایی را که یک سرویس ارائه می‌دهد همراه با طرح‌واره‌های XML تمام ساختارهای داده‌ای ارجاع‌شده توصیف می‌کند. یک پروکسی کلاینت کلاسی است که همان متدهای سرویس مربوطه را ارائه می‌دهد، اما پیاده‌سازی ندارد و فقط فراخوانی‌ها را به سرویس راه دور (Remote Service) فوروارد می‌کند.
.PP
پروکسی‌های کلاینت تولیدشده الزاماً ضروری نیستند، زیرا زمان اجرای برنامه (Runtime) می‌تواند به صورت خودکار از روی انواع اصلی سرویس، پروکسی ایجاد کند. با این حال، این کار مستلزم توزیع کلاس سرویس بین تمام کلاینت‌ها است. در برخی سناریوها رویکرد بهتر استفاده از
.I soapsuds
برای تولید یک کلاس پروکسی است که رابطی یکسان با سرویس دارد، اما بدون هیچ پیاده‌سازی است.
.PP
ابزار
.I soapsuds
می‌تواند از مجموعه‌ای از انواع مشخص‌شده با گزینه
.I \-types
یک سند WSDL تولید کند یا انواع را از یک اسمبلی مشخص‌شده با گزینه
.I \-inputassemblyfile
استخراج نماید. در حالت اخیر، soapsuds طرح‌واره‌های مربوط به تمام کلاس‌های قابل سریال‌سازی را در سند WSDL قرار می‌دهد.
.PP
با دریافت یک سند WSDL به عنوان ورودی (یا هر چیزی که بتوان چنین سندی را از روی آن تولید کرد)، این ابزار می‌تواند سورس‌کد پروکسی کلاینت را تولید کند (با استفاده از گزینه
.IR \-gc )
یا مستقیماً یک اسمبلی تولید کند که پروکسی را پیاده‌سازی می‌کند (با استفاده از گزینه
.IR \-outputassemblyfile ).
همچنین soapsuds کلاس‌های سریال‌سازی ساختگی را برای تمام انواع تعریف‌شده در طرح‌واره تولید می‌کند. با این حال توجه داشته باشید که این کلاس‌ها فاقد معناشناسی کلاس‌های اصلی خواهند بود، زیرا تنها ساختار داده‌ای تولید می‌شود.
.PP
.SH "منابع ورودی (INPUT SOURCES)"
منابع زیر در دسترس هستند (تنها یک مورد می‌تواند مشخص شود):
.TP
.I "\-urltoschema:url" "\-url:url"
آدرس اینترنتی (URL) برای دریافت سند WSDL.
.TP
.I "\-types:type1,assembly[,serviceEndPoint][;type2,assembly[,serviceEndPoint]]..."
انواعی را مشخص می‌کند که باید برای آن‌ها طرح‌واره یا پروکسی تولید شود. اگر نقطه پایانی سرویس (Service Endpoint) ارائه نشود، از مقدار ارائه‌شده در گزینه
.I \-serviceendpoint
استفاده خواهد شد.
.TP
.I "\-inputassemblyfile:file", "\-ia:file"
اسمبلی حاوی انواع داده‌ای برای خروجی گرفتن.
.TP
.I "\-inputschemafile:schema", "\-is:schema"
طرح‌واره‌ای که کلاس‌های پروکسی از روی آن تولید می‌شوند.
.SH "گزینه‌های ورودی (INPUT OPTIONS)"
گزینه‌های زیر در دسترس هستند:
.TP
.I "\-inputdirectory:directory", "\-id:directory"
دایرکتوری محل قرارگیری فایل‌های DLL.
.TP
.I "\-serviceendpoint:url", "\-se:url"
آدرس اینترنتی (URL) سرویس که در سند WSDL قرار می‌گیرد.
.SH "خروجی‌ها (OUTPUTS)"
گزینه‌های خروجی زیر در دسترس هستند (بیش از یک مورد می‌تواند مشخص شود):
.TP
.I "\-outputassemblyfile:file", "\-oa:file"
کد پروکسی را تولید کرده و آن را در یک اسمبلی با نام ارائه‌شده کامپایل می‌کند.
.TP
.I "\-outputschemafile:file", "\-os:file"
یک سند WSDL تولید می‌کند که انواع ارائه‌شده را نمایش می‌دهد.
.TP
.I "\-generatecode", "\-gc"
سورس‌کد پروکسی را برای سند WSDL یا انواع ارائه‌شده تولید می‌کند.
.SH "گزینه‌های خروجی (OUTPUT OPTIONS)"
گزینه‌های زیر در دسترس هستند:
.TP
.I "\-outputdirectory:directory", "\-od:directory"
دایرکتوری محل ذخیره فایل‌های تولیدشده.
.TP
.I "\-proxynamespace:namespace", "\-pn:namespace"
فضای نام (Namespace) پروکسی تولیدشده.
.TP
.I "\-nowrappedproxy", "\-nowp"
پروکسی بسته‌بندی‌شده (Wrapped Proxy) تولید نشود.
.TP
.I "\-wrappedproxy", "\-wp"
پروکسی بسته‌بندی‌شده (Wrapped Proxy) تولید شود.
.TP
.I "\-strongnamefile:file", "\-sn:file"
فایل کلید نام قوی (Strong Name File).
.SH "گزینه‌های عمومی (GENERAL OPTIONS)"
گزینه‌های زیر در دسترس هستند:
.TP
.I "\-nologo"
عدم نمایش لوگو و پیام آغازین برنامه.
.TP
.I "\-u:username", "\-user:username"
نام کاربری برای اتصال به سرور.
.TP
.I "\-p:password", "\-password:password"
گذرواژه برای اتصال به سرور.
.TP
.I "\-d:domain", "\-domain:domain"
دامنه (Domain) برای اتصال به سرور.
.TP
.I "\-httpproxyname:name", "\-hpn:name"
نام پروکسی HTTP.
.TP
.I "\-httpproxyport:port", "\-hpp:port"
درگاه (Port) پروکسی HTTP.
.PP
.SH "نویسندگان (AUTHORS)"
Lluis Sanchez Gual (lluis@ximian.com)
.PP
.SH "مجوز (LICENSE)"
این برنامه تحت شرایط مجوز عمومی همگانی گنو (GNU GPL) منتشر شده است.
.PP
.SH "همچنین ببینید (SEE ALSO)"
.BR wsdl (1),
.BR disco (1),
.BR mono (1),
.BR mcs (1)