Refactoring; Some comments added

AnalysisRunner/src/main/java/kieker/analysisRunner/common/DisplayUpdateThread.java → AnalysisRunner/src/main/java/kieker/webgui/analysisRunner/common/DisplayUpdateThread.java

-package kieker.analysisRunner.common;
+package kieker.webgui.analysisRunner.common;
 
 import java.lang.reflect.InvocationTargetException;
 import java.lang.reflect.Method;

AnalysisRunner/src/main/java/kieker/analysisRunner/connector/Connector.java → AnalysisRunner/src/main/java/kieker/webgui/analysisRunner/connector/Connector.java

-package kieker.analysisRunner.connector;
+package kieker.webgui.analysisRunner.connector;
 
 import java.io.File;
 import java.io.IOException;
@@ -12,9 +12,9 @@ import kieker.analysis.AnalysisController.STATE;
 import kieker.analysis.AnalysisControllerThread;
 import kieker.analysis.exception.AnalysisConfigurationException;
 import kieker.analysis.model.analysisMetaModel.MIProject;
-import kieker.analysisRunner.common.DisplayUpdateThread;
 import kieker.common.logging.Log;
 import kieker.common.logging.LogFactory;
+import kieker.webgui.analysisRunner.common.DisplayUpdateThread;
 
 public class Connector extends UnicastRemoteObject implements IConnector {
 
@@ -25,23 +25,38 @@ public class Connector extends UnicastRemoteObject implements IConnector {
 	private AnalysisControllerThread analysisThread = null;
 	private DisplayUpdateThread displayUpdateThread = null;
 
+	/**
+	 * Creates a new instance of this class.
+	 * 
+	 * @throws RemoteException
+	 *             If something went wrong.
+	 */
 	public Connector() throws RemoteException {
 		super();
 	}
-	
+
+	/**
+	 * {@inheritDoc}
+	 */
 	public void setKaxFile(final File file) throws RemoteException {
 		synchronized (this) {
 			this.kaxFile = file;
 		}
 	}
 
+	/**
+	 * {@inheritDoc}
+	 */
 	public void init() throws RemoteException {
 		synchronized (this) {
 			try {
+				this.stop();
 				final MIProject project = AnalysisController.loadFromFile(this.kaxFile);
 				this.analysisController = AnalysisController.createAnalysisController(project, Thread.currentThread().getContextClassLoader());
 				this.analysisThread = new AnalysisControllerThread(this.analysisController.getController());
 				this.displayUpdateThread = new DisplayUpdateThread(this.analysisController.getPluginMap(), project);
+
+				Connector.LOG.info("Analysis initialized.");
 			} catch (final NullPointerException ex) {
 				Connector.LOG.error("Invalid Project", ex);
 				System.exit(1);
@@ -55,13 +70,21 @@ public class Connector extends UnicastRemoteObject implements IConnector {
 		}
 	}
 
+	/**
+	 * {@inheritDoc}
+	 */
 	public void start() throws RemoteException {
 		synchronized (this) {
 			this.analysisThread.start();
 			this.displayUpdateThread.start();
+
+			Connector.LOG.info("Analysis started.");
 		}
 	}
 
+	/**
+	 * {@inheritDoc}
+	 */
 	public void stop() throws RemoteException {
 		synchronized (this) {
 			try {
@@ -77,24 +100,35 @@ public class Connector extends UnicastRemoteObject implements IConnector {
 
 				this.analysisThread = null;
 				this.displayUpdateThread = null;
+
+				Connector.LOG.info("Analysis stopped.");
 			} catch (final InterruptedException ex) {
 				// Ignore exception
 			}
 		}
 	}
 
+	/**
+	 * {@inheritDoc}
+	 */
 	public Serializable getDisplay(final String viewName, final String displayConnectorName) throws RemoteException {
 		synchronized (this) {
 			return (Serializable) this.displayUpdateThread.getDisplay(viewName, displayConnectorName);
 		}
 	}
 
-	public STATE getState() {
+	/**
+	 * {@inheritDoc}
+	 */
+	public STATE getState() throws RemoteException {
 		synchronized (this) {
 			return this.analysisController.getController().getState();
 		}
 	}
 
+	/**
+	 * {@inheritDoc}
+	 */
 	public void terminateProgram() throws RemoteException {
 		synchronized (this) {
 			this.stop();

AnalysisRunner/src/main/java/kieker/analysisRunner/connector/IConnector.java → AnalysisRunner/src/main/java/kieker/webgui/analysisRunner/connector/IConnector.java

-package kieker.analysisRunner.connector;
+package kieker.webgui.analysisRunner.connector;
 
 import java.io.File;
 import java.io.Serializable;
@@ -7,18 +7,56 @@ import java.rmi.RemoteException;
 
 import kieker.analysis.AnalysisController;
 
+/**
+ * This interface is a remote interface to communicate with this application via RMI.
+ * 
+ * @author Nils Christian Ehmke
+ * @version 1.0
+ */
 public interface IConnector extends Remote {
 
 	public void setKaxFile(final File file) throws RemoteException;
 
+	/**
+	 * This method initializes the configured analysis. It is assumed that the {@link #setKaxFile(File)}-method has already been called. If an analysis instance is
+	 * running, it will be terminated.
+	 * 
+	 * @throws RemoteException
+	 *             If something went wrong.
+	 */
 	public void init() throws RemoteException;
 
+	/**
+	 * This method starts the already initializes analysis. It is assumed that the {@link #init()}-method has already been called.
+	 * 
+	 * @throws RemoteException
+	 *             If something went wrong.
+	 */
 	public void start() throws RemoteException;
 
+	/**
+	 * This method stops the currently running analysis. If no analysis is running, this method does nothing.
+	 * 
+	 * @throws RemoteException
+	 *             If something went wrong.
+	 */
 	public void stop() throws RemoteException;
 
+	/**
+	 * This method stops the (potential) currently running analysis and terminates the program.
+	 * 
+	 * @throws RemoteException
+	 *             If something went wrong.
+	 */
 	public void terminateProgram() throws RemoteException;
 
+	/**
+	 * This method delivers the current state of the analysis. It is assumed that the analysis has already been initialized.
+	 * 
+	 * @return The state of the analysis.
+	 * @throws RemoteException
+	 *             If something went wrong.
+	 */
 	public AnalysisController.STATE getState() throws RemoteException;
 
 	public Serializable getDisplay(final String viewName, final String displayConnectorName) throws RemoteException;

AnalysisRunner/src/main/java/kieker/analysisRunner/main/Main.java → AnalysisRunner/src/main/java/kieker/webgui/analysisRunner/main/Main.java

-package kieker.analysisRunner.main;
+package kieker.webgui.analysisRunner.main;
 
 import java.rmi.RemoteException;
 import java.rmi.registry.LocateRegistry;
 import java.rmi.registry.Registry;
 
-import kieker.analysisRunner.connector.Connector;
 import kieker.common.logging.Log;
 import kieker.common.logging.LogFactory;
+import kieker.webgui.analysisRunner.connector.Connector;
 
 public class Main {
 
 	private static final Log LOG = LogFactory.getLog(Main.class);
 
+	/**
+	 * This is the application's main method. It binds the instance of the class {@link Connector} to the given name.
+	 * 
+	 * @param args
+	 *            The command line arguments. The first element will be used as a name to (re)bind the instance of {@link Connector}. This first parameter
+	 *            <b>must</b> be provided.
+	 */
 	public static void main(final String[] args) {
 		try {
-			final Registry registry = LocateRegistry.createRegistry(1099);
+			final Registry registry = LocateRegistry.getRegistry();
 			registry.rebind(args[0], new Connector());
 
 			Main.LOG.info("Connection established.");