2 * Copyright (C) 2015 Roland Haeder
4 * This program is free software: you can redistribute it and/or modify
5 * it under the terms of the GNU General Public License as published by
6 * the Free Software Foundation, either version 3 of the License, or
7 * (at your option) any later version.
9 * This program is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 * GNU General Public License for more details.
14 * You should have received a copy of the GNU General Public License
15 * along with this program. If not, see <http://www.gnu.org/licenses/>.
17 package org.mxchange.addressbook.application;
19 import java.io.IOException;
20 import java.sql.SQLException;
21 import java.text.MessageFormat;
22 import org.mxchange.addressbook.BaseAddressbookSystem;
23 import org.mxchange.addressbook.client.AddressbookClient;
24 import org.mxchange.addressbook.client.console.ConsoleClient;
25 import org.mxchange.addressbook.client.gui.SwingClient;
26 import org.mxchange.jcore.BaseFrameworkSystem;
27 import org.mxchange.jcore.application.Application;
28 import org.mxchange.jcore.client.Client;
29 import org.mxchange.jcore.exceptions.UnhandledUserChoiceException;
30 import org.mxchange.jcore.manager.application.ApplicationManager;
33 * ============================================
34 * AddressbookApplication management:
35 * ============================================
37 * Inernet("public" service) and Intranet
40 * - Single-user local application
59 * - Categorization of contacts
62 * - Permanent storage in database
65 * - Multi-user web application
66 * - Local user registration / login / resend confirmation link / password
68 * - User groups (aka. teams)
69 * - Administration area (user role)
70 * + Create/edit/delete groups
71 * + Edit/delete/lock/unlock user
72 * + Assign user roles/rights
73 * - Allow other users / groups to view addressbook
75 * + Only some categories
77 * + Allow users/guests (not recommended)
78 * - XML export of addressbook and compressable (ZIP)
79 * - Form to contact other user/group without need of mail program
80 * + User can disabled this
81 * - Directory for ussers/groups (who allowed to be listed)
82 * + Simple click to add user to own addressbook
86 * - Multi-language support
88 * Version 2.2+:("socialized")
89 * - "Social login" (OpenID consumer)
90 * + Connect user account to social account
96 * ============================================
98 * ============================================
104 * + Initial tables: contacts, categories, contact_category
108 * + Additional tables: admins (?), admin_rights, groups,
109 * users, user_contacts, user_user_rights, user_category_rights,
113 * + Additional tables: languages (disable, enable language "pack" ?)
117 * + Additional tables: ???
119 * @author Roland Haeder
122 public class AddressbookApplication extends BaseAddressbookSystem implements Application {
127 public static final String APP_TITLE = "Adressbuch"; //NOI18N
130 * Application version
132 public static final String APP_VERSION = "0.0"; //NOI18N
135 * Console client is enabled by default
137 private boolean consoleClient = true;
140 * GUI client is disabled by default
142 private boolean guiClient = false;
145 * Protected constructor
146 * @throws java.io.IOException If any IO error occurs
148 protected AddressbookApplication () throws IOException {
149 // Init properties file
150 this.initProperties();
157 * Bootstraps application
160 public void doBootstrap () {
161 this.getLogger().debug("Initializing application ..."); //NOI18N
163 // Init client variable
164 Client client = null;
166 // Is console or Swing choosen?
167 if (this.isConsole()) {
169 this.getLogger().debug("Initializing console client ..."); //NOI18N
171 // Init console client instance
172 client = new ConsoleClient(this);
173 } else if (this.isGui()) {
175 this.getLogger().debug("Initializing GUI (Swing) client ..."); //NOI18N
177 // Init console instance
178 client = new SwingClient(this);
180 // Not client choosen
181 this.getLogger().error("No client choosen. Cannot launch."); //NOI18N
188 // Set client instance
189 this.setClient(client);
191 // The application is running at this point
192 this.getClient().enableIsRunning();
195 this.getLogger().trace("EXIT!"); //NOI18N
199 * Main loop of the application
202 public void doMainLoop () {
203 // Get client and cast it
204 AddressbookClient client = (AddressbookClient) this.getClient();
207 this.getLogger().trace("CALLED!"); //NOI18N
209 // @TODO The application should be running now
210 // Output introduction
213 // Set current menu to main
214 client.setCurrentMenu("main"); //NOI18N
216 // --- Main loop starts here ---
217 while (this.getClient().isRunning()) {
218 // The application is still active, show menu selection
219 client.showCurrentMenu();
222 // Ask for user input and run proper method
223 client.doUserMenuChoice();
224 } catch (final UnhandledUserChoiceException ex) {
225 this.getLogger().catching(ex);
229 // Sleep a little to reduce system load
231 } catch (final InterruptedException ex) {
235 // --- Main loop ends here ---
238 this.getLogger().debug("Main loop exit - shutting down ..."); //NOI18N
242 * Shuts down the application.
245 public void doShutdown () throws SQLException, IOException {
247 this.getLogger().trace("CALLED!"); //NOI18N
250 this.getClient().doShutdown();
252 this.getLogger().info("End of program (last line)"); //NOI18N
257 * Enables console client by setting propper flag
259 private void enableConsoleClient () {
260 this.getLogger().debug("Enabling console client (may become optional client) ..."); //NOI18N
261 this.consoleClient = true;
262 this.guiClient = false;
266 * Enables GUI client by setting propper flag
268 private void enableGuiClient () {
269 this.getLogger().debug("Enabling GUI client (may become new default client) ..."); //NOI18N
270 this.consoleClient = false;
271 this.guiClient = true;
275 * Checks whether the client shoule be console client should be launched by
276 * checking if -console is set.
278 * @return Whether console client should be taken
280 private boolean isConsole () {
281 return this.consoleClient;
285 * Checks whether the client shoule be GUI client should be launched by
286 * checking if -gui is set.
288 * @return Whether GUI client should be taken
290 private boolean isGui () {
291 return this.guiClient;
295 * Parses all given arguments
297 * @param args Arguments from program launch
299 private void parseArguments (final String[] args) {
301 this.getLogger().trace(MessageFormat.format("args()={0} - CALLED!", args.length)); //NOI18N
304 this.getLogger().debug(MessageFormat.format("Parsing {0} arguments ...", args.length)); //NOI18N
306 for (final String arg : args) {
309 case "-console": //NOI18N
310 enableConsoleClient();
313 case "-gui": //NOI18N
321 * Show introduction which depends on client
323 private void showIntro () {
325 this.getLogger().trace("CALLED!"); //NOI18N
327 // Let the client show it
328 this.getClient().showWelcome();
331 this.getLogger().trace("EXIT!"); //NOI18N
335 * Launches the application
337 * @param args Arguments handled to program
339 private void start (final String args[]) {
340 this.getLogger().info("Program is started."); //NOI18N
342 // Init properties file
343 this.initProperties();
344 } catch (final IOException ex) {
345 // Something bad happened
346 this.abortProgramWithException(ex);
350 this.parseArguments(args);
352 // Launch application
353 ApplicationManager.getManager(this).start();
355 // Good bye, but this should not be reached ...
356 this.getLogger().warn("Unusual exit reached."); //NOI18N
359 } catch (final SQLException | IOException ex) {
360 this.abortProgramWithException(ex);
365 * Main method (entry point)
367 * @param args the command line arguments
369 public static void main (String[] args) {
372 new AddressbookApplication().start(args);
373 } catch (final IOException ex) {
375 BaseFrameworkSystem.getInstance().getLogger().catching(ex);
381 * Getter for printable application name
383 * @return A printable name
385 public static String printableTitle () {
386 return MessageFormat.format("{0} v{1}", APP_TITLE, APP_VERSION); //NOI18N