From d364beafb169e605e8b8bb4757895f8ba7c785b6 Mon Sep 17 00:00:00 2001
From: Arjen Poutsma <apoutsma@vmware.com>
Date: Tue, 15 May 2007 00:24:28 +0000
Subject: [PATCH] More Docs.

---
 src/docbkx/client.xml                    |   2 +-
 src/docbkx/common.xml                    |  54 +++++------
 src/docbkx/resources/images/sequence.png | Bin 0 -> 12492 bytes
 src/docbkx/security.xml                  |   4 +-
 src/docbkx/server.xml                    | 115 ++++++++++++++++++++---
 5 files changed, 134 insertions(+), 41 deletions(-)
 create mode 100644 src/docbkx/resources/images/sequence.png

diff --git a/src/docbkx/client.xml b/src/docbkx/client.xml
index 88afc677..872fa277 100644
--- a/src/docbkx/client.xml
+++ b/src/docbkx/client.xml
@@ -21,7 +21,7 @@
     </section>
     <section>
         <title>Using the client-side API</title>
-        <section>
+        <section id="client-webservicetemplate">
             <title><classname>WebServiceTemplate</classname></title>
             <para>
                 The <classname>WebServiceTemplate</classname> is the core class for client-side Web service access in
diff --git a/src/docbkx/common.xml b/src/docbkx/common.xml
index 8529b9d2..7e40a4c0 100644
--- a/src/docbkx/common.xml
+++ b/src/docbkx/common.xml
@@ -31,43 +31,25 @@
                         </thead>
                         <tbody>
                             <row>
-                                <entry>
-                                    <classname>javax.xml.transform.dom.DOMSource</classname>
-                                </entry>
-                                <entry>
-                                    <interfacename>org.w3c.dom.Node</interfacename>
-                                </entry>
+                                <entry><classname>javax.xml.transform.dom.DOMSource</classname></entry>
+                                <entry><interfacename>org.w3c.dom.Node</interfacename></entry>
                             </row>
                             <row>
-                                <entry>
-                                    <classname>javax.xml.transform.dom.DOMResult</classname>
-                                </entry>
-                                <entry>
-                                    <interfacename>org.w3c.dom.Node</interfacename>
-                                </entry>
+                                <entry><classname>javax.xml.transform.dom.DOMResult</classname></entry>
+                                <entry><interfacename>org.w3c.dom.Node</interfacename></entry>
                             </row>
                             <row>
-                                <entry>
-                                    <classname>javax.xml.transform.sax.SAXSource</classname>
-                                </entry>
-                                <entry>
-                                    <classname>org.xml.sax.InputSource</classname>
-                                    and
+                                <entry><classname>javax.xml.transform.sax.SAXSource</classname></entry>
+                                <entry><classname>org.xml.sax.InputSource</classname> and
                                     <interfacename>org.xml.sax.XMLReader</interfacename>
                                 </entry>
                             </row>
                             <row>
-                                <entry>
-                                    <classname>javax.xml.transform.sax.SAXResult</classname>
-                                </entry>
-                                <entry>
-                                    <interfacename>org.xml.sax.ContentHandler</interfacename>
-                                </entry>
+                                <entry><classname>javax.xml.transform.sax.SAXResult</classname></entry>
+                                <entry><interfacename>org.xml.sax.ContentHandler</interfacename></entry>
                             </row>
                             <row>
-                                <entry>
-                                    <classname>javax.xml.transform.stream.StreamSource</classname>
-                                </entry>
+                                <entry><classname>javax.xml.transform.stream.StreamSource</classname></entry>
                                 <entry>
                                     <classname>java.io.File</classname>, <classname>java.io.InputStream</classname>, or
                                     <classname>java.io.Reader</classname>
@@ -154,5 +136,23 @@
                 </para>                 
             </section>
         </section>
+        <section id="message-context">
+        	<title><interfacename>MessageContext</interfacename></title>
+        	<para>
+        		Typically, messages come in pairs: a request and a response. A request is created on the client-side,
+        		which is sent over some transport to the server-side, where a response is generated. This response gets
+        		sent back to the client, where it is read.
+        	</para>
+        	<para>
+        		In Spring Web Services, such a conversation is contained in a 
+        		<interfacename>MessageContext</interfacename>, which has properties to get request and response
+        		messages.
+        		On the client-side, the message context is created by the <link linkend="client-webservicetemplate">
+        		<classname>WebServiceTemplate</classname></link>.
+        		On the server-side, the message context is read from the transport-specific input stream. In HTTP,
+        		it is read from the <interfacename>HttpServletRequest</interfacename> and the response is written back
+        		to the <interfacename>HttpServletResponse</interfacename>.
+       		</para>
+        </section>
     </section>
 </chapter>
