2 * Copyright (C) 2016 Roland Haeder
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.
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.
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/>.
17 package org.mxchange.addressbook.beans.contact;
19 import java.text.MessageFormat;
20 import java.util.Date;
21 import java.util.Iterator;
22 import javax.annotation.PostConstruct;
23 import javax.enterprise.context.RequestScoped;
24 import javax.enterprise.event.Event;
25 import javax.enterprise.inject.Any;
26 import javax.faces.context.FacesContext;
27 import javax.faces.view.facelets.FaceletException;
28 import javax.inject.Inject;
29 import javax.inject.Named;
30 import javax.naming.Context;
31 import javax.naming.InitialContext;
32 import javax.naming.NamingException;
33 import org.mxchange.addressbook.beans.BaseAddressbookController;
34 import org.mxchange.addressbook.beans.helper.AddressbookWebRequestController;
35 import org.mxchange.jcontacts.contact.Contact;
36 import org.mxchange.jcontacts.contact.ContactSessionBeanRemote;
37 import org.mxchange.jcontacts.contact.UserContact;
38 import org.mxchange.jcontacts.contact.gender.Gender;
39 import org.mxchange.jcontacts.contact.utils.ContactUtils;
40 import org.mxchange.jcontacts.events.contact.add.AdminAddedContactEvent;
41 import org.mxchange.jcontacts.events.contact.add.AdminContactAddedEvent;
42 import org.mxchange.jcontacts.events.contact.update.AdminContactUpdatedEvent;
43 import org.mxchange.jcontacts.events.contact.update.AdminUpdatedContactEvent;
44 import org.mxchange.jcontacts.exceptions.ContactAlreadyAddedException;
45 import org.mxchange.jcountry.data.Country;
46 import org.mxchange.jphone.phonenumbers.DialableNumber;
47 import org.mxchange.jphone.phonenumbers.cellphone.CellphoneNumber;
48 import org.mxchange.jphone.phonenumbers.cellphone.DialableCellphoneNumber;
49 import org.mxchange.jphone.phonenumbers.fax.DialableFaxNumber;
50 import org.mxchange.jphone.phonenumbers.fax.FaxNumber;
51 import org.mxchange.jphone.phonenumbers.landline.DialableLandLineNumber;
52 import org.mxchange.jphone.phonenumbers.landline.LandLineNumber;
53 import org.mxchange.jphone.phonenumbers.mobileprovider.MobileProvider;
56 * An administrative user bean (controller)
58 * @author Roland Haeder<roland@mxchange.org>
60 @Named ("adminContactController")
62 public class AddressbookAdminContactWebRequestBean extends BaseAddressbookController implements AddressbookAdminContactWebRequestController {
67 private static final long serialVersionUID = 542_145_347_916L;
70 * An event fired when the administrator has added a new contact
74 private Event<AdminAddedContactEvent> addedContactEvent;
77 * Admin helper instance
80 private AddressbookWebRequestController beanHelper;
85 private Date birthday;
88 * Cellphone number's carrier
90 private MobileProvider cellphoneCarrier;
95 private Long cellphoneId;
100 private Long cellphoneNumber;
110 private String comment;
113 * Remote contact bean
115 private final ContactSessionBeanRemote contactBean;
118 * General contact controller
121 private AddressbookContactWebSessionController contactController;
126 private Long contactId;
131 private Country country;
136 private String emailAddress;
141 private String familyName;
144 * Fax number's area code
146 private Integer faxAreaCode;
149 * Country instance for fax number
151 private Country faxCountry;
161 private Long faxNumber;
166 private String firstName;
171 private Gender gender;
176 private Short houseNumber;
179 * Whether a cellphone entry has been unlinked
181 private boolean isCellphoneUnlinked;
184 * Whether a fax entry has been unlinked
186 private boolean isFaxUnlinked;
189 * Whether a land-line number has been unlinked
191 private boolean isLandLineUnlinked;
194 * Land-line id number
196 private Long landLineId;
199 * Phone number area code
201 private Integer phoneAreaCode;
204 * Country instance for phone number
206 private Country phoneCountry;
211 private Long phoneNumber;
216 private String street;
221 private String title;
224 * An event fired when the administrator has updated contact data
228 private Event<AdminUpdatedContactEvent> updatedContactEvent;
233 private Integer zipCode;
236 * Default constructor
238 public AddressbookAdminContactWebRequestBean () {
241 // Get initial context
242 Context context = new InitialContext();
245 this.contactBean = (ContactSessionBeanRemote) context.lookup("java:global/addressbook-ejb/contact!org.mxchange.jcontacts.contact.ContactSessionBeanRemote"); //NOI18N
246 } catch (final NamingException e) {
248 throw new FaceletException(e);
253 public String addContact () {
254 // Are all minimum fields set?
255 if (this.getGender() == null) {
257 throw new NullPointerException("gender is null"); //NOI18N
258 } else if (this.getFirstName() == null) {
260 throw new NullPointerException("firstName is null"); //NOI18N
261 } else if (this.getFirstName().isEmpty()) {
263 throw new IllegalStateException("firstName is empty"); //NOI18N
264 } else if (this.getFamilyName() == null) {
266 throw new NullPointerException("familyName is null"); //NOI18N
267 } else if (this.getFamilyName().isEmpty()) {
269 throw new IllegalStateException("familyName is empty"); //NOI18N
272 // Create new contact instance
273 Contact contact = this.createContactInstance();
275 // Default is not same contact
276 if (this.isSameContactFound(contact)) {
277 // Already registered
278 throw new FaceletException(new ContactAlreadyAddedException(contact));
282 Contact updatedContact;
287 updatedContact = this.contactBean.addContact(contact);
288 } catch (final ContactAlreadyAddedException ex) {
290 throw new FaceletException(ex);
294 this.addedContactEvent.fire(new AdminContactAddedEvent(updatedContact));
300 return "admin_list_contact"; //NOI18N
304 public void copyContactToController (final Contact contact) {
305 // The contact instance must be valid
306 if (null == contact) {
308 throw new NullPointerException("contact is null"); //NOI18N
309 } else if (contact.getContactId() == null) {
311 throw new NullPointerException("contact.contactId is null"); //NOI18N //NOI18N
312 } else if (contact.getContactId() < 1) {
314 throw new IllegalStateException(MessageFormat.format("contact.contactId={0} is not valid.", contact.getContactId())); //NOI18N
317 // Set all fields: contact
318 this.setContactId(contact.getContactId());
319 this.setTitle(contact.getContactTitle());
320 this.setBirthday(contact.getContactBirthday());
321 this.setCity(contact.getContactCity());
322 this.setComment(contact.getContactComment());
323 this.setCountry(contact.getContactCountry());
324 this.setEmailAddress(contact.getContactEmailAddress());
325 this.setFamilyName(contact.getContactFamilyName());
326 this.setFirstName(contact.getContactFirstName());
327 this.setGender(contact.getContactGender());
328 this.setHouseNumber(contact.getContactHouseNumber());
329 this.setStreet(contact.getContactStreet());
330 this.setZipCode(contact.getContactZipCode());
332 // ... cellphone data
333 if (contact.getContactCellphoneNumber() instanceof DialableCellphoneNumber) {
334 this.setCellphoneId(contact.getContactCellphoneNumber().getPhoneId());
335 this.setCellphoneCarrier(contact.getContactCellphoneNumber().getCellphoneProvider());
336 this.setCellphoneNumber(contact.getContactCellphoneNumber().getPhoneNumber());
340 if (contact.getContactFaxNumber() instanceof DialableFaxNumber) {
341 this.setFaxId(contact.getContactFaxNumber().getPhoneId());
342 this.setFaxAreaCode(contact.getContactFaxNumber().getPhoneAreaCode());
343 this.setFaxCountry(contact.getContactFaxNumber().getPhoneCountry());
344 this.setFaxNumber(contact.getContactFaxNumber().getPhoneNumber());
348 if (contact.getContactLandLineNumber() instanceof DialableLandLineNumber) {
349 this.setLandLineId(contact.getContactLandLineNumber().getPhoneId());
350 this.setPhoneAreaCode(contact.getContactLandLineNumber().getPhoneAreaCode());
351 this.setPhoneCountry(contact.getContactLandLineNumber().getPhoneCountry());
352 this.setPhoneNumber(contact.getContactLandLineNumber().getPhoneNumber());
357 public Contact createContactInstance () {
358 // Generate phone number
359 DialableLandLineNumber phone = new LandLineNumber(this.getPhoneCountry(), this.getPhoneAreaCode(), this.getPhoneNumber());
360 DialableCellphoneNumber cellphone = new CellphoneNumber(this.getCellphoneCarrier(), this.getCellphoneNumber());
361 DialableFaxNumber fax = new FaxNumber(this.getFaxCountry(), this.getFaxAreaCode(), this.getFaxNumber());
363 // Create new instance
364 Contact contact = new UserContact(this.getGender(), this.getFirstName(), this.getFamilyName());
366 // Check if contact instance is in helper and valid
367 if (null == contact) {
369 throw new NullPointerException("beanHelper.contact is null"); //NOI18N
370 } else if (contact.getContactId() == null) {
372 throw new NullPointerException("beanHelper.contact.contactId is null"); //NOI18N //NOI18N
373 } else if (contact.getContactId() < 1) {
375 throw new IllegalStateException(MessageFormat.format("beanHelper.contact.contactId={0} is invalid", contact.getContactId())); //NOI18N
378 // Update all data in contact
379 this.updateContactData(contact);
381 // Call EJB for updating contact data
382 Contact updatedContact = this.contactBean.updateContactData(contact, this.isCellphoneUnlinked, this.isLandLineUnlinked, this.isFaxUnlinked);
385 this.updatedContactEvent.fire(new AdminContactUpdatedEvent(updatedContact));
395 public String editContactData () {
396 // Get contact instance
397 Contact contact = this.beanHelper.getContact();
399 // Check if contact instance is in helper and valid
400 if (null == contact) {
402 throw new NullPointerException("beanHelper.contact is null"); //NOI18N
403 } else if (contact.getContactId() == null) {
405 throw new NullPointerException("beanHelper.contact.contactId is null"); //NOI18N //NOI18N
406 } else if (contact.getContactId() < 1) {
408 throw new IllegalStateException(MessageFormat.format("beanHelper.contact.contactId={0} is invalid", contact.getContactId())); //NOI18N
411 // Update all data in contact
412 this.updateContactData(contact);
414 // Call EJB for updating contact data
415 Contact updatedContact = this.contactBean.updateContactData(contact, this.isCellphoneUnlinked, this.isLandLineUnlinked, this.isFaxUnlinked);
418 this.updatedContactEvent.fire(new AdminContactUpdatedEvent(updatedContact));
423 // Return to contact list (for now)
424 return "admin_list_contact"; //NOI18N
428 public String generateCellphoneNumber (final DialableCellphoneNumber cellphoneNumber) {
430 if (null == cellphoneNumber) {
436 String number = String.format(
438 cellphoneNumber.getCellphoneProvider().getProviderCountry().getCountryExternalDialPrefix(),
439 cellphoneNumber.getCellphoneProvider().getProviderDialPrefix(),
440 cellphoneNumber.getPhoneNumber()
448 public String generatePhoneNumber (final DialableNumber phoneNumber) {
450 if (null == phoneNumber) {
456 String number = String.format(
458 phoneNumber.getPhoneCountry().getCountryExternalDialPrefix(),
459 phoneNumber.getPhoneAreaCode(),
460 phoneNumber.getPhoneNumber()
468 @SuppressWarnings ("ReturnOfDateField")
469 public Date getBirthday () {
470 return this.birthday;
474 @SuppressWarnings ("AssignmentToDateFieldFromParameter")
475 public void setBirthday (final Date birthday) {
476 this.birthday = birthday;
480 public MobileProvider getCellphoneCarrier () {
481 return this.cellphoneCarrier;
485 public void setCellphoneCarrier (final MobileProvider cellphoneCarrier) {
486 this.cellphoneCarrier = cellphoneCarrier;
490 public Long getCellphoneId () {
491 return this.cellphoneId;
495 public void setCellphoneId (final Long cellphoneId) {
496 this.cellphoneId = cellphoneId;
500 public Long getCellphoneNumber () {
501 return this.cellphoneNumber;
505 public void setCellphoneNumber (Long cellphoneNumber) {
506 this.cellphoneNumber = cellphoneNumber;
510 public String getCity () {
515 public void setCity (final String city) {
520 public String getComment () {
525 public void setComment (final String comment) {
526 this.comment = comment;
530 public Long getContactId () {
531 return this.contactId;
535 public void setContactId (final Long contactId) {
536 this.contactId = contactId;
540 public Country getCountry () {
545 public void setCountry (final Country country) {
546 this.country = country;
550 public String getEmailAddress () {
551 return this.emailAddress;
555 public void setEmailAddress (final String emailAddress) {
556 this.emailAddress = emailAddress;
560 public String getFamilyName () {
561 return this.familyName;
565 public void setFamilyName (final String familyName) {
566 this.familyName = familyName;
570 public Integer getFaxAreaCode () {
571 return this.faxAreaCode;
575 public void setFaxAreaCode (final Integer faxAreaCode) {
576 this.faxAreaCode = faxAreaCode;
580 public Country getFaxCountry () {
581 return this.faxCountry;
585 public void setFaxCountry (final Country faxCountry) {
586 this.faxCountry = faxCountry;
590 public Long getFaxId () {
595 public void setFaxId (final Long faxId) {
600 public Long getFaxNumber () {
601 return this.faxNumber;
605 public void setFaxNumber (final Long faxNumber) {
606 this.faxNumber = faxNumber;
610 public String getFirstName () {
611 return this.firstName;
615 public void setFirstName (final String firstName) {
616 this.firstName = firstName;
620 public Gender getGender () {
625 public void setGender (final Gender gender) {
626 this.gender = gender;
630 public Short getHouseNumber () {
631 return this.houseNumber;
635 public void setHouseNumber (final Short houseNumber) {
636 this.houseNumber = houseNumber;
640 public Long getLandLineId () {
641 return this.landLineId;
645 public void setLandLineId (final Long landLineId) {
646 this.landLineId = landLineId;
650 public Integer getPhoneAreaCode () {
651 return this.phoneAreaCode;
655 public void setPhoneAreaCode (final Integer phoneAreaCode) {
656 this.phoneAreaCode = phoneAreaCode;
660 public Country getPhoneCountry () {
661 return this.phoneCountry;
665 public void setPhoneCountry (final Country phoneCountry) {
666 this.phoneCountry = phoneCountry;
670 public Long getPhoneNumber () {
671 return this.phoneNumber;
675 public void setPhoneNumber (final Long phoneNumber) {
676 this.phoneNumber = phoneNumber;
680 public String getStreet () {
685 public void setStreet (final String street) {
686 this.street = street;
690 public String getTitle () {
695 public void setTitle (final String title) {
700 public Integer getZipCode () {
705 public void setZipCode (final Integer zipCode) {
706 this.zipCode = zipCode;
710 * Post-initialization of this class
713 public void init () {
717 public boolean isGenderRequired () {
718 // Get context parameter
719 String contextParameter = FacesContext.getCurrentInstance().getExternalContext().getInitParameter("is_admin_gender_enabled"); //NOI18N
722 boolean isRequired = ((contextParameter instanceof String) && (contextParameter.toLowerCase().equals("true"))); //NOI18N
731 private void clear () {
734 this.setGender(Gender.UNKNOWN);
736 this.setFirstName(null);
737 this.setFamilyName(null);
738 this.setStreet(null);
739 this.setHouseNumber(null);
740 this.setZipCode(null);
742 this.setCountry(null);
745 this.setEmailAddress(null);
746 this.setPhoneCountry(null);
747 this.setPhoneAreaCode(null);
748 this.setPhoneNumber(null);
749 this.setCellphoneCarrier(null);
750 this.setCellphoneNumber(null);
751 this.setFaxCountry(null);
752 this.setFaxAreaCode(null);
753 this.setFaxNumber(null);
756 this.setBirthday(null);
757 this.setComment(null);
761 * Checks whether the given contact is found
763 * @param contact Contact inastance
765 * @return Wether contact has been found
767 private boolean isSameContactFound (final Contact contact) {
768 // Default is not found
769 boolean IsFound = false;
772 Iterator<Contact> iterator = this.contactController.allContacts().iterator();
775 while (iterator.hasNext()) {
777 Contact next = iterator.next();
780 if (ContactUtils.isSameContact(contact, next)) {
781 // Yes, then abort loop
792 * Updates all data in contact instance.
794 * @param contact Contact instance
796 private void updateContactData (final Contact contact) {
797 // Contact instance should be valid
798 if (null == contact) {
800 throw new NullPointerException("contact is null"); //NOI18N
801 } else if (contact.getContactId() == null) {
803 throw new NullPointerException("contact.contactId is null"); //NOI18N //NOI18N
804 } else if (contact.getContactId() < 1) {
806 throw new IllegalStateException(MessageFormat.format("contact.contactId={0} is invalid", contact.getContactId())); //NOI18N
810 contact.setContactGender(this.getGender());
811 contact.setContactTitle(this.getTitle());
812 contact.setContactFirstName(this.getFirstName());
813 contact.setContactFamilyName(this.getFamilyName());
814 contact.setContactStreet(this.getStreet());
815 contact.setContactHouseNumber(this.getHouseNumber());
816 contact.setContactZipCode(this.getZipCode());
817 contact.setContactCity(this.getCity());
818 contact.setContactCountry(this.getCountry());
820 // Update contact's cellphone number
821 this.isCellphoneUnlinked = ContactUtils.updateCellPhoneNumber(contact, this.getCellphoneCarrier(), this.getCellphoneNumber());
823 // Update contact's land-line number
824 this.isLandLineUnlinked = ContactUtils.updateLandLineNumber(contact, this.getPhoneCountry(), this.getPhoneAreaCode(), this.getPhoneNumber());
826 // Update contact's fax number
827 this.isFaxUnlinked = ContactUtils.updateFaxNumber(contact, this.getFaxCountry(), this.getFaxAreaCode(), this.getFaxNumber());