X-Git-Url: https://git.pterodactylus.net/?a=blobdiff_plain;f=src%2Fde%2Ftodesbaum%2Fjsite%2Fapplication%2FInsertListener.java;h=13710617bd568d46a38d20af7ad04f83fffd62db;hb=bb52f8a8424a1fb38c99875dc17b39648b2d5d8b;hp=0966e1047c5096f7de378d4929cf109176969009;hpb=6f1a8216cfba28add0ef365b46a08d16d4eb87fe;p=jSite.git

diff --git a/src/de/todesbaum/jsite/application/InsertListener.java b/src/de/todesbaum/jsite/application/InsertListener.java
index 0966e10..1371061 100644
--- a/src/de/todesbaum/jsite/application/InsertListener.java
+++ b/src/de/todesbaum/jsite/application/InsertListener.java
@@ -22,19 +22,83 @@ package de.todesbaum.jsite.application;
 import java.util.EventListener;
 
 /**
- * @author David Roden <droden@gmail.com>
- * @version $Id: InsertListener.java 397 2006-03-25 16:11:34Z bombe $
+ * Interface for objects that want to be notified abount insert events.
+ * 
+ * @author David ‘Bombe’ Roden <bombe@freenetproject.org>
  */
 public interface InsertListener extends EventListener {
 
+	/**
+	 * Enumeration for the different error situations.
+	 * 
+	 * @author David ‘Bombe’ Roden <bombe@freenetproject.org>
+	 */
 	public static enum ErrorType {
-		KEY_COLLISION, ROUTE_NOT_FOUND, DATA_NOT_FOUND, FCP_ERROR, IO_ERROR
+
+		/** The key does already exist. */
+		KEY_COLLISION,
+
+		/** The route to the key was not found. */
+		ROUTE_NOT_FOUND,
+
+		/** The data was not found. */
+		DATA_NOT_FOUND,
+
+		/** Error in the FCP communication. */
+		FCP_ERROR,
+
+		/** General error in the communication. */
+		IO_ERROR
 	}
 
+	/**
+	 * Notifies a listener that an insert has started.
+	 * 
+	 * @param project
+	 *            The project that is now being inserted
+	 */
 	public void projectInsertStarted(Project project);
 
+	/**
+	 * Notifies a listener that a project insert has generated a URI.
+	 * 
+	 * @param project
+	 *            The project being inserted
+	 * @param uri
+	 *            The generated URI
+	 */
+	public void projectURIGenerated(Project project, String uri);
+
+	/**
+	 * Notifies a listener that an insert has made some progress.
+	 * 
+	 * @param project
+	 *            The project being inserted
+	 * @param succeeded
+	 *            The number of succeeded blocks
+	 * @param failed
+	 *            The number of failed blocks
+	 * @param fatal
+	 *            The number of fatally failed blocks
+	 * @param total
+	 *            The total number of blocks
+	 * @param finalized
+	 *            <code>true</code> if the total number of blocks has been
+	 *            finalized, <code>false</code> otherwise
+	 */
 	public void projectInsertProgress(Project project, int succeeded, int failed, int fatal, int total, boolean finalized);
 
+	/**
+	 * Notifies a listener that a project insert has finished.
+	 * 
+	 * @param project
+	 *            The project being inserted
+	 * @param success
+	 *            <code>true</code> if the insert succeeded,
+	 *            <code>false</code> otherwise
+	 * @param cause
+	 *            The cause of a failure, if any (may be <code>null</code>)
+	 */
 	public void projectInsertFinished(Project project, boolean success, Throwable cause);
 
 }