[jboss-svn-commits] JBL Code SVN: r34580 - in labs/jbossesb/trunk/product/docs/Services_Guide/en-US: images/configuring_the_registry and 1 other directory.

[jboss-svn-commits at lists.jboss.org]

Author: kevin.conner at jboss.com
Date: 2010-08-06 11:15:42 -0400 (Fri, 06 Aug 2010)
New Revision: 34580

Added:
   labs/jbossesb/trunk/product/docs/Services_Guide/en-US/images/configuring_the_registry/interceptors.png
Modified:
   labs/jbossesb/trunk/product/docs/Services_Guide/en-US/Configuring_the_Registry.xml
Log:
Add description of registry interceptors: JBESB-2604

Modified: labs/jbossesb/trunk/product/docs/Services_Guide/en-US/Configuring_the_Registry.xml
===================================================================
--- labs/jbossesb/trunk/product/docs/Services_Guide/en-US/Configuring_the_Registry.xml	2010-08-06 14:53:10 UTC (rev 34579)
+++ labs/jbossesb/trunk/product/docs/Services_Guide/en-US/Configuring_the_Registry.xml	2010-08-06 15:15:42 UTC (rev 34580)
@@ -424,7 +424,58 @@
 	</para>
 </note>	
 	
-	
 </section>	
+<section>
+    <title>
+        Registry Interceptors
+    </title>
+    <para>
+        The registry supports the ability to intercept requests to the registry
+        using an interceptor stack.  Each interceptor in the stack is provided
+        with an opportunity to service the request, provide direct responses to
+        the request or to augment the responses received from a lower interceptor
+        or registry implementation as it wishes.
+        </para>
+        <para>
+        The interceptor stack is configured using the org.jboss.soa.esb.registry.interceptors
+        property within jbossesb-properties.xml
+    </para>
 
+    <figure>
+        <title>Registry Interceptors</title>
+        <mediaobject>
+            <imageobject>
+                <imagedata fileref="images/configuring_the_registry/interceptors.png"/>
+            </imageobject>
+        </mediaobject>
+    </figure>
+    
+    <para>
+        There are two interceptors provided in the current implementation.
+    </para>
+    <itemizedlist>
+        <listitem>
+            <para>org.jboss.internal.soa.esb.services.registry.InVMRegistryInterceptor</para>
+            <para>
+                The InVM registry interceptor is responsible for handling any InVMEprs which are
+                registered by any of the services executing within the same server instance.  The
+                information about the InVMEpr and its associated service will be cached within the
+                interceptor, will not be propagated to subsequent interceptors and will be returned
+                to the caller by augmenting results from subsequent interceptors/registry queries.
+            </para>
+        </listitem>
+        <listitem>
+            <para>org.jboss.internal.soa.esb.services.registry.CachingRegistryInterceptor</para>
+            <para>
+                The Caching registry interceptor retains a cache of Eprs and their associated services,
+                evicting information from the cache on a LRU basis or after the information has expired.
+            </para>
+            <para>
+                The interceptor can be configured through the org.jboss.soa.esb.registry.cache.maxSize
+                and org.jboss.soa.esb.registry.cache.validityPeriod properties within jbossesb-properties.xml
+            </para>
+        </listitem>
+    </itemizedlist>
 </section>
+
+</section>

Added: labs/jbossesb/trunk/product/docs/Services_Guide/en-US/images/configuring_the_registry/interceptors.png
===================================================================
(Binary files differ)


Property changes on: labs/jbossesb/trunk/product/docs/Services_Guide/en-US/images/configuring_the_registry/interceptors.png
___________________________________________________________________
Name: svn:mime-type
   + image/png