[rhmessaging-commits] rhmessaging commits: r4125 - store/trunk/java/bdbstore/src/test/java/org/apache/qpid/server/store/berkeleydb.

[rhmessaging-commits at lists.jboss.org]

Author: rgemmell
Date: 2010-07-19 05:13:48 -0400 (Mon, 19 Jul 2010)
New Revision: 4125

Modified:
   store/trunk/java/bdbstore/src/test/java/org/apache/qpid/server/store/berkeleydb/BDBStoreUpgradeTestPreparer.java
Log:
Add overlooked descriptive Javadoc


Modified: store/trunk/java/bdbstore/src/test/java/org/apache/qpid/server/store/berkeleydb/BDBStoreUpgradeTestPreparer.java
===================================================================
--- store/trunk/java/bdbstore/src/test/java/org/apache/qpid/server/store/berkeleydb/BDBStoreUpgradeTestPreparer.java	2010-07-16 15:25:26 UTC (rev 4124)
+++ store/trunk/java/bdbstore/src/test/java/org/apache/qpid/server/store/berkeleydb/BDBStoreUpgradeTestPreparer.java	2010-07-19 09:13:48 UTC (rev 4125)
@@ -83,7 +83,17 @@
     }
 
     /**
-     * TODO: description
+     * Prepare a queue for use in testing message and binding recovery
+     * after the upgrade is performed.
+     * 
+     * - Create a transacted session on the connection.
+     * - Use a consumer to create the (durable by default) queue.
+     * - Send 5 large messages to test (multi-frame) content recovery.
+     * - Send 1 small message to test (single-frame) content recovery.
+     * - Commit the session.
+     * - Send 5 small messages to test that uncommitted messages are not recovered.
+     *   following the upgrade.
+     * - Close the session.  
      */
     private void prepareQueues() throws Exception
     {
@@ -123,7 +133,15 @@
     }
 
     /**
-     * TODO: description
+     * Prepare a DurableSubscription backing queue for use in testing selector 
+     * recovery and queue exclusivity marking during the upgrade process.
+     * 
+     * - Create a transacted session on the connection.
+     * - Open and close a DurableSubscription with selector to create the backing queue.
+     * - Send a message which matches the selector.
+     * - Send a message which does not match the selector.
+     * - Send a message which matches the selector but will remain uncommitted.
+     * - Close the session.
      */
     private void prepareDurableSubscription() throws Exception
     {