R: Create a SOAP server object

SOAPServer {SSOAP} | R Documentation

## Create a SOAP server object

### Description

These are constructors for the basic `SOAPServer` class which represent the location of the web services and methods. The basic `SOAPServer-class` is used to identify the host, port and URL of a SOAP server. The dynamic SOAP server is represented by the class `DynamicSOAPServer-class` and that contains not only the location of the SOAP server, but also information about its methods and data types. This information is typically read from a Web Services Description Language (WSDL) file.

We can use the form `server$method(arg1, arg2, ...)` to invoke a method in both types of server.

### Usage

    SOAPServer(host, url, port = NA, s = new(className))
    dynamicSOAPServer(iface, obj = new("DynamicSOAPServer"))

### Arguments

`host` | typically, the name of the host machine, e.g. `"www.omegahat.org"`. Alternatively, a complete URL (e.g. `http://www.omegahat.org/SOAP`) may be given as the value for host and the individual parts are extracted from this.
`url` | the file/URL within the server that contains the SOAP server. If this is omitted, we attempt to find the value from the value of `host`.
`port` | the port number on which the server is listening. This is typically 80, the standard HTTP port. However, one can specify this when creating the S server object to identify a different port. This is useful when testing a server since one can use a user-level port. It is left as `NA` if not specified to indicate that it was not explicitly set to 80.
`s` | the object being created and initialized. Having this as an argument allows the caller to specify the class of the desired object and supply a partially initialized value and still get the “standard” initialization for the server object. `className` is computed in the body of the function and this mechanism works via lazy evaluation.
`iface` | this is an object of class `SOAPClientInterface-class` typically returned from a call to `genSOAPClientInterface`. This represents the collection of methods that the SOAP server provides.

.

`obj` | the object that will be returned from the `dymanicSOAPServer` function. This is specified with a default value so that this constructor can be easily reused for derived classes. Typically, a user-level call to this function will not need to specify this.

### Value

An object of class `HTTPSOAPServer`, `FTPSOAPServer` or `SOAPServer`. If the host is specified with an `ftp:` or `http:` prefix, an object of class `FTPSOAPServer` or `HTTPSOAPServer` respectively is returned. Otherwise, a generic `SOAPServer` is created.

### Note

In the future, we will use a `SOAPConnection` class that builds on the server and maintains a connection to the server. The URL may get dropped from the server as we can use the same basic host and port combination with different URLs for different requests. Experience will give us a better handle on an appropriate interface.

Also, we may store a server-specific, default SOAPAction value in the server.

### Author(s)

Duncan Temple Lang <duncan@wald.ucdavis.edu>

### References

http://www.w3.org/TR/SOAP/ http://www.omegahat.org/SSOAP, http://www.omegahat.org/bugs.

### See Also

`.SOAP` `$`

### Examples

    server = SOAPServer("www.nanonull.com", "TimeService/TimeService.asmx")

[Package SSOAP version 0.91-0 Index]