NAME
soapsuds - Mono's Remoting Proxy Generator
SYNOPSIS
soapsuds [options] [inputs] [outputs]
DESCRIPTION
soapsuds is a tool for generating WSDL documents and client proxies for
remoting services. A WSDL document describes the methods that a
service provides together with XML schemas of all referenced data
structures. A client proxy is a class which offers the same methods as
the service it represents, but provides no implementation, it just
forwards calls to the remote service.
Generated client proxies are not strictly necessary, since the runtime
can automatically generate proxies from the original service types.
However, it implies the need of distributing the service class to all
clients. In some scenarios a better approach is to use soapsuds to
generate a proxy class which has the same interface as the service, but
without any implementation.
soapsuds can generate a WSDL document from a set of types specified
with the option -types or can extract the types from an assembly
specified with -inputassemblyfile. In this last case, soapsuds will
include schemas for all serializable classes in the WSDL document.
Taking as input a WSDL document (or anything from which such document
can be generated) the tool can generate source code for the client
proxy (using the -gc option) or it can directly generate an assembly
that implements the proxy (with the -outputassemblyfile option).
soapsuds will also generate fake serializable classes for all types
defined in the schema. However, beware that those classes will lack the
semantics of the original classes, since only data structure is
generated.
INPUT SOURCES
The following sources are available (only one can be specified):
-urltoschema:url -url:url
Url from which to retrieve the WSDL document.
-types:type1,assembly[,serviceEndPoint][;type2,assembly[,serviceEndPoint]]...
Specifies types for which to generate a schema or proxy. If no
service endpoint is provided, the one provided with the
-serviceendpoint option is used.
-inputassemblyfile:file , -ia:file
Assembly that contains the types to export.
-inputschemafile:schena , -is:schema
Schema from which to generate proxy classes.
INPUT OPTIONS
The following options are available:
-inputdirectory:directory , -id:directory
Directory where DLLs are located.
-serviceendpoint:url , -se:url
Url of the service to be placed in the WSDL document.
OUTPUTS
The following output options are available (more than one can be
specified):
-outputassemblyfile:file , -oa:file
Generates the proxy code and compiles it into an assembly with
the provided name.
-outputschemafile:file , -os:file
Generates a WSDL document that represents the provided types.
-generatecode , -gc
Generates proxy source code for the provided WSDL document or
types.
OUTPUT OPTIONS
The following options are available:
-outputdirectory:directory , -od:directory
Directory where generated files will be placed.
-proxynamespace:namespace , -pn:namespace
Namespace of the generated proxy.
-nowrappedproxy , -nowp
Do not generate a wrapped proxy.
-wrappedproxy , -wp
Generate a wrapped proxy.
-strongnamefile:file , -sn:file
Strong name file.
GENERAL OPTIONS
The following options are available:
-nologo
Supress the startup logo.
-u:username , -user:username
The user name to use when connecting to the server.
-p:password , -password:password
The password to use when connecting to the server.
-d:domain , -domain:domain
The domain to use when connecting to the server.
-httpproxyname:name , -hpn:name
Name of the http proxy.
-httpproxyport:port , -hpp:port
Port of the http proxy.
AUTHORS
Lluis Sanchez Gual (lluis@ximian.com)
LICENSE
wsdl is released under the terms of the GNU GPL.
SEE ALSO
wsdl(1), disco(1), mono(1), mcs(1)
soapsuds(1)