You are viewing a plain text version of this content. The canonical link for it is here.
Posted to axis-cvs@ws.apache.org by ch...@apache.org on 2006/01/17 08:24:04 UTC
svn commit: r369706 - in /webservices/axis2/trunk/java/xdocs/latest:
WS_policy.html userguide.html
Author: chinthaka
Date: Mon Jan 16 23:23:49 2006
New Revision: 369706
URL: http://svn.apache.org/viewcvs?rev=369706&view=rev
Log:
Improving the documentation. Thanks Chatra.
Added:
webservices/axis2/trunk/java/xdocs/latest/WS_policy.html
Modified:
webservices/axis2/trunk/java/xdocs/latest/userguide.html
Added: webservices/axis2/trunk/java/xdocs/latest/WS_policy.html
URL: http://svn.apache.org/viewcvs/webservices/axis2/trunk/java/xdocs/latest/WS_policy.html?rev=369706&view=auto
==============================================================================
--- webservices/axis2/trunk/java/xdocs/latest/WS_policy.html (added)
+++ webservices/axis2/trunk/java/xdocs/latest/WS_policy.html Mon Jan 16 23:23:49 2006
@@ -0,0 +1,61 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
+ "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+ <meta http-equiv="content-type" content="text/html; charset=iso-8859-1">
+ <title>WS Policy Support in Axis2</title>
+ <meta name="generator" content="amaya 9.2.1, see http://www.w3.org/Amaya/">
+</head>
+
+<body lang="en">
+<h1 align="center">Web Services Policy Support In Axis2</h1>
+
+<h2 align="center"><em>-Experimental Feature</em></h2>
+
+<p><em>Axis2 version 0.94</em></p>
+<i>E-mail comments/ suggestions to: <a
+href="mailto:axis-dev@ws.apache.org">axis-dev@ws.apache.org</a></i>
+
+<h2>What is Web Services (WS) Policy?</h2>
+
+<p>To consume non trivial web services one must fully understand its xml
+contract (WSDL) along with any other additional requirements, capabilities or
+preferences which translates to the configuration of the service, and
+essentially becomes the policies of the service.</p>
+
+<p>WS Policy framework provides a way to express the policies of a service in
+a machine-readable way. Web services infrastructure can be enhanced to
+understand and enforce policies at runtime. For instance, a service author
+might write a policy requiring digital signature and encryption, while
+service consumers could use the policy information to reason out whether they
+can adhere to this policy information to use the service or not.</p>
+
+<p>Further more, web service infrastructure could be enhanced to enforce
+those requirements without requiring the service author to write even single
+line of code.</p>
+
+<h2>What's in this release?</h2>
+
+<p>In this current release Axis2 framework uses ws-commons/policy as an
+object model to manipulate policy documents. All its description builders
+store any policy information included in description documents (services.xml,
+axis2.xml, .. etc) in the appropriate description classes. This information
+is available at both deployment and run time via these description
+classes.</p>
+
+<p>When generating WSDL dynamically for each service, policy information in
+the description classes is included. For instance, if you declare a policy in
+axis2.xml then that policy is reflected in service elements of WSDL of every
+service. If a policy is declared in a services.xml, it is shown in the
+service element of WSDL for that particular service.</p>
+
+<p>Next step is to use that information to engage and configure required
+modules and allow the module to make use of this policy information.</p>
+
+<p>It is evident that a great deal of work is required to make axis2 a fully
+fledged ws-policy supported web service infrastructure. But it is encouraging
+to note that we've taken the first steps towards this goal. We appreciate any
+suggestions, patches etc you send us in this regard. Keep on
+contributing...!</p>
+</body>
+</html>
Modified: webservices/axis2/trunk/java/xdocs/latest/userguide.html
URL: http://svn.apache.org/viewcvs/webservices/axis2/trunk/java/xdocs/latest/userguide.html?rev=369706&r1=369705&r2=369706&view=diff
==============================================================================
--- webservices/axis2/trunk/java/xdocs/latest/userguide.html (original)
+++ webservices/axis2/trunk/java/xdocs/latest/userguide.html Mon Jan 16 23:23:49 2006
@@ -286,7 +286,7 @@
<ol type="1">
<li>Sessions scoping for Application, SOAP, Transport and Request
levels</li>
- <li>Server side Web Service Policy support</li>
+ <li><a href="WS_policy.html" target="_blank">Server side Web Services Policy support</li>
<li>?wsdl and ?xsd support</li>
<li>Java2WSDL</li>
<li>Generating ServiceClient for a given WSDL and invoke the corresponding