2 * Copyright (C) 2015 Roland Haeder
\r
4 * This program is free software: you can redistribute it and/or modify
\r
5 * it under the terms of the GNU General Public License as published by
\r
6 * the Free Software Foundation, either version 3 of the License, or
\r
7 * (at your option) any later version.
\r
9 * This program is distributed in the hope that it will be useful,
\r
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
\r
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
\r
12 * GNU General Public License for more details.
\r
14 * You should have received a copy of the GNU General Public License
\r
15 * along with this program. If not, see <http://www.gnu.org/licenses/>.
\r
17 package org.mxchange.addressbook.manager.contact;
\r
19 import java.text.MessageFormat;
\r
20 import java.util.ArrayList;
\r
21 import java.util.Collections;
\r
22 import java.util.Iterator;
\r
23 import java.util.List;
\r
24 import org.mxchange.addressbook.UnhandledUserChoiceException;
\r
25 import org.mxchange.addressbook.client.Client;
\r
26 import org.mxchange.addressbook.contact.Contact;
\r
27 import org.mxchange.addressbook.database.frontend.contact.ContactDatabaseFrontend;
\r
28 import org.mxchange.addressbook.database.frontend.contact.ContactWrapper;
\r
29 import org.mxchange.addressbook.manager.BaseManager;
\r
32 * A manager for contacts, please note that this implementation loads the whole
\r
35 * @author Roland Haeder
\r
38 public class ContactManager extends BaseManager implements ManageableContact {
\r
42 private final List<String> columnNames;
\r
45 * A ContactWrapper instance
\r
47 private final ContactWrapper contactDatabase;
\r
50 * A list of all contacts
\r
52 private final List<Contact> contacts;
\r
56 * @param maxContacts Maximum allowed contacts
\r
57 * @param client Client instance to use
\r
59 public ContactManager (final int maxContacts, final Client client) {
\r
60 // Always call super constructor first
\r
63 // Set client instance
\r
64 this.setClient(client);
\r
67 this.contacts = new ArrayList<>(maxContacts);
\r
69 // Init database connection
\r
70 this.contactDatabase = new ContactDatabaseFrontend(this);
\r
73 this.columnNames = new ArrayList<>(15);
\r
76 this.fillColumnNamesFromBundle();
\r
79 this.contactDatabase.readAllContacts();
\r
82 //* NOISY-DEBUG: */ this.getLogger().debug("client=" + client);
\r
86 * Adds given Contact instance to list
\r
88 * @param contact Contact instance to add
\r
91 public void addContact (final Contact contact) {
\r
92 this.contacts.add(contact);
\r
96 * Let the user add a new other address
\r
99 public void addOtherAddress () {
\r
100 throw new UnsupportedOperationException("Not supported yet.");
\r
104 * Let the user change other address
\r
107 public void changeOtherAddress () {
\r
108 throw new UnsupportedOperationException("Not supported yet.");
\r
112 * Allows the user to change his/her own data
\r
115 public void changeOwnData () {
\r
117 * First check if the user has registered own contact, before that
\r
118 * nothing can be changed.
\r
120 if (!this.isOwnContactAdded()) {
\r
122 this.getClient().outputMessage("Sie haben noch nicht Ihre Daten eingegeben.");
\r
124 // Skip any below code
\r
129 Contact contact = this.getOwnContact();
\r
131 // It must be found
\r
132 assert(contact instanceof Contact);
\r
135 contact.show(this.getClient());
\r
138 // Ask user what to change
\r
139 this.getClient().userChooseChangeContactData(contact);
\r
140 } catch (final UnhandledUserChoiceException ex) {
\r
141 this.getLogger().catching(ex);
\r
146 * Let the user delete other address
\r
149 public void deleteOtherAddress () {
\r
150 throw new UnsupportedOperationException("Not supported yet.");
\r
154 * Let the user change address data
\r
156 * @param contact Instance to change data
\r
157 * @param client Client instance to call back
\r
160 public void doChangeAddressData (final Contact contact, final Client client) {
\r
161 // First display it again
\r
162 client.displayAddressBox(contact);
\r
165 if (contact.isOwnContact()) {
\r
166 // Deligate to client
\r
167 this.getClient().doChangeOwnAddressData(contact);
\r
169 // Other contact's address data to change
\r
170 throw new UnsupportedOperationException("Changing contact entries not finished.");
\r
173 // Flush whole list
\r
178 * Let the user change "name data"
\r
180 * @param contact Instance to change data
\r
181 * @param client Client instance to call back
\r
184 public void doChangeNameData (final Contact contact, final Client client) {
\r
185 // First display them again
\r
186 client.displayNameBox(contact);
\r
188 // Is this own data?
\r
189 if (contact.isOwnContact()) {
\r
191 this.getClient().doChangeOwnNameData(contact);
\r
193 // Then re-ask them ...
\r
194 throw new UnsupportedOperationException("Changing contact entries not finished.");
\r
197 // Flush whole list
\r
202 * Let the user change other data
\r
204 * @param contact Instance to change data
\r
205 * @param client Client instance to call back
\r
206 * @todo Didn't handle birthday
\r
209 public void doChangeOtherData (final Contact contact, final Client client) {
\r
210 // First display them again
\r
211 this.getClient().displayOtherDataBox(contact);
\r
213 // Is this own data?
\r
214 if (contact.isOwnContact()) {
\r
216 this.getClient().doChangeOwnOtherData(contact);
\r
218 // Then re-ask them ...
\r
219 throw new UnsupportedOperationException("Changing contact entries not finished.");
\r
222 // Flush whole list
\r
227 * Asks user for own data
\r
230 public void doEnterOwnData () {
\r
231 // Deligate this call to the client
\r
232 Contact contact = this.getClient().doEnterOwnData();
\r
234 // Add it to contact "book"
\r
235 this.registerContact(contact);
\r
239 * Shuts down this contact manager
\r
242 public void doShutdown () {
\r
243 // Shut down the database layer
\r
244 this.contactDatabase.doShutdown();
\r
248 * Asks the user for his/her cellphone number
\r
250 * @return User's cellphone number
\r
253 public String enterOwnCellNumber () {
\r
254 return this.getClient().enterString(5, 30, "Bitte geben Sie Ihre Handynummer an: ", true);
\r
258 * Asks the user for his/her city's name
\r
260 * @return City's name of the user
\r
263 public String enterOwnCity () {
\r
264 return this.getClient().enterString(3, 50, "Bitte geben Sie Ihre Wohnort ein: ", false);
\r
268 * Asks the user for his/her city's name
\r
270 * @return City's name of the user
\r
273 public String enterOwnComment () {
\r
274 return this.getClient().enterString(0, 100, "Kommentar zu Ihrem Eintrag: ", true);
\r
278 * Asks the user for his/her company name
\r
280 * @return User's company name
\r
283 public String enterOwnCompanyName () {
\r
284 return this.getClient().enterString(5, 50, "Bitte geben Sie Ihre Firmenbezeichnung ein: ", true);
\r
288 * Asks user for his/her own country code
\r
290 * @return User's own country code
\r
293 public String enterOwnCountryCode () {
\r
294 return this.getClient().enterString(2, 2, "Bitte geben Sie den zweistelligen Ländercode von Ihrem Land ein: ", false).toUpperCase();
\r
298 * Asks user for his/her own country code
\r
300 * @return User's own country code
\r
303 public String enterOwnEmailAddress () {
\r
304 return this.getClient().enterString(10, 50, "Bitte geben Sie Ihre Email-Adresse ein: ", true);
\r
308 * Asks the user for family name
\r
310 * @return Family name of the user
\r
313 public String enterOwnFamilyName () {
\r
314 return this.getClient().enterString(2, 50, "Bitte geben Sie Ihren Nachnamen ein: ", false);
\r
318 * Asks the user for family name
\r
320 * @return Family name of the user
\r
323 public String enterOwnFaxNumber () {
\r
324 return this.getClient().enterString(5, 30, "Bitte geben Sie Ihre Faxnummer an: ", true);
\r
328 * Asks the user for gender, until a valid has been entered
\r
330 * @return Gender of the user
\r
333 public char enterOwnGender () {
\r
334 return this.getClient().enterChar(new char[] {'M', 'F', 'C'}, "Bitte geben Sie die Anrede ein: (M=Herr, F=Frau, C=Firma): ");
\r
338 * Asks the user for phone number
\r
340 * @return Phone number of the user
\r
343 public String enterOwnPhoneNumber () {
\r
344 return this.getClient().enterString(5, 30, "Bitte geben Sie Ihre Telefonnummer an: ", true);
\r
348 * Asks the user for own street (including number)
\r
349 * @return Own street an number
\r
352 public String enterOwnStreet () {
\r
353 return this.getClient().enterString(5, 50, "Bitte geben Sie Ihre Strasse und Hausnummer ein: ", false);
\r
357 * Asks the user for surname
\r
358 * @return Surname of the user
\r
361 public String enterOwnSurname () {
\r
362 return this.getClient().enterString(2, 50, "Bitte geben Sie Ihren Vornamen ein: ", false);
\r
366 * Asks the user for own ZIP code
\r
371 public int enterOwnZipCode () {
\r
372 return this.getClient().enterInt(0, 99_999, "Bitte geben Sie Ihre Postleitzahl ein: ");
\r
376 public int getColumnCount () {
\r
377 return this.columnNames.size();
\r
381 * Getter for whole contact list
\r
383 * @return List of all contacts
\r
386 public List<Contact> getList () {
\r
387 return Collections.unmodifiableList(this.contacts);
\r
391 * Checks whether own contact is already added by checking all entries for
\r
392 * isOwnContact flag
\r
394 * @return Whether own contact is already added
\r
397 public boolean isOwnContactAdded () {
\r
398 // Default is not added
\r
399 boolean isAdded = false;
\r
401 // Now get it back from address book, first get an iterator
\r
402 Iterator<Contact> iterator = this.contacts.iterator();
\r
405 while (iterator.hasNext()) {
\r
407 Contact contact = iterator.next();
\r
410 if (contact instanceof Contact) {
\r
412 isAdded = contact.isOwnContact();
\r
414 // Is this own contact?
\r
426 public void listContacts () {
\r
427 throw new UnsupportedOperationException("Not supported yet.");
\r
431 * Adds given contact to address book and flushes all entries to database
\r
433 * @param contact Contact being added
\r
434 * @todo Add check for book size
\r
437 public void registerContact (final Contact contact) {
\r
438 // Check if contact is found
\r
439 if (this.isContactAlreadyAdded(contact)) {
\r
440 // Contact already added
\r
441 // @todo Do something here
\r
442 } else if ((contact.isOwnContact()) && (this.isOwnContactAdded())) {
\r
443 // Own contact already added
\r
444 // @todo Do something
\r
448 /* NOISY-DEBUG: */ this.getLogger().debug(MessageFormat.format("Adding '{0}' '{1}' at pos '{2}' ...", contact.getSurname(), contact.getFamilyName(), this.size()));
\r
450 // Add contact to internal list
\r
451 this.addContact(contact);
\r
453 // Flush whole list
\r
458 public void searchContacts () {
\r
459 throw new UnsupportedOperationException("Not supported yet.");
\r
465 * @return size of contact "book"
\r
468 public int size () {
\r
469 return this.contacts.size();
\r
473 * Fills the column names array with strings from bundle
\r
475 private void fillColumnNamesFromBundle () {
\r
476 // First get an iterator from key set to iterate over
\r
477 Iterator<String> iterator = this.getBundle().keySet().iterator();
\r
479 // Then iterate over all
\r
480 while (iterator.hasNext()) {
\r
481 // Get next element
\r
482 String key = iterator.next();
\r
484 // Does the key start with ContactManager.columnName ?
\r
485 if (key.startsWith("ContactManager.columnName")) {
\r
486 // This is the wanted entry.
\r
487 this.getLogger().debug(MessageFormat.format("key={0}", key));
\r
490 this.columnNames.add(this.getBundle().getString(key));
\r
496 * Flushes all entries by calling database backend
\r
498 private void flush () {
\r
500 this.getContactDatabase().flushAllContacts();
\r
504 * A ContactWrapper instance
\r
506 * @return the database
\r
508 private ContactWrapper getContactDatabase () {
\r
509 return this.contactDatabase;
\r
513 * "Getter" for own contact instance or null if not found
\r
515 * @return Contact instance or null
\r
517 private Contact getOwnContact () {
\r
518 // Now get it back from address book, first get an iterator
\r
519 Iterator<Contact> iterator = this.contacts.iterator();
\r
522 Contact contact = null;
\r
524 // Search all contact
\r
525 while (iterator.hasNext()) {
\r
526 // Get next instance
\r
527 Contact next = iterator.next();
\r
529 // Is this own contact?
\r
530 if (next.isOwnContact()) {
\r
538 // Return instance or null
\r
543 * Checks whether given contact was found in "address book"
\r
545 * @param checkContact Contact to be checked
\r
546 * @return TRUE if found, FALSE if not found
\r
548 private boolean isContactAlreadyAdded (final Contact checkContact) throws NullPointerException {
\r
549 // Default is not found
\r
550 boolean isFound = false;
\r
553 //* NOISY-DEBUG: */ this.getLogger().debug("Checking '" + this.contacts.length + "' entries...");
\r
555 // Now get it back from address book, first get an iterator
\r
556 Iterator<Contact> iterator = this.contacts.iterator();
\r
559 while (iterator.hasNext()) {
\r
561 Contact contact = iterator.next();
\r
564 //* NOISY-DEBUG: */ this.getLogger().debug("contact=" + contact + ",checkContent=" + checkContact);
\r
567 if ((contact instanceof Contact) && ((contact.equals(checkContact)))) {
\r
568 // Found matching entry
\r