|
CreateObject: web service object
DescriptionThis
function can create a web service object.
ReturnsA web
service object.
Function syntaxCreateObject(type, urltowsdl[, portname, wsdl2JavaArgs])
OR
CreateObject(type, urltowsdl, argStruct)
Parameters
Parameter
|
Description
|
type
|
Type of object to create.
com
corba
java
component
webservice
|
urltowsdl
|
Specifies the URL to web service WSDL file.
One of the following:
|
portname
|
The port name for the web service. This
value is case-sensitive and corresponds to the port element’s name attribute under
the service element. Specify this parameter if
the web service contains multiple ports. If no port name is specified,
ColdFusion uses the first port found in the WSDL.
|
wsdl2JavaArgs
|
A string containing a space-delimited list
of arguments to pass to the WSDL2Java tool that generates Java stubs
for the web services. Useful arguments include the following:
-W or --noWrapped: Turns
off the special treatment of wrapped document/literal style operations.
-a or --all: Generates
code for all elements in the WSDL, even unreferenced ones.
-w or --wrapArrays: Prefers
building beans to straight arrays for wrapped XML array types. This
switch is not in included in the Axis documentation.
For
detailed information on valid arguments, see the Apache Axis WSDL2Java Reference.
|
argStruct
|
A structure containing web service configuration
arguments. For more information see Usage
|
UsageYou can
use the CreateObject function to create a web service.
The argStruct structure
can contain any combination of the following values:
Name
|
Default
|
Description
|
password
|
Password set in the Administrator, if any
|
The password to use to access the web service.
If the webservice attribute specifies a web service
name configured in the Administrator, overrides any user name specified
in the Administrator entry.
|
port
|
|
See portname in the Syntax
Parameter table.
|
proxyPassword
|
http.proxyPassword system property, if any
|
The user’s password on the proxy server.
|
proxyPort
|
http.proxyPort system property, if any
|
The port to use on the proxy server.
|
proxyServer
|
http.proxyHost system property, if any
|
The proxy server required to access the
webservice URL.
|
proxyUser
|
http.proxyUser system property, if any
|
The user ID to send to the proxy server.
|
refreshWSDL
|
no
|
|
saveJava
|
no
|
|
timeout
|
0 (no time-out)
|
The time-out for retrieving the web service
WSDL, in seconds.
|
username
|
User name set in the Administrator, if any
|
The user name to use to access the web service.
If the webservice attribute specifies a web service
name configured in the Administrator, overrides any user name specified
in the Administrator entry.
|
wsdl2javaArgs
|
|
See the Syntax parameter table.
|
Example<cfscript>
ws = CreateObject("webservice",
"http://www.xmethods.net/sd/2001/TemperatureService.wsdl");
xlatstring = ws.getTemp(zipcode = "55987");
writeoutput("The temperature at 55987 is " & xlatstring);
</cfscript>
|