X-Git-Url: https://git.pterodactylus.net/?a=blobdiff_plain;f=src%2Fnet%2Fpterodactylus%2Fjsite%2Fcore%2FCore.java;h=4909b4d889e7ba5757e2b1c79cdec6185c0c5fa6;hb=cf127faffabd3f07b0acc6de9ea746059d571b56;hp=3f0067868b286c0b15ef64a2ef19508229ebe108;hpb=b735dd79e051542c424419474798a006039b2cfc;p=jSite2.git diff --git a/src/net/pterodactylus/jsite/core/Core.java b/src/net/pterodactylus/jsite/core/Core.java index 3f00678..4909b4d 100644 --- a/src/net/pterodactylus/jsite/core/Core.java +++ b/src/net/pterodactylus/jsite/core/Core.java @@ -19,32 +19,18 @@ package net.pterodactylus.jsite.core; -import java.util.ArrayList; +import java.io.IOException; +import java.net.UnknownHostException; import java.util.List; +import net.pterodactylus.jsite.project.Project; + /** - * The core of jSite. + * Interface for the core. * * @author David ‘Bombe’ Roden <bombe@freenetproject.org> - * @version $Id$ */ -public class Core { - - /** The core listeners. */ - private final List coreListeners = new ArrayList(); - - /** The node list. */ - private List nodeList = new ArrayList(); - - /** - * Creates a new core. - */ - public Core() { - } - - // - // LISTENER MANAGEMENT - // +public interface Core { /** * Adds the given listener to the list of registered listeners. @@ -52,9 +38,7 @@ public class Core { * @param coreListener * The listener to add */ - public void addCoreListener(CoreListener coreListener) { - coreListeners.add(coreListener); - } + public void addCoreListener(CoreListener coreListener); /** * Removes the given listener from the list of registered listeners. @@ -62,42 +46,54 @@ public class Core { * @param coreListener * The listener to remove */ - public void removeCoreListener(CoreListener coreListener) { - coreListeners.remove(coreListener); - } + public void removeCoreListener(CoreListener coreListener); /** - * Notifies all core listeners that the core has loaded and is ready to run. + * Adds the given node to the core. + * + * @param node + * The node to add + * @return true if the node was added, false + * if it was not added because it was already known + * @throws UnknownHostException + * if the hostname of the node can not be resolved */ - private void fireCoreLoaded() { - for (CoreListener coreListener: coreListeners) { - coreListener.coreLoaded(); - } - } + public boolean addNode(Node node) throws UnknownHostException; - // - // ACCESSORS - // + /** + * Removes the given node from the core. + * + * @param node + * The node to remove + */ + public void removeNode(Node node); /** * Returns the list of all configured nodes. * * @return All configured nodes */ - public List getNodeList() { - return nodeList; - } + public List getNodes(); - // - // ACTIONS - // + /** + * Returns whether the core is currently connected to the given node. + * + * @param node + * The node to check + * @return true if the core is currently connected to the + * node, false otherwise + */ + public boolean isNodeConnected(Node node); /** * Starts the core. */ - public void start() { - fireCoreLoaded(); - } + public void start(); + + /** + * Stops the core. + */ + public void stop(); /** * Connects to the given node. @@ -105,7 +101,33 @@ public class Core { * @param node * The node to connect to */ - public void connectToNode(Node node) { - } + public void connectToNode(Node node); + + /** + * Disconnects from the given node. + * + * @param node + * The node to disconnect from + */ + public void disconnectFromNode(Node node); + + /** + * Creates a new project. The returned {@link Project} will contain a newly + * generated key pair. + * + * @return A newly created project + * @throws IOException + * if an I/O error occured communicating with the node + * @throws JSiteException + * if there is a problem with the node + */ + public Project createProject() throws IOException, JSiteException; + + /** + * Returns a list of all projects. + * + * @return A list of all projects + */ + public List getProjects(); }