soap-nhttp.h File Reference

Go to the source code of this file.

Defines
#define	SOAP_NHTTP_SOAP_ACTION   "SoapAction"
Functions
herror_t	soap_nhttp_server_init_args (int argc, char **argv)
herror_t	soap_nhttp_server_run (void)
void	soap_nhttp_server_destroy (void)
herror_t	soap_nhttp_register (const char *context)
short	soap_nhttp_get_port (void)
const char *	soap_nhttp_get_protocol (void)
herror_t	soap_nhttp_client_init_args (int argc, char **argv)
herror_t	soap_nhttp_client_invoke (void *unused, struct SoapCtx *req, struct SoapCtx **res)
void	soap_nhttp_client_destroy (void)

---

Detailed Description

Using SOAP in HTTP

This section describes how to use SOAP within HTTP with or without using the HTTP Extension Framework. Binding SOAP to HTTP provides the advantage of being able to use the formalism and decentralized flexibility of SOAP with the rich feature set of HTTP. Carrying SOAP in HTTP does not mean that SOAP overrides existing semantics of HTTP but rather that the semantics of SOAP over HTTP maps naturally to HTTP semantics.

SOAP naturally follows the HTTP request/response message model providing SOAP request parameters in a HTTP request and SOAP response parameters in a HTTP response. Note, however, that SOAP intermediaries are NOT the same as HTTP intermediaries. That is, an HTTP intermediary addressed with the HTTP Connection header field cannot be expected to inspect or process the SOAP entity body carried in the HTTP request.

HTTP applications MUST use the media type "text/xml" according to RFC 2376 when including SOAP entity bodies in HTTP messages.

See also:

http://www.ietf.org/rfc/rfc2376.txt

---

Define Documentation

#define SOAP_NHTTP_SOAP_ACTION   "SoapAction"

The SOAPAction HTTP request header field can be used to indicate the intent of the SOAP HTTP request. The value is a URI identifying the intent. SOAP places no restrictions on the format or specificity of the URI or that it is resolvable. An HTTP client MUST use this header field when issuing a SOAP HTTP Request. The presence and content of the SOAPAction header field can be used by servers such as firewalls to appropriately filter SOAP request messages in HTTP. The header field value of empty string ("") means that the intent of the SOAP message is provided by the HTTP Request-URI. No value means that there is no indication of the intent of the message.

---

Function Documentation

void soap_nhttp_client_destroy (  void   )

herror_t soap_nhttp_client_init_args (  int  argc, char **  argv )

herror_t soap_nhttp_client_invoke (  void *  unused, struct SoapCtx *  req, struct SoapCtx **  res )

short soap_nhttp_get_port (  void   )

const char* soap_nhttp_get_protocol (  void   )

herror_t soap_nhttp_register (  const char *  context  )

void soap_nhttp_server_destroy (  void   )

herror_t soap_nhttp_server_init_args (  int  argc, char **  argv )

herror_t soap_nhttp_server_run (  void   )

---