X-Git-Url: https://git.pterodactylus.net/?a=blobdiff_plain;f=src%2Fnet%2Fpterodactylus%2Fjsite%2Fcore%2FCoreListener.java;h=4da2ec84476dc4104a21e318fa530505f0e881ed;hb=c63257e8cc0ba1a5aca9364b22171abe7279d479;hp=fb109d7696c7425cb2b3997605a3d10930b140b1;hpb=ebd531bc775036dd66a7e20abebbcb480af35491;p=jSite2.git diff --git a/src/net/pterodactylus/jsite/core/CoreListener.java b/src/net/pterodactylus/jsite/core/CoreListener.java index fb109d7..4da2ec8 100644 --- a/src/net/pterodactylus/jsite/core/CoreListener.java +++ b/src/net/pterodactylus/jsite/core/CoreListener.java @@ -21,9 +21,8 @@ package net.pterodactylus.jsite.core; /** * Interface definition for user interfaces. - * + * * @author David ‘Bombe’ Roden <bombe@freenetproject.org> - * @version $Id$ */ public interface CoreListener { @@ -33,7 +32,7 @@ public interface CoreListener { /** * Notifies a listener that loading the projects finished successfully. - * + * * @param directory * The directory the nodes were loaded from */ @@ -41,7 +40,7 @@ public interface CoreListener { /** * Notifies all listeners that loading the projects has failed. - * + * * @param directory * The directory the projects were tried to load from * @param throwable @@ -52,7 +51,7 @@ public interface CoreListener { /** * Notifies a listener that the projects were successfully saved to the * given directory. - * + * * @param directory * The directory the projects were saved to */ @@ -60,7 +59,7 @@ public interface CoreListener { /** * Notifies a listener that saving the projects has failed. - * + * * @param directory * The directory the projects were to be saved to * @param throwable @@ -68,13 +67,39 @@ public interface CoreListener { */ public void savingProjectsFailed(String directory, Throwable throwable); + /** + * Notifies a listener that the given project was added. + * + * @param project + * The project that was added. + */ + public void projectAdded(Project project); + + /** + * Notifies a listener that a project was cloned. + * + * @param clonedProject + * The clones project + * @param projectClone + * The clone of the project + */ + public void projectCloned(Project clonedProject, Project projectClone); + + /** + * Notifies a listener that the given project was removed. + * + * @param project + * The project that was removed. + */ + public void projectRemoved(Project project); + // // node configuration // /** * Notifies a listener that the nodes were successfully loaded. - * + * * @param directory * The directory the nodes were loaded from */ @@ -82,7 +107,7 @@ public interface CoreListener { /** * Notifies a listener that loading the nodes has failed. - * + * * @param directory * The directory the nodes were loaded from * @param throwable @@ -92,7 +117,7 @@ public interface CoreListener { /** * Notifies a listener that the nodes were successfully saved. - * + * * @param directory * The directory the nodes were saved to */ @@ -100,7 +125,7 @@ public interface CoreListener { /** * Notifies a listener that saving the nodes has failed. - * + * * @param directory * The directory the nodes were saved to * @param throwable @@ -128,7 +153,7 @@ public interface CoreListener { /** * Notifies a listener that a node was added to the core. - * + * * @param node * The node that was added. */ @@ -138,7 +163,7 @@ public interface CoreListener { * Notifies a listener that a node was removed from the core. Before a node * is removed, it will be disconnected (and * {@link #nodeDisconnected(Node, Throwable)} will be called). - * + * * @param node * The node that was removed */ @@ -148,7 +173,7 @@ public interface CoreListener { * Notifies all listeners that the core started connecting to the given * node. Before a node is connected, it will be added (and * {@link #nodeAdded(Node)} will be called). - * + * * @param node * The node that is being connected */ @@ -156,15 +181,25 @@ public interface CoreListener { /** * Notifies all listeners that the core connected to the given node. - * + * * @param node * The node that is connected */ public void nodeConnected(Node node); /** + * Notifies a listener that a connection to a node has failed. + * + * @param node + * The node that could not be connected + * @param cause + * The cause of the failure + */ + public void nodeConnectionFailed(Node node, Throwable cause); + + /** * Notifies all listeners that the core disconnected from the given node. - * + * * @param node * The node that was diconnected * @param throwable @@ -174,38 +209,58 @@ public interface CoreListener { public void nodeDisconnected(Node node, Throwable throwable); // - // request stuff + // project insertion stuff // /** - * Notifies a listener that a request was added to a node. - * - * @param node - * The node the request was added to - * @param request - * The request that was added + * Notifies a listener that a project insert started. + * + * @param project + * The project that is now inserting */ - public void requestAdded(Node node, Request request); + public void projectInsertStarted(Project project); /** - * Notifies a listener that a request made some progress. - * - * @param request - * The request that made the progress + * Notifies a listener that a project insert made progress. + * + * @param project + * The project that made progress * @param totalBlocks - * The total number of blocks + * The number of total blocks * @param requiredBlocks * The number of required blocks * @param successfulBlocks - * The number of successful blocks + * The number of successfully inserted blocks * @param failedBlocks - * The number of failed blocks + * The number of blocks that could not be inserted * @param fatallyFailedBlocks - * The number of fatally failed blocks + * The number of blocks that can not be inserted even with + * retries * @param finalizedTotal - * true if the number of total blocks is - * finalized, false if it is not + * true if the number of total blocks is already + * finalized, false otherwise + */ + public void projectInsertProgressed(Project project, int totalBlocks, int requiredBlocks, int successfulBlocks, int failedBlocks, int fatallyFailedBlocks, boolean finalizedTotal); + + /** + * Notifies a listener that a project insert has generated a URI. + * + * @param project + * The project that generated a URI + * @param uri + * The URI that was generated + */ + public void projectInsertGeneratedURI(Project project, String uri); + + /** + * Notifies a listener that a project insert has finished. + * + * @param project + * The project that has finished + * @param success + * true if the project was inserted successfully, + * false otherwise */ - public void requestProgressed(Request request, int totalBlocks, int requiredBlocks, int successfulBlocks, int failedBlocks, int fatallyFailedBlocks, boolean finalizedTotal); + public void projectInsertFinished(Project project, boolean success); }