SOAPServer-class            package:SSOAP            R Documentation

_C_l_a_s_s_e_s _f_o_r _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 classes provide a way to describe the location of a SOAP
     server. This is separate from the servers actions.  Rather, we use
     this to  represent the identity of the server in terms of its Web
     address, i.e.  the machine name or IP address, port number and URI
     or path within the server.  The different classes represent the
     communication protocol, typically HTTP or HTTPS, i.e. HTTP over
     SSL, the secure communication protocol.

     A DynamicSOAPServer might be better termed a ``compiled'' server. 
     It contains information about the methods and data types
     accessible via the server. This information is converted into R
     classes and functions that can be used to invoke the server's
     methods.

     DynamicSOAPServer does not extend SOAPServer currently. Rather, it
     contains a SOAPServer.  This is because we need to be able to
     determine the protocol and so have different types of SOAPServer
     objects associated with the interface methods. This class
     hierarchy may change in the future.

_O_b_j_e_c_t_s _f_r_o_m _t_h_e _C_l_a_s_s:

     The function  'SOAPServer' is used as the general constructor.
     Alternatively, one can use the 'new' syntax, 'new("HTTPServer",
     host = "www.omegahat.org", url = "theServer")'

_S_l_o_t_s:

     '_h_o_s_t': Object of class '"character"'. The machine name or IP
          address of the server.

     '_p_o_r_t': Object of class '"integer"'. The port number, if other
          than the default HTTP port 80. 

     '_u_r_l': Object of class '"character"'.  The document within the
          server that is the location of the server.

_M_e_t_h_o_d_s:

     $ 'signature(x = "SOAPServer", name = "character")':  returns a
          function that will invoke the server's method whose name is
          given by 'name'. This is merely syntactic sugar to allow the
          expression 'server\$foo(1, 2, 3)'  to invoke the method foo
          in the remote server.

     $ 'signature(x = "DynamicSOAPServer", name = "character")': 
          returns a function that will invoke the server's method whose
          name is given by 'name'. This is merely syntactic sugar to
          allow the expression 'server\$foo(1, 2, 3)'  to invoke the
          method foo in the remote server. 

     _n_a_m_e_s 'signature(x = "DynamicSOAPServer")'{ returns the names of
          the server's available methods. }

_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:

     'SOAPServer'

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

