curator-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From randg...@apache.org
Subject svn commit: r1459958 [23/42] - in /incubator/curator/site/trunk: ./ apidocs/ apidocs/cache/ apidocs/cache/class-use/ apidocs/discovery/ apidocs/discovery/class-use/ apidocs/framework/ apidocs/framework/class-use/ apidocs/leader/ apidocs/leader/class-us...
Date Fri, 22 Mar 2013 19:59:01 GMT
Added: incubator/curator/site/trunk/curator-recipes/distributed-id-queue.html
URL: http://svn.apache.org/viewvc/incubator/curator/site/trunk/curator-recipes/distributed-id-queue.html?rev=1459958&view=auto
==============================================================================
--- incubator/curator/site/trunk/curator-recipes/distributed-id-queue.html (added)
+++ incubator/curator/site/trunk/curator-recipes/distributed-id-queue.html Fri Mar 22 19:57:43 2013
@@ -0,0 +1,295 @@
+<!DOCTYPE html>
+<!--
+ | Generated by Apache Maven Doxia at Mar 22, 2013
+ | Rendered using Apache Maven Fluido Skin 1.3.0
+-->
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <meta name="Date-Revision-yyyymmdd" content="20130322" />
+    <meta http-equiv="Content-Language" content="en" />
+    <title>Apache Curator Recipes - </title>
+    <link rel="stylesheet" href="./css/apache-maven-fluido-1.3.0.min.css" />
+    <link rel="stylesheet" href="./css/site.css" />
+    <link rel="stylesheet" href="./css/print.css" media="print" />
+
+      
+    <script type="text/javascript" src="./js/apache-maven-fluido-1.3.0.min.js"></script>
+
+                          
+        
+<link rel="stylesheet" href="../css/site.css"/>
+                      
+        
+<script type="text/javascript">$(function(){
+                    if ( location.pathname.match(".*index\.html") )
+                    {
+                        $('a[title="Recipes"]').parent().addClass("active");
+                    }
+                });</script>
+          
+            </head>
+        <body class="topBarDisabled">
+          
+        
+    
+        <div class="container-fluid">
+          <div id="banner">
+        <div class="pull-left">
+                                                  <a href="../index.html" id="bannerLeft">
+                                                                                                <img src="../images/curator-logo.png"  alt="Apache Curator"/>
+                </a>
+                      </div>
+        <div class="pull-right">                  <a href="http://incubator.apache.org" id="bannerRight">
+                                                                                        <img src="http://incubator.apache.org/images/apache-incubator-logo.png"  alt="Apache Incubator"/>
+                </a>
+      </div>
+        <div class="clear"><hr/></div>
+      </div>
+
+      <div id="breadcrumbs">
+        <ul class="breadcrumb">
+                
+            
+                  <li id="publishDate">Last Published: 2013-03-22</li>
+                  <li class="divider">|</li> <li id="projectVersion">Version: 2.0.0-SNAPSHOT</li>
+                      
+                
+            
+      
+                                              
+    <li class="pull-right">              <a href="http://zookeeper.apache.org" class="externalLink" title="Apache ZooKeeper">
+        Apache ZooKeeper</a>
+  </li>
+
+                        </ul>
+      </div>
+
+            
+      <div class="row-fluid">
+        <div id="leftColumn" class="span3">
+          <div class="well sidebar-nav">
+                
+            
+                <ul class="nav nav-list">
+                    <li class="nav-header">Apache Curator</li>
+                                
+      <li>
+    
+                          <a href="../index.html" title="About">
+          <i class="none"></i>
+        About</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../getting-started.html" title="Getting Started">
+          <i class="none"></i>
+        Getting Started</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../curator-examples/index.html" title="Examples">
+          <i class="none"></i>
+        Examples</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../curator-recipes/index.html" title="Recipes">
+          <i class="none"></i>
+        Recipes</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../curator-framework/index.html" title="Framework">
+          <i class="none"></i>
+        Framework</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../utilities.html" title="Utilities">
+          <i class="none"></i>
+        Utilities</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../curator-client/index.html" title="Client">
+          <i class="none"></i>
+        Client</a>
+            </li>
+                              <li class="nav-header">Details</li>
+                                
+      <li>
+    
+                          <a href="../errors.html" title="Error Handling">
+          <i class="none"></i>
+        Error Handling</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../logging.html" title="Logging and Tracing">
+          <i class="none"></i>
+        Logging and Tracing</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../tech-notes.html" title="Tech Notes">
+          <i class="none"></i>
+        Tech Notes</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../exhibitor.html" title="Exhibitor Integration">
+          <i class="none"></i>
+        Exhibitor Integration</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../project-info.html" title="Project Information">
+          <i class="none"></i>
+        Project Information</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../apidocs/index.html" title="Javadoc">
+          <i class="none"></i>
+        Javadoc</a>
+            </li>
+                              <li class="nav-header">Extensions</li>
+                                
+      <li>
+    
+                          <a href="../curator-x-discovery/index.html" title="Service Discovery">
+          <i class="none"></i>
+        Service Discovery</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../curator-x-discovery-server/index.html" title="Service Discovery Server">
+          <i class="none"></i>
+        Service Discovery Server</a>
+            </li>
+                              <li class="nav-header">Community</li>
+                                
+      <li>
+    
+                          <a href="../patches.html" title="Submitting Patches">
+          <i class="none"></i>
+        Submitting Patches</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../history.html" title="History">
+          <i class="none"></i>
+        History</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../articles.html" title="Third Party Articles">
+          <i class="none"></i>
+        Third Party Articles</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../contributions.html" title="Third Party Contributions">
+          <i class="none"></i>
+        Third Party Contributions</a>
+            </li>
+                              <li class="nav-header">ASF</li>
+                                
+      <li>
+    
+                          <a href="http://www.apache.org/foundation/how-it-works.html" class="externalLink" title="How the ASF works">
+          <i class="none"></i>
+        How the ASF works</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="http://www.apache.org/foundation/getinvolved.html" class="externalLink" title="Get Involved">
+          <i class="none"></i>
+        Get Involved</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="http://www.apache.org/dev/" class="externalLink" title="Developer Resources">
+          <i class="none"></i>
+        Developer Resources</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsorship">
+          <i class="none"></i>
+        Sponsorship</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="http://www.apache.org/foundation/thanks.html" class="externalLink" title="Thanks">
+          <i class="none"></i>
+        Thanks</a>
+            </li>
+            </ul>
+                
+            
+                
+          <hr class="divider" />
+
+           <div id="poweredBy">
+                            <div class="clear"></div>
+                            <div class="clear"></div>
+                            <div class="clear"></div>
+                             <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+        <img class="builtBy" alt="Built by Maven" src="./images/logos/maven-feather.png" />
+      </a>
+                  </div>
+          </div>
+        </div>
+        
+                
+        <div id="bodyColumn"  class="span9" >
+                                  
+            <div class="section"><h2>Distributed ID Queue<a name="Distributed_ID_Queue"></a></h2></div><div class="section"><h3><b>IMPORTANT</b> - We recommend that you do NOT use ZooKeeper for Queues. Please see <a href="../tech-note-4.html">Tech Note 4</a> for details.<a name="IMPORTANT_-_We_recommend_that_you_do_NOT_use_ZooKeeper_for_Queues._Please_see_Tech_Note_4_for_details."></a></h3></div><div class="section"><h3>Description<a name="Description"></a></h3></div><p>This is an alternate version of <a href="distributed-queue.html">Distributed Queue</a> that supports assigning IDs to the items added to the queue. Items put into the queue are guaranteed to be ordered (by means of ZK's PERSISTENTSEQUENTIAL node). If a single consumer takes items out of the queue, they will be ordered FIFO. If ordering is important, use a LeaderSelector to nominate a single consumer.</p><div class="section"><h3>Participating Classes<a name="Participating_Classes"></a></h3></div><ul><li>QueueB
 uilder</li><li>QueueConsumer</li><li>QueueSerializer</li><li>DistributedQueue</li></ul><div class="section"><h3>Usage<a name="Usage"></a></h3></div><div class="section"><h4>Creating a DistributedIdQueue<a name="Creating_a_DistributedIdQueue"></a></h4></div><p>See <a href="distributed-queue.html">Distributed Queue</a> for details of using the builder, the only difference is to use the <tt>buildIdQueue()</tt> method.</p><div class="section"><h3>General Usage<a name="General_Usage"></a></h3></div><p>The queue must be started via the <tt>start()</tt> method. Call <tt>close()</tt> when you are done with the queue.</p><p>To add messages to the queue:</p><div class="source"><pre class="prettyprint">queue.put(aMessage, messageId);
+</pre></div><p>To remove messages from the queue:</p><div class="source"><pre class="prettyprint">int numberRemoved = queue.remove(messageId);
+</pre></div><p>Your consumer (<tt>QueueConsumer.consumeMessage()</tt>) will get called as messages arrive.</p><p>The lock safety and error handling are the same as for <a href="distributed-queue.html">Distributed Queue</a>.</p>
+                  </div>
+            </div>
+          </div>
+
+    <hr/>
+
+    <footer>
+            <div class="container-fluid">
+              <div class="row span12">Copyright &copy;                    2011-2013
+                        <a href="http://www.apache.org/">The Apache Software Foundation</a>.
+            All Rights Reserved.      
+            
+      </div>
+
+                                                                  <?xml version="1.0" encoding="UTF-8"?>
+<div style="margin-bottom: 8px;" class="row span12">Apache Curator, the Apache feather logo, and the Apache Curator project logos are
+                trademarks of The Apache Software Foundation. All other marks mentioned may be
+                trademarks or registered trademarks of their respective owners.</div>
+                  
+        
+                </div>
+    </footer>
+  </body>
+</html>

Propchange: incubator/curator/site/trunk/curator-recipes/distributed-id-queue.html
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: incubator/curator/site/trunk/curator-recipes/distributed-id-queue.html
------------------------------------------------------------------------------
    svn:keywords = Date Revision Author HeadURL Id

Propchange: incubator/curator/site/trunk/curator-recipes/distributed-id-queue.html
------------------------------------------------------------------------------
    svn:mime-type = text/html

Added: incubator/curator/site/trunk/curator-recipes/distributed-priority-queue.html
URL: http://svn.apache.org/viewvc/incubator/curator/site/trunk/curator-recipes/distributed-priority-queue.html?rev=1459958&view=auto
==============================================================================
--- incubator/curator/site/trunk/curator-recipes/distributed-priority-queue.html (added)
+++ incubator/curator/site/trunk/curator-recipes/distributed-priority-queue.html Fri Mar 22 19:57:43 2013
@@ -0,0 +1,320 @@
+<!DOCTYPE html>
+<!--
+ | Generated by Apache Maven Doxia at Mar 22, 2013
+ | Rendered using Apache Maven Fluido Skin 1.3.0
+-->
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <meta name="Date-Revision-yyyymmdd" content="20130322" />
+    <meta http-equiv="Content-Language" content="en" />
+    <title>Apache Curator Recipes - </title>
+    <link rel="stylesheet" href="./css/apache-maven-fluido-1.3.0.min.css" />
+    <link rel="stylesheet" href="./css/site.css" />
+    <link rel="stylesheet" href="./css/print.css" media="print" />
+
+      
+    <script type="text/javascript" src="./js/apache-maven-fluido-1.3.0.min.js"></script>
+
+                          
+        
+<link rel="stylesheet" href="../css/site.css"/>
+                      
+        
+<script type="text/javascript">$(function(){
+                    if ( location.pathname.match(".*index\.html") )
+                    {
+                        $('a[title="Recipes"]').parent().addClass("active");
+                    }
+                });</script>
+          
+            </head>
+        <body class="topBarDisabled">
+          
+        
+    
+        <div class="container-fluid">
+          <div id="banner">
+        <div class="pull-left">
+                                                  <a href="../index.html" id="bannerLeft">
+                                                                                                <img src="../images/curator-logo.png"  alt="Apache Curator"/>
+                </a>
+                      </div>
+        <div class="pull-right">                  <a href="http://incubator.apache.org" id="bannerRight">
+                                                                                        <img src="http://incubator.apache.org/images/apache-incubator-logo.png"  alt="Apache Incubator"/>
+                </a>
+      </div>
+        <div class="clear"><hr/></div>
+      </div>
+
+      <div id="breadcrumbs">
+        <ul class="breadcrumb">
+                
+            
+                  <li id="publishDate">Last Published: 2013-03-22</li>
+                  <li class="divider">|</li> <li id="projectVersion">Version: 2.0.0-SNAPSHOT</li>
+                      
+                
+            
+      
+                                              
+    <li class="pull-right">              <a href="http://zookeeper.apache.org" class="externalLink" title="Apache ZooKeeper">
+        Apache ZooKeeper</a>
+  </li>
+
+                        </ul>
+      </div>
+
+            
+      <div class="row-fluid">
+        <div id="leftColumn" class="span3">
+          <div class="well sidebar-nav">
+                
+            
+                <ul class="nav nav-list">
+                    <li class="nav-header">Apache Curator</li>
+                                
+      <li>
+    
+                          <a href="../index.html" title="About">
+          <i class="none"></i>
+        About</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../getting-started.html" title="Getting Started">
+          <i class="none"></i>
+        Getting Started</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../curator-examples/index.html" title="Examples">
+          <i class="none"></i>
+        Examples</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../curator-recipes/index.html" title="Recipes">
+          <i class="none"></i>
+        Recipes</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../curator-framework/index.html" title="Framework">
+          <i class="none"></i>
+        Framework</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../utilities.html" title="Utilities">
+          <i class="none"></i>
+        Utilities</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../curator-client/index.html" title="Client">
+          <i class="none"></i>
+        Client</a>
+            </li>
+                              <li class="nav-header">Details</li>
+                                
+      <li>
+    
+                          <a href="../errors.html" title="Error Handling">
+          <i class="none"></i>
+        Error Handling</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../logging.html" title="Logging and Tracing">
+          <i class="none"></i>
+        Logging and Tracing</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../tech-notes.html" title="Tech Notes">
+          <i class="none"></i>
+        Tech Notes</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../exhibitor.html" title="Exhibitor Integration">
+          <i class="none"></i>
+        Exhibitor Integration</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../project-info.html" title="Project Information">
+          <i class="none"></i>
+        Project Information</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../apidocs/index.html" title="Javadoc">
+          <i class="none"></i>
+        Javadoc</a>
+            </li>
+                              <li class="nav-header">Extensions</li>
+                                
+      <li>
+    
+                          <a href="../curator-x-discovery/index.html" title="Service Discovery">
+          <i class="none"></i>
+        Service Discovery</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../curator-x-discovery-server/index.html" title="Service Discovery Server">
+          <i class="none"></i>
+        Service Discovery Server</a>
+            </li>
+                              <li class="nav-header">Community</li>
+                                
+      <li>
+    
+                          <a href="../patches.html" title="Submitting Patches">
+          <i class="none"></i>
+        Submitting Patches</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../history.html" title="History">
+          <i class="none"></i>
+        History</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../articles.html" title="Third Party Articles">
+          <i class="none"></i>
+        Third Party Articles</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../contributions.html" title="Third Party Contributions">
+          <i class="none"></i>
+        Third Party Contributions</a>
+            </li>
+                              <li class="nav-header">ASF</li>
+                                
+      <li>
+    
+                          <a href="http://www.apache.org/foundation/how-it-works.html" class="externalLink" title="How the ASF works">
+          <i class="none"></i>
+        How the ASF works</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="http://www.apache.org/foundation/getinvolved.html" class="externalLink" title="Get Involved">
+          <i class="none"></i>
+        Get Involved</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="http://www.apache.org/dev/" class="externalLink" title="Developer Resources">
+          <i class="none"></i>
+        Developer Resources</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsorship">
+          <i class="none"></i>
+        Sponsorship</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="http://www.apache.org/foundation/thanks.html" class="externalLink" title="Thanks">
+          <i class="none"></i>
+        Thanks</a>
+            </li>
+            </ul>
+                
+            
+                
+          <hr class="divider" />
+
+           <div id="poweredBy">
+                            <div class="clear"></div>
+                            <div class="clear"></div>
+                            <div class="clear"></div>
+                             <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+        <img class="builtBy" alt="Built by Maven" src="./images/logos/maven-feather.png" />
+      </a>
+                  </div>
+          </div>
+        </div>
+        
+                
+        <div id="bodyColumn"  class="span9" >
+                                  
+            <div class="section"><h2>Distributed Priority Queue<a name="Distributed_Priority_Queue"></a></h2></div><div class="section"><h3><b>IMPORTANT</b> - We recommend that you do NOT use ZooKeeper for Queues. Please see <a href="../tech-note-4.html">Tech Note 4</a> for details.<a name="IMPORTANT_-_We_recommend_that_you_do_NOT_use_ZooKeeper_for_Queues._Please_see_Tech_Note_4_for_details."></a></h3></div><div class="section"><h3>Description<a name="Description"></a></h3></div><p>An implementation of the Distributed Priority Queue ZK recipe.</p><div class="section"><h3>Participating Classes<a name="Participating_Classes"></a></h3></div><ul><li>QueueBuilder</li><li>QueueConsumer</li><li>QueueSerializer</li><li>DistributedPriorityQueue</li></ul><div class="section"><h3>Usage<a name="Usage"></a></h3></div><div class="section"><h4>Creating a DistributedPriorityQueue<a name="Creating_a_DistributedPriorityQueue"></a></h4></div><div class="source"><pre class="prettyprint">public 
 static &lt;T&gt; QueueBuilder&lt;T&gt; builder(CuratorFramework client,
+                                          QueueConsumer&lt;T&gt; consumer,
+                                          QueueSerializer&lt;T&gt; serializer,
+                                          java.lang.String queuePath)
+Parameters:
+client - the curator client
+consumer - message consumer
+serializer - serializer to use for items
+queuePath - path to store queue
+</pre></div><div class="source"><pre class="prettyprint">QueueBuilder&lt;MessageType&gt;    builder = QueueBuilder.builder(client, consumer, serializer, path);
+... more builder method calls as needed ...
+DistributedPriorityQueue&lt;MessageType&gt; queue = builder.buildPriorityQueue(minItemsBeforeRefresh);
+</pre></div><div class="source"><pre class="prettyprint">public DistributedPriorityQueue&lt;T&gt; buildPriorityQueue(int minItemsBeforeRefresh)
+Build a DistributedPriorityQueue from the current builder values.
+
+When the priority queue detects an item addition/removal, it will stop processing its current list of items and refresh the
+list. minItemsBeforeRefresh modifies this. It determines the minimum number of items from the active list that will get processed before a refresh.
+
+Due to a quirk in the way ZooKeeper notifies changes, the queue will get an item addition/remove notification after every item is
+processed. This can lead to poor performance. Set minItemsBeforeRefresh to the value your application can tolerate being out of sync.
+
+For example: if the queue sees 10 items to process, it will end up making 10 calls to ZooKeeper to check status. You can control
+this by setting minItemsBeforeRefresh to 10 (or more) and the queue will only refresh with ZooKeeper after 10 items are processed
+
+Parameters:
+minItemsBeforeRefresh - minimum items to process before refreshing the item list
+</pre></div><div class="section"><h3>General Usage<a name="General_Usage"></a></h3></div><p>The queue must be started via the <tt>start()</tt> method. Call <tt>close()</tt> when you are done with the queue.</p><p>To add messages to the queue:</p><div class="source"><pre class="prettyprint">queue.put(aMessage, priority);
+</pre></div><p>The consumer (<tt>QueueConsumer.consumeMessage()</tt>) will get called as messages arrive.</p><div class="section"><h3>Lock Safety<a name="Lock_Safety"></a></h3></div><p>In the general usage case, the message is removed from the queue prior to the consumer being called. A more atomic mode is provided that removes the item from the queue only after the consumer successfully returns. To enable this mode, call the <tt>lockPath()</tt> method of the Queue Builder. This uses a lock to make the message recoverable. A lock is held while the message is being processed - this prevents other processes from taking the message. The message will not be removed from the queue until the consumer functor returns. Thus, if there is a failure or the process dies, the message will get sent to another process. There is a small performance penalty for this behavior however.</p><div class="section"><h3>Data Format<a name="Data_Format"></a></h3></div><p>Same as <a href="distributed-q
 ueue.html">Distributed Queue</a>.</p><div class="section"><h3>Error Handling<a name="Error_Handling"></a></h3></div><p>The <tt>QueueConsumer</tt> class extends <tt>ConnectionStateListener</tt>. When the queue is started, it adds the listener to the Curator instance. Users of the <tt>DistributedPriorityQueue</tt> must pay attention to any connection state changes.</p><p>If the SUSPENDED state is reported, the instance must assume that, until it receives a RECONNECTED state, the queue is no longer being updated. If the LOST state is reported, the queue is permanently down.</p>
+                  </div>
+            </div>
+          </div>
+
+    <hr/>
+
+    <footer>
+            <div class="container-fluid">
+              <div class="row span12">Copyright &copy;                    2011-2013
+                        <a href="http://www.apache.org/">The Apache Software Foundation</a>.
+            All Rights Reserved.      
+            
+      </div>
+
+                                                                  <?xml version="1.0" encoding="UTF-8"?>
+<div style="margin-bottom: 8px;" class="row span12">Apache Curator, the Apache feather logo, and the Apache Curator project logos are
+                trademarks of The Apache Software Foundation. All other marks mentioned may be
+                trademarks or registered trademarks of their respective owners.</div>
+                  
+        
+                </div>
+    </footer>
+  </body>
+</html>

Propchange: incubator/curator/site/trunk/curator-recipes/distributed-priority-queue.html
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: incubator/curator/site/trunk/curator-recipes/distributed-priority-queue.html
------------------------------------------------------------------------------
    svn:keywords = Date Revision Author HeadURL Id

Propchange: incubator/curator/site/trunk/curator-recipes/distributed-priority-queue.html
------------------------------------------------------------------------------
    svn:mime-type = text/html

Added: incubator/curator/site/trunk/curator-recipes/distributed-queue.html
URL: http://svn.apache.org/viewvc/incubator/curator/site/trunk/curator-recipes/distributed-queue.html?rev=1459958&view=auto
==============================================================================
--- incubator/curator/site/trunk/curator-recipes/distributed-queue.html (added)
+++ incubator/curator/site/trunk/curator-recipes/distributed-queue.html Fri Mar 22 19:57:43 2013
@@ -0,0 +1,306 @@
+<!DOCTYPE html>
+<!--
+ | Generated by Apache Maven Doxia at Mar 22, 2013
+ | Rendered using Apache Maven Fluido Skin 1.3.0
+-->
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <meta name="Date-Revision-yyyymmdd" content="20130322" />
+    <meta http-equiv="Content-Language" content="en" />
+    <title>Apache Curator Recipes - </title>
+    <link rel="stylesheet" href="./css/apache-maven-fluido-1.3.0.min.css" />
+    <link rel="stylesheet" href="./css/site.css" />
+    <link rel="stylesheet" href="./css/print.css" media="print" />
+
+      
+    <script type="text/javascript" src="./js/apache-maven-fluido-1.3.0.min.js"></script>
+
+                          
+        
+<link rel="stylesheet" href="../css/site.css"/>
+                      
+        
+<script type="text/javascript">$(function(){
+                    if ( location.pathname.match(".*index\.html") )
+                    {
+                        $('a[title="Recipes"]').parent().addClass("active");
+                    }
+                });</script>
+          
+            </head>
+        <body class="topBarDisabled">
+          
+        
+    
+        <div class="container-fluid">
+          <div id="banner">
+        <div class="pull-left">
+                                                  <a href="../index.html" id="bannerLeft">
+                                                                                                <img src="../images/curator-logo.png"  alt="Apache Curator"/>
+                </a>
+                      </div>
+        <div class="pull-right">                  <a href="http://incubator.apache.org" id="bannerRight">
+                                                                                        <img src="http://incubator.apache.org/images/apache-incubator-logo.png"  alt="Apache Incubator"/>
+                </a>
+      </div>
+        <div class="clear"><hr/></div>
+      </div>
+
+      <div id="breadcrumbs">
+        <ul class="breadcrumb">
+                
+            
+                  <li id="publishDate">Last Published: 2013-03-22</li>
+                  <li class="divider">|</li> <li id="projectVersion">Version: 2.0.0-SNAPSHOT</li>
+                      
+                
+            
+      
+                                              
+    <li class="pull-right">              <a href="http://zookeeper.apache.org" class="externalLink" title="Apache ZooKeeper">
+        Apache ZooKeeper</a>
+  </li>
+
+                        </ul>
+      </div>
+
+            
+      <div class="row-fluid">
+        <div id="leftColumn" class="span3">
+          <div class="well sidebar-nav">
+                
+            
+                <ul class="nav nav-list">
+                    <li class="nav-header">Apache Curator</li>
+                                
+      <li>
+    
+                          <a href="../index.html" title="About">
+          <i class="none"></i>
+        About</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../getting-started.html" title="Getting Started">
+          <i class="none"></i>
+        Getting Started</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../curator-examples/index.html" title="Examples">
+          <i class="none"></i>
+        Examples</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../curator-recipes/index.html" title="Recipes">
+          <i class="none"></i>
+        Recipes</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../curator-framework/index.html" title="Framework">
+          <i class="none"></i>
+        Framework</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../utilities.html" title="Utilities">
+          <i class="none"></i>
+        Utilities</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../curator-client/index.html" title="Client">
+          <i class="none"></i>
+        Client</a>
+            </li>
+                              <li class="nav-header">Details</li>
+                                
+      <li>
+    
+                          <a href="../errors.html" title="Error Handling">
+          <i class="none"></i>
+        Error Handling</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../logging.html" title="Logging and Tracing">
+          <i class="none"></i>
+        Logging and Tracing</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../tech-notes.html" title="Tech Notes">
+          <i class="none"></i>
+        Tech Notes</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../exhibitor.html" title="Exhibitor Integration">
+          <i class="none"></i>
+        Exhibitor Integration</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../project-info.html" title="Project Information">
+          <i class="none"></i>
+        Project Information</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../apidocs/index.html" title="Javadoc">
+          <i class="none"></i>
+        Javadoc</a>
+            </li>
+                              <li class="nav-header">Extensions</li>
+                                
+      <li>
+    
+                          <a href="../curator-x-discovery/index.html" title="Service Discovery">
+          <i class="none"></i>
+        Service Discovery</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../curator-x-discovery-server/index.html" title="Service Discovery Server">
+          <i class="none"></i>
+        Service Discovery Server</a>
+            </li>
+                              <li class="nav-header">Community</li>
+                                
+      <li>
+    
+                          <a href="../patches.html" title="Submitting Patches">
+          <i class="none"></i>
+        Submitting Patches</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../history.html" title="History">
+          <i class="none"></i>
+        History</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../articles.html" title="Third Party Articles">
+          <i class="none"></i>
+        Third Party Articles</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../contributions.html" title="Third Party Contributions">
+          <i class="none"></i>
+        Third Party Contributions</a>
+            </li>
+                              <li class="nav-header">ASF</li>
+                                
+      <li>
+    
+                          <a href="http://www.apache.org/foundation/how-it-works.html" class="externalLink" title="How the ASF works">
+          <i class="none"></i>
+        How the ASF works</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="http://www.apache.org/foundation/getinvolved.html" class="externalLink" title="Get Involved">
+          <i class="none"></i>
+        Get Involved</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="http://www.apache.org/dev/" class="externalLink" title="Developer Resources">
+          <i class="none"></i>
+        Developer Resources</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsorship">
+          <i class="none"></i>
+        Sponsorship</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="http://www.apache.org/foundation/thanks.html" class="externalLink" title="Thanks">
+          <i class="none"></i>
+        Thanks</a>
+            </li>
+            </ul>
+                
+            
+                
+          <hr class="divider" />
+
+           <div id="poweredBy">
+                            <div class="clear"></div>
+                            <div class="clear"></div>
+                            <div class="clear"></div>
+                             <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+        <img class="builtBy" alt="Built by Maven" src="./images/logos/maven-feather.png" />
+      </a>
+                  </div>
+          </div>
+        </div>
+        
+                
+        <div id="bodyColumn"  class="span9" >
+                                  
+            <div class="section"><h2>Distributed Queue<a name="Distributed_Queue"></a></h2></div><div class="section"><h3><b>IMPORTANT</b> - We recommend that you do NOT use ZooKeeper for Queues. Please see <a href="../tech-note-4.html">Tech Note 4</a> for details.<a name="IMPORTANT_-_We_recommend_that_you_do_NOT_use_ZooKeeper_for_Queues._Please_see_Tech_Note_4_for_details."></a></h3></div><div class="section"><h3>Description<a name="Description"></a></h3></div><p>An implementation of the Distributed Queue ZK recipe. Items put into the queue are guaranteed to be ordered (by means of ZK's PERSISTENTSEQUENTIAL node). If a single consumer takes items out of the queue, they will be ordered FIFO. If ordering is important, use a LeaderSelector to nominate a single consumer.</p><div class="section"><h3>Participating Classes<a name="Participating_Classes"></a></h3></div><ul><li>QueueBuilder</li><li>QueueConsumer</li><li>QueueSerializer</li><li>DistributedQueue</li></ul><div class="s
 ection"><h3>Usage<a name="Usage"></a></h3></div><div class="section"><h4>Creating a DistributedQueue<a name="Creating_a_DistributedQueue"></a></h4></div><div class="source"><pre class="prettyprint">public static &lt;T&gt; QueueBuilder&lt;T&gt; builder(CuratorFramework client,
+                                          QueueConsumer&lt;T&gt; consumer,
+                                          QueueSerializer&lt;T&gt; serializer,
+                                          java.lang.String queuePath)
+Parameters:
+client - the curator client
+consumer - functor to receive messages
+serializer - serializer to use for items
+queuePath - path to store queue
+</pre></div><div class="source"><pre class="prettyprint">QueueBuilder&lt;MessageType&gt;    builder = QueueBuilder.builder(client, consumer, serializer, path);
+... more builder method calls as needed ...
+DistributedQueue&lt;MessageType queue = builder.build();
+</pre></div><div class="section"><h3>General Usage<a name="General_Usage"></a></h3></div><p>The queue must be started via the <tt>start()</tt> method. Call <tt>close()</tt> when you are done with the queue.</p><p>To add messages to the queue:</p><div class="source"><pre class="prettyprint">queue.put(aMessage);
+</pre></div><p>Your consumer (<tt>QueueConsumer.consumeMessage()</tt>) will get called as messages arrive.</p><div class="section"><h3>Lock Safety<a name="Lock_Safety"></a></h3></div><p>In the general usage case, the message is removed from the queue prior to the consumer being called. A more atomic mode is provided that removes the item from the queue only after the consumer successfully returns. To enable this mode, call the <tt>lockPath()</tt> method of the Queue Builder. This uses a lock to make the message recoverable. A lock is held while the message is being processed - this prevents other processes from taking the message. The message will not be removed from the queue until the consumer functor returns. Thus, if there is a failure or the process dies, the message will get sent to another process. There is a small performance penalty for this behavior however.</p><div class="section"><h3>Data Format<a name="Data_Format"></a></h3></div><p>The Distributed queue writes 
 messages using this format:</p><table border="0" class="table table-striped"><tr class="a"><th><b>OFFSET</b></th><th><b>SIZE</b></th><th><b>DESCRIPTION</b></th></tr><tr class="b"><td>0</td><td>4</td><td>Format version. Currently 0x00010001</td></tr><tr class="a"><td>4</td><td>1</td><td>Opcode: 0x01 = message, 0x02 = End of data</td></tr><tr class="b"><td>5</td><td>4</td><td>Message byte length</td></tr><tr class="a"><td>9</td><td>n</td><td>Message: serialized message bytes</td></tr><tr class="b"><td>9 + n</td><td>...</td><td>Next set of opcode-size-bytes until end of data</td></tr></table><div class="section"><h3>Error Handling<a name="Error_Handling"></a></h3></div><p>The <tt>QueueConsumer</tt> class extends <tt>ConnectionStateListener</tt>. When the queue is started, it adds the listener to the Curator instance. Users of the <tt>DistributedQueue</tt> must pay attention to any connection state changes.</p><p>If the SUSPENDED state is reported, the instance must assume that,
  until it receives a RECONNECTED state, the queue is no longer being updated. If the LOST state is reported, the queue is permanently down.</p>
+                  </div>
+            </div>
+          </div>
+
+    <hr/>
+
+    <footer>
+            <div class="container-fluid">
+              <div class="row span12">Copyright &copy;                    2011-2013
+                        <a href="http://www.apache.org/">The Apache Software Foundation</a>.
+            All Rights Reserved.      
+            
+      </div>
+
+                                                                  <?xml version="1.0" encoding="UTF-8"?>
+<div style="margin-bottom: 8px;" class="row span12">Apache Curator, the Apache feather logo, and the Apache Curator project logos are
+                trademarks of The Apache Software Foundation. All other marks mentioned may be
+                trademarks or registered trademarks of their respective owners.</div>
+                  
+        
+                </div>
+    </footer>
+  </body>
+</html>

Propchange: incubator/curator/site/trunk/curator-recipes/distributed-queue.html
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: incubator/curator/site/trunk/curator-recipes/distributed-queue.html
------------------------------------------------------------------------------
    svn:keywords = Date Revision Author HeadURL Id

Propchange: incubator/curator/site/trunk/curator-recipes/distributed-queue.html
------------------------------------------------------------------------------
    svn:mime-type = text/html

Added: incubator/curator/site/trunk/curator-recipes/distribution-management.html
URL: http://svn.apache.org/viewvc/incubator/curator/site/trunk/curator-recipes/distribution-management.html?rev=1459958&view=auto
==============================================================================
--- incubator/curator/site/trunk/curator-recipes/distribution-management.html (added)
+++ incubator/curator/site/trunk/curator-recipes/distribution-management.html Fri Mar 22 19:57:43 2013
@@ -0,0 +1,293 @@
+<!DOCTYPE html>
+<!--
+ | Generated by Apache Maven Doxia at Mar 22, 2013
+ | Rendered using Apache Maven Fluido Skin 1.3.0
+-->
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <meta name="Date-Revision-yyyymmdd" content="20130322" />
+    <meta http-equiv="Content-Language" content="en" />
+    <title>Apache Curator Recipes - Project Distribution Management</title>
+    <link rel="stylesheet" href="./css/apache-maven-fluido-1.3.0.min.css" />
+    <link rel="stylesheet" href="./css/site.css" />
+    <link rel="stylesheet" href="./css/print.css" media="print" />
+
+      
+    <script type="text/javascript" src="./js/apache-maven-fluido-1.3.0.min.js"></script>
+
+                          
+        
+<link rel="stylesheet" href="../css/site.css"/>
+                      
+        
+<script type="text/javascript">$(function(){
+                    if ( location.pathname.match(".*index\.html") )
+                    {
+                        $('a[title="Recipes"]').parent().addClass("active");
+                    }
+                });</script>
+          
+            </head>
+        <body class="topBarDisabled">
+          
+        
+    
+        <div class="container-fluid">
+          <div id="banner">
+        <div class="pull-left">
+                                                  <a href="../index.html" id="bannerLeft">
+                                                                                                <img src="../images/curator-logo.png"  alt="Apache Curator"/>
+                </a>
+                      </div>
+        <div class="pull-right">                  <a href="http://incubator.apache.org" id="bannerRight">
+                                                                                        <img src="http://incubator.apache.org/images/apache-incubator-logo.png"  alt="Apache Incubator"/>
+                </a>
+      </div>
+        <div class="clear"><hr/></div>
+      </div>
+
+      <div id="breadcrumbs">
+        <ul class="breadcrumb">
+                
+            
+                  <li id="publishDate">Last Published: 2013-03-22</li>
+                  <li class="divider">|</li> <li id="projectVersion">Version: 2.0.0-SNAPSHOT</li>
+                      
+                
+            
+      
+                                              
+    <li class="pull-right">              <a href="http://zookeeper.apache.org" class="externalLink" title="Apache ZooKeeper">
+        Apache ZooKeeper</a>
+  </li>
+
+                        </ul>
+      </div>
+
+            
+      <div class="row-fluid">
+        <div id="leftColumn" class="span3">
+          <div class="well sidebar-nav">
+                
+            
+                <ul class="nav nav-list">
+                    <li class="nav-header">Apache Curator</li>
+                                
+      <li>
+    
+                          <a href="../index.html" title="About">
+          <i class="none"></i>
+        About</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../getting-started.html" title="Getting Started">
+          <i class="none"></i>
+        Getting Started</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../curator-examples/index.html" title="Examples">
+          <i class="none"></i>
+        Examples</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../curator-recipes/index.html" title="Recipes">
+          <i class="none"></i>
+        Recipes</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../curator-framework/index.html" title="Framework">
+          <i class="none"></i>
+        Framework</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../utilities.html" title="Utilities">
+          <i class="none"></i>
+        Utilities</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../curator-client/index.html" title="Client">
+          <i class="none"></i>
+        Client</a>
+            </li>
+                              <li class="nav-header">Details</li>
+                                
+      <li>
+    
+                          <a href="../errors.html" title="Error Handling">
+          <i class="none"></i>
+        Error Handling</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../logging.html" title="Logging and Tracing">
+          <i class="none"></i>
+        Logging and Tracing</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../tech-notes.html" title="Tech Notes">
+          <i class="none"></i>
+        Tech Notes</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../exhibitor.html" title="Exhibitor Integration">
+          <i class="none"></i>
+        Exhibitor Integration</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../project-info.html" title="Project Information">
+          <i class="none"></i>
+        Project Information</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../apidocs/index.html" title="Javadoc">
+          <i class="none"></i>
+        Javadoc</a>
+            </li>
+                              <li class="nav-header">Extensions</li>
+                                
+      <li>
+    
+                          <a href="../curator-x-discovery/index.html" title="Service Discovery">
+          <i class="none"></i>
+        Service Discovery</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../curator-x-discovery-server/index.html" title="Service Discovery Server">
+          <i class="none"></i>
+        Service Discovery Server</a>
+            </li>
+                              <li class="nav-header">Community</li>
+                                
+      <li>
+    
+                          <a href="../patches.html" title="Submitting Patches">
+          <i class="none"></i>
+        Submitting Patches</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../history.html" title="History">
+          <i class="none"></i>
+        History</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../articles.html" title="Third Party Articles">
+          <i class="none"></i>
+        Third Party Articles</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../contributions.html" title="Third Party Contributions">
+          <i class="none"></i>
+        Third Party Contributions</a>
+            </li>
+                              <li class="nav-header">ASF</li>
+                                
+      <li>
+    
+                          <a href="http://www.apache.org/foundation/how-it-works.html" class="externalLink" title="How the ASF works">
+          <i class="none"></i>
+        How the ASF works</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="http://www.apache.org/foundation/getinvolved.html" class="externalLink" title="Get Involved">
+          <i class="none"></i>
+        Get Involved</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="http://www.apache.org/dev/" class="externalLink" title="Developer Resources">
+          <i class="none"></i>
+        Developer Resources</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsorship">
+          <i class="none"></i>
+        Sponsorship</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="http://www.apache.org/foundation/thanks.html" class="externalLink" title="Thanks">
+          <i class="none"></i>
+        Thanks</a>
+            </li>
+            </ul>
+                
+            
+                
+          <hr class="divider" />
+
+           <div id="poweredBy">
+                            <div class="clear"></div>
+                            <div class="clear"></div>
+                            <div class="clear"></div>
+                             <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+        <img class="builtBy" alt="Built by Maven" src="./images/logos/maven-feather.png" />
+      </a>
+                  </div>
+          </div>
+        </div>
+        
+                
+        <div id="bodyColumn"  class="span9" >
+                                  
+            <div class="section"><h2>Overview<a name="Overview"></a></h2><a name="Overview"></a><p>The following is the distribution management information used by this project.</p><div class="section"><h3>Repository - apache.releases.https<a name="Repository_-_apache.releases.https"></a></h3><a name="Repository_-_apache.releases.https"></a><a class="externalLink" href="https://repository.apache.org/service/local/staging/deploy/maven2">https://repository.apache.org/service/local/staging/deploy/maven2</a></div><div class="section"><h3>Snapshot Repository - apache.snapshots.https<a name="Snapshot_Repository_-_apache.snapshots.https"></a></h3><a name="Snapshot_Repository_-_apache.snapshots.https"></a><a class="externalLink" href="https://repository.apache.org/content/repositories/snapshots">https://repository.apache.org/content/repositories/snapshots</a></div><div class="section"><h3>Site - apache<a name="Site_-_apache"></a></h3><a name="Site_-_apache"></a><p>scp://people.apach
 e.org/www/curator.incubator.apache.org/curator-recipes</p></div></div>
+                  </div>
+            </div>
+          </div>
+
+    <hr/>
+
+    <footer>
+            <div class="container-fluid">
+              <div class="row span12">Copyright &copy;                    2011-2013
+                        <a href="http://www.apache.org/">The Apache Software Foundation</a>.
+            All Rights Reserved.      
+            
+      </div>
+
+                                                                  <?xml version="1.0" encoding="UTF-8"?>
+<div style="margin-bottom: 8px;" class="row span12">Apache Curator, the Apache feather logo, and the Apache Curator project logos are
+                trademarks of The Apache Software Foundation. All other marks mentioned may be
+                trademarks or registered trademarks of their respective owners.</div>
+                  
+        
+                </div>
+    </footer>
+  </body>
+</html>

Propchange: incubator/curator/site/trunk/curator-recipes/distribution-management.html
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: incubator/curator/site/trunk/curator-recipes/distribution-management.html
------------------------------------------------------------------------------
    svn:keywords = Date Revision Author HeadURL Id

Propchange: incubator/curator/site/trunk/curator-recipes/distribution-management.html
------------------------------------------------------------------------------
    svn:mime-type = text/html

Added: incubator/curator/site/trunk/curator-recipes/double-barrier.html
URL: http://svn.apache.org/viewvc/incubator/curator/site/trunk/curator-recipes/double-barrier.html?rev=1459958&view=auto
==============================================================================
--- incubator/curator/site/trunk/curator-recipes/double-barrier.html (added)
+++ incubator/curator/site/trunk/curator-recipes/double-barrier.html Fri Mar 22 19:57:43 2013
@@ -0,0 +1,305 @@
+<!DOCTYPE html>
+<!--
+ | Generated by Apache Maven Doxia at Mar 22, 2013
+ | Rendered using Apache Maven Fluido Skin 1.3.0
+-->
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <meta name="Date-Revision-yyyymmdd" content="20130322" />
+    <meta http-equiv="Content-Language" content="en" />
+    <title>Apache Curator Recipes - </title>
+    <link rel="stylesheet" href="./css/apache-maven-fluido-1.3.0.min.css" />
+    <link rel="stylesheet" href="./css/site.css" />
+    <link rel="stylesheet" href="./css/print.css" media="print" />
+
+      
+    <script type="text/javascript" src="./js/apache-maven-fluido-1.3.0.min.js"></script>
+
+                          
+        
+<link rel="stylesheet" href="../css/site.css"/>
+                      
+        
+<script type="text/javascript">$(function(){
+                    if ( location.pathname.match(".*index\.html") )
+                    {
+                        $('a[title="Recipes"]').parent().addClass("active");
+                    }
+                });</script>
+          
+            </head>
+        <body class="topBarDisabled">
+          
+        
+    
+        <div class="container-fluid">
+          <div id="banner">
+        <div class="pull-left">
+                                                  <a href="../index.html" id="bannerLeft">
+                                                                                                <img src="../images/curator-logo.png"  alt="Apache Curator"/>
+                </a>
+                      </div>
+        <div class="pull-right">                  <a href="http://incubator.apache.org" id="bannerRight">
+                                                                                        <img src="http://incubator.apache.org/images/apache-incubator-logo.png"  alt="Apache Incubator"/>
+                </a>
+      </div>
+        <div class="clear"><hr/></div>
+      </div>
+
+      <div id="breadcrumbs">
+        <ul class="breadcrumb">
+                
+            
+                  <li id="publishDate">Last Published: 2013-03-22</li>
+                  <li class="divider">|</li> <li id="projectVersion">Version: 2.0.0-SNAPSHOT</li>
+                      
+                
+            
+      
+                                              
+    <li class="pull-right">              <a href="http://zookeeper.apache.org" class="externalLink" title="Apache ZooKeeper">
+        Apache ZooKeeper</a>
+  </li>
+
+                        </ul>
+      </div>
+
+            
+      <div class="row-fluid">
+        <div id="leftColumn" class="span3">
+          <div class="well sidebar-nav">
+                
+            
+                <ul class="nav nav-list">
+                    <li class="nav-header">Apache Curator</li>
+                                
+      <li>
+    
+                          <a href="../index.html" title="About">
+          <i class="none"></i>
+        About</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../getting-started.html" title="Getting Started">
+          <i class="none"></i>
+        Getting Started</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../curator-examples/index.html" title="Examples">
+          <i class="none"></i>
+        Examples</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../curator-recipes/index.html" title="Recipes">
+          <i class="none"></i>
+        Recipes</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../curator-framework/index.html" title="Framework">
+          <i class="none"></i>
+        Framework</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../utilities.html" title="Utilities">
+          <i class="none"></i>
+        Utilities</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../curator-client/index.html" title="Client">
+          <i class="none"></i>
+        Client</a>
+            </li>
+                              <li class="nav-header">Details</li>
+                                
+      <li>
+    
+                          <a href="../errors.html" title="Error Handling">
+          <i class="none"></i>
+        Error Handling</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../logging.html" title="Logging and Tracing">
+          <i class="none"></i>
+        Logging and Tracing</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../tech-notes.html" title="Tech Notes">
+          <i class="none"></i>
+        Tech Notes</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../exhibitor.html" title="Exhibitor Integration">
+          <i class="none"></i>
+        Exhibitor Integration</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../project-info.html" title="Project Information">
+          <i class="none"></i>
+        Project Information</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../apidocs/index.html" title="Javadoc">
+          <i class="none"></i>
+        Javadoc</a>
+            </li>
+                              <li class="nav-header">Extensions</li>
+                                
+      <li>
+    
+                          <a href="../curator-x-discovery/index.html" title="Service Discovery">
+          <i class="none"></i>
+        Service Discovery</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../curator-x-discovery-server/index.html" title="Service Discovery Server">
+          <i class="none"></i>
+        Service Discovery Server</a>
+            </li>
+                              <li class="nav-header">Community</li>
+                                
+      <li>
+    
+                          <a href="../patches.html" title="Submitting Patches">
+          <i class="none"></i>
+        Submitting Patches</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../history.html" title="History">
+          <i class="none"></i>
+        History</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../articles.html" title="Third Party Articles">
+          <i class="none"></i>
+        Third Party Articles</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="../contributions.html" title="Third Party Contributions">
+          <i class="none"></i>
+        Third Party Contributions</a>
+            </li>
+                              <li class="nav-header">ASF</li>
+                                
+      <li>
+    
+                          <a href="http://www.apache.org/foundation/how-it-works.html" class="externalLink" title="How the ASF works">
+          <i class="none"></i>
+        How the ASF works</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="http://www.apache.org/foundation/getinvolved.html" class="externalLink" title="Get Involved">
+          <i class="none"></i>
+        Get Involved</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="http://www.apache.org/dev/" class="externalLink" title="Developer Resources">
+          <i class="none"></i>
+        Developer Resources</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsorship">
+          <i class="none"></i>
+        Sponsorship</a>
+            </li>
+                  
+      <li>
+    
+                          <a href="http://www.apache.org/foundation/thanks.html" class="externalLink" title="Thanks">
+          <i class="none"></i>
+        Thanks</a>
+            </li>
+            </ul>
+                
+            
+                
+          <hr class="divider" />
+
+           <div id="poweredBy">
+                            <div class="clear"></div>
+                            <div class="clear"></div>
+                            <div class="clear"></div>
+                             <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+        <img class="builtBy" alt="Built by Maven" src="./images/logos/maven-feather.png" />
+      </a>
+                  </div>
+          </div>
+        </div>
+        
+                
+        <div id="bodyColumn"  class="span9" >
+                                  
+            <div class="section"><h2>Double Barrier<a name="Double_Barrier"></a></h2></div><div class="section"><h3>Description<a name="Description"></a></h3></div><p>An implementation of the Distributed Double Barrier ZK recipe.</p><p>Double barriers enable clients to synchronize the beginning and the end of a computation. When enough processes have joined the barrier, processes start their computation and leave the barrier once they have finished.</p><div class="section"><h3>Participating Classes<a name="Participating_Classes"></a></h3></div><ul><li>DistributedDoubleBarrier</li></ul><div class="section"><h3>Usage<a name="Usage"></a></h3></div><div class="section"><h4>Creating a DistributedBarrier<a name="Creating_a_DistributedBarrier"></a></h4></div><div class="source"><pre class="prettyprint">public DistributedDoubleBarrier(CuratorFramework client,
+                                String barrierPath,
+                                int memberQty)
+Creates the barrier abstraction. memberQty is the number of members in the barrier. When enter() is called, it blocks until
+all members have entered. When leave() is called, it blocks until all members have left.
+
+Parameters:
+client - the client
+barrierPath - path to use
+memberQty - the number of members in the barrier
+</pre></div><div class="section"><h3>General Usage<a name="General_Usage"></a></h3></div><p>To enter on the barrier:</p><div class="source"><pre class="prettyprint">public void     enter();
+</pre></div><p>To leave on the barrier:</p><div class="source"><pre class="prettyprint">public void     leave();
+</pre></div><div class="section"><h3>Error Handling<a name="Error_Handling"></a></h3></div><p>DistributedDoubleBarrier instances watch for connection loss and will throw an exception from <tt>enter()</tt> and/or <tt>leave()</tt>.</p>
+                  </div>
+            </div>
+          </div>
+
+    <hr/>
+
+    <footer>
+            <div class="container-fluid">
+              <div class="row span12">Copyright &copy;                    2011-2013
+                        <a href="http://www.apache.org/">The Apache Software Foundation</a>.
+            All Rights Reserved.      
+            
+      </div>
+
+                                                                  <?xml version="1.0" encoding="UTF-8"?>
+<div style="margin-bottom: 8px;" class="row span12">Apache Curator, the Apache feather logo, and the Apache Curator project logos are
+                trademarks of The Apache Software Foundation. All other marks mentioned may be
+                trademarks or registered trademarks of their respective owners.</div>
+                  
+        
+                </div>
+    </footer>
+  </body>
+</html>

Propchange: incubator/curator/site/trunk/curator-recipes/double-barrier.html
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: incubator/curator/site/trunk/curator-recipes/double-barrier.html
------------------------------------------------------------------------------
    svn:keywords = Date Revision Author HeadURL Id

Propchange: incubator/curator/site/trunk/curator-recipes/double-barrier.html
------------------------------------------------------------------------------
    svn:mime-type = text/html

Added: incubator/curator/site/trunk/curator-recipes/images/accessories-text-editor.png
URL: http://svn.apache.org/viewvc/incubator/curator/site/trunk/curator-recipes/images/accessories-text-editor.png?rev=1459958&view=auto
==============================================================================
Binary file - no diff available.

Propchange: incubator/curator/site/trunk/curator-recipes/images/accessories-text-editor.png
------------------------------------------------------------------------------
    svn:mime-type = image/png

Added: incubator/curator/site/trunk/curator-recipes/images/add.gif
URL: http://svn.apache.org/viewvc/incubator/curator/site/trunk/curator-recipes/images/add.gif?rev=1459958&view=auto
==============================================================================
Binary file - no diff available.

Propchange: incubator/curator/site/trunk/curator-recipes/images/add.gif
------------------------------------------------------------------------------
    svn:mime-type = image/gif

Added: incubator/curator/site/trunk/curator-recipes/images/apache-maven-project-2.png
URL: http://svn.apache.org/viewvc/incubator/curator/site/trunk/curator-recipes/images/apache-maven-project-2.png?rev=1459958&view=auto
==============================================================================
Binary file - no diff available.

Propchange: incubator/curator/site/trunk/curator-recipes/images/apache-maven-project-2.png
------------------------------------------------------------------------------
    svn:mime-type = image/png

Added: incubator/curator/site/trunk/curator-recipes/images/application-certificate.png
URL: http://svn.apache.org/viewvc/incubator/curator/site/trunk/curator-recipes/images/application-certificate.png?rev=1459958&view=auto
==============================================================================
Binary file - no diff available.

Propchange: incubator/curator/site/trunk/curator-recipes/images/application-certificate.png
------------------------------------------------------------------------------
    svn:mime-type = image/png

Added: incubator/curator/site/trunk/curator-recipes/images/close.gif
URL: http://svn.apache.org/viewvc/incubator/curator/site/trunk/curator-recipes/images/close.gif?rev=1459958&view=auto
==============================================================================
Binary file - no diff available.

Propchange: incubator/curator/site/trunk/curator-recipes/images/close.gif
------------------------------------------------------------------------------
    svn:mime-type = image/gif

Added: incubator/curator/site/trunk/curator-recipes/images/contact-new.png
URL: http://svn.apache.org/viewvc/incubator/curator/site/trunk/curator-recipes/images/contact-new.png?rev=1459958&view=auto
==============================================================================
Binary file - no diff available.

Propchange: incubator/curator/site/trunk/curator-recipes/images/contact-new.png
------------------------------------------------------------------------------
    svn:mime-type = image/png

Added: incubator/curator/site/trunk/curator-recipes/images/document-properties.png
URL: http://svn.apache.org/viewvc/incubator/curator/site/trunk/curator-recipes/images/document-properties.png?rev=1459958&view=auto
==============================================================================
Binary file - no diff available.

Propchange: incubator/curator/site/trunk/curator-recipes/images/document-properties.png
------------------------------------------------------------------------------
    svn:mime-type = image/png

Added: incubator/curator/site/trunk/curator-recipes/images/drive-harddisk.png
URL: http://svn.apache.org/viewvc/incubator/curator/site/trunk/curator-recipes/images/drive-harddisk.png?rev=1459958&view=auto
==============================================================================
Binary file - no diff available.

Propchange: incubator/curator/site/trunk/curator-recipes/images/drive-harddisk.png
------------------------------------------------------------------------------
    svn:mime-type = image/png

Added: incubator/curator/site/trunk/curator-recipes/images/fix.gif
URL: http://svn.apache.org/viewvc/incubator/curator/site/trunk/curator-recipes/images/fix.gif?rev=1459958&view=auto
==============================================================================
Binary file - no diff available.

Propchange: incubator/curator/site/trunk/curator-recipes/images/fix.gif
------------------------------------------------------------------------------
    svn:mime-type = image/gif

Added: incubator/curator/site/trunk/curator-recipes/images/icon_error_sml.gif
URL: http://svn.apache.org/viewvc/incubator/curator/site/trunk/curator-recipes/images/icon_error_sml.gif?rev=1459958&view=auto
==============================================================================
Binary file - no diff available.

Propchange: incubator/curator/site/trunk/curator-recipes/images/icon_error_sml.gif
------------------------------------------------------------------------------
    svn:mime-type = image/gif

Added: incubator/curator/site/trunk/curator-recipes/images/icon_help_sml.gif
URL: http://svn.apache.org/viewvc/incubator/curator/site/trunk/curator-recipes/images/icon_help_sml.gif?rev=1459958&view=auto
==============================================================================
Binary file - no diff available.

Propchange: incubator/curator/site/trunk/curator-recipes/images/icon_help_sml.gif
------------------------------------------------------------------------------
    svn:mime-type = image/gif

Added: incubator/curator/site/trunk/curator-recipes/images/icon_info_sml.gif
URL: http://svn.apache.org/viewvc/incubator/curator/site/trunk/curator-recipes/images/icon_info_sml.gif?rev=1459958&view=auto
==============================================================================
Binary file - no diff available.

Propchange: incubator/curator/site/trunk/curator-recipes/images/icon_info_sml.gif
------------------------------------------------------------------------------
    svn:mime-type = image/gif

Added: incubator/curator/site/trunk/curator-recipes/images/icon_success_sml.gif
URL: http://svn.apache.org/viewvc/incubator/curator/site/trunk/curator-recipes/images/icon_success_sml.gif?rev=1459958&view=auto
==============================================================================
Binary file - no diff available.

Propchange: incubator/curator/site/trunk/curator-recipes/images/icon_success_sml.gif
------------------------------------------------------------------------------
    svn:mime-type = image/gif

Added: incubator/curator/site/trunk/curator-recipes/images/icon_warning_sml.gif
URL: http://svn.apache.org/viewvc/incubator/curator/site/trunk/curator-recipes/images/icon_warning_sml.gif?rev=1459958&view=auto
==============================================================================
Binary file - no diff available.

Propchange: incubator/curator/site/trunk/curator-recipes/images/icon_warning_sml.gif
------------------------------------------------------------------------------
    svn:mime-type = image/gif

Added: incubator/curator/site/trunk/curator-recipes/images/image-x-generic.png
URL: http://svn.apache.org/viewvc/incubator/curator/site/trunk/curator-recipes/images/image-x-generic.png?rev=1459958&view=auto
==============================================================================
Binary file - no diff available.

Propchange: incubator/curator/site/trunk/curator-recipes/images/image-x-generic.png
------------------------------------------------------------------------------
    svn:mime-type = image/png

Added: incubator/curator/site/trunk/curator-recipes/images/internet-web-browser.png
URL: http://svn.apache.org/viewvc/incubator/curator/site/trunk/curator-recipes/images/internet-web-browser.png?rev=1459958&view=auto
==============================================================================
Binary file - no diff available.

Propchange: incubator/curator/site/trunk/curator-recipes/images/internet-web-browser.png
------------------------------------------------------------------------------
    svn:mime-type = image/png

Added: incubator/curator/site/trunk/curator-recipes/images/logos/build-by-maven-black.png
URL: http://svn.apache.org/viewvc/incubator/curator/site/trunk/curator-recipes/images/logos/build-by-maven-black.png?rev=1459958&view=auto
==============================================================================
Binary file - no diff available.

Propchange: incubator/curator/site/trunk/curator-recipes/images/logos/build-by-maven-black.png
------------------------------------------------------------------------------
    svn:mime-type = image/png

Added: incubator/curator/site/trunk/curator-recipes/images/logos/build-by-maven-white.png
URL: http://svn.apache.org/viewvc/incubator/curator/site/trunk/curator-recipes/images/logos/build-by-maven-white.png?rev=1459958&view=auto
==============================================================================
Binary file - no diff available.

Propchange: incubator/curator/site/trunk/curator-recipes/images/logos/build-by-maven-white.png
------------------------------------------------------------------------------
    svn:mime-type = image/png

Added: incubator/curator/site/trunk/curator-recipes/images/logos/maven-feather.png
URL: http://svn.apache.org/viewvc/incubator/curator/site/trunk/curator-recipes/images/logos/maven-feather.png?rev=1459958&view=auto
==============================================================================
Binary file - no diff available.

Propchange: incubator/curator/site/trunk/curator-recipes/images/logos/maven-feather.png
------------------------------------------------------------------------------
    svn:mime-type = image/png

Added: incubator/curator/site/trunk/curator-recipes/images/network-server.png
URL: http://svn.apache.org/viewvc/incubator/curator/site/trunk/curator-recipes/images/network-server.png?rev=1459958&view=auto
==============================================================================
Binary file - no diff available.

Propchange: incubator/curator/site/trunk/curator-recipes/images/network-server.png
------------------------------------------------------------------------------
    svn:mime-type = image/png

Added: incubator/curator/site/trunk/curator-recipes/images/package-x-generic.png
URL: http://svn.apache.org/viewvc/incubator/curator/site/trunk/curator-recipes/images/package-x-generic.png?rev=1459958&view=auto
==============================================================================
Binary file - no diff available.

Propchange: incubator/curator/site/trunk/curator-recipes/images/package-x-generic.png
------------------------------------------------------------------------------
    svn:mime-type = image/png

Added: incubator/curator/site/trunk/curator-recipes/images/profiles/pre-release.png
URL: http://svn.apache.org/viewvc/incubator/curator/site/trunk/curator-recipes/images/profiles/pre-release.png?rev=1459958&view=auto
==============================================================================
Binary file - no diff available.

Propchange: incubator/curator/site/trunk/curator-recipes/images/profiles/pre-release.png
------------------------------------------------------------------------------
    svn:mime-type = image/png

Added: incubator/curator/site/trunk/curator-recipes/images/profiles/retired.png
URL: http://svn.apache.org/viewvc/incubator/curator/site/trunk/curator-recipes/images/profiles/retired.png?rev=1459958&view=auto
==============================================================================
Binary file - no diff available.

Propchange: incubator/curator/site/trunk/curator-recipes/images/profiles/retired.png
------------------------------------------------------------------------------
    svn:mime-type = image/png

Added: incubator/curator/site/trunk/curator-recipes/images/profiles/sandbox.png
URL: http://svn.apache.org/viewvc/incubator/curator/site/trunk/curator-recipes/images/profiles/sandbox.png?rev=1459958&view=auto
==============================================================================
Binary file - no diff available.

Propchange: incubator/curator/site/trunk/curator-recipes/images/profiles/sandbox.png
------------------------------------------------------------------------------
    svn:mime-type = image/png

Added: incubator/curator/site/trunk/curator-recipes/images/remove.gif
URL: http://svn.apache.org/viewvc/incubator/curator/site/trunk/curator-recipes/images/remove.gif?rev=1459958&view=auto
==============================================================================
Binary file - no diff available.

Propchange: incubator/curator/site/trunk/curator-recipes/images/remove.gif
------------------------------------------------------------------------------
    svn:mime-type = image/gif

Added: incubator/curator/site/trunk/curator-recipes/images/rss.png
URL: http://svn.apache.org/viewvc/incubator/curator/site/trunk/curator-recipes/images/rss.png?rev=1459958&view=auto
==============================================================================
Binary file - no diff available.

Propchange: incubator/curator/site/trunk/curator-recipes/images/rss.png
------------------------------------------------------------------------------
    svn:mime-type = image/png

Added: incubator/curator/site/trunk/curator-recipes/images/update.gif
URL: http://svn.apache.org/viewvc/incubator/curator/site/trunk/curator-recipes/images/update.gif?rev=1459958&view=auto
==============================================================================
Binary file - no diff available.

Propchange: incubator/curator/site/trunk/curator-recipes/images/update.gif
------------------------------------------------------------------------------
    svn:mime-type = image/gif

Added: incubator/curator/site/trunk/curator-recipes/images/window-new.png
URL: http://svn.apache.org/viewvc/incubator/curator/site/trunk/curator-recipes/images/window-new.png?rev=1459958&view=auto
==============================================================================
Binary file - no diff available.

Propchange: incubator/curator/site/trunk/curator-recipes/images/window-new.png
------------------------------------------------------------------------------
    svn:mime-type = image/png

Added: incubator/curator/site/trunk/curator-recipes/img/glyphicons-halflings-white.png
URL: http://svn.apache.org/viewvc/incubator/curator/site/trunk/curator-recipes/img/glyphicons-halflings-white.png?rev=1459958&view=auto
==============================================================================
Binary file - no diff available.

Propchange: incubator/curator/site/trunk/curator-recipes/img/glyphicons-halflings-white.png
------------------------------------------------------------------------------
    svn:mime-type = image/png

Added: incubator/curator/site/trunk/curator-recipes/img/glyphicons-halflings.png
URL: http://svn.apache.org/viewvc/incubator/curator/site/trunk/curator-recipes/img/glyphicons-halflings.png?rev=1459958&view=auto
==============================================================================
Binary file - no diff available.

Propchange: incubator/curator/site/trunk/curator-recipes/img/glyphicons-halflings.png
------------------------------------------------------------------------------
    svn:mime-type = image/png



Mime
View raw message