| <!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> |