src/java/org/mxchange/jjobs/beans/phone/list/JobsPhoneListWebViewBean.java

   1 /*
   2  * Copyright (C) 2016 - 2020 Free Software Foundation
   3  *
   4  * This program is free software: you can redistribute it and/or modify
   5  * it under the terms of the GNU Affero General Public License as
   6  * published by the Free Software Foundation, either version 3 of the
   7  * License, or (at your option) any later version.
   8  *
   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 Affero General Public License for more details.
  13  *
  14  * You should have received a copy of the GNU Affero General Public License
  15  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  16  */
  17 package org.mxchange.jjobs.beans.phone.list;
  18
  19 import fish.payara.cdi.jsr107.impl.NamedCache;
  20 import java.text.MessageFormat;
  21 import java.util.Comparator;
  22 import java.util.LinkedList;
  23 import java.util.List;
  24 import java.util.Objects;
  25 import javax.annotation.PostConstruct;
  26 import javax.cache.Cache;
  27 import javax.ejb.EJB;
  28 import javax.enterprise.event.Observes;
  29 import javax.faces.view.ViewScoped;
  30 import javax.inject.Inject;
  31 import javax.inject.Named;
  32 import org.mxchange.jcontacts.events.contact.add.ObservableAdminAddedContactEvent;
  33 import org.mxchange.jcontacts.events.contact.update.ObservableAdminUpdatedContactEvent;
  34 import org.mxchange.jcontacts.events.fax.linked.ObservableAdminLinkedFaxNumberEvent;
  35 import org.mxchange.jcontacts.events.landline.linked.ObservableAdminLinkedLandLineNumberEvent;
  36 import org.mxchange.jcontacts.model.contact.Contact;
  37 import org.mxchange.jjobs.beans.BaseJobsBean;
  38 import org.mxchange.jphone.events.fax.deleted.AdminDeletedFaxNumberEvent;
  39 import org.mxchange.jphone.events.fax.updated.AdminUpdatedFaxNumberEvent;
  40 import org.mxchange.jphone.events.landline.deleted.AdminDeletedLandLineNumberEvent;
  41 import org.mxchange.jphone.events.landline.updated.AdminUpdatedLandLineNumberEvent;
  42 import org.mxchange.jphone.exceptions.phone.PhoneEntityNotFoundException;
  43 import org.mxchange.jphone.model.phonenumbers.fax.DialableFaxNumber;
  44 import org.mxchange.jphone.model.phonenumbers.landline.DialableLandLineNumber;
  45 import org.mxchange.jphone.model.phonenumbers.phone.PhoneSessionBeanRemote;
  46
  47 /**
  48  * Administrative listing controller (bean) for phone numbers
  49  * <p>
  50  * @author Roland Häder<roland@mxchange.org>
  51  */
  52 @Named ("phoneListController")
  53 @ViewScoped
  54 public class JobsPhoneListWebViewBean extends BaseJobsBean implements JobsPhoneListWebViewController {
  55
  56         /**
  57          * Serial number
  58          */
  59         private static final long serialVersionUID = 491_058_674_675_690_107L;
  60
  61         /**
  62          * A list of all fax numbers
  63          */
  64         private final List<DialableFaxNumber> allFaxNumbers;
  65
  66         /**
  67          * A list of all land-line numbers
  68          */
  69         private final List<DialableLandLineNumber> allLandLineNumbers;
  70
  71         /**
  72          * All fax numbers
  73          */
  74         @Inject
  75         @NamedCache (cacheName = "faxNumberCache")
  76         private transient Cache<Long, DialableFaxNumber> faxNumberCache;
  77
  78         /**
  79          * A list of filtered fax numbers
  80          */
  81         private List<DialableFaxNumber> filteredFaxNumbers;
  82
  83         /**
  84          * A list of filtered land-line numbers
  85          */
  86         private List<DialableLandLineNumber> filteredLandLineNumbers;
  87
  88         /**
  89          * All land-line numbers
  90          */
  91         @Inject
  92         @NamedCache (cacheName = "landLineNumberCache")
  93         private transient Cache<Long, DialableLandLineNumber> landLineNumberCache;
  94
  95         /**
  96          * General EJB for phone numbers
  97          */
  98         @EJB (lookup = "java:global/jjobs-ejb/phone!org.mxchange.jphone.model.phonenumbers.phone.PhoneSessionBeanRemote")
  99         private PhoneSessionBeanRemote phoneBean;
 100
 101         /**
 102          * Default constructor
 103          */
 104         public JobsPhoneListWebViewBean () {
 105                 // Call super constructor
 106                 super();
 107
 108                 // Initialize lists
 109                 this.allFaxNumbers = new LinkedList<>();
 110                 this.allLandLineNumbers = new LinkedList<>();
 111         }
 112
 113         /**
 114          * Observes events being fired when an administrator has added a new
 115          * contact.
 116          * <p>
 117          * @param event Event being fired
 118          */
 119         public void afterAdminAddedContactEvent (@Observes final ObservableAdminAddedContactEvent event) {
 120                 // The event must be valid
 121                 if (null == event) {
 122                         // Throw NPE
 123                         throw new NullPointerException("event is null"); //NOI18N
 124                 } else if (event.getAddedContact() == null) {
 125                         // Throw again ...
 126                         throw new NullPointerException("event.addedContact is null"); //NOI18N
 127                 } else if (event.getAddedContact().getContactId() == null) {
 128                         // ... and again
 129                         throw new NullPointerException("event.addedContact.contactId is null"); //NOI18N
 130                 } else if (event.getAddedContact().getContactId() < 1) {
 131                         // Not valid
 132                         throw new IllegalArgumentException(MessageFormat.format("event.addedContact.contactId={0} is not valid", event.getAddedContact().getContactId())); //NOI18N
 133                 }
 134
 135                 // Update contact's mobile, land-line and fax number
 136                 this.updateContactPhoneNumbers(event.getAddedContact());
 137
 138                 // Clear this bean
 139                 this.clear();
 140         }
 141
 142         /**
 143          * Observes events being fired when an administrator has deleted a fax
 144          * number
 145          * <p>
 146          * @param event Event being fired
 147          */
 148         public void afterAdminDeletedFaxNumberEvent (@Observes final AdminDeletedFaxNumberEvent event) {
 149                 // Event and contained entity instance should not be null
 150                 if (null == event) {
 151                         // Throw NPE
 152                         throw new NullPointerException("event is null"); //NOI18N
 153                 } else if (event.getDeletedFaxNumber() == null) {
 154                         // Throw NPE again
 155                         throw new NullPointerException("event.deletedFaxNumber is null"); //NOI18N
 156                 } else if (event.getDeletedFaxNumber().getPhoneId() == null) {
 157                         // phoneId is null
 158                         throw new NullPointerException("event.deletedFaxNumber.phoneId is null"); //NOI18N
 159                 } else if (event.getDeletedFaxNumber().getPhoneId() < 1) {
 160                         // Not avalid id
 161                         throw new IllegalArgumentException(MessageFormat.format("phoneId of contact={0} is not valid: {1}", event.getDeletedFaxNumber(), event.getDeletedFaxNumber().getPhoneId())); //NOI18N
 162                 }
 163
 164                 // Update contact's mobile, land-line and fax number
 165                 this.getAllFaxNumbers().remove(event.getDeletedFaxNumber());
 166
 167                 // Clear all data
 168                 this.clear();
 169         }
 170
 171         /**
 172          * Observes events being fired when an administrator has deleted a land-line
 173          * number
 174          * <p>
 175          * @param event Event being fired
 176          */
 177         public void afterAdminDeletedLandLineNumberEvent (@Observes final AdminDeletedLandLineNumberEvent event) {
 178                 // Event and contained entity instance should not be null
 179                 if (null == event) {
 180                         // Throw NPE
 181                         throw new NullPointerException("event is null"); //NOI18N
 182                 } else if (event.getDeletedLandLineNumber() == null) {
 183                         // Throw NPE again
 184                         throw new NullPointerException("event.deletedLandLineNumber is null"); //NOI18N
 185                 } else if (event.getDeletedLandLineNumber().getPhoneId() == null) {
 186                         // phoneId is null
 187                         throw new NullPointerException("event.deletedLandLineNumber.phoneId is null"); //NOI18N
 188                 } else if (event.getDeletedLandLineNumber().getPhoneId() < 1) {
 189                         // Not avalid id
 190                         throw new IllegalArgumentException(MessageFormat.format("phoneId of contact={0} is not valid: {1}", event.getDeletedLandLineNumber(), event.getDeletedLandLineNumber().getPhoneId())); //NOI18N
 191                 }
 192
 193                 // Update contact's mobile, land-line and fax number
 194                 this.getAllLandLineNumbers().remove(event.getDeletedLandLineNumber());
 195
 196                 // Clear all data
 197                 this.clear();
 198         }
 199
 200         /**
 201          * Observes events being fired when an administrator has a linked a fax
 202          * number
 203          * <p>
 204          * @param event Event being fired
 205          */
 206         public void afterAdminLinkedFaxNumberEvent (@Observes final ObservableAdminLinkedFaxNumberEvent event) {
 207                 // Is the event fine?
 208                 if (event == null) {
 209                         // Throw NPE
 210                         throw new NullPointerException("event is null"); //NOI18N
 211                 } else if (event.getContact() == null) {
 212                         // Throw again ...
 213                         throw new NullPointerException("event.contact is null"); //NOI18N
 214                 } else if (event.getContact().getContactId() == null) {
 215                         // Throw again ...
 216                         throw new NullPointerException("event.contact.contactId is null"); //NOI18N
 217                 } else if (event.getContact().getContactId() < 1) {
 218                         // Throw again ...
 219                         throw new NullPointerException(MessageFormat.format("event.contact.contactId={0} is invalid", event.getContact().getContactId())); //NOI18N
 220                 } else if (event.getContact().getContactFaxNumber() == null) {
 221                         // Throw again ...
 222                         throw new NullPointerException("event.contact.contactFaxNumber is null"); //NOI18N
 223                 } else if (event.getContact().getContactFaxNumber().getPhoneId() == null) {
 224                         // Throw again ...
 225                         throw new NullPointerException("event.contact.contactFaxNumber.phoneId is null"); //NOI18N
 226                 } else if (event.getContact().getContactFaxNumber().getPhoneId() < 1) {
 227                         // Throw again ...
 228                         throw new NullPointerException(MessageFormat.format("event.contact.contactFaxNumber.phoneId={0} is invalid", event.getContact().getContactFaxNumber().getPhoneId())); //NOI18N
 229                 } else if (event.getLinkedFaxNumber() == null) {
 230                         // Throw again ...
 231                         throw new NullPointerException("event.linkedFaxNumer is null"); //NOI18N
 232                 }
 233
 234                 // Is the id number in linked number not set?
 235                 if (event.getLinkedFaxNumber().getPhoneId() == null) {
 236                         // Then it is a new number, so add it from contact as there the id number has been set
 237                         this.uniqueAddFaxNumber(event.getContact().getContactFaxNumber());
 238                 }
 239         }
 240
 241         /**
 242          * Observes events being fired when an administrator has a linked a
 243          * land-line number
 244          * <p>
 245          * @param event Event being fired
 246          */
 247         public void afterAdminLinkedLandLineNumberEvent (@Observes final ObservableAdminLinkedLandLineNumberEvent event) {
 248                 // Is the event fine?
 249                 if (event == null) {
 250                         // Throw NPE
 251                         throw new NullPointerException("event is null"); //NOI18N
 252                 } else if (event.getContact() == null) {
 253                         // Throw again ...
 254                         throw new NullPointerException("event.contact is null"); //NOI18N
 255                 } else if (event.getContact().getContactId() == null) {
 256                         // Throw again ...
 257                         throw new NullPointerException("event.contact.contactId is null"); //NOI18N
 258                 } else if (event.getContact().getContactId() < 1) {
 259                         // Throw again ...
 260                         throw new NullPointerException(MessageFormat.format("event.contact.contactId={0} is invalid", event.getContact().getContactId())); //NOI18N
 261                 } else if (event.getContact().getContactLandLineNumber() == null) {
 262                         // Throw again ...
 263                         throw new NullPointerException("event.contact.contactLandLineNumber is null"); //NOI18N
 264                 } else if (event.getContact().getContactLandLineNumber().getPhoneId() == null) {
 265                         // Throw again ...
 266                         throw new NullPointerException("event.contact.contactLandLineNumber.phoneId is null"); //NOI18N
 267                 } else if (event.getContact().getContactLandLineNumber().getPhoneId() < 1) {
 268                         // Throw again ...
 269                         throw new NullPointerException(MessageFormat.format("event.contact.contactLandLineNumber.phoneId={0} is invalid", event.getContact().getContactLandLineNumber().getPhoneId())); //NOI18N
 270                 } else if (event.getLinkedLandLineNumber() == null) {
 271                         // Throw again ...
 272                         throw new NullPointerException("event.linkedLandLineNumer is null"); //NOI18N
 273                 }
 274
 275                 // Is the id number in linked number not set?
 276                 if (event.getLinkedLandLineNumber().getPhoneId() == null) {
 277                         // Then it is a new number, so add it from contact as there the id number has been set
 278                         this.uniqueAddLandLineNumber(event.getContact().getContactLandLineNumber());
 279                 }
 280         }
 281
 282         /**
 283          * Observes events being fired when an administrator has updated contact
 284          * data.
 285          * <p>
 286          * @param event Event being fired
 287          */
 288         public void afterAdminUpdatedContactDataEvent (@Observes final ObservableAdminUpdatedContactEvent event) {
 289                 // Event and contained entity instance should not be null
 290                 if (null == event) {
 291                         // Throw NPE
 292                         throw new NullPointerException("event is null"); //NOI18N
 293                 } else if (event.getUpdatedContact() == null) {
 294                         // Throw NPE again
 295                         throw new NullPointerException("event.updatedContact is null"); //NOI18N
 296                 } else if (event.getUpdatedContact().getContactId() == null) {
 297                         // phoneId is null
 298                         throw new NullPointerException("event.updatedContact.contactId is null"); //NOI18N
 299                 } else if (event.getUpdatedContact().getContactId() < 1) {
 300                         // Not avalid id
 301                         throw new IllegalArgumentException(MessageFormat.format("contactId of contact={0} is not valid: {1}", event.getUpdatedContact(), event.getUpdatedContact().getContactId())); //NOI18N
 302                 }
 303
 304                 // Update contact's mobile, land-line and fax number
 305                 this.updateContactPhoneNumbers(event.getUpdatedContact());
 306
 307                 // Clear all data
 308                 this.clear();
 309         }
 310
 311         /**
 312          * Observes events being fired when an administrator has updated a fax
 313          * number.
 314          * <p>
 315          * @param event Event being fired
 316          */
 317         public void afterAdminUpdatedFaxNumberEvent (@Observes final AdminUpdatedFaxNumberEvent event) {
 318                 // Event and contained entity instance should not be null
 319                 if (null == event) {
 320                         // Throw NPE
 321                         throw new NullPointerException("event is null"); //NOI18N
 322                 } else if (event.getUpdatedFaxNumber() == null) {
 323                         // Throw NPE again
 324                         throw new NullPointerException("event.updatedFaxNumber is null"); //NOI18N
 325                 } else if (event.getUpdatedFaxNumber().getPhoneId() == null) {
 326                         // phoneId is null
 327                         throw new NullPointerException("event.updatedFaxNumber.phoneId is null"); //NOI18N
 328                 } else if (event.getUpdatedFaxNumber().getPhoneId() < 1) {
 329                         // Not avalid id
 330                         throw new IllegalArgumentException(MessageFormat.format("phoneId of contact={0} is not valid: {1}", event.getUpdatedFaxNumber(), event.getUpdatedFaxNumber().getPhoneId())); //NOI18N
 331                 }
 332
 333                 // Uniquely add it
 334                 this.uniqueAddFaxNumber(event.getUpdatedFaxNumber());
 335
 336                 // Clear it
 337                 this.clear();
 338         }
 339
 340         /**
 341          * Observes events being fired when an administrator has updated a land-line
 342          * number.
 343          * <p>
 344          * @param event Event being fired
 345          */
 346         public void afterAdminUpdatedLandLineNumberEvent (@Observes final AdminUpdatedLandLineNumberEvent event) {
 347                 // Event and contained entity instance should not be null
 348                 if (null == event) {
 349                         // Throw NPE
 350                         throw new NullPointerException("event is null"); //NOI18N
 351                 } else if (event.getUpdatedLandLineNumber() == null) {
 352                         // Throw NPE again
 353                         throw new NullPointerException("event.updatedLandLineNumber is null"); //NOI18N
 354                 } else if (event.getUpdatedLandLineNumber().getPhoneId() == null) {
 355                         // phoneId is null
 356                         throw new NullPointerException("event.updatedLandLineNumber.phoneId is null"); //NOI18N
 357                 } else if (event.getUpdatedLandLineNumber().getPhoneId() < 1) {
 358                         // Not avalid id
 359                         throw new IllegalArgumentException(MessageFormat.format("phoneId of contact={0} is not valid: {1}", event.getUpdatedLandLineNumber(), event.getUpdatedLandLineNumber().getPhoneId())); //NOI18N
 360                 }
 361
 362                 // Uniquely add it
 363                 this.uniqueAddLandLineNumber(event.getUpdatedLandLineNumber());
 364
 365                 // Clear it
 366                 this.clear();
 367         }
 368
 369         @Override
 370         public DialableFaxNumber findFaxNumberById (final Long phoneId) throws PhoneEntityNotFoundException {
 371                 // Validate paramter
 372                 if (null == phoneId) {
 373                         // Throw NPE
 374                         throw new NullPointerException("phoneId is null"); //NOI18N
 375                 } else if (phoneId < 1) {
 376                         // Throw IAE
 377                         throw new IllegalArgumentException("phoneId=" + phoneId + " is invalid."); //NOI18N
 378                 } else if (!this.faxNumberCache.containsKey(phoneId)) {
 379                         // Not found
 380                         throw new PhoneEntityNotFoundException(phoneId);
 381                 }
 382
 383                 // Get it from cache
 384                 final DialableFaxNumber faxNumber = this.faxNumberCache.get(phoneId);
 385
 386                 // Return it
 387                 return faxNumber;
 388         }
 389
 390         @Override
 391         public DialableLandLineNumber findLandLineNumberById (final Long landLineNumberId) throws PhoneEntityNotFoundException {
 392                 // Validate paramter
 393                 if (null == landLineNumberId) {
 394                         // Throw NPE
 395                         throw new NullPointerException("landLineNumberId is null"); //NOI18N
 396                 } else if (landLineNumberId < 1) {
 397                         // Throw IAE
 398                         throw new IllegalArgumentException(MessageFormat.format("landLineNumberId={0} is invalid.", landLineNumberId)); //NOI18N
 399                 } else if (!this.landLineNumberCache.containsKey(landLineNumberId)) {
 400                         // Not found
 401                         throw new PhoneEntityNotFoundException(landLineNumberId);
 402                 }
 403
 404                 // Get it from cache
 405                 final DialableLandLineNumber landLineNumber = this.landLineNumberCache.get(landLineNumberId);
 406
 407                 // Return it
 408                 return landLineNumber;
 409         }
 410
 411         @Override
 412         @SuppressWarnings ("ReturnOfCollectionOrArrayField")
 413         public List<DialableFaxNumber> getAllFaxNumbers () {
 414                 return this.allFaxNumbers;
 415         }
 416
 417         @Override
 418         @SuppressWarnings ("ReturnOfCollectionOrArrayField")
 419         public List<DialableLandLineNumber> getAllLandLineNumbers () {
 420                 return this.allLandLineNumbers;
 421         }
 422
 423         /**
 424          * Getter for filtered fax number list
 425          * <p>
 426          * @return Filtered fax number list
 427          */
 428         @SuppressWarnings ("ReturnOfCollectionOrArrayField")
 429         public List<DialableFaxNumber> getFilteredFaxNumbers () {
 430                 return this.filteredFaxNumbers;
 431         }
 432
 433         /**
 434          * Setter for filtered fax number list
 435          *
 436          * @param filteredFaxNumbers Filtered fax number list
 437          */
 438         @SuppressWarnings ("AssignmentToCollectionOrArrayFieldFromParameter")
 439         public void setFilteredFaxNumbers (final List<DialableFaxNumber> filteredFaxNumbers) {
 440                 this.filteredFaxNumbers = filteredFaxNumbers;
 441         }
 442
 443         /**
 444          * Getter for filtered land-line number list
 445          * <p>
 446          * @return Filtered land-line number list
 447          */
 448         @SuppressWarnings ("ReturnOfCollectionOrArrayField")
 449         public List<DialableLandLineNumber> getFilteredLandLineNumbers () {
 450                 return this.filteredLandLineNumbers;
 451         }
 452
 453         /**
 454          * Setter for filtered land-line number list
 455          *
 456          * @param filteredLandLineNumbers Filtered land-line number list
 457          */
 458         @SuppressWarnings ("AssignmentToCollectionOrArrayFieldFromParameter")
 459         public void setFilteredLandLineNumbers (final List<DialableLandLineNumber> filteredLandLineNumbers) {
 460                 this.filteredLandLineNumbers = filteredLandLineNumbers;
 461         }
 462
 463         /**
 464          * Post-construction method
 465          */
 466         @PostConstruct
 467         public void initializeList () {
 468                 // Is cache there?
 469                 if (!this.faxNumberCache.iterator().hasNext()) {
 470                         // Add all
 471                         for (final DialableFaxNumber currentNumber : this.phoneBean.fetchAllFaxNumbers()) {
 472                                 // Add it to cache
 473                                 this.faxNumberCache.put(currentNumber.getPhoneId(), currentNumber);
 474                         }
 475                 }
 476
 477                 // Is cache there?
 478                 if (!this.landLineNumberCache.iterator().hasNext()) {
 479                         // Add all
 480                         for (final DialableLandLineNumber currentNumber : this.phoneBean.fetchAllLandLineNumbers()) {
 481                                 // Add it to cache
 482                                 this.landLineNumberCache.put(currentNumber.getPhoneId(), currentNumber);
 483                         }
 484                 }
 485
 486                 // Is cache filled and list is empty
 487                 if ((this.faxNumberCache.iterator().hasNext()) && (this.getAllFaxNumbers().isEmpty())) {
 488                         // Build up list
 489                         for (final Cache.Entry<Long, DialableFaxNumber> currentEntry : this.faxNumberCache) {
 490                                 // Add to list
 491                                 this.getAllFaxNumbers().add(currentEntry.getValue());
 492                         }
 493
 494                         // Sort list
 495                         this.getAllFaxNumbers().sort(new Comparator<DialableFaxNumber>() {
 496                                 @Override
 497                                 public int compare (final DialableFaxNumber faxNumber1, final DialableFaxNumber faxNumber2) {
 498                                         return faxNumber1.getPhoneId() > faxNumber2.getPhoneId() ? 1 : faxNumber1.getPhoneId() < faxNumber2.getPhoneId() ? -1 : 0;
 499                                 }
 500                         });
 501
 502                         // Set full list
 503                         this.setFilteredFaxNumbers(this.getAllFaxNumbers());
 504                 }
 505
 506                 // Is cache filled and list is empty
 507                 if ((this.landLineNumberCache.iterator().hasNext()) && (this.getAllLandLineNumbers().isEmpty())) {
 508                         // Build up list
 509                         for (final Cache.Entry<Long, DialableLandLineNumber> currentEntry : this.landLineNumberCache) {
 510                                 // Add to list
 511                                 this.getAllLandLineNumbers().add(currentEntry.getValue());
 512                         }
 513
 514                         // Sort list
 515                         this.getAllLandLineNumbers().sort(new Comparator<DialableLandLineNumber>() {
 516                                 @Override
 517                                 public int compare (final DialableLandLineNumber landLineNumber1, final DialableLandLineNumber landLineNumber2) {
 518                                         return landLineNumber1.getPhoneId() > landLineNumber2.getPhoneId() ? 1 : landLineNumber1.getPhoneId() < landLineNumber2.getPhoneId() ? -1 : 0;
 519                                 }
 520                         });
 521
 522                         // Set full list
 523                         this.setFilteredLandLineNumbers(this.getAllLandLineNumbers());
 524                 }
 525         }
 526
 527         /**
 528          * Clears this bean
 529          */
 530         private void clear () {
 531                 // Clear all data
 532         }
 533
 534         /**
 535          * Uniquely add given fax number to this bean's list. First remove the old
 536          * instance (by id number), then re-add it again.
 537          * <p>
 538          * @param faxNumber number to add
 539          */
 540         private void uniqueAddFaxNumber (final DialableFaxNumber faxNumber) {
 541                 // Make sure the parameter is valid
 542                 if (null == faxNumber) {
 543                         // Throw NPE
 544                         throw new NullPointerException("faxNumber is null"); //NOI18N
 545                 } else if (faxNumber.getPhoneId() == null) {
 546                         // Throw again ...
 547                         throw new NullPointerException("faxNumber.phoneId is null"); //NOI18N
 548                 } else if (faxNumber.getPhoneId() < 1) {
 549                         // Not valid
 550                         throw new IllegalArgumentException(MessageFormat.format("faxNumber.phoneId={0} is not valid.", faxNumber.getPhoneId())); //NOI18N
 551                 }
 552
 553                 // First remove it
 554                 if (!this.getAllFaxNumbers().remove(faxNumber)) {
 555                         // Did not work, try by id number
 556                         for (final DialableFaxNumber currentNumber : this.getAllFaxNumbers()) {
 557                                 // Is id number the same?
 558                                 if (Objects.equals(currentNumber.getPhoneId(), faxNumber.getPhoneId())) {
 559                                         // Found it
 560                                         this.getAllFaxNumbers().remove(currentNumber);
 561                                         break;
 562                                 }
 563                         }
 564                 }
 565
 566                 // ... then add it
 567                 this.getAllFaxNumbers().add(faxNumber);
 568         }
 569
 570         /**
 571          * Uniquely add given land-line number to this bean's list. First remove the
 572          * old instance (by id number), then re-add it again.
 573          * <p>
 574          * @param landLineNumber Land-line number to add
 575          */
 576         private void uniqueAddLandLineNumber (final DialableLandLineNumber landLineNumber) {
 577                 // Make sure the parameter is valid
 578                 if (null == landLineNumber) {
 579                         // Throw NPE
 580                         throw new NullPointerException("landLineNumber is null"); //NOI18N
 581                 } else if (landLineNumber.getPhoneId() == null) {
 582                         // Throw again ...
 583                         throw new NullPointerException("landLineNumber.phoneId is null"); //NOI18N
 584                 } else if (landLineNumber.getPhoneId() < 1) {
 585                         // Not valid
 586                         throw new IllegalArgumentException(MessageFormat.format("landLineNumber.phoneId={0} is not valid.", landLineNumber.getPhoneId())); //NOI18N
 587                 }
 588
 589                 // First remove it
 590                 if (!this.getAllLandLineNumbers().remove(landLineNumber)) {
 591                         // Did not work, try by id number
 592                         for (final DialableLandLineNumber currentNumber : this.getAllLandLineNumbers()) {
 593                                 // Is id number the same?
 594                                 if (Objects.equals(currentNumber.getPhoneId(), landLineNumber.getPhoneId())) {
 595                                         // Found it
 596                                         this.getAllLandLineNumbers().remove(currentNumber);
 597                                         break;
 598                                 }
 599                         }
 600                 }
 601
 602                 // ... then add it
 603                 this.getAllLandLineNumbers().add(landLineNumber);
 604         }
 605
 606         /**
 607          * Updates given contact's mobile, land-line and fax number
 608          * <p>
 609          * @param contact Contact instance
 610          */
 611         private void updateContactPhoneNumbers (final Contact contact) {
 612                 // Parameter must be valid
 613                 if (null == contact) {
 614                         // Throw NPE
 615                         throw new NullPointerException("contact is null"); //NOI18N
 616                 } else if (contact.getContactId() == null) {
 617                         // Throw again
 618                         throw new NullPointerException("contact.contactId is null"); //NOI18N
 619                 } else if (contact.getContactId() < 1) {
 620                         // Id number is not valid
 621                 }
 622
 623                 // Is land-line set?
 624                 if (contact.getContactLandLineNumber() instanceof DialableLandLineNumber) {
 625                         // Unique-add it
 626                         this.uniqueAddLandLineNumber(contact.getContactLandLineNumber());
 627                 }
 628
 629                 // Is fax set?
 630                 if (contact.getContactFaxNumber() instanceof DialableFaxNumber) {
 631                         // Unique-add it
 632                         this.uniqueAddFaxNumber(contact.getContactFaxNumber());
 633                 }
 634         }
 635
 636 }