package net.pterodactylus.jsite.core;
+import java.io.IOException;
+import java.net.UnknownHostException;
import java.util.List;
+import net.pterodactylus.jsite.project.Project;
+
/**
* Interface for the core.
- *
+ *
* @author David ‘Bombe’ Roden <bombe@freenetproject.org>
- * @version $Id$
*/
public interface Core {
/**
* Adds the given listener to the list of registered listeners.
- *
+ *
* @param coreListener
* The listener to add
*/
/**
* Removes the given listener from the list of registered listeners.
- *
+ *
* @param coreListener
* The listener to remove
*/
public void removeCoreListener(CoreListener coreListener);
/**
+ * Adds the given node to the core.
+ *
+ * @param node
+ * The node to add
+ * @return <code>true</code> if the node was added, <code>false</code>
+ * 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<Node> getNodes();
/**
* Returns whether the core is currently connected to the given node.
- *
+ *
* @param node
* The node to check
* @return <code>true</code> if the core is currently connected to the
/**
* Connects to the given node.
- *
+ *
* @param node
* The node to connect to
*/
public void connectToNode(Node node);
-}
\ No newline at end of file
+ /**
+ * 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<Project> getProjects();
+
+}