X-Git-Url: https://git.pterodactylus.net/?a=blobdiff_plain;f=src%2Fnet%2Fpterodactylus%2Fjsite%2Fcore%2FCore.java;h=53cd6b7b0ef8959de6560f5611e86b34f0ca6e1f;hb=6bb73948c60f63571115c6556f6b90293fd99432;hp=c2072cbd7eb547d175ae9f1991d6fa5efbae8bd8;hpb=66abf632954a83c789b423229781bc2c94ffde67;p=jSite2.git diff --git a/src/net/pterodactylus/jsite/core/Core.java b/src/net/pterodactylus/jsite/core/Core.java index c2072cb..53cd6b7 100644 --- a/src/net/pterodactylus/jsite/core/Core.java +++ b/src/net/pterodactylus/jsite/core/Core.java @@ -19,108 +19,137 @@ 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; /** - * 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 configuredNodes = new ArrayList(); - - /** List of currently connected nodes. */ - private List connectedNodes = new ArrayList(); - - /** - * Creates a new core. - */ - public Core() { - } - - // - // LISTENER MANAGEMENT - // +public interface Core { /** * Adds the given listener to the list of registered listeners. - * + * * @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. - * + * * @param coreListener * The listener to remove */ - public void removeCoreListener(CoreListener coreListener) { - coreListeners.remove(coreListener); - } + public void removeCoreListener(CoreListener coreListener); + + /** + * Returns a thread pool. + * + * @return A thread pool + */ + public Executor getThreadPool(); /** - * 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 getNodes() { - return configuredNodes; - } + public List getNodes(); /** * 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 + * @return true if the core is currently connected to the node, + * false otherwise */ - public boolean isNodeConnected(Node node) { - return connectedNodes.contains(node); - } - - // - // ACTIONS - // + 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. - * + * * @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(); }