1soapsuds(1) General Commands Manual soapsuds(1)
2
6 soapsuds - Mono's Remoting Proxy Generator
7
9 soapsuds [options] [inputs] [outputs]
10
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 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 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 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
40 The following sources are available (only one can be specified):
41 -urltoschema:url -url:url
43 Url from which to retrieve the WSDL document.
44 -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 -inputassemblyfile:file , -ia:file
52 Assembly that contains the types to export.
53 -inputschemafile:schena , -is:schema
55 Schema from which to generate proxy classes.
56
58 The following options are available:
59 -inputdirectory:directory , -id:directory
61 Directory where DLLs are located.
62 -serviceendpoint:url , -se:url
64 Url of the service to be placed in the WSDL document.
65
67 The following output options are available (more than one can be speci‐
68 fied):
69 -outputassemblyfile:file , -oa:file
71 Generates the proxy code and compiles it into an assembly with
72 the provided name.
73 -outputschemafile:file , -os:file
75 Generates a WSDL document that represents the provided types.
76 -generatecode , -gc
78 Generates proxy source code for the provided WSDL document or
79 types.
80
82 The following options are available:
83 -outputdirectory:directory , -od:directory
85 Directory where generated files will be placed.
86 -proxynamespace:namespace , -pn:namespace
88 Namespace of the generated proxy.
89 -nowrappedproxy , -nowp
91 Do not generate a wrapped proxy.
92 -wrappedproxy , -wp
94 Generate a wrapped proxy.
95 -strongnamefile:file , -sn:file
97 Strong name file.
98
100 The following options are available:
101 -nologo
103 Supress the startup logo.
104 -u:username , -user:username
106 The user name to use when connecting to the server.
107 -p:password , -password:password
109 The password to use when connecting to the server.
110 -d:domain , -domain:domain
112 The domain to use when connecting to the server.
113 -httpproxyname:name , -hpn:name
115 Name of the http proxy.
116 -httpproxyport:port , -hpp:port
118 Port of the http proxy.
119
121 Lluis Sanchez Gual (lluis@ximian.com)
122
124 wsdl is released under the terms of the GNU GPL.
125
127 wsdl(1), disco(1), mono(1), mcs(1)
128 soapsuds(1)