Author: asankha
Date: Thu Oct 26 22:17:30 2006
New Revision: 468276
URL: http://svn.apache.org/viewvc?view=rev&rev=468276
Log:
update to reflect security/rm aspects and service parameters for endpoints and
proxy services
Modified:
incubator/synapse/trunk/java/xdocs/Synapse_Configuration_Language.html
Modified: incubator/synapse/trunk/java/xdocs/Synapse_Configuration_Language.html
URL:
http://svn.apache.org/viewvc/incubator/synapse/trunk/java/xdocs/Synapse_Configuration_Language.html?view=diff&rev=468276&r1=468275&r2=468276
==============================================================================
--- incubator/synapse/trunk/java/xdocs/Synapse_Configuration_Language.html
(original)
+++ incubator/synapse/trunk/java/xdocs/Synapse_Configuration_Language.html Thu
Oct 26 22:17:30 2006
@@ -28,8 +28,7 @@
<rules [key="string"]>
mediator*
</rules>
- </synapse>
-</pre>
+ </synapse></pre>
<h3>Registries</h3>
@@ -57,8 +56,7 @@
follows:</p>
<pre> <set-property name="string" [value="string"] [src="url"]
[key="string"]>
<inline-xml/>?
- <set-property/>
-</pre>
+ <set-property/></pre>
<p>These properties are top level properties which are set globally for the
entire system. Values of these properties can be retrieved via the extension
@@ -88,7 +86,7 @@
<p>If an optional error handler sequence name is specified through the
attribute 'onError', an exception on this sequence will invoke the sequence
-specified by this name. </p>
+specified by this name.</p>
<p>A Dynamic Sequence may be defined by specifying a Dynamic Property as its
definition. As the dynamic property changes, the sequence will dynamically be
@@ -101,18 +99,10 @@
simple URL, then extensibility elements may be used to indicate the address
(i.e. to compute the address at runtime).</p>
<pre> <endpoint name="string" [address="url"] [key="string"]>
- <parameter name="OutflowSecurity">
- ...
- </parameter>?
- <wsp:Policy xmlns:wsp="http://schemas.xmlsoap.org/ws/2004/09/policy";..
- xmlns:wsrm="http://ws.apache.org/sandesha2/policy"; wsu:Id="RMPolicy">
- ...
- </Policy>?
- <enableRM/>?
+ <enableRM [policy="key"]/>?
<enableSec/>?
.. extensibility ..
- </endpoint>
-</pre>
+ </endpoint></pre>
<p>An Axis2 Parameter element within an endpoint definition with the name "
OutflowSecurity" describes the Apache Rampart security configuration to be
@@ -148,13 +138,13 @@
<pre> <proxy name="string" [description="string"] [transports="(http |https
|jms )+|all"]>
<target sequence="name" | endpoint="name"/>? // defaults to the
synapse main sequence
<wsdl key="string">?
- <schema key="string">* // not yet used
- <policy key="string">*
- <property name="string" value="string"/>*
<enableRM/>?
<enableSec/>?
- </proxy>
-</pre>
+ <policy key="string">* // optional service
level policies
+ // (e.g. WS-Security and/or
WS-RM policies)
+ <property name="string" value="string"/>* // optional service
parameters
+ // (e.g.
transport.jms.ConnectionFactory)
+ </proxy></pre>
<p>A proxy service is created and exposed on the specified transports through
the underlying Axis2 instance, exposing service EPR's as per the standard
@@ -201,23 +191,19 @@
<p>In the simplest case, the place to send the message to is implicit in the
message (via a property of the message itself)- that is indicated by the
following:</p>
-<pre> <send/>
-</pre>
+<pre> <send/></pre>
<p>If the message is to be sent to one or more endpoints, then the following
is used:</p>
<pre> <send>
(endpointref | endpoint)+
- </send>
-</pre>
+ </send></pre>
<p>where the endpointref token refers to the following:</p>
-<pre> <endpoint ref="name"/>
-</pre>
+<pre> <endpoint ref="name"/></pre>
<p>and the endpoint token refers to an anonymous endpoint defined inline:</p>
-<pre> <endpoint address="url"/>
-</pre>
+<pre> <endpoint address="url"/></pre>
<p>If the message is to be sent to an endpoint selected by load balancing
across a set of endpoints, then it is indicated by the following:</p>
@@ -225,8 +211,7 @@
<load-balance algorithm="uri">
(endpointref | endpoint)+
</load-balance>
- </send>
-</pre>
+ </send></pre>
<p>Similarly, if the message is to be sent to an endpoint with failover
semantics, then it is indicated by the following:</p>
@@ -234,8 +219,7 @@
<failover>
(endpointref | endpoint)+
</failover>
- </send>
-</pre>
+ </send></pre>
<p>Once the <send> mediator executes, further processing of the current
message stops.</p>
@@ -247,8 +231,7 @@
<p>The drop token refers to a <drop> element which is used to drop a
message:</p>
-<pre> <drop/>
-</pre>
+<pre> <drop/></pre>
<p>Once the <drop> mediator executes, further processing of the current
message stops.</p>
@@ -259,13 +242,12 @@
messages being mediated:</p>
<pre> <log [level="string"] [separator="string"]>
<property name="string" (value="literal" | expression="xpath")/>*
- </log>
-</pre>
+ </log></pre>
<p>The optional level attribute selects a pre-defined subset of properties to
be logged.</p>
-<p>e.g. </p>
+<p>e.g.</p>
<ul>
<li>simple = To, From, WSAction, SOAPAction, ReplyTo, MessageID and any
properties</li>
@@ -287,8 +269,7 @@
<node>?
<role>?
<detail>?
- </makefault>
-</pre>
+ </makefault></pre>
<p>The <makefault> mediator transforms the current message into a fault
message, but does NOT send it. The <send> mediator needs to be invoked
@@ -300,8 +281,7 @@
<h5>XSLT</h5>
<pre> <xslt key="string" [source="xpath"]>
<property name="string" (value="literal" | expression="xpath")/>*
- </transform>
-</pre>
+ </transform></pre>
<p>The <xslt> mediator applies the specified XSLT transformation to the
given element. If the source element is not specified, it defaults to the
@@ -310,8 +290,7 @@
<h5>Headers</h5>
<pre> <header name="qname" (value="literal" | expression="xpath")
[action="set"]/>
- <header name="qname" action="remove"/>
-</pre>
+ <header name="qname" action="remove"/></pre>
<p>The <header> mediator sets or removes a specified header from the
current soap message. Currently the set header only supports simple valued
@@ -325,8 +304,7 @@
<h5>Filters</h5>
<pre> <filter (source="xpath" regex="string") | xpath="xpath">
mediator+
- </filter>
-</pre>
+ </filter></pre>
<p>The <filter> mediator either test the given xpath expression as a
boolean expression, or match the evaluation result of a source xpath
@@ -341,8 +319,7 @@
<default>
mediator+
</default>?
- </switch>
-</pre>
+ </switch></pre>
<p>The <switch> mediator will evaluate the given source xpath
expression into its string value, and match it against the given regular
@@ -354,8 +331,7 @@
<on-fail>
mediator+
</on-fail>
- </validate>
-</pre>
+ </validate></pre>
<p>The <validate> mediator validates the result of the evaluation of
the source xpath expression, against the schema specified. If the source
@@ -368,8 +344,7 @@
will remain simple and lightweight.</p>
<h4>Properties</h4>
-<pre> <set-property name="string" (value="literal" |
expression="xpath")/>
-</pre>
+<pre> <set-property name="string" (value="literal" |
expression="xpath")/></pre>
<p>The setproperty token refers to a <set-property> element which is a
mediator that has no direct impact on the message but rather on the message
@@ -380,8 +355,7 @@
<h4>Class Mediators</h4>
<pre> <class name="class-name">
<property name="string" (value="literal" | expression="xpath")/>*
- </class>
-</pre>
+ </class> </pre>
<p>The class mediator creates an instance of the specified class and sets it
as a mediator. The class must implement the org.apache.synapse.api.Mediator
@@ -390,8 +364,7 @@
properties.</p>
<h4>Reusing Sequences</h4>
-<pre> <sequence ref="name"/>
-</pre>
+<pre> <sequence ref="name"/></pre>
<p>A sequenceref token refers to a <sequence> element which is used to
invoke a named sequence of mediators.</p>
@@ -417,8 +390,7 @@
src, key or inlined XML references to the Spring configuration</p>
<h4>Spring mediator</h4>
-<pre> <spring:spring bean="exampleBean1" key="string"/>
-</pre>
+<pre> <spring:spring bean="exampleBean1" key="string"/></pre>
<p>The <spring> element creates an instance of a mediator, which is
managed by Spring. This Spring bean must implement the Mediator interface for
@@ -502,8 +474,7 @@
<switch>
</rules>
-</synapse>
-</pre>
+</synapse> </pre>
<h3>Example 0.</h3>
<pre><synapse xmlns="http://ws.apache.org/ns/synapse">
@@ -545,8 +516,7 @@
<send/>
</rules>
-</synapse>
-</pre>
+</synapse> </pre>
<p>The above configuration is available with the Synapse distribution and
illustrates the usual Stock quote examples. The client code for these are
@@ -805,7 +775,6 @@
<spring:spring bean="springtest" key="springconfig1"/>
<spring:spring bean="springtest" key="springconfig2"/>
</rules>
-</synapse>
-</pre>
+</synapse> </pre>
</body>
</html>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
