X-Git-Url: https://git.pterodactylus.net/?a=blobdiff_plain;f=src%2Fnet%2Fpterodactylus%2Fjsite%2Fcore%2FCore.java;h=c72314f47ed428512c3f20d8e61274e8a260d7f7;hb=e1e349bae97feb779fc692eb03c2fea0e0e612c9;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..c72314f 100644 --- a/src/net/pterodactylus/jsite/core/Core.java +++ b/src/net/pterodactylus/jsite/core/Core.java @@ -19,32 +19,19 @@ package net.pterodactylus.jsite.core; -import java.util.ArrayList; +import java.io.IOException; +import java.net.UnknownHostException; import java.util.List; +import java.util.concurrent.Executor; + +import net.pterodactylus.jsite.core.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 +39,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 +47,61 @@ 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. + * Returns a thread pool. + * + * @return A thread pool */ - private void fireCoreLoaded() { - for (CoreListener coreListener: coreListeners) { - coreListener.coreLoaded(); - } - } + public Executor getThreadPool(); - // - // ACCESSORS - // + /** + * 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 + */ + public boolean addNode(Node node) throws UnknownHostException; + + /** + * 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 +109,49 @@ 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. + * + * @throws IOException + * if an I/O error occured communicating with the node + * @throws JSiteException + * if there is a problem with the node + */ + public void createProject() throws IOException, JSiteException; + + /** + * Clones the given project. {@link CoreListener}s will be notified of the + * new clone via the {@link CoreListener#projectCloned(Project, Project)} + * event. + * + * @param project + * The project to clone + */ + public void cloneProject(Project project); + + /** + * Removes the given project. + * + * @param project + * The project to remove + */ + public void removeProject(Project project); + + /** + * Returns a list of all projects. + * + * @return A list of all projects + */ + public List getProjects(); }