diff --git a/src/site/apt/index.apt b/src/site/apt/index.apt new file mode 100644 index 00000000..154d2518 --- /dev/null +++ b/src/site/apt/index.apt @@ -0,0 +1,46 @@ + ------------------- + Spring Web Services + ------------------- + +What is Spring Web Services? + + Spring Web Services is a product of the {{{http://www.springframework.org}Spring}} community focused on creating + document-driven Web services. + Spring Web Services aims to facilitate contract-first SOAP service development, allowing for the creation of + flexible web services using one of the many ways to manipulate XML payloads. + +Key Features + + * <> + Spring Web Services makes enforcing best practices easier. This includes practices such as the WS-I basic profile, + Contract-First development, and having a loose coupling between contract and implementation. + + * <> + You can distribute incoming XML request to any object, depending on message payload, SOAP Action header, or an + XPath expression. + + * <> + Incoming XML messages can be handled in standard JAXP APIs such as DOM, SAX, and StAX, but also JDOM, dom4j, XOM, + or even marshalling technologies. + + * <> + The Object/XML Mapping module in the Spring Web Services distribution supports JAXB 1 and 2, Castor, XMLBeans, + JiBX, and XStream. And because it is a separate module, you can use it in non-Web services code as well. + + * <> + Spring-WS uses Spring application contexts for all configuration, which should + help Spring developers get up-to-speed nice and quickly. Also, the architecture of Spring-WS resembles that of + Spring-MVC. + + * <> + WS-Security allows you to sign SOAP messages, encrypt and decrypt them, or authenticate against them. + + * <> + The WS-Security implementation of Spring Web Services provides integration with + {{{http://acegisecurity.org/}Acegi Security}}. This means you can use your existing Acegi configuration for your + SOAP service as well. + + * <> This assists you in effectively reusing the Spring Web Services artifacts in your own + Maven-based projects. + + * <> You can confidently use Spring-WS in your project. diff --git a/src/site/apt/resources.apt b/src/site/apt/resources.apt index c38a0102..8f810301 100644 --- a/src/site/apt/resources.apt +++ b/src/site/apt/resources.apt @@ -1,14 +1,35 @@ - --------- - Resources - --------- + ------------------- + Resources and Tools + ------------------- Resources -* SOAP Reference + On this page, we give some general resource related to XML, SOAP, XSD, WSDL, and WS-Security. Note that these + resources are generic, and not tied to Spring Web Services. - Below are some resources which help you understand SOAP in general. These are not tied to Spring-WS. +* XML +** XML + + * {{{http://www.w3schools.com/xml/default.asp}XML tutorial}} + + * {{{http://www.amazon.com/gp/product/0321150406/}Effective XML}}, a good book on XML + +** XSD + + * {{{http://www.w3.org/XML/Schema}the XSD 1.1 specification}} + + * {{{http://www.w3schools.com/schema/default.asp}XSD tutorial}} + + * {{{http://www.amazon.com/gp/product/0130655678}Definite XML Schema}}, a good book on XSDs + + * {{{http://www.amazon.com/gp/product/0201740958}Essential XML Quick Reference}}, a good reference on XML, XPath, XSL, XSD, and more + +* Web Services + +** SOAP + * {{{http://www.w3.org/TR/2000/NOTE-SOAP-20000508/}the SOAP 1.1 specification}} * {{{http://www.ws-i.org/Profiles/BasicProfile-1.1.html}the WS-Interop basic profile}}, to make sure your Web services are interopable with other platforms @@ -21,23 +42,7 @@ Resources * {{{http://www.amazon.com/gp/product/0131488740}Web Services Platform Architecture}} is a good book on SOAP, WSDL, and all current and upcoming WS-* specifications -* XSD Reference - - Below are some resources which help you understand XSD schemas in general. These are not tied to Spring-WS. - - - * {{{http://www.w3.org/XML/Schema}the XSD 1.1 specification}} - - * {{{http://www.w3schools.com/schema/default.asp}XSD tutorial}} - - * {{{http://www.amazon.com/gp/product/0130655678}Definite XML Schema}}, a good book on XSDs - - * {{{http://www.amazon.com/gp/product/0201740958}Essential XML Quick Reference}}, a good reference on XML, XPath, XSL, XSD, and more - -* WSDL Reference - - Below are some resources which help you understand WSDL in general. These are not tied to Spring-WS. - +** WSDL * {{{http://www.w3.org/TR/wsdl}the WSDL 1.1 specification}} @@ -47,13 +52,19 @@ Resources * {{{http://www.amazon.com/gp/product/0131488740}Web Services Platform Architecture}} is a good book on SOAP, WSDL, and all current and upcoming WS-* specifications -* WS-Security Reference - - Below are some resources which help you understand WS-Security in general. These are not tied to Spring-WS. - +** WS-Security * {{{http://www.oasis-open.org/committees/tc_home.php?wg_abbrev=wss}the WS-Security 1.1 specification}} * {{{http://dev2dev.bea.com/pub/a/2004/05/WS-Security.html}WS-Security and Java: Practical, In-Depth, Message-Based Security}} * {{{http://www.amazon.com/gp/product/0131488740}Web Services Platform Architecture}} is a good book on SOAP, WSDL, and all current and upcoming WS-* specifications + +Tools + + These tools can help you test your Web service applications. + + * {{{http://www.soapui.org/}soapui}} is a desktop application for inspecting, invoking and testing (functional and load) of web services over HTTP + + * {{{http://www.ws-i.org/deliverables/workinggroup.aspx?wg=testingtools}the WS-I testing tools}}, which make sure your Web service is {{{http://www.ws-i.org/Profiles/BasicProfile-1.1-2004-08-24.html}interoperable}}. + diff --git a/src/site/site.xml b/src/site/site.xml index ae6bda99..e6e5084b 100644 --- a/src/site/site.xml +++ b/src/site/site.xml @@ -15,9 +15,12 @@ - - + + + + + @@ -26,12 +29,12 @@ - + - + \ No newline at end of file