1soapsuds(1)                 General Commands Manual                soapsuds(1)
2
3
4

NAME

6       soapsuds - Mono's Remoting Proxy Generator
7

SYNOPSIS

9       soapsuds [options] [inputs] [outputs]
10

DESCRIPTION

12       soapsuds is a tool for generating WSDL documents and client proxies for
13       remoting services.  A WSDL document describes the methods that  a  ser‐
14       vice  provides  together with XML schemas of all referenced data struc‐
15       tures. A client proxy is a class which offers the same methods  as  the
16       service it represents, but provides no implementation, it just forwards
17       calls to the remote service.
18
19       Generated client proxies are not strictly necessary, since the  runtime
20       can  automatically  generate  proxies  from the original service types.
21       However, it implies the need of distributing the service class  to  all
22       clients. In some scenarios a better approach is to use soapsuds to gen‐
23       erate a proxy class which has the same interface as  the  service,  but
24       without any implementation.
25
26       soapsuds  can  generate  a  WSDL document from a set of types specified
27       with the option -types or can extract the types from an assembly speci‐
28       fied with -inputassemblyfile.  In this last case, soapsuds will include
29       schemas for all serializable classes in the WSDL document.
30
31       Taking as input a WSDL document (or anything from which  such  document
32       can  be  generated)  the  tool  can generate source code for the client
33       proxy (using the -gc option) or it can directly  generate  an  assembly
34       that  implements the proxy (with the -outputassemblyfile option). soap‐
35       suds will also generate fake serializable classes for all types defined
36       in  the schema. However, beware that those classes will lack the seman‐
37       tics of the original classes, since only data structure is generated.
38

INPUT SOURCES

40       The following sources are available (only one can be specified):
41
42       -urltoschema:url -url:url
43              Url from which to retrieve the WSDL document.
44
45       -types:type1,assembly[,serviceEndPoint][;type2,assembly[,serviceEnd‐
46       Point]]...
47              Specifies  types  for which to generate a schema or proxy. If no
48              service endpoint is provided, the one provided  with  the  -ser‐
49              viceendpoint option is used.
50
51       -inputassemblyfile:file , -ia:file
52              Assembly that contains the types to export.
53
54       -inputschemafile:schena , -is:schema
55              Schema from which to generate proxy classes.
56

INPUT OPTIONS

58       The following options are available:
59
60       -inputdirectory:directory , -id:directory
61              Directory where DLLs are located.
62
63       -serviceendpoint:url , -se:url
64              Url of the service to be placed in the WSDL document.
65

OUTPUTS

67       The following output options are available (more than one can be speci‐
68       fied):
69
70       -outputassemblyfile:file , -oa:file
71              Generates the proxy code and compiles it into an  assembly  with
72              the provided name.
73
74       -outputschemafile:file , -os:file
75              Generates a WSDL document that represents the provided types.
76
77       -generatecode , -gc
78              Generates  proxy  source  code for the provided WSDL document or
79              types.
80

OUTPUT OPTIONS

82       The following options are available:
83
84       -outputdirectory:directory , -od:directory
85              Directory where generated files will be placed.
86
87       -proxynamespace:namespace , -pn:namespace
88              Namespace of the generated proxy.
89
90       -nowrappedproxy , -nowp
91              Do not generate a wrapped proxy.
92
93       -wrappedproxy , -wp
94              Generate a wrapped proxy.
95
96       -strongnamefile:file , -sn:file
97              Strong name file.
98

GENERAL OPTIONS

100       The following options are available:
101
102       -nologo
103              Supress the startup logo.
104
105       -u:username , -user:username
106              The user name to use when connecting to the server.
107
108       -p:password , -password:password
109              The password to use when connecting to the server.
110
111       -d:domain , -domain:domain
112              The domain to use when connecting to the server.
113
114       -httpproxyname:name , -hpn:name
115              Name of the http proxy.
116
117       -httpproxyport:port , -hpp:port
118              Port of the http proxy.
119

AUTHORS

121       Lluis Sanchez Gual (lluis@ximian.com)
122

LICENSE

124       wsdl is released under the terms of the GNU GPL.
125

SEE ALSO

127       wsdl(1), disco(1), mono(1), mcs(1)
128
129
130
131                                                                   soapsuds(1)
Impressum