Author: toad
Date: 2009-01-28 17:13:35 +0000 (Wed, 28 Jan 2009)
New Revision: 25349

Modified:
   branches/db4o/freenet/src/freenet/client/async/SimpleManifestPutter.java
Log:
Javadocs


Modified: 
branches/db4o/freenet/src/freenet/client/async/SimpleManifestPutter.java
===================================================================
--- branches/db4o/freenet/src/freenet/client/async/SimpleManifestPutter.java    
2009-01-28 17:07:23 UTC (rev 25348)
+++ branches/db4o/freenet/src/freenet/client/async/SimpleManifestPutter.java    
2009-01-28 17:13:35 UTC (rev 25349)
@@ -463,6 +463,14 @@
                
        };
        
+       /**
+        * Called when we have metadata for all the PutHandler's.
+        * This does *not* necessarily mean we can immediately insert the final 
metadata, since
+        * if these metadata's are too big, they will need to be inserted 
separately. See
+        * resolveAndStartBase().
+        * @param container
+        * @param context
+        */
        private void gotAllMetadata(ObjectContainer container, ClientContext 
context) {
                // This can be huge! Run it on its own transaction to minimize 
the build up of stuff to commit
                // and maximise the opportunities for garbage collection.
@@ -474,6 +482,11 @@
                }
        }
        
+       /**
+        * Generate the global metadata, and then call resolveAndStartBase.
+        * @param container
+        * @param context
+        */
        private void innerGotAllMetadata(ObjectContainer container, 
ClientContext context) {
                if(persistent()) {
                        container.activate(putHandlersByName, 2);
@@ -508,6 +521,14 @@
                
        }
        
+       /**
+        * Attempt to insert the base metadata and the container. If the base 
metadata cannot be resolved,
+        * try to resolve it: start inserts for each part that cannot be 
resolved, and wait for them to generate
+        * URIs that can be incorporated into the metadata. This method will 
then be called again, and will 
+        * complete.
+        * @param container
+        * @param context
+        */
        private void resolveAndStartBase(ObjectContainer container, 
ClientContext context) {
                Bucket bucket = null;
                synchronized(this) {

_______________________________________________
cvs mailing list
[email protected]
http://emu.freenetproject.org/cgi-bin/mailman/listinfo/cvs

Reply via email to