X-Git-Url: https://git.mxchange.org/?a=blobdiff_plain;f=Addressbook%2Fsrc%2Forg%2Fmxchange%2Faddressbook%2Fapplication%2FAddressbookApplication.java;h=ea26bc1ec1bbe7117f389c6c3a2a0fcd9254202d;hb=fed8835173cbf96fceec08639f4a20d890fec23c;hp=788c940ed3c41eb082ab699fcda3f03383381a24;hpb=00c8762778cdc63923406bb356f3c922326a8030;p=jaddressbook-lib.git

diff --git a/Addressbook/src/org/mxchange/addressbook/application/AddressbookApplication.java b/Addressbook/src/org/mxchange/addressbook/application/AddressbookApplication.java
index 788c940e..ea26bc1e 100644
--- a/Addressbook/src/org/mxchange/addressbook/application/AddressbookApplication.java
+++ b/Addressbook/src/org/mxchange/addressbook/application/AddressbookApplication.java
@@ -1,327 +1,376 @@
-/*
- * Copyright (C) 2015 Roland Haeder
- *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program.  If not, see <http://www.gnu.org/licenses/>.
- */
-package org.mxchange.addressbook.application;
-
-import java.text.MessageFormat;
-import org.mxchange.addressbook.BaseFrameworkSystem;
-import org.mxchange.addressbook.UnhandledUserChoiceException;
-import org.mxchange.addressbook.client.Client;
-import org.mxchange.addressbook.client.console.ConsoleClient;
-import org.mxchange.addressbook.client.gui.SwingClient;
-import org.mxchange.addressbook.manager.application.ApplicationManager;
-
-/**
- * ============================================
- * AddressbookApplication management:
- * ============================================
- * 
- * Inernet("public" service) and Intranet
- * 
- * Version 1.0+:
- * - Single-user local application
- * - Fields:
- *   + Gender
- *   + Surname
- *   + Family name
- *   + Company name
- *   + Street + number
- *   + ZIP code
- *   + City
- *   + Landline number
- *   + Fax number
- *   + Cell phone number
- *   + Email address
- *   + Birth day
- *   + Comment (?)
- * - Edit own data
- * - Add new contact
- * - Edit contacts
- * - Delete contacts
- * - Categorization of contacts
- * 
- * Version 1.1+:
- * - Permanent storage in database
- * 
- * Version 2.0+:
- * - Multi-user web application
- * - Local user registration / login / resend confirmation link / password
- *   recovery
- * - User groups (aka. teams)
- * - Administration area (user role)
- *   + Create/edit/delete groups
- *   + Edit/delete/lock/unlock user
- *   + Assign user roles/rights
- * - Allow other users / groups to view addressbook
- *   + Full addressbook
- *   + Only some categories
- * - VCard export
- *   + Allow users/guests (not recommended)
- * - XML export of addressbook and compressable (ZIP)
- * - Form to contact other user/group without need of mail program
- *   + User can disabled this
- * - Directory for ussers/groups (who allowed to be listed)
- *   + Simple click to add user to own addressbook
- *   + Search form?
- * 
- * Version 2.1+:
- * - Multi-language support
- * 
- * Version 2.2+:("socialized")
- * - "Social login" (OpenID consumer)
- *   + Connect user account to social account
- *   + Sync own data?
- * - "Social profile"
- *   + OpenID provider
- *   + RSS/activity feed 
- * 
- * ============================================
- * Time esitmation:
- * ============================================
- * 1.0 (console):
- *   + 2 days
- * 
- * 1.1 (database):
- *   + 2 day
- *   + Initial tables: contacts, categories, contact_category
- * 
- * 2.0 (web):
- *   + 3 days
- *   + Additional tables: admins (?), admin_rights, groups,
- *    users, user_contacts, user_user_rights, user_category_rights, 
- * 
- * 2.1 (language)
- *   + 1 day
- *   + Additional tables: languages (disable, enable language "pack" ?)
- * 
- * 2.2 (social):
- *   + 3 days
- *   + Additional tables: ???
- * 
- * @author Roland Haeder
- * @version 0.0
- * @since 0.0
- */
-public class AddressbookApplication extends BaseFrameworkSystem implements Application {
-    /**
-     * Application title
-     */
-    public static final String APP_TITLE = "Adressbuch";
-
-    /**
-     * Application version
-     */
-    public static final String APP_VERSION = "0.0";
-
-    /**
-     * Console client is enabled by default
-     */
-    private boolean consoleClient = true;
-
-    /**
-     * GUI client is disabled by default
-     */
-    private boolean guiClient = false;
-
-    /**
-     * Getter for printable application name
-     * 
-     * @return A printable name
-     */
-    public static String printableTitle () {
-	return MessageFormat.format("{0} v{1}", APP_TITLE, APP_VERSION);
-    }
-
-    /**
-     * Bootstraps application
-     */
-    @Override
-    public void doBootstrap () {
-	this.getLogger().debug("Initializing application ...");
-
-	// Init client variable
-	Client client = null;
-
-	// Is console or Swing choosen?
-	if (this.isConsole()) {
-	    // Debug message
-	    this.getLogger().debug("Initializing console client ...");
-
-	    // Init console client instance
-	    client = new ConsoleClient(this);
-	} else if (this.isGui()) {
-	    // Debug message
-	    this.getLogger().debug("Initializing GUI (Swing) client ...");
-
-	    // Init console instance
-	    client = new SwingClient(this);
-	} else {
-	    // Not client choosen
-	    this.getLogger().error("No client choosen. Cannot launch.");
-	    System.exit(1);
-	}
-
-	// Init client
-	client.initClient();
-
-	// Set client instance
-	this.setClient(client);
-	
-	// The application is running at this point
-	this.getClient().enableIsRunning();
-    }
-
-    /**
-     * Main loop of the application
-     */
-    @Override
-    public void doMainLoop () {
-	// @TODO The application should be running now
-	
-	// Output introduction
-	this.showIntro();
-
-	// Set current menu to main
-	this.getClient().setCurrentMenu("main");
-
-	// --- Main loop starts here ---
-	while (this.getClient().isRunning()) {
-	    // The application is still active, show menu selection
-	    this.getClient().showCurrentMenu();
-
-	    try {
-		// Ask for user input and run proper method
-		this.getClient().doUserMenuChoice();
-	    } catch (final UnhandledUserChoiceException ex) {
-		this.getLogger().catching(ex);
-	    }
-	}
-	// --- Main loop ends here ---
-
-	// Debug message
-	this.getLogger().debug("Main loop exit - shutting down ...");
-    }
-
-    /**
-     * Enables console client by setting propper flag
-     */
-    private void enableConsoleClient () {
-	this.getLogger().debug("Enabling console client (may become optional client) ...");
-	this.consoleClient = true;
-	this.guiClient = false;
-    }
-
-    /**
-     * Enables GUI client by setting propper flag
-     */
-    private void enableGuiClient () {
-	this.getLogger().debug("Enabling GUI client (may become new default client) ...");
-	this.consoleClient = false;
-	this.guiClient = true;
-    }
-
-    /**
-     * Checks whether the client shoule be console client should be launched by
-     * checking if -console is set.
-     * 
-     * @return Whether console client should be taken
-     */
-    private boolean isConsole () {
-	return this.consoleClient;
-    }
-
-    /**
-     * Checks whether the client shoule be GUI client should be launched by
-     * checking if -gui is set.
-     * 
-     * @return Whether GUI client should be taken
-     */
-    private boolean isGui () {
-	return this.guiClient;
-    }
-
-    /**
-     * Parses all given arguments
-     *
-     * @param args Arguments from program launch
-     */
-    private void parseArguments (final String[] args) {
-	// Debug message
-	this.getLogger().debug(MessageFormat.format("Parsing {0} arguments ...", args.length));
-	
-	for (final String arg : args) {
-	    // Switch on it
-	    switch (arg) {
-		case "-console":
-		    enableConsoleClient();
-		    break;
-		    
-		case "-gui":
-		    enableGuiClient();
-		    break;
-}
-	}
-    }
-
-    /**
-     * Show introduction which depends on client
-     */
-    private void showIntro () {
-	// Let the client show it
-	this.getClient().showWelcome();
-    }
-
-    /**
-     * Launches the application
-     * 
-     * @param args Arguments handled to program
-     */
-    private void start (final String args[]) {
-	this.getLogger().info("Program is started.");
-
-	// Parse arguments
-	this.parseArguments(args);
-
-	// Launch application
-	ApplicationManager.getManager(this).start();
-
-	// Good bye, but this should not be reached ...
-	this.getLogger().warn("Unusual exit reached.");
-	this.doShutdown();
-    }
-
-    /**
-     * Main method (entry point)
-     *
-     * @param args the command line arguments
-     */
-    public static void main (String[] args) {
-	// Start application
-	new AddressbookApplication().start(args);
-    }
-
-    /**
-     * Shuts down the application.
-     */
-    @Override
-    public void doShutdown () {
-	// Shutdown client
-	this.getClient().doShutdown();
-
-	this.getLogger().info("End of program (last line)");
-	System.exit(0);
-    }
-}
+/*
+ * Copyright (C) 2015 Roland Haeder
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+package org.mxchange.addressbook.application;
+
+import java.io.IOException;
+import java.text.MessageFormat;
+import org.mxchange.addressbook.BaseAddressbookSystem;
+import org.mxchange.addressbook.client.AddressbookClient;
+import org.mxchange.addressbook.client.console.ConsoleClient;
+import org.mxchange.addressbook.client.gui.SwingClient;
+import org.mxchange.jcore.BaseFrameworkSystem;
+import org.mxchange.jcore.application.Application;
+import org.mxchange.jcore.client.Client;
+import org.mxchange.jcore.exceptions.UnhandledUserChoiceException;
+import org.mxchange.jcore.manager.application.ApplicationManager;
+
+/**
+ * ============================================
+ * AddressbookApplication management:
+ * ============================================
+ * 
+ * Inernet("public" service) and Intranet
+ * 
+ * Version 1.0+:
+ * - Single-user local application
+ * - Fields:
+ *   + Gender
+ *   + Surname
+ *   + Family name
+ *   + Company name
+ *   + Street + number
+ *   + ZIP code
+ *   + City
+ *   + Landline number
+ *   + Fax number
+ *   + Cell phone number
+ *   + Email address
+ *   + Birth day
+ *   + Comment (?)
+ * - Edit own data
+ * - Add new contact
+ * - Edit contacts
+ * - Delete contacts
+ * - Categorization of contacts
+ * 
+ * Version 1.1+:
+ * - Permanent storage in database
+ * 
+ * Version 2.0+:
+ * - Multi-user web application
+ * - Local user registration / login / resend confirmation link / password
+ *   recovery
+ * - User groups (aka. teams)
+ * - Administration area (user role)
+ *   + Create/edit/delete groups
+ *   + Edit/delete/lock/unlock user
+ *   + Assign user roles/rights
+ * - Allow other users / groups to view addressbook
+ *   + Full addressbook
+ *   + Only some categories
+ * - VCard export
+ *   + Allow users/guests (not recommended)
+ * - XML export of addressbook and compressable (ZIP)
+ * - Form to contact other user/group without need of mail program
+ *   + User can disabled this
+ * - Directory for ussers/groups (who allowed to be listed)
+ *   + Simple click to add user to own addressbook
+ *   + Search form?
+ * 
+ * Version 2.1+:
+ * - Multi-language support
+ * 
+ * Version 2.2+:("socialized")
+ * - "Social login" (OpenID consumer)
+ *   + Connect user account to social account
+ *   + Sync own data?
+ * - "Social profile"
+ *   + OpenID provider
+ *   + RSS/activity feed 
+ * 
+ * ============================================
+ * Time esitmation:
+ * ============================================
+ * 1.0 (console):
+ *   + 2 days
+ * 
+ * 1.1 (database):
+ *   + 2 day
+ *   + Initial tables: contacts, categories, contact_category
+ * 
+ * 2.0 (web):
+ *   + 3 days
+ *   + Additional tables: admins (?), admin_rights, groups,
+ *    users, user_contacts, user_user_rights, user_category_rights, 
+ * 
+ * 2.1 (language)
+ *   + 1 day
+ *   + Additional tables: languages (disable, enable language "pack" ?)
+ * 
+ * 2.2 (social):
+ *   + 3 days
+ *   + Additional tables: ???
+*
+ * @author Roland Haeder
+ * @version 0.0
+ */
+public class AddressbookApplication extends BaseAddressbookSystem implements Application {
+
+	/**
+	 * Application title
+	 */
+	public static final String APP_TITLE = "Adressbuch"; //NOI18N
+
+	/**
+	 * Application version
+	 */
+	public static final String APP_VERSION = "0.0"; //NOI18N
+
+	/**
+	 * Console client is enabled by default
+	 */
+	private boolean consoleClient = true;
+
+	/**
+	 * GUI client is disabled by default
+	 */
+	private boolean guiClient = false;
+
+	/**
+	 * Protected constructor
+	 * @throws java.io.IOException If any IO error occurs
+	 */
+	protected AddressbookApplication () throws IOException {
+		// Init properties file
+		this.initProperties();
+
+		// Init bundle
+		this.initBundle();
+	}
+
+	/**
+	 * Bootstraps application
+	 */
+	@Override
+	public void doBootstrap () {
+		this.getLogger().debug("Initializing application ..."); //NOI18N
+
+		// Init client variable
+		Client client = null;
+
+		// Is console or Swing choosen?
+		if (this.isConsole()) {
+			// Debug message
+			this.getLogger().debug("Initializing console client ..."); //NOI18N
+
+			// Init console client instance
+			client = new ConsoleClient(this);
+		} else if (this.isGui()) {
+			// Debug message
+			this.getLogger().debug("Initializing GUI (Swing) client ..."); //NOI18N
+
+			// Init console instance
+			client = new SwingClient(this);
+		} else {
+			// Not client choosen
+			this.getLogger().error("No client choosen. Cannot launch."); //NOI18N
+			System.exit(1);
+		}
+
+		// Init client
+		client.init();
+
+		// Set client instance
+		this.setClient(client);
+
+		// The application is running at this point
+		this.getClient().enableIsRunning();
+
+		// Trace message
+		this.getLogger().trace("EXIT!"); //NOI18N
+	}
+
+	/**
+	 * Main loop of the application
+	 */
+	@Override
+	public void doMainLoop () {
+		// Get client and cast it
+		AddressbookClient client = (AddressbookClient) this.getClient();
+
+		// Debug message
+		this.getLogger().trace("CALLED!"); //NOI18N
+
+		// @TODO The application should be running now
+		// Output introduction
+		this.showIntro();
+
+		// Set current menu to main
+		client.setCurrentMenu("main"); //NOI18N
+
+		// --- Main loop starts here ---
+		while (this.getClient().isRunning()) {
+			// The application is still active, show menu selection
+			client.showCurrentMenu();
+
+			try {
+				// Ask for user input and run proper method
+				client.doUserMenuChoice();
+			} catch (final UnhandledUserChoiceException ex) {
+				this.getLogger().catching(ex);
+			}
+
+			try {
+				// Sleep a little to reduce system load
+				Thread.sleep(100);
+			} catch (final InterruptedException ex) {
+				// Ignore it
+			}
+		}
+		// --- Main loop ends here ---
+
+		// Debug message
+		this.getLogger().debug("Main loop exit - shutting down ..."); //NOI18N
+	}
+
+	/**
+	 * Shuts down the application.
+	 */
+	@Override
+	public void doShutdown () {
+		// Trace message
+		this.getLogger().trace("CALLED!"); //NOI18N
+		
+		// Shutdown client
+		this.getClient().doShutdown();
+		
+		this.getLogger().info("End of program (last line)"); //NOI18N
+		System.exit(0);
+	}
+
+	/**
+	 * Enables console client by setting propper flag
+	 */
+	private void enableConsoleClient () {
+		this.getLogger().debug("Enabling console client (may become optional client) ..."); //NOI18N
+		this.consoleClient = true;
+		this.guiClient = false;
+	}
+
+	/**
+	 * Enables GUI client by setting propper flag
+	 */
+	private void enableGuiClient () {
+		this.getLogger().debug("Enabling GUI client (may become new default client) ..."); //NOI18N
+		this.consoleClient = false;
+		this.guiClient = true;
+	}
+
+	/**
+	 * Checks whether the client shoule be console client should be launched by
+	 * checking if -console is set.
+	 *
+	 * @return Whether console client should be taken
+	 */
+	private boolean isConsole () {
+		return this.consoleClient;
+	}
+
+	/**
+	 * Checks whether the client shoule be GUI client should be launched by
+	 * checking if -gui is set.
+	 *
+	 * @return Whether GUI client should be taken
+	 */
+	private boolean isGui () {
+		return this.guiClient;
+	}
+
+	/**
+	 * Parses all given arguments
+	 *
+	 * @param args Arguments from program launch
+	 */
+	private void parseArguments (final String[] args) {
+		// Trace message
+		this.getLogger().trace(MessageFormat.format("args()={0} - CALLED!", args.length)); //NOI18N
+
+		// Debug message
+		this.getLogger().debug(MessageFormat.format("Parsing {0} arguments ...", args.length)); //NOI18N
+
+		for (final String arg : args) {
+			// Switch on it
+			switch (arg) {
+				case "-console": //NOI18N
+					enableConsoleClient();
+					break;
+
+				case "-gui": //NOI18N
+					enableGuiClient();
+					break;
+			}
+		}
+	}
+
+	/**
+	 * Show introduction which depends on client
+	 */
+	private void showIntro () {
+		// Trace message
+		this.getLogger().trace("CALLED!"); //NOI18N
+
+		// Let the client show it
+		this.getClient().showWelcome();
+
+		// Trace message
+		this.getLogger().trace("EXIT!"); //NOI18N
+	}
+
+	/**
+	 * Launches the application
+	 *
+	 * @param args Arguments handled to program
+	 */
+	private void start (final String args[]) {
+		this.getLogger().info("Program is started."); //NOI18N
+
+		// Parse arguments
+		this.parseArguments(args);
+
+		// Launch application
+		ApplicationManager.getManager(this).start();
+
+		// Good bye, but this should not be reached ...
+		this.getLogger().warn("Unusual exit reached."); //NOI18N
+		this.doShutdown();
+	}
+
+	/**
+	 * Main method (entry point)
+	 *
+	 * @param args the command line arguments
+	 */
+	public static void main (String[] args) {
+		try {
+			// Start application
+			new AddressbookApplication().start(args);
+		} catch (final IOException ex) {
+			// Get instance
+			BaseFrameworkSystem.getInstance().getLogger().catching(ex);
+			System.exit(1);
+		}
+	}
+
+	/**
+	 * Getter for printable application name
+	 *
+	 * @return A printable name
+	 */
+	public static String printableTitle () {
+		return MessageFormat.format("{0} v{1}", APP_TITLE, APP_VERSION); //NOI18N
+	}
+}