package net.pterodactylus.jsite.core;
+import net.pterodactylus.jsite.project.Project;
+
/**
* Interface definition for user interfaces.
*
//
/**
+ * Notifies a listener that a node was added to the core.
+ *
+ * @param node
+ * The node that was added.
+ */
+ public void nodeAdded(Node node);
+
+ /**
+ * 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
+ */
+ public void nodeRemoved(Node node);
+
+ /**
* Notifies all listeners that the core started connecting to the given
- * node.
+ * 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
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
public void nodeDisconnected(Node node, Throwable throwable);
//
- // request stuff
+ // project insertion stuff
//
/**
- * Notifies a listener that a request was added to a node.
+ * Notifies a listener that a project insert started.
*
- * @param node
- * The node the request was added to
- * @param request
- * The request that was added
+ * @param project
+ * The project that is now inserting
+ */
+ public void projectInsertStarted(Project project);
+
+ /**
+ * Notifies a listener that a project insert made progress.
+ *
+ * @param project
+ * The project that made progress
+ * @param totalBlocks
+ * The number of total blocks
+ * @param requiredBlocks
+ * The number of required blocks
+ * @param successfulBlocks
+ * The number of successfully inserted blocks
+ * @param failedBlocks
+ * The number of blocks that could not be inserted
+ * @param fatallyFailedBlocks
+ * The number of blocks that can not be inserted even with
+ * retries
+ * @param finalizedTotal
+ * <code>true</code> if the number of total blocks is already
+ * finalized, <code>false</code> 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
+ * <code>true</code> if the project was inserted successfully,
+ * <code>false</code> otherwise
*/
- public void requestAdded(Node node, Request request);
+ public void projectInsertFinished(Project project, boolean success);
}