]> git.mxchange.org Git - jjobs-war.git/blob - src/java/org/mxchange/jjobs/beans/contact/JobsContactWebRequestBean.java
Please cherry-pick:
[jjobs-war.git] / src / java / org / mxchange / jjobs / beans / contact / JobsContactWebRequestBean.java
1 /*
2  * Copyright (C) 2016 - 2022 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.contact;
18
19 import java.text.MessageFormat;
20 import java.util.Date;
21 import java.util.Objects;
22 import javax.ejb.EJB;
23 import javax.enterprise.context.RequestScoped;
24 import javax.enterprise.event.Event;
25 import javax.enterprise.event.Observes;
26 import javax.enterprise.inject.Any;
27 import javax.faces.FacesException;
28 import javax.faces.application.FacesMessage;
29 import javax.inject.Inject;
30 import javax.inject.Named;
31 import org.mxchange.jcontacts.events.contact.update.ObservableUpdatedContactEvent;
32 import org.mxchange.jcontacts.events.contact.update.UpdatedContactEvent;
33 import org.mxchange.jcontacts.exceptions.ContactNotFoundException;
34 import org.mxchange.jcontacts.model.contact.Contact;
35 import org.mxchange.jcontacts.model.contact.ContactSessionBeanRemote;
36 import org.mxchange.jcontacts.model.utils.ContactUtils;
37 import org.mxchange.jcontacts.model.contact.UserContact;
38 import org.mxchange.jcontacts.model.contact.title.PersonalTitle;
39 import org.mxchange.jcountry.model.data.Country;
40 import org.mxchange.jjobs.beans.BaseJobsBean;
41 import org.mxchange.jjobs.beans.contact.list.JobsContactListWebViewController;
42 import org.mxchange.jjobs.beans.user.login.JobsUserLoginWebSessionController;
43 import org.mxchange.jphone.model.phonenumbers.fax.DialableFaxNumber;
44 import org.mxchange.jphone.model.phonenumbers.fax.FaxNumber;
45 import org.mxchange.jphone.model.phonenumbers.landline.DialableLandLineNumber;
46 import org.mxchange.jphone.model.phonenumbers.landline.LandLineNumber;
47 import org.mxchange.jphone.model.phonenumbers.mobile.DialableMobileNumber;
48 import org.mxchange.jphone.model.phonenumbers.mobile.MobileNumber;
49 import org.mxchange.jphone.model.phonenumbers.mobileprovider.MobileProvider;
50 import org.mxchange.jusercore.events.user.add.ObservableAdminAddedUserEvent;
51 import org.mxchange.jusercore.events.user.linked.ObservableAdminLinkedUserEvent;
52 import org.mxchange.jusercore.events.user.update.pre.ObservablePreUserPersonalDataUpdatedEvent;
53 import org.mxchange.juserlogincore.events.login.ObservableUserLoggedInEvent;
54 import org.mxchange.juserlogincore.exceptions.UserPasswordMismatchException;
55
56 /**
57  * A general contact controller (bean)
58  * <p>
59  * @author Roland Häder<roland@mxchange.org>
60  */
61 @Named ("contactController")
62 @RequestScoped
63 public class JobsContactWebRequestBean extends BaseJobsBean implements JobsContactWebRequestController {
64
65         /**
66          * Serial number
67          */
68         private static final long serialVersionUID = 542_145_347_916L;
69
70         /**
71          * Academic academicTitle
72          */
73         private String academicTitle;
74
75         /**
76          * Birth day
77          */
78         private Date birthday;
79
80         /**
81          * City
82          */
83         private String city;
84
85         /**
86          * Optional comments
87          */
88         private String comment;
89
90         /**
91          * EJB for general contact purposes
92          */
93         @EJB (lookup = "java:global/jjobs-ejb/contact!org.mxchange.jcontacts.model.contact.ContactSessionBeanRemote")
94         private ContactSessionBeanRemote contactBean;
95
96         /**
97          * An instance of a contact-list backing bean
98          */
99         private JobsContactListWebViewController contactListController;
100
101         /**
102          * Event being fired when a user has updated his contact data
103          */
104         @Any
105         @Inject
106         private Event<ObservableUpdatedContactEvent> contactUpdatedEvent;
107
108         /**
109          * Country instance
110          */
111         private Country country;
112
113         /**
114          * Email address
115          */
116         private String emailAddress;
117
118         /**
119          * Email address repeated
120          */
121         private String emailAddressRepeat;
122
123         /**
124          * Family name
125          */
126         private String familyName;
127
128         /**
129          * Fax number's area code
130          */
131         private Integer faxAreaCode;
132
133         /**
134          * Country instance for fax number
135          */
136         private Country faxCountry;
137
138         /**
139          * Fax number
140          */
141         private Long faxNumber;
142
143         /**
144          * First name
145          */
146         private String firstName;
147
148         /**
149          * House number
150          */
151         private Short houseNumber;
152
153         /**
154          * House number extension
155          */
156         private String houseNumberExtension;
157
158         /**
159          * Phone number area code
160          */
161         private Integer landLineAreaCode;
162
163         /**
164          * Country instance for phone number
165          */
166         private Country landLineCountry;
167
168         /**
169          * Phone number
170          */
171         private Long landLineNumber;
172
173         /**
174          * Mobile number
175          */
176         private Long mobileNumber;
177
178         /**
179          * Mobile number's carrier
180          */
181         private MobileProvider mobileProvider;
182
183         /**
184          * Personal academicTitle
185          */
186         private PersonalTitle personalTitle;
187
188         /**
189          * Street
190          */
191         private String street;
192
193         /**
194          * Login bean (controller)
195          */
196         @Inject
197         private JobsUserLoginWebSessionController userLoginController;
198
199         /**
200          * ZIP code
201          */
202         private Integer zipCode;
203
204         /**
205          * Default constructor
206          */
207         public JobsContactWebRequestBean () {
208                 // Call super constructor
209                 super();
210         }
211
212         /**
213          * Event observer for newly added users by administrator
214          * <p>
215          * @param event Event being fired
216          */
217         public void afterAdminAddedUserEvent (@Observes final ObservableAdminAddedUserEvent event) {
218                 // Event and contained entity instance should not be null
219                 if (null == event) {
220                         // Throw NPE
221                         throw new NullPointerException("event is null"); //NOI18N
222                 } else if (event.getAddedUser() == null) {
223                         // Throw NPE again
224                         throw new NullPointerException("event.addedUser is null"); //NOI18N
225                 } else if (event.getAddedUser().getUserId() == null) {
226                         // userId is null
227                         throw new NullPointerException("event.addedUser.userId is null"); //NOI18N
228                 } else if (event.getAddedUser().getUserId() < 1) {
229                         // Not avalid id
230                         throw new IllegalArgumentException(MessageFormat.format("userId of user={0} is not valid: {1}", event.getAddedUser(), event.getAddedUser().getUserId())); //NOI18N
231                 }
232
233                 // Clear all data
234                 this.clear();
235         }
236
237         /**
238          * Observes events being fired when an administrator has linked a new user
239          * with existing contact data.
240          * <p>
241          * @param event Event being fired
242          */
243         public void afterAdminLinkedUserEvent (@Observes final ObservableAdminLinkedUserEvent event) {
244                 // Event and contained entity instance should not be null
245                 if (null == event) {
246                         // Throw NPE
247                         throw new NullPointerException("event is null"); //NOI18N
248                 } else if (event.getLinkedUser() == null) {
249                         // Throw NPE again
250                         throw new NullPointerException("event.linkedUser is null"); //NOI18N
251                 } else if (event.getLinkedUser().getUserContact() == null) {
252                         // Throw NPE again
253                         throw new NullPointerException("event.linkedUser.userContact is null"); //NOI18N
254                 } else if (event.getLinkedUser().getUserContact().getContactId() == null) {
255                         // userId is null
256                         throw new NullPointerException("event.linkedUser.userContact.contactId is null"); //NOI18N
257                 } else if (event.getLinkedUser().getUserContact().getContactId() < 1) {
258                         // Not avalid id
259                         throw new IllegalArgumentException(MessageFormat.format("contactId of contact={0} is not valid: {1}", event.getLinkedUser(), event.getLinkedUser().getUserContact().getContactId())); //NOI18N
260                 }
261
262                 // Clear all data
263                 this.clear();
264         }
265
266         /**
267          * Event observer for logged-in user
268          * <p>
269          * @param event Event instance
270          */
271         public void afterUserLoginEvent (@Observes final ObservableUserLoggedInEvent event) {
272                 // Event and contained entity instance should not be null
273                 if (null == event) {
274                         // Throw NPE
275                         throw new NullPointerException("event is null"); //NOI18N
276                 } else if (event.getLoggedInUser() == null) {
277                         // Throw NPE again
278                         throw new NullPointerException("event.loggedInUser is null"); //NOI18N
279                 } else if (event.getLoggedInUser().getUserId() == null) {
280                         // userId is null
281                         throw new NullPointerException("event.loggedInUser.userId is null"); //NOI18N
282                 } else if (event.getLoggedInUser().getUserId() < 1) {
283                         // Not avalid id
284                         throw new IllegalArgumentException(MessageFormat.format("userId of user={0} is not valid: {1}", event.getLoggedInUser(), event.getLoggedInUser().getUserId())); //NOI18N
285                 }
286
287                 // Copy all data to this bean
288                 this.copyFromContact(event.getLoggedInUser().getUserContact());
289         }
290
291         /**
292          * Observes events being fired before an updated of personal data done by a
293          * user has started.
294          * <p>
295          * @param event Event being observed
296          */
297         public void beforeUserUpdatedPersonalDataEvent (@Observes final ObservablePreUserPersonalDataUpdatedEvent event) {
298                 // Is the instance valid?
299                 if (null == event) {
300                         // Throw NPE
301                         throw new NullPointerException("event is null"); //NOI18N
302                 } else if (event.getUpdatedUser() == null) {
303                         // Throw NPE
304                         throw new NullPointerException("event.updatedUser is null"); //NOI18N
305                 }
306
307                 // Set all
308                 this.copyToContact(event.getUpdatedUser().getUserContact());
309         }
310
311         @Override
312         public void clearEmailAddresses () {
313                 // Clear both
314                 this.setEmailAddress(null);
315                 this.setEmailAddressRepeat(null);
316         }
317
318         @Override
319         public Contact createContactInstance () {
320                 // Is all required data set?
321                 if (!this.isRequiredPersonalDataSet()) {
322                         // No, then abort here
323                         throw new FacesException(new IllegalArgumentException("Not all personal data is set, but createContactInstance() is called.")); //NOI18N
324                 }
325
326                 // Required personal data must be set
327                 assert (this.isRequiredPersonalDataSet()) : "not all personal data is set"; //NOI18N
328
329                 // Create new contact
330                 final Contact contact = new UserContact(
331                                           this.getPersonalTitle(),
332                                           this.getFirstName(),
333                                           this.getFamilyName()
334                           );
335
336                 // Return instance
337                 return contact;
338         }
339
340         @Override
341         public String doChangePersonalContactData () {
342                 // This method shall only be called if the user is logged-in
343                 if (!this.userLoginController.isUserLoggedIn()) {
344                         // Not logged-in
345                         throw new IllegalStateException("User is not logged-in"); //NOI18N
346                 } else if (!this.isRequiredChangePersonalDataSet()) {
347                         // Not all required fields are set
348                         throw new FacesException("Not all required fields are set."); //NOI18N
349                 } else if (!this.userLoginController.ifCurrentPasswordMatches()) {
350                         // Password not matching
351                         this.showFacesMessage("form_login_change_personal:currentPassword", new UserPasswordMismatchException(this.userLoginController.getLoggedInUser()), FacesMessage.SEVERITY_ERROR); //NOI18N
352                         return ""; //NOI18N
353                 }
354
355                 // Get contact instance
356                 final Contact contact = this.userLoginController.getLoggedInUser().getUserContact();
357
358                 // It should be there, so run some tests on it
359                 assert (contact instanceof Contact) : "Instance userLoginController.loggedInUser.userContact is null"; //NOI18N
360                 assert (contact.getContactId() instanceof Long) : "Instance userLoginController.userContact.contactId is null"; //NOI18N
361                 assert (contact.getContactId() > 0) : MessageFormat.format("Instance userLoginController.userContact.contactId={0} is invalid", contact.getContactId()); //NOI18N
362
363                 // Update all fields
364                 contact.setContactPersonalTitle(this.getPersonalTitle());
365                 contact.setContactFirstName(this.getFirstName());
366                 contact.setContactFamilyName(this.getFamilyName());
367                 contact.setContactStreet(this.getStreet());
368                 contact.setContactHouseNumber(this.getHouseNumber());
369                 contact.setContactHouseNumberExtension(this.getHouseNumberExtension());
370                 contact.setContactZipCode(this.getZipCode());
371                 contact.setContactCity(this.getCity());
372                 contact.setContactCountry(this.getCountry());
373
374                 // Update contact's mobile number
375                 final boolean isMobileUnlinked = ContactUtils.updateMobileNumber(contact, this.getMobileProvider(), this.getMobileNumber());
376
377                 // Update contact's land-line number
378                 final boolean isLandLineUnlinked = ContactUtils.updateLandLineNumber(contact, this.getLandLineCountry(), this.getLandLineAreaCode(), this.getLandLineNumber());
379
380                 // Update contact's fax number
381                 final boolean isFaxUnlinked = ContactUtils.updateFaxNumber(contact, this.getFaxCountry(), this.getFaxAreaCode(), this.getFaxNumber());
382
383                 // Init updated contact instance
384                 final Contact updatedContact;
385
386                 try {
387                         // Send it to the EJB
388                         updatedContact = this.contactBean.updateContactData(contact, isMobileUnlinked, isLandLineUnlinked, isFaxUnlinked);
389                 } catch (final ContactNotFoundException ex) {
390                         // Throw as cause
391                         throw new FacesException(ex);
392                 }
393
394                 // Fire event
395                 this.contactUpdatedEvent.fire(new UpdatedContactEvent(updatedContact));
396
397                 // All fine
398                 return "contact_data_saved"; //NOI18N
399         }
400
401         /**
402          * Getter for academic title
403          * <p>
404          * @return Academic title
405          */
406         public String getAcademicTitle () {
407                 return this.academicTitle;
408         }
409
410         /**
411          * Setter for academic title
412          * <p>
413          * @param academicTitle Academic title
414          */
415         public void setAcademicTitle (final String academicTitle) {
416                 this.academicTitle = academicTitle;
417         }
418
419         /**
420          * Getter for birth day
421          * <p>
422          * @return Birth day
423          */
424         @SuppressWarnings ("ReturnOfDateField")
425         public Date getBirthday () {
426                 return this.birthday;
427         }
428
429         /**
430          * Setter for birth day
431          * <p>
432          * @param birthday Birth day
433          */
434         @SuppressWarnings ("AssignmentToDateFieldFromParameter")
435         public void setBirthday (final Date birthday) {
436                 this.birthday = birthday;
437         }
438
439         /**
440          * Getter for city name
441          * <p>
442          * @return City name
443          */
444         public String getCity () {
445                 return this.city;
446         }
447
448         /**
449          * Setter for city name
450          * <p>
451          * @param city City name
452          */
453         public void setCity (final String city) {
454                 this.city = city;
455         }
456
457         /**
458          * Getter for comments
459          * <p>
460          * @return Comments
461          */
462         public String getComment () {
463                 return this.comment;
464         }
465
466         /**
467          * Setter for comment
468          * <p>
469          * @param comment Comments
470          */
471         public void setComment (final String comment) {
472                 this.comment = comment;
473         }
474
475         /**
476          * Getter for country instance
477          * <p>
478          * @return Country instance
479          */
480         public Country getCountry () {
481                 return this.country;
482         }
483
484         /**
485          * Setter for country instance
486          * <p>
487          * @param country Country instance
488          */
489         public void setCountry (final Country country) {
490                 this.country = country;
491         }
492
493         @Override
494         public String getEmailAddress () {
495                 return this.emailAddress;
496         }
497
498         /**
499          * Setter for email address
500          * <p>
501          * @param emailAddress Email address
502          */
503         public void setEmailAddress (final String emailAddress) {
504                 this.emailAddress = emailAddress;
505         }
506
507         /**
508          * Getter for email address, repeated
509          * <p>
510          * @return the emailAddress, repeated
511          */
512         public String getEmailAddressRepeat () {
513                 return this.emailAddressRepeat;
514         }
515
516         /**
517          * Setter for email address repeated
518          * <p>
519          * @param emailAddressRepeat the emailAddress to set
520          */
521         public void setEmailAddressRepeat (final String emailAddressRepeat) {
522                 this.emailAddressRepeat = emailAddressRepeat;
523         }
524
525         /**
526          * Family name
527          * <p>
528          * @return the familyName
529          */
530         public String getFamilyName () {
531                 return this.familyName;
532         }
533
534         /**
535          * Family name
536          * <p>
537          * @param familyName the familyName to set
538          */
539         public void setFamilyName (final String familyName) {
540                 this.familyName = familyName;
541         }
542
543         /**
544          * Getter for fax number's area code
545          * <p>
546          * @return Fax number's area code
547          */
548         public Integer getFaxAreaCode () {
549                 return this.faxAreaCode;
550         }
551
552         /**
553          * Setter for fax number's area code
554          * <p>
555          * @param faxAreaCode Fax number's area code
556          */
557         public void setFaxAreaCode (final Integer faxAreaCode) {
558                 this.faxAreaCode = faxAreaCode;
559         }
560
561         /**
562          * Getter for fax's country instance
563          * <p>
564          * @return Fax' country instance
565          */
566         public Country getFaxCountry () {
567                 return this.faxCountry;
568         }
569
570         /**
571          * Setter for fax's country instance
572          * <p>
573          * @param faxCountry Fax' country instance
574          */
575         public void setFaxCountry (final Country faxCountry) {
576                 this.faxCountry = faxCountry;
577         }
578
579         /**
580          * Getter for fax number
581          * <p>
582          * @return Fax number
583          */
584         public Long getFaxNumber () {
585                 return this.faxNumber;
586         }
587
588         /**
589          * Setter for fax number
590          * <p>
591          * @param faxNumber Fax number
592          */
593         public void setFaxNumber (final Long faxNumber) {
594                 this.faxNumber = faxNumber;
595         }
596
597         /**
598          * First name
599          * <p>
600          * @return the first name
601          */
602         public String getFirstName () {
603                 return this.firstName;
604         }
605
606         /**
607          * First name
608          * <p>
609          * @param firstName the first name to set
610          */
611         public void setFirstName (final String firstName) {
612                 this.firstName = firstName;
613         }
614
615         /**
616          * House number
617          * <p>
618          * @return the houseNumber
619          */
620         public Short getHouseNumber () {
621                 return this.houseNumber;
622         }
623
624         /**
625          * House number
626          * <p>
627          * @param houseNumber the houseNumber to set
628          */
629         public void setHouseNumber (final Short houseNumber) {
630                 this.houseNumber = houseNumber;
631         }
632
633         /**
634          * Getter for house number extension, example: 123a 'a' is then the
635          * extension and 123 is the house number.
636          * <p>
637          * @return House number extension
638          */
639         public String getHouseNumberExtension () {
640                 return this.houseNumberExtension;
641         }
642
643         /**
644          * Setter for house number extension
645          * <p>
646          * @param houseNumberExtension House number extension
647          */
648         public void setHouseNumberExtension (final String houseNumberExtension) {
649                 this.houseNumberExtension = houseNumberExtension;
650         }
651
652         /**
653          * Getter for land-line number's area code
654          * <p>
655          * @return Land-line number's area code
656          */
657         public Integer getLandLineAreaCode () {
658                 return this.landLineAreaCode;
659         }
660
661         /**
662          * Setter for land-line number's area code
663          * <p>
664          * @param landLineAreaCode Land-line number's area code
665          */
666         public void setLandLineAreaCode (final Integer landLineAreaCode) {
667                 this.landLineAreaCode = landLineAreaCode;
668         }
669
670         /**
671          * Getter for land-line number's country instance
672          * <p>
673          * @return Land-line number's country instance
674          */
675         public Country getLandLineCountry () {
676                 return this.landLineCountry;
677         }
678
679         /**
680          * Setter for land-line number's country instance
681          * <p>
682          * @param landLineCountry Land-line number's country instance
683          */
684         public void setLandLineCountry (final Country landLineCountry) {
685                 this.landLineCountry = landLineCountry;
686         }
687
688         /**
689          * Getter for land-line number
690          * <p>
691          * @return Land-line number
692          */
693         public Long getLandLineNumber () {
694                 return this.landLineNumber;
695         }
696
697         /**
698          * Setter for land-line number
699          * <p>
700          * @param landLineNumber Land-line number
701          */
702         public void setLandLineNumber (final Long landLineNumber) {
703                 this.landLineNumber = landLineNumber;
704         }
705
706         /**
707          * Getter for mobile number
708          * <p>
709          * @return Mobile number
710          */
711         public Long getMobileNumber () {
712                 return this.mobileNumber;
713         }
714
715         /**
716          * Setter for mobile number
717          * <p>
718          * @param mobileNumber Mobile number
719          */
720         public void setMobileNumber (final Long mobileNumber) {
721                 this.mobileNumber = mobileNumber;
722         }
723
724         /**
725          * Getter for mobile number's carrier
726          * <p>
727          * @return Mobile number's carrier
728          */
729         public MobileProvider getMobileProvider () {
730                 return this.mobileProvider;
731         }
732
733         /**
734          * Setter for mobile number's provider
735          * <p>
736          * @param mobileProvider Mobile number's provider
737          */
738         public void setMobileProvider (final MobileProvider mobileProvider) {
739                 this.mobileProvider = mobileProvider;
740         }
741
742         /**
743          * Getter for personal title
744          * <p>
745          * @return Personal title
746          */
747         public PersonalTitle getPersonalTitle () {
748                 return this.personalTitle;
749         }
750
751         /**
752          * Setter for personal title
753          * <p>
754          * @param personalTitle Personal title
755          */
756         public void setPersonalTitle (final PersonalTitle personalTitle) {
757                 this.personalTitle = personalTitle;
758         }
759
760         /**
761          * Getter for street
762          * <p>
763          * @return Street
764          */
765         public String getStreet () {
766                 return this.street;
767         }
768
769         /**
770          * Setter for street
771          * <p>
772          * @param street Street
773          */
774         public void setStreet (final String street) {
775                 this.street = street;
776         }
777
778         /**
779          * Getter for ZIP code
780          * <p>
781          * @return ZIP code
782          */
783         public Integer getZipCode () {
784                 return this.zipCode;
785         }
786
787         /**
788          * Setter for ZIP code
789          * <p>
790          * @param zipCode ZIP code
791          */
792         public void setZipCode (final Integer zipCode) {
793                 this.zipCode = zipCode;
794         }
795
796         @Override
797         public boolean isEmailAddressRegistered (final Contact contact) {
798                 // Cherck parameter
799                 if (null == contact) {
800                         // Throw NPE
801                         throw new NullPointerException("contact is null"); //NOI18N
802                 } else if (contact.getContactEmailAddress() == null) {
803                         // Throw again
804                         throw new NullPointerException("contact.contactEmailAddress is null"); //NOI18N
805                 } else if (contact.getContactEmailAddress().isEmpty()) {
806                         // Is empty
807                         throw new IllegalArgumentException("contact.contactEmailAddress is empty."); //NOI18N
808                 }
809
810                 // Default is not registered
811                 boolean isRegistered = false;
812
813                 // Determine it
814                 for (final Contact currentContact : this.contactListController.getAllContacts()) {
815                         // Is same contact found?
816                         if (currentContact.getContactEmailAddress().equals(contact.getContactEmailAddress())) {
817                                 // Found same email address
818                                 isRegistered = true;
819
820                                 // Skipp further iterations
821                                 break;
822                         }
823                 }
824
825                 // Return status
826                 return isRegistered;
827         }
828
829         @Override
830         public boolean isEmailAddressRegistered (final String emailAddress) {
831                 throw new UnsupportedOperationException("Not supported yet."); //To change body of generated methods, choose Tools | Templates.
832         }
833
834         @Override
835         public boolean isRequiredChangePersonalDataSet () {
836                 return ((this.getPersonalTitle() != null) &&
837                                 (this.getFirstName() != null) &&
838                                 (this.getFamilyName() != null) &&
839                                 (this.getStreet() != null) &&
840                                 (this.getHouseNumber() != null) &&
841                                 (this.getZipCode() != null) &&
842                                 (this.getCity() != null));
843         }
844
845         @Override
846         public boolean isRequiredPersonalDataSet () {
847                 return ((this.getPersonalTitle() != null) &&
848                                 (this.getFirstName() != null) &&
849                                 (this.getFamilyName() != null) &&
850                                 (this.getStreet() != null) &&
851                                 (this.getHouseNumber() != null) &&
852                                 (this.getZipCode() != null) &&
853                                 (this.getCity() != null) &&
854                                 (this.getEmailAddress() != null) &&
855                                 (this.getEmailAddressRepeat() != null));
856         }
857
858         @Override
859         public boolean isSameEmailAddressEntered () {
860                 return (Objects.equals(this.getEmailAddress(), this.getEmailAddressRepeat()));
861         }
862
863         /**
864          * Clears this bean
865          */
866         private void clear () {
867                 // Clear all data
868                 // - personal data
869                 this.setPersonalTitle(null);
870                 this.setAcademicTitle(null);
871                 this.setFirstName(null);
872                 this.setFamilyName(null);
873                 this.setStreet(null);
874                 this.setHouseNumber(null);
875                 this.setHouseNumberExtension(null);
876                 this.setZipCode(null);
877                 this.setCity(null);
878                 this.setCountry(null);
879
880                 // - contact data
881                 this.clearEmailAddresses();
882                 this.setLandLineAreaCode(null);
883                 this.setLandLineCountry(null);
884                 this.setLandLineNumber(null);
885                 this.setMobileProvider(null);
886                 this.setMobileNumber(null);
887                 this.setFaxAreaCode(null);
888                 this.setFaxCountry(null);
889                 this.setFaxNumber(null);
890
891                 // - other data
892                 this.setBirthday(null);
893                 this.setComment(null);
894         }
895
896         /**
897          * Copies given contact data into the controller
898          * <p>
899          * @param contact Contact instance
900          */
901         private void copyFromContact (final Contact contact) {
902                 // Copy all fields:
903                 // - base data
904                 this.setPersonalTitle(contact.getContactPersonalTitle());
905                 this.setAcademicTitle(contact.getContactTitle());
906                 this.setFirstName(contact.getContactFirstName());
907                 this.setFamilyName(contact.getContactFamilyName());
908                 this.setStreet(contact.getContactStreet());
909                 this.setHouseNumber(contact.getContactHouseNumber());
910                 this.setHouseNumberExtension(contact.getContactHouseNumberExtension());
911                 this.setZipCode(contact.getContactZipCode());
912                 this.setCity(contact.getContactCity());
913                 this.setCountry(contact.getContactCountry());
914                 this.setEmailAddress(contact.getContactEmailAddress());
915                 this.setBirthday(contact.getContactBirthday());
916                 this.setComment(contact.getContactComment());
917
918                 // Get mobile, phone and fax instance
919                 final DialableFaxNumber fax = contact.getContactFaxNumber();
920                 final DialableLandLineNumber landLine = contact.getContactLandLineNumber();
921                 final DialableMobileNumber mobile = contact.getContactMobileNumber();
922
923                 // Is a fax number set?
924                 if ((fax instanceof DialableFaxNumber) && (fax.getPhoneAreaCode() > 0)) {
925                         // Copy elements
926                         this.setFaxCountry(fax.getPhoneCountry());
927                         this.setFaxAreaCode(fax.getPhoneAreaCode());
928                         this.setFaxNumber(fax.getPhoneNumber());
929                 }
930
931                 // Is a land-line number set?
932                 if ((landLine instanceof DialableLandLineNumber) && (landLine.getPhoneAreaCode() > 0)) {
933                         // Copy elements
934                         this.setLandLineCountry(landLine.getPhoneCountry());
935                         this.setLandLineAreaCode(landLine.getPhoneAreaCode());
936                         this.setLandLineNumber(landLine.getPhoneNumber());
937                 }
938
939                 // Is a mobile number set?
940                 if ((mobile instanceof DialableMobileNumber) && (mobile.getMobileProvider() instanceof MobileProvider)) {
941                         // Copy elements
942                         this.setMobileProvider(mobile.getMobileProvider());
943                         this.setMobileNumber(mobile.getMobileNumber());
944                 }
945         }
946
947         /**
948          * Copies all fields from this backing bean into given instance.
949          * <p>
950          * @param contact An instance of a Contact class
951          */
952         private void copyToContact (final Contact contact) {
953                 // Set other elements
954                 contact.setContactStreet(this.getStreet());
955                 contact.setContactHouseNumber(this.getHouseNumber());
956                 contact.setContactHouseNumberExtension(this.getHouseNumberExtension());
957                 contact.setContactZipCode(this.getZipCode());
958                 contact.setContactCity(this.getCity());
959                 contact.setContactCountry(this.getCountry());
960                 contact.setContactEmailAddress(this.getEmailAddress());
961                 contact.setContactBirthday(this.getBirthday());
962                 contact.setContactComment(this.getComment());
963
964                 // Generate phone number
965                 final DialableLandLineNumber landLine = new LandLineNumber(this.getLandLineCountry(), this.getLandLineAreaCode(), this.getLandLineNumber());
966                 final DialableMobileNumber mobile = new MobileNumber(this.getMobileProvider(), this.getMobileNumber());
967                 final DialableFaxNumber fax = new FaxNumber(this.getFaxCountry(), this.getFaxAreaCode(), this.getFaxNumber());
968
969                 // Don't set null or wrong references
970                 if ((landLine instanceof DialableLandLineNumber) && (landLine.getPhoneCountry() instanceof Country) && (this.getLandLineAreaCode() != null) && (this.getLandLineNumber() != null) && (this.getLandLineAreaCode() > 0) && (this.getLandLineNumber() > 0)) {
971                         // Now the number must be given
972                         if (landLine.getPhoneAreaCode() == null) {
973                                 // Is null
974                                 throw new NullPointerException("phone.phoneAreaCode is null"); //NOI18N
975                         } else if (landLine.getPhoneAreaCode() < 1) {
976                                 // Abort here
977                                 throw new IllegalArgumentException("phone.phoneAreaCode is zero or below."); //NOI18N
978                         } else if (landLine.getPhoneNumber() == null) {
979                                 // Is null
980                                 throw new NullPointerException("phone.phoneNumber is null"); //NOI18N
981                         } else if (landLine.getPhoneNumber() < 1) {
982                                 // Abort here
983                                 throw new IllegalArgumentException("phone.phoneNumber is zero or below."); //NOI18N
984                         }
985
986                         // Set phone number
987                         contact.setContactLandLineNumber(landLine);
988                 }
989
990                 // Don't set null or wrong references
991                 if ((fax instanceof DialableFaxNumber) && (fax.getPhoneCountry() instanceof Country) && (this.getFaxAreaCode() != null) && (this.getFaxNumber() != null) && (this.getFaxAreaCode() > 0) && (this.getFaxNumber() > 0)) {
992                         // Now the number must be given
993                         if (fax.getPhoneAreaCode() == null) {
994                                 // Is null
995                                 throw new NullPointerException("fax.phoneAreaCode is null"); //NOI18N
996                         } else if (fax.getPhoneAreaCode() < 1) {
997                                 // Abort here
998                                 throw new IllegalArgumentException("fax.phoneAreaCode is zero or below."); //NOI18N
999                         } else if (fax.getPhoneNumber() == null) {
1000                                 // Is null
1001                                 throw new NullPointerException("fax.phoneNumber is null"); //NOI18N
1002                         } else if (fax.getPhoneNumber() < 1) {
1003                                 // Abort here
1004                                 throw new IllegalArgumentException("fax.phoneNumber is zero or below."); //NOI18N
1005                         }
1006
1007                         // Set fax number
1008                         contact.setContactFaxNumber(fax);
1009                 }
1010
1011                 // Is the provider set?
1012                 if ((mobile instanceof DialableMobileNumber) && (this.getMobileProvider() instanceof MobileProvider) && (this.getMobileNumber() != null) && (this.getMobileNumber() > 0)) {
1013                         // Is the number set?
1014                         if (mobile.getMobileNumber() == null) {
1015                                 // Is null
1016                                 throw new NullPointerException("mobile.phoneNumber is null"); //NOI18N
1017                         } else if (mobile.getMobileNumber() < 1) {
1018                                 // Abort here
1019                                 throw new IllegalArgumentException("mobile.phoneNumber is zero or below."); //NOI18N
1020                         }
1021
1022                         // Set mobile number
1023                         contact.setContactMobileNumber(mobile);
1024                 }
1025         }
1026
1027 }