More docs
This commit is contained in:
Arjen Poutsma
46
src/site/apt/index.apt
Normal file
46
src/site/apt/index.apt
Normal file
@@ -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
|
||||
|
||||
* <<Makes the Best Practice an Easy Practice:>>
|
||||
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.
|
||||
|
||||
* <<Powerful mappings:>>
|
||||
You can distribute incoming XML request to any object, depending on message payload, SOAP Action header, or an
|
||||
XPath expression.
|
||||
|
||||
* <<XML API support:>>
|
||||
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.
|
||||
|
||||
* <<Flexible XML Marshalling:>>
|
||||
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.
|
||||
|
||||
* <<Reuses your Spring expertise:>>
|
||||
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.
|
||||
|
||||
* <<Supports WS-Security:>>
|
||||
WS-Security allows you to sign SOAP messages, encrypt and decrypt them, or authenticate against them.
|
||||
|
||||
* <<Integrates with Acegi Security:>>
|
||||
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.
|
||||
|
||||
* <<Built by Maven:>> This assists you in effectively reusing the Spring Web Services artifacts in your own
|
||||
Maven-based projects.
|
||||
|
||||
* <<Apache license.>> You can confidently use Spring-WS in your project.
|
||||
@@ -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}}.
|
||||
|
||||
|
||||
@@ -15,9 +15,12 @@
|
||||
</bannerRight>
|
||||
<body>
|
||||
<links>
|
||||
<item name="Spring Framework" href="http://www.springframework.org/"/>
|
||||
<item name="Spring Web Services" href="http://www.springframework.org/spring-ws/"/>
|
||||
<item name="Spring Framework" href="http://www.springframework.org/" />
|
||||
<item name="Spring Web Services" href="http://www.springframework.org/spring-ws/" />
|
||||
</links>
|
||||
<menu name="Overview">
|
||||
<item name="Home" href="/"/>
|
||||
</menu>
|
||||
<menu name="Downloads">
|
||||
<item name="Releases" href="downloads/releases.html"/>
|
||||
<item name="Snapshots" href="downloads/snapshots.html"/>
|
||||
@@ -26,12 +29,12 @@
|
||||
<item name="FAQ" href="faq.html"/>
|
||||
<item name="Upgrading" href="upgrading.html"/>
|
||||
<item name="Tutorial" href="tutorial/tutorial1.html"/>
|
||||
<item name="Resources" href="resources.html"/>
|
||||
<item name="Resources & Tools" href="resources.html"/>
|
||||
</menu>
|
||||
<menu name="Support">
|
||||
<item name="Support Forums" href="http://forum.springframework.org/forumdisplay.php?f=39"/>
|
||||
<item name="JIRA" href="http://opensource.atlassian.com/projects/spring/browse/SWS"/>
|
||||
</menu>
|
||||
<menu ref="reports" />
|
||||
<menu ref="reports" />
|
||||
</body>
|
||||
</project>
|
||||
Reference in New Issue
Block a user