\ No newline at end of file
diff --git a/src/docbkx/resources/images/sequence.png b/src/docbkx/resources/images/sequence.png
new file mode 100644
index 0000000000000000000000000000000000000000..4f8adf4049b21e0c9567fdf78b9eef84fc6ab69b
GIT binary patch
literal 12492
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
Y7%OHLOrZe(TLOZDjEZ!*r1AIv16q+9RsaA1

literal 0
HcmV?d00001

diff --git a/src/docbkx/security.xml b/src/docbkx/security.xml
index 79828333..dc30da97 100644
--- a/src/docbkx/security.xml
+++ b/src/docbkx/security.xml
@@ -60,7 +60,7 @@
 			is an
 			<classname>EndpointInterceptor</classname>
 			(see
-			<xref linkend="ws-endpoint-interceptor" />
+			<xref linkend="server-endpoint-interceptor" />
 			) that is based on SUN's XML and Web Services Security package (XWSS). This WS-Security implementation is
 			part of the Java Web Services Developer Pack (
 			<ulink url="http://java.sun.com/webservices/">
@@ -70,7 +70,7 @@
 		</para>
 		<para>
 			Like any other endpoint interceptor, it is defined in the endpoint mapping (see
-			<xref linkend="ws-endpoint-mapping" />
+			<xref linkend="server-endpoint-mapping" />
 			). This means that you can be selective about adding WS-Security support: some endpoint mappings require it,
 			while others do not.
 		</para>
diff --git a/src/docbkx/server.xml b/src/docbkx/server.xml
index d27a7864..2b20ed58 100644
--- a/src/docbkx/server.xml
+++ b/src/docbkx/server.xml
@@ -3,23 +3,114 @@
                  "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <chapter id="server">
     <title>Creating a Web service with Spring-WS</title>    
-<!--
     <section id="ws-introduction">
         <title>Introduction</title>
         <para>
-            Spring's Web service framework is designed around
+        	Spring Web Services's server-side support in designed around a <classname>MessageDispatcher</classname>
+        	that dispatches incoming messages to endpoints, with configurable endpoint mappings, response generation,
+        	and endpoint interception.
+        	The simplest endpoint is a <interfacename>PayloadEndpoint</interfacename>, just offering a 
+        	<literal>Source invoke(Source request)</literal> method. This interface can be implemented for creating an
+        	endpoint, but you will prefer the included implementation hierarchy, consisting of, for example
+        	<classname>AbstractDomPayloadEndpoint</classname>, <classname>AbstractSaxPayloadEndpoint</classname>, and
+        	of course <classname>AbstractMarshallingPayloadEndpoint</classname>. Application endpoints will typically 
+        	be subclasses of those.
+        	Alternatively, there is a endpoint development that uses Java 5 annotations, such as 
+        	<literal>@Endpoint</literal> for marking a POJO as endpoint, and marking a method with 
+        	<literal>@PayloadRoot</literal> or <literal>@SoapAction</literal>.
+       	</para>
+       	<para>
+       		Spring-WS's XML handling is extremely flexible. An endpoint can choose from
+       		a large amount of XML handling libraries supported by Spring-WS, including the DOM family (W3C DOM, JDOM,
+       		dom4j, and XOM), SAX or StAX for faster performance, XPath to extract information from the message, or even
+       		marshalling to convert the XML to objects and vice-versa.
         </para>
     </section>
     <section>
-        <title>MessageDispatcher</title>
-        <para>
-            Spring-WS is designed around a central dispatching mechanism, which received and forwards incoming
-        </para>
-    </section>
+    	<title>The <classname>MessageDispatcher</classname></title>
+    	<para>
+    		The server-side of Spring-WS is designed around a central class that dispatches incoming XML messages to 
+    		endpoints. Spring-WS's <classname>MessageDispatcher</classname> is extremely flexible, allowing you to 
+    		use any sort of class as an endpoint, as long as it can be configured in the Spring IoC container.
+    		In a way, the message dispatcher resembles Spring's<classname>DispatcherServlet</classname>, the
+    		<quote>Front Controller</quote> used in Spring Web MVC.
+    	</para>
+    	<para>
+    		The processing and dispatching flow of the <classname>MessageDispatcher</classname> is illustrated in the 
+    		following sequence diagram. Whenever a message comes in, a suitable endpoint is retrieved via the
+    		<interfacename>EndpointMapping</interfacename>. After the endpoint has been determined, the 
+    		<classname>MessageDispatcher</classname> delegates to an <interfacename>EndpointAdapter</interfacename>
+    		to adapt to the specific method signature of the endpoint class. After the endpoint has been invoked, the 
+    		result value of the endpoint, if any, is converted back by the adapter after the invocation, and the 
+    		response is sent on its way.
+			<mediaobject>
+				<imageobject role="fo">
+					<imagedata fileref="src/docbkx/resources/images/sequence.png" format="PNG" align="center" />
+				</imageobject>
+				<imageobject role="html">
+					<imagedata fileref="images/sequence.png" format="PNG" align="center" />
+				</imageobject>
+				<caption>
+					<para>The request processing workflow in Spring Web Services</para>
+				</caption>
+			</mediaobject>
+    	</para>
+    	<para>
+    		The <classname>MessageDispatcher</classname> has several properties, for setting endpoint adapters, 
+    		<link linkend="server-endpoint-mapping">mappings</link>,  
+    		<link linkend="server-endpoint-exception-resolver">exception resolvers</link>.
+    		However, setting these properties is not required, since the dispatcher will automatically detect all of 
+    		these types that are registered in the application context. Only when detection needs to be overriden, 
+    		should these properties be set.
+   		</para>
+   		<para>
+   			The message dispatcher operates on a <link linkend="message-context">message context</link>, and not 
+   			transport-specific input stream and output stream. As a result, transport specific requests need to read 
+   			into a <interfacename>MessageContext</interfacename>. For HTTP, this is done with a 
+   			<classname>WebServiceMessageReceiverHandlerAdapter</classname>, which is a Spring Web 
+   			<interfacename>HandlerInterceptor</interfacename>, so that the <classname>MessageDispatcher</classname>
+   			can be wired in a standard <classname>DispatcherServlet</classname>. There is a more convenient way to do
+   			this, however, which is shown in the next section.
+   		</para>
+		<section>
+			<title><classname>MessageDispatcherServlet</classname></title>
+			<para>
+				The <classname>MessageDispatcherServlet</classname> is a standard <interface>Servlet</interface> which 
+				conveniently extends from the standard Spring Web <classname>DispatcherServlet</classname>, and wraps
+				a <classname>MessageDispatcher</classname>.  As a servlet, the 
+				<classname>MessageDispatcherServlet</classname> is configured in the <filename>web.xml</filename> of 
+				your web application. Requests that you want the <classname>MessageDispatcherServlet</classname> to 
+				handle will have to be mapped using a URL mapping in the same <literal>web.xml</literal> file. This is 
+				standard Java EE servlet configuration; an example of such a 
+				<classname>MessageDispatcherServlet</classname> declaration and mapping can be found below.
+			</para>
+		    <programlisting><![CDATA[<web-app>
+
+    <servlet>
+        <servlet-name>spring-ws</servlet-name>
+        <servlet-class>org.springframework.ws.transport.http.MessageDispatcherServlet</servlet-class>
+        <load-on-startup>1</load-on-startup>
+    </servlet>
+
+    <servlet-mapping>
+        <servlet-name>spring-ws</servlet-name>
+        <url-pattern>/*</url-pattern>
+    </servlet-mapping>
+
+</web-app>]]></programlisting>
+    		<para>
+    			In the example above, all requests will be handled by the <literal>'spring-ws'</literal>
+			    <classname>MessageDispatcherServlet</classname>. This is only the first step in setting up Spring Web 
+			    Services; the various endpoint and other beans used by the Spring Web Services framework also need to be
+			    configured.
+		    </para>
+		</section>
+   	</section>
     <section>
         <title>Endpoints</title>
+        <para/>
     </section>
-    <section id="ws-endpoint-mapping">
+    <section id="server-endpoint-mapping">
         <title>Endpoint mappings</title>
         <para>
             The endpoint mapping is responsible for mapping incoming messages to appropriate endpoints. It does this by
@@ -65,14 +156,17 @@
         </para>
         <section>
             <title>SoapActionEndpointMapping</title>
+            <para/>
         </section>
         <section>
             <title>PayloadRootQNameEndpointMapping</title>
+            <para/>
         </section>
-        <section id="ws-endpoint-interceptor">
+        <section id="server-endpoint-interceptor">
             <title>Adding <interfacename>EndpointInterceptors</interfacename></title>
+            <para/>
         </section>
-        <section>
+        <section id="server-endpoint-exception-resolver">
             <title>Handling Exceptions</title>
             <para>
                 Spring-WS provides
@@ -192,5 +286,4 @@
             </informaltable>
         </para>
     </section>
--->
 </chapter>
\ No newline at end of file