SOAPServer               package:SSOAP               R Documentation

_C_r_e_a_t_e _a _S_O_A_P _s_e_r_v_e_r _o_b_j_e_c_t

_D_e_s_c_r_i_p_t_i_o_n:

     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.

_U_s_a_g_e:

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

_A_r_g_u_m_e_n_t_s:

    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.

_V_a_l_u_e:

     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.

_N_o_t_e:

     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.

_A_u_t_h_o_r(_s):

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

_R_e_f_e_r_e_n_c_e_s:

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

_S_e_e _A_l_s_o:

     '.SOAP' '$'

_E_x_a_m_p_l_e_s:

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

