curator-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From randg...@apache.org
Subject svn commit: r1459958 [27/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/shared-lock.html
URL: http://svn.apache.org/viewvc/incubator/curator/site/trunk/curator-recipes/shared-lock.html?rev=1459958&view=auto
==============================================================================
--- incubator/curator/site/trunk/curator-recipes/shared-lock.html (added)
+++ incubator/curator/site/trunk/curator-recipes/shared-lock.html Fri Mar 22 19:57:43 2013
@@ -0,0 +1,311 @@
+<!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>Shared Lock<a name="Shared_Lock"></a></h2></div><div class="section"><h3>Description<a name="Description"></a></h3></div><p>Fully distributed locks that are globally synchronous, meaning at any snapshot in time no two clients think they hold the same lock. Note: unlike InterProcessMutex this lock is <b>not</b> reentrant.</p><div class="section"><h3>Participating Classes<a name="Participating_Classes"></a></h3></div><ul><li>InterProcessSemaphoreMutex</li></ul><div class="section"><h3>Usage<a name="Usage"></a></h3></div><div class="section"><h4>Create an InterProcessSemaphoreMutex<a name="Create_an_InterProcessSemaphoreMutex"></a></h4></div><div class="source"><pre class="prettyprint">public InterProcessSemaphoreMutex(CuratorFramework client,
+                         String path)
+Parameters:
+client - client
+path - the path to lock
+</pre></div><div class="section"><h4>General Usage<a name="General_Usage"></a></h4></div><p>To acquire the lock, use one of the acquire methods:</p><div class="source"><pre class="prettyprint">public void acquire()
+Acquire the mutex - blocking until it's available. Must be balanced by a call to release().
+</pre></div><div class="source"><pre class="prettyprint">public boolean acquire(long time,
+                       TimeUnit unit)
+Acquire the mutex - blocks until it's available or the given time expires. Must be balanced by a call to release().
+    &amp;nbsp;
+Parameters:
+time - time to wait
+unit - time unit
+Returns:
+true if the mutex was acquired, false if not
+</pre></div><p>To release the mutex, call:</p><div class="source"><pre class="prettyprint">public void release()
+Perform one release of the mutex if the calling thread is the same thread that acquired it.
+</pre></div><div class="section"><h3>Error Handling<a name="Error_Handling"></a></h3></div><p>It is strongly recommended that you add a <tt>ConnectionStateListener</tt> and watch for SUSPENDED and LOST state changes. If a SUSPENDED state is reported you cannot be certain that you still hold the lock unless you subsequently receive a RECONNECTED state. If a LOST state is reported it is certain that you no longer hold the lock.</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/shared-lock.html
------------------------------------------------------------------------------
    svn:eol-style = native

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

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

Added: incubator/curator/site/trunk/curator-recipes/shared-reentrant-lock.html
URL: http://svn.apache.org/viewvc/incubator/curator/site/trunk/curator-recipes/shared-reentrant-lock.html?rev=1459958&view=auto
==============================================================================
--- incubator/curator/site/trunk/curator-recipes/shared-reentrant-lock.html (added)
+++ incubator/curator/site/trunk/curator-recipes/shared-reentrant-lock.html Fri Mar 22 19:57:43 2013
@@ -0,0 +1,327 @@
+<!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>Shared Reentrant Lock<a name="Shared_Reentrant_Lock"></a></h2></div><div class="section"><h3>Description<a name="Description"></a></h3></div><p>Fully distributed locks that are globally synchronous, meaning at any snapshot in time no two clients think they hold the same lock.</p><div class="section"><h3>Participating Classes<a name="Participating_Classes"></a></h3></div><ul><li>InterProcessMutex</li></ul><div class="section"><h3>Usage<a name="Usage"></a></h3></div><div class="section"><h4>Create an InterProcessMutex<a name="Create_an_InterProcessMutex"></a></h4></div><div class="source"><pre class="prettyprint">public InterProcessMutex(CuratorFramework client,
+                         String path)
+Parameters:
+client - client
+path - the path to lock
+</pre></div><div class="section"><h4>General Usage<a name="General_Usage"></a></h4></div><p>To acquire the lock, use one of the acquire methods:</p><div class="source"><pre class="prettyprint">public void acquire()
+Acquire the mutex - blocking until it's available. Note: the same thread can call acquire
+re-entrantly. Each call to acquire must be balanced by a call to release()
+</pre></div><div class="source"><pre class="prettyprint">public boolean acquire(long time,
+                       TimeUnit unit)
+Acquire the mutex - blocks until it's available or the given time expires. Note: the same thread can
+call acquire re-entrantly. Each call to acquire that returns true must be balanced by a call to release()
+
+Parameters:
+time - time to wait
+unit - time unit
+Returns:
+true if the mutex was acquired, false if not
+</pre></div><p>To release the mutex, call:</p><div class="source"><pre class="prettyprint">public void release()
+Perform one release of the mutex if the calling thread is the same thread that acquired it. If the
+thread had made multiple calls to acquire, the mutex will still be held when this method returns.
+</pre></div><p><b>NOTE:</b> A InterProcessMutex instance is reusable. i.e. don't create a new instance every time. Re-use a single instance.</p><div class="section"><h4>Revoking<a name="Revoking"></a></h4></div><p>InterProcessMutex supports a cooperative revocation mechanism as described on the ZooKeeper recipes wiki.</p><p>To make a mutex revocable, call:</p><div class="source"><pre class="prettyprint">public void makeRevocable(RevocationListener&lt;T&gt; listener)
+Make the lock revocable. Your listener will get called when another process/thread wants you to release the lock. Revocation is cooperative.
+Parameters:
+listener - the listener
+</pre></div><p>To ask for a lock to revoke/release, use the static method in the <tt>Revoker</tt> class:</p><div class="source"><pre class="prettyprint">public static void attemptRevoke(CuratorFramework client,
+                                 String path)
+                         throws Exception
+Utility to mark a lock for revocation. Assuming that the lock has been registered
+with a RevocationListener, it will get called and the lock should be released. Note,
+however, that revocation is cooperative.
+Parameters:
+client - the client
+path - the path of the lock - usually from something like InterProcessMutex.getParticipantNodes()
+</pre></div><div class="section"><h3>Error Handling<a name="Error_Handling"></a></h3></div><p>It is strongly recommended that you add a <tt>ConnectionStateListener</tt> and watch for SUSPENDED and LOST state changes. If a SUSPENDED state is reported you cannot be certain that you still hold the lock unless you subsequently receive a RECONNECTED state. If a LOST state is reported it is certain that you no longer hold the lock.</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/shared-reentrant-lock.html
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: incubator/curator/site/trunk/curator-recipes/shared-reentrant-lock.html
------------------------------------------------------------------------------
    svn:keywords = Date Revision Author HeadURL Id

Propchange: incubator/curator/site/trunk/curator-recipes/shared-reentrant-lock.html
------------------------------------------------------------------------------
    svn:mime-type = text/html

Added: incubator/curator/site/trunk/curator-recipes/shared-reentrant-read-write-lock.html
URL: http://svn.apache.org/viewvc/incubator/curator/site/trunk/curator-recipes/shared-reentrant-read-write-lock.html?rev=1459958&view=auto
==============================================================================
--- incubator/curator/site/trunk/curator-recipes/shared-reentrant-read-write-lock.html (added)
+++ incubator/curator/site/trunk/curator-recipes/shared-reentrant-read-write-lock.html Fri Mar 22 19:57:43 2013
@@ -0,0 +1,301 @@
+<!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>Shared Reentrant Read Write Lock<a name="Shared_Reentrant_Read_Write_Lock"></a></h2></div><div class="section"><h3>Description<a name="Description"></a></h3></div><p>A re-entrant read/write mutex that works across JVMs. Uses Zookeeper to hold the lock. All processes in all JVMs that use the same lock path will achieve an inter-process critical section. Further, this mutex is &quot;fair&quot; - each user will get the mutex in the order requested (from ZK's point of view).</p><p>A read write lock maintains a pair of associated locks, one for read-only operations and one for writing. The read lock may be held simultaneously by multiple reader processes, so long as there are no writers. The write lock is exclusive.</p><p><i>Reentrancy</i> This lock allows both readers and writers to reacquire read or write locks in the style of a re-entrant lock. Non-re-entrant readers are not allowed until all write locks held by the writing thread/process h
 ave been released. Additionally, a writer can acquire the read lock, but not vice-versa. If a reader tries to acquire the write lock it will never succeed.</p><p><i>Lock Downgrading</i> Re-entrancy also allows downgrading from the write lock to a read lock, by acquiring the write lock, then the read lock and then releasing the write lock. However, upgrading from a read lock to the write lock is not possible.</p><div class="section"><h3>Participating Classes<a name="Participating_Classes"></a></h3></div><ul><li>InterProcessReadWriteLock</li><li>InterProcessLock</li></ul><div class="section"><h3>Usage<a name="Usage"></a></h3></div><div class="section"><h4>Create an InterProcessReadWriteLock<a name="Create_an_InterProcessReadWriteLock"></a></h4></div><div class="source"><pre class="prettyprint">public InterProcessReadWriteLock(CuratorFramework client,
+                                 String basePath)
+Parameters:
+client - the client
+basePath - path to use for locking
+</pre></div><div class="section"><h4>General Usage<a name="General_Usage"></a></h4></div><p>Access either the read lock or the write lock and then use the methods as described for <a href="shared-lock.html">Shared lock</a>.</p><div class="source"><pre class="prettyprint">public InterProcessLock readLock()
+
+public InterProcessLock writeLock()
+</pre></div><div class="section"><h3>Error Handling<a name="Error_Handling"></a></h3></div><p>It is strongly recommended that you add a <tt>ConnectionStateListener</tt> and watch for SUSPENDED and LOST state changes. If a SUSPENDED state is reported you cannot be certain that you still hold the lock unless you subsequently receive a RECONNECTED state. If a LOST state is reported it is certain that you no longer hold the lock.</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/shared-reentrant-read-write-lock.html
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: incubator/curator/site/trunk/curator-recipes/shared-reentrant-read-write-lock.html
------------------------------------------------------------------------------
    svn:keywords = Date Revision Author HeadURL Id

Propchange: incubator/curator/site/trunk/curator-recipes/shared-reentrant-read-write-lock.html
------------------------------------------------------------------------------
    svn:mime-type = text/html

Added: incubator/curator/site/trunk/curator-recipes/shared-semaphore.html
URL: http://svn.apache.org/viewvc/incubator/curator/site/trunk/curator-recipes/shared-semaphore.html?rev=1459958&view=auto
==============================================================================
--- incubator/curator/site/trunk/curator-recipes/shared-semaphore.html (added)
+++ incubator/curator/site/trunk/curator-recipes/shared-semaphore.html Fri Mar 22 19:57:43 2013
@@ -0,0 +1,350 @@
+<!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>Shared Semaphore<a name="Shared_Semaphore"></a></h2></div><div class="section"><h3>Description<a name="Description"></a></h3></div><p>A counting semaphore that works across JVMs. All processes in all JVMs that use the same lock path will achieve an inter-process limited set of leases. Further, this semaphore is mostly &quot;fair&quot; - each user will get a lease in the order requested (from ZK's point of view).</p><p>There are two modes for determining the max leases for the semaphore. In the first mode the max leases is a convention maintained by the users of a given path. In the second mode a SharedCountReader is used as the method for semaphores of a given path to determine the max leases.</p><p>If a SharedCountReader is not used, no internal checks are done to prevent Process A acting as if there are 10 leases and Process B acting as if there are 20. Therefore, make sure that all instances in all processes use the same numberOfLeases
  value.</p><p>The various acquire methods return Lease objects that represent acquired leases. Clients must take care to close lease objects (ideally in a <tt>finally</tt> block) else the lease will be lost. However, if the client session drops (crash, etc.), any leases held by the client are automatically closed and made available to other clients.</p><div class="section"><h3>Participating Classes<a name="Participating_Classes"></a></h3></div><ul><li>InterProcessSemaphoreV2</li><li>Lease</li><li>SharedCountReader</li></ul><div class="section"><h3>Usage<a name="Usage"></a></h3></div><div class="section"><h4>Creating an InterProcessSemaphoreV2<a name="Creating_an_InterProcessSemaphoreV2"></a></h4></div><div class="source"><pre class="prettyprint">public InterProcessSemaphoreV2(CuratorFramework client,
+                             String path,
+                             int numberOfLeases)
+Parameters:
+client - client
+path - the path to lock
+numberOfLeases - the number of leases allowed by this semaphore
+</pre></div><div class="source"><pre class="prettyprint">public InterProcessSemaphoreV2(CuratorFramework client,
+                             String path,
+                             SharedCountReader count)
+Parameters:
+client - the client
+path - path for the semaphore
+count - the shared count to use for the max leases
+</pre></div><div class="section"><h3>General Usage<a name="General_Usage"></a></h3></div><p>To acquire one lease/usage, use one of the acquire methods:</p><div class="source"><pre class="prettyprint">public Lease acquire()
+
+Acquire a lease. If no leases are available, this method blocks until either the maximum number of
+leases is increased or another client/process closes a lease.
+The client must close the lease when it is done with it. You should do this in a finally block.
+Returns:
+the new lease
+</pre></div><div class="source"><pre class="prettyprint">public Collection&lt;Lease&gt; acquire(int qty)
+
+Acquire qty leases. If there are not enough leases available, this method blocks until either the
+maximum number of leases is increased enough or other clients/processes close enough leases.
+The client must close the leases when it is done with them. You should do this in a finally block.
+NOTE: You can use returnAll(Collection) for this.
+Parameters:
+qty - number of leases to acquire
+Returns:
+the new leases
+</pre></div><div class="source"><pre class="prettyprint">public Lease acquire(long time,
+                     TimeUnit unit)
+Acquire a lease. If no leases are available, this method blocks until either the maximum number of
+leases is increased or another client/process closes a lease. However, this method will only block
+to a maximum of the time parameters given.
+The client must close the lease when it is done with it. You should do this in a finally block.
+Parameters:
+time - time to wait
+unit - time unit
+Returns:
+the new lease or null if time ran out
+</pre></div><div class="source"><pre class="prettyprint">public Collection&lt;Lease&gt; acquire(int qty,
+                               long time,
+                               TimeUnit unit)
+Acquire qty leases. If there are not enough leases available, this method blocks until either the
+maximum number of leases is increased enough or other clients/processes close enough leases. However,
+this method will only block to a maximum of the time parameters given. If time expires before all
+leases are acquired, the subset of acquired leases are automatically closed.
+The client must close the leases when it is done with them. You should do this in a finally block.
+NOTE: You can use returnAll(Collection) for this.
+Parameters:
+qty - number of leases to acquire
+time - time to wait
+unit - time unit
+</pre></div><p><tt>Lease</tt> instances can either be closed directly or you can use these convenience methods:</p><div class="source"><pre class="prettyprint">public void returnAll(Collection&lt;Lease&gt; leases)
+public void returnLease(Lease lease)
+</pre></div><div class="section"><h3>Error Handling<a name="Error_Handling"></a></h3></div><p>It is strongly recommended that you add a <tt>ConnectionStateListener</tt> and watch for SUSPENDED and LOST state changes. If a SUSPENDED state is reported you cannot be certain that you still hold the lock unless you subsequently receive a RECONNECTED state. If a LOST state is reported it is certain that you no longer hold the lock.</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/shared-semaphore.html
------------------------------------------------------------------------------
    svn:eol-style = native

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

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

Added: incubator/curator/site/trunk/curator-recipes/simple-distributed-queue.html
URL: http://svn.apache.org/viewvc/incubator/curator/site/trunk/curator-recipes/simple-distributed-queue.html?rev=1459958&view=auto
==============================================================================
--- incubator/curator/site/trunk/curator-recipes/simple-distributed-queue.html (added)
+++ incubator/curator/site/trunk/curator-recipes/simple-distributed-queue.html Fri Mar 22 19:57:43 2013
@@ -0,0 +1,310 @@
+<!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>Simple Distributed Queue<a name="Simple_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>A drop-in replacement for the DistributedQueue that comes with the ZK distribution.</p><div class="section"><h3>Participating Classes<a name="Participating_Classes"></a></h3></div><ul><li>SimpleDistributedQueue</li></ul><div class="section"><h3>Usage<a name="Usage"></a></h3></div><p><b>Creating a SimpleDistributedQueue</b></p><div class="source"><pre class="prettyprint">public SimpleDistributedQueue(CuratorFramework client,
+                              String path)
+Parameters:
+client - the client
+path - path to store queue nodes
+</pre></div><p><b>Add to the queue</b></p><div class="source"><pre class="prettyprint">public boolean offer(byte[] data)
+             throws Exception
+Inserts data into queue.
+Parameters:
+data - the data
+Returns:
+true if data was successfully added
+</pre></div><p><b>Take from the queue</b></p><div class="source"><pre class="prettyprint">public byte[] take()
+           throws Exception
+Removes the head of the queue and returns it, blocks until it succeeds.
+Returns:
+The former head of the queue
+</pre></div><p>NOTE: see the Javadoc for additional methods</p><div class="section"><h3>Error Handling<a name="Error_Handling"></a></h3></div><p>It is strongly recommended that you add a <tt>ConnectionStateListener</tt> and watch for SUSPENDED and LOST state changes.</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/simple-distributed-queue.html
------------------------------------------------------------------------------
    svn:eol-style = native

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

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

Added: incubator/curator/site/trunk/curator-recipes/source-repository.html
URL: http://svn.apache.org/viewvc/incubator/curator/site/trunk/curator-recipes/source-repository.html?rev=1459958&view=auto
==============================================================================
--- incubator/curator/site/trunk/curator-recipes/source-repository.html (added)
+++ incubator/curator/site/trunk/curator-recipes/source-repository.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 - Source Repository</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>This project uses a Source Content Management System to manage its source code.</p></div><div class="section"><h2>Web Access<a name="Web_Access"></a></h2><a name="Web_Access"></a><p>The following is a link to the online source repository.</p><div class="source"><pre class="prettyprint"><a class="externalLink" href="https://git-wip-us.apache.org/repos/asf?p=curator.git/curator-recipes">https://git-wip-us.apache.org/repos/asf?p=curator.git/curator-recipes</a></pre></div></div><div class="section"><h2>Anonymous access<a name="Anonymous_access"></a></h2><a name="Anonymous_access"></a><p>Refer to the documentation of the SCM used for more information about anonymously check out. The connection url is:</p><div class="source"><pre class="prettyprint">git:https://git-wip-us.apache.org/repos/asf/curator.git/curator-recipes</pre></div></div><div class="section"><h2>Developer access<a nam
 e="Developer_access"></a></h2><a name="Developer_access"></a><p>Refer to the documentation of the SCM used for more information about developer check out. The connection url is:</p><div class="source"><pre class="prettyprint">git:https://git-wip-us.apache.org/repos/asf/curator.git/curator-recipes</pre></div></div><div class="section"><h2>Access from behind a firewall<a name="Access_from_behind_a_firewall"></a></h2><a name="Access_from_behind_a_firewall"></a><p>Refer to the documentation of the SCM used for more information about access behind a firewall.</p></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/source-repository.html
------------------------------------------------------------------------------
    svn:eol-style = native

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

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



Mime
View raw message