diff --git a/src/docbkx/server.xml b/src/docbkx/server.xml index c2dc519e..0b853b89 100644 --- a/src/docbkx/server.xml +++ b/src/docbkx/server.xml @@ -433,6 +433,78 @@ ]]> +
+ Embedded HTTP Server transport + + Spring Web Services provides a transport based on Sun's JRE 1.6 + HTTP server. + The embedded HTTP Server is a standalone server that is simple to configure. It lends itself to a lighter + alternative to conventional servlet containers. + + + When using the embedded HTTP server, no external deployment descriptor is needed + (web.xml). + You only need to define an instance of the server and configure it to handle incoming requests. + The remoting module in the Core Spring Framework contains a convenient factory bean for the HTTP server: + the SimpleHttpServerFactoryBean. + The most important property is contexts, which maps context paths to corresponding + HttpHandlers. + + + Spring Web Services provides 2 implementations of the HttpHandler + interface: WsdlDefinitionHttpHandler + and WebServiceMessageReceiverHttpHandler. + The former maps an incoming GET request to a WsdlDefinition. + The latter is responsible for handling POST requests for web services messages and thus + needs a WebServiceMessageFactory (typically a + SaajSoapMessageFactory) and a + WebServiceMessageReceiver (typically the + SoapMessageDispatcher) to accomplish its task. + + + To draw parallels with the servlet world, the contexts property plays + the role of servlet mappings in web.xml and the + WebServiceMessageReceiverHttpHandler is the equivalent of + a MessageDispatcherServlet. + + + The following snippet shows a simple configuration example of the HTTP server + transport: + + + + + + + + + + + + + + + + + + + + + + + + + + + +]]> + + + For more information on the SimpleHttpServerFactoryBean, refer to the + Javadoc. + +
Endpoints