]> git.mxchange.org Git - addressbook-lib.git/blobdiff - src/org/mxchange/addressbook/application/AddressbookApplication.java
auto-formatted project + updated jars
[addressbook-lib.git] / src / org / mxchange / addressbook / application / AddressbookApplication.java
index 2e16df4e97e8d90b547d2e4efed1304578d13ee2..dca6fe202e2dc7e9892f2a158a474f8ef4e5e7e5 100644 (file)
@@ -24,101 +24,18 @@ 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.application.BaseApplication;
 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: ???
-*
+ * Address book application class. Please see ROADMAP.txt for details.
+ * <p>
  * @author Roland Haeder
  * @version 0.0
  */
-public class AddressbookApplication extends BaseFrameworkSystem implements Application {
+public class AddressbookApplication extends BaseApplication implements Application {
 
        /**
         * Application title
@@ -142,6 +59,7 @@ public class AddressbookApplication extends BaseFrameworkSystem implements Appli
 
        /**
         * Protected constructor
+        * <p>
         * @throws java.io.IOException If any IO error occurs
         */
        protected AddressbookApplication () throws IOException {
@@ -164,7 +82,7 @@ public class AddressbookApplication extends BaseFrameworkSystem implements Appli
                this.getLogger().debug("Initializing application ..."); //NOI18N
 
                // Init client variable
-               Client client;
+               Client client = null;
 
                // Is console or Swing choosen?
                if (this.isConsole()) {
@@ -182,6 +100,7 @@ public class AddressbookApplication extends BaseFrameworkSystem implements Appli
                } else {
                        // Not client choosen
                        this.getLogger().error("No client choosen. Cannot launch."); //NOI18N
+
                        try {
                                this.doShutdown();
                        } catch (final SQLException | IOException ex) {
@@ -256,10 +175,10 @@ public class AddressbookApplication extends BaseFrameworkSystem implements Appli
        public void doShutdown () throws SQLException, IOException {
                // Trace message
                this.getLogger().trace("CALLED!"); //NOI18N
-               
+
                // Shutdown client
                this.getClient().doShutdown();
-               
+
                this.getLogger().info("End of program (last line)"); //NOI18N
                System.exit(0);
        }
@@ -285,7 +204,7 @@ public class AddressbookApplication extends BaseFrameworkSystem implements Appli
        /**
         * Checks whether the client shoule be console client should be launched by
         * checking if -console is set.
-        *
+        * <p>
         * @return Whether console client should be taken
         */
        private boolean isConsole () {
@@ -295,7 +214,7 @@ public class AddressbookApplication extends BaseFrameworkSystem implements Appli
        /**
         * Checks whether the client shoule be GUI client should be launched by
         * checking if -gui is set.
-        *
+        * <p>
         * @return Whether GUI client should be taken
         */
        private boolean isGui () {
@@ -304,7 +223,7 @@ public class AddressbookApplication extends BaseFrameworkSystem implements Appli
 
        /**
         * Parses all given arguments
-        *
+        * <p>
         * @param args Arguments from program launch
         */
        private void parseArguments (final String[] args) {
@@ -344,7 +263,7 @@ public class AddressbookApplication extends BaseFrameworkSystem implements Appli
 
        /**
         * Launches the application
-        *
+        * <p>
         * @param args Arguments handled to program
         */
        private void start (final String args[]) {
@@ -374,7 +293,7 @@ public class AddressbookApplication extends BaseFrameworkSystem implements Appli
 
        /**
         * Main method (entry point)
-        *
+        * <p>
         * @param args the command line arguments
         */
        public static void main (String[] args) {
@@ -390,7 +309,7 @@ public class AddressbookApplication extends BaseFrameworkSystem implements Appli
 
        /**
         * Getter for printable application name
-        *
+        * <p>
         * @return A printable name
         */
        public static String printableTitle () {