[jjobs-war.git] /

/*
 * Copyright (C) 2017 - 2022 Free Software Foundation
 *
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU Affero General Public License as
 * published by the Free Software Foundation, either version 3 of the
 * License, or (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU Affero General Public License for more details.
 *
 * You should have received a copy of the GNU Affero General Public License
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
 */
package org.mxchange.jjobs.beans.business.branchoffice.action;

import java.text.MessageFormat;
import java.util.ArrayList;
import java.util.Date;
import java.util.List;
import java.util.Objects;
import javax.ejb.EJB;
import javax.enterprise.context.RequestScoped;
import javax.enterprise.event.Event;
import javax.enterprise.inject.Any;
import javax.faces.FacesException;
import javax.faces.application.FacesMessage;
import javax.inject.Inject;
import javax.inject.Named;
import org.mxchange.jcontacts.model.contact.Contact;
import org.mxchange.jcontactsbusiness.events.branchoffice.added.AdminBranchOfficeAddedEvent;
import org.mxchange.jcontactsbusiness.events.branchoffice.added.ObservableAdminBranchOfficeAddedEvent;
import org.mxchange.jcontactsbusiness.events.branchoffice.updated.AdminBranchOfficeUpdatedEvent;
import org.mxchange.jcontactsbusiness.events.branchoffice.updated.ObservableAdminBranchOfficeUpdatedEvent;
import org.mxchange.jcontactsbusiness.exceptions.branchoffice.BranchOfficeAlreadyAddedException;
import org.mxchange.jcontactsbusiness.exceptions.branchoffice.BranchOfficeNotFoundException;
import org.mxchange.jcontactsbusiness.model.basicdata.BasicData;
import org.mxchange.jcontactsbusiness.model.branchoffice.AdminBranchOfficeSessionBeanRemote;
import org.mxchange.jcontactsbusiness.model.branchoffice.BranchOffice;
import org.mxchange.jcontactsbusiness.model.branchoffice.BranchOffices;
import org.mxchange.jcontactsbusiness.model.branchoffice.BusinessBranchOffice;
import org.mxchange.jcontactsbusiness.model.opening_time.BusinessOpeningTime;
import org.mxchange.jcontactsbusiness.model.opening_time.OpeningTime;
import org.mxchange.jcoreee.dates.DayOfTheWeek;
import org.mxchange.jcountry.model.data.Country;
import org.mxchange.jjobs.beans.BaseJobsBean;
import org.mxchange.jjobs.beans.business.branchoffice.list.JobsBranchOfficeListWebViewController;
import org.mxchange.jphone.model.phonenumbers.fax.DialableFaxNumber;
import org.mxchange.jphone.model.phonenumbers.fax.FaxNumber;
import org.mxchange.jphone.model.phonenumbers.landline.DialableLandLineNumber;
import org.mxchange.jphone.model.phonenumbers.landline.LandLineNumber;
import org.mxchange.jusercore.model.user.User;

/**
 * An administrative bean for branch offices
 * <p>
 * @author Roland Häder<roland@mxchange.org>
 */
@Named ("adminBranchOfficeActionController")
@RequestScoped
public class JobsAdminBranchOfficeActionWebRequestBean extends BaseJobsBean implements JobsAdminBranchOfficeActionWebRequestController {

        /**
         * Opening times of this branch office
         */
        private static List<OpeningTime> BRANCH_OPENING_TIMES;

        /**
         * Serial number
         */
        private static final long serialVersionUID = 5_028_697_360_471L;

        /**
         * EJB for administrative purposes
         */
        @EJB (lookup = "java:global/jjobs-ejb/adminBranchOffice!org.mxchange.jcontactsbusiness.model.branchoffice.AdminBranchOfficeSessionBeanRemote")
        private AdminBranchOfficeSessionBeanRemote adminBranchOfficeBean;

        /**
         * City
         */
        private String branchCity;

        /**
         * Assigned company for this branch office
         */
        private BasicData branchCompany;

        /**
         * Contact person in branch office
         */
        private Contact branchContactEmployee;

        /**
         * Country
         */
        private Country branchCountry;

        /**
         * Email address
         */
        private String branchEmailAddress;

        /**
         * House number
         */
        private Short branchHouseNumber;

        /**
         * House number's extension (a,b,c,...)
         */
        private String branchHouseNumberExtension;

        /**
         * Branch office's id number
         */
        private Long branchId;

        /**
         * Last house number
         */
        private Short branchLastHouseNumber;

        /**
         * Number of branch office
         */
        private Long branchNumber;

        /**
         * An event being fired when a branch office has been successfully added
         */
        @Inject
        @Any
        private Event<ObservableAdminBranchOfficeAddedEvent> branchOfficeAddedEvent;

        /**
         * A list branch office controller (backing bean)
         */
        @Inject
        private JobsBranchOfficeListWebViewController branchOfficeListController;

        /**
         * Owner/leader of branch office
         */
        private Contact branchOwnerEmployee;

        /**
         * Store
         */
        private Short branchStore;

        /**
         * Branch office street name
         */
        private String branchStreet;

        /**
         * Suite number
         */
        private Short branchSuiteNumber;

        /**
         * Owning user instance (which this branch office is assigned to)
         */
        private User branchUserOwner;

        /**
         * ZIP code
         */
        private Integer branchZipCode;

        /**
         * Currently worked on branch office
         */
        private BranchOffice currentBranchOffice;

        /**
         * Area code for fax number
         */
        private Integer faxAreaCode;

        /**
         * Country for fax number
         */
        private Country faxCountry;

        /**
         * Dial number for fax number
         */
        private Long faxNumber;

        /**
         * Area code for land-line number
         */
        private Integer landLineAreaCode;

        /**
         * Country for land-line number
         */
        private Country landLineCountry;

        /**
         * Dial number for land-line number
         */
        private Long landLineNumber;

        /**
         * Ending week day
         */
        private DayOfTheWeek openingEndDay;

        /**
         * Ending time
         */
        private Date openingEndTime;

        /**
         * Starting week day
         */
        private DayOfTheWeek openingStartDay;

        /**
         * Starting time
         */
        private Date openingStartTime;

        /**
         * Event being fired when an administrator has updated a branch office
         */
        @Any
        @Inject
        private Event<ObservableAdminBranchOfficeUpdatedEvent> updatedBranchOfficeEvent;

        /**
         * Default constructor
         */
        public JobsAdminBranchOfficeActionWebRequestBean () {
                // Call super constructor
                super();

                // Is the opening times list there?
                if (null == BRANCH_OPENING_TIMES) {
                        // Init list
                        BRANCH_OPENING_TIMES = new ArrayList<>(1);
                }
        }

        /**
         * Adds branch office with all data from this backing bean. First this
         * action method will validate if the branch office's address is already
         * registered and if found, it will output a proper faces message.
         */
        public void addBranchOffice () {
                // Get instance
                final BranchOffice branchOffice = this.createBranchOffice();

                // Is the branch office not created yet?
                if (this.isBranchOfficeCreatedBySameAddress(branchOffice)) {
                        // Then show proper faces message
                        this.showFacesMessage("form-admin-add-branch-office:branchStreet", "ADMIN_BRANCH_OFFICE_ALREADY_CREATED", FacesMessage.SEVERITY_WARN); //NOI18N
                        return;
                }

                // Delcare updated instance
                final BranchOffice updatedOffice;

                try {
                        // Try to call EJB
                        updatedOffice = this.adminBranchOfficeBean.addBranchOffice(branchOffice);
                } catch (final BranchOfficeAlreadyAddedException ex) {
                        // Output message
                        this.showFacesMessage("form-admin-add-branch-office:branchStreet", "ADMIN_BRANCH_OFFICE_ALREADY_CREATED", FacesMessage.SEVERITY_ERROR); //NOI18N
                        return;
                }

                // Fire event
                this.branchOfficeAddedEvent.fire(new AdminBranchOfficeAddedEvent(updatedOffice));

                // Clear this bean
                this.clear();
        }

        /**
         * Adds opening time to temporary list which will be sent along with the
         * branch office data to the EJB.
         */
        public void addOpeningTime () {
                // Validate all required fields
                if (this.getOpeningEndDay() == null) {
                        // Throw NPE
                        throw new NullPointerException("this.openingEndDay is null"); //NOI18N
                } else if (this.getOpeningEndTime() == null) {
                        // Throw NPE
                        throw new NullPointerException("this.openingEndTime is null"); //NOI18N
                } else if (this.getOpeningStartDay() == null) {
                        // Throw NPE
                        throw new NullPointerException("this.openingStartDay is null"); //NOI18N
                } else if (this.getOpeningStartTime() == null) {
                        // Throw NPE
                        throw new NullPointerException("this.openingStartTime is null"); //NOI18N
                }

                // Get opening time instance
                final OpeningTime openingTime = this.createOpeningTimes();

                // Is same found?
                if (this.isOpeningTimeFound(openingTime)) {
                        // Yes then abort here
                        this.showFacesMessage("form-admin-add-branch-opening-time:openingStartDay", "ADMIN_OPENING_TIME_ALREADY_CREATED", FacesMessage.SEVERITY_WARN); //NOI18N
                        return;
                }

                // Add to temporary list
                getBranchOpeningTimes().add(openingTime);

                // Clear opening time fields
                this.clearOpeningTime();
        }

        /**
         * Copies all current branch office's properties back to this bean.
         */
        public void copyAllBranchOfficeProperties () {
                // Validate current product instance
                if (this.getCurrentBranchOffice() == null) {
                        // Throw NPE
                        throw new NullPointerException("this.product is null"); //NOI18N
                } else if (this.getCurrentBranchOffice().getBranchId() == null) {
                        // Throw NPE again
                        throw new NullPointerException("this.product.branchId is null"); //NOI18N
                } else if (this.getCurrentBranchOffice().getBranchId() < 1) {
                        // Not valid
                        throw new IllegalStateException(MessageFormat.format("this.product.branchId={0} is not valid.", this.getCurrentBranchOffice().getBranchId())); //NOI18N
                }

                // Now copy all fields
                this.setBranchCity(this.getCurrentBranchOffice().getBranchCity());
                this.setBranchCompany(this.getCurrentBranchOffice().getBranchCompany());
                this.setBranchContactEmployee(this.getCurrentBranchOffice().getBranchContactEmployee());
                this.setBranchCountry(this.getCurrentBranchOffice().getBranchCountry());
                this.setBranchEmailAddress(this.getCurrentBranchOffice().getBranchEmailAddress());
                this.setBranchHouseNumber(this.getCurrentBranchOffice().getBranchHouseNumber());
                this.setBranchHouseNumberExtension(this.getCurrentBranchOffice().getBranchHouseNumberExtension());
                this.setBranchId(this.getCurrentBranchOffice().getBranchId());
                this.setBranchLastHouseNumber(this.getCurrentBranchOffice().getBranchLastHouseNumber());
                this.setBranchNumber(this.getCurrentBranchOffice().getBranchNumber());
                this.setBranchOpeningTimes(this.getCurrentBranchOffice().getBranchOpeningTimes());
                this.setBranchOwnerEmployee(this.getCurrentBranchOffice().getBranchOwnerEmployee());
                this.setBranchStore(this.getCurrentBranchOffice().getBranchStore());
                this.setBranchStreet(this.getCurrentBranchOffice().getBranchStreet());
                this.setBranchSuiteNumber(this.getCurrentBranchOffice().getBranchSuiteNumber());
                this.setBranchUserOwner(this.getCurrentBranchOffice().getBranchUserOwner());
                this.setBranchZipCode(this.getCurrentBranchOffice().getBranchZipCode());
        }

        /**
         * Getter for city
         * <p>
         * @return City
         */
        public String getBranchCity () {
                return this.branchCity;
        }

        /**
         * Setter for city
         * <p>
         * @param branchCity City
         */
        public void setBranchCity (final String branchCity) {
                this.branchCity = branchCity;
        }

        /**
         * Getter for basic company data
         * <p>
         * @return Basic company data
         */
        public BasicData getBranchCompany () {
                return this.branchCompany;
        }

        /**
         * Setter for basic company data
         * <p>
         * @param branchCompany Basic company data
         */
        public void setBranchCompany (final BasicData branchCompany) {
                this.branchCompany = branchCompany;
        }

        /**
         * Getter for branch office contact person
         * <p>
         * @return Branch office contact person
         */
        public Contact getBranchContactEmployee () {
                return this.branchContactEmployee;
        }

        /**
         * Setter for branch office contact person
         * <p>
         * @param branchContactEmployee Branch office contact person
         */
        public void setBranchContactEmployee (final Contact branchContactEmployee) {
                this.branchContactEmployee = branchContactEmployee;
        }

        /**
         * Getter for country
         * <p>
         * @return Country
         */
        public Country getBranchCountry () {
                return this.branchCountry;
        }

        /**
         * Setter for country
         * <p>
         * @param branchCountry Country
         */
        public void setBranchCountry (final Country branchCountry) {
                this.branchCountry = branchCountry;
        }

        /**
         * Getter for email address
         * <p>
         * @return Email address
         */
        public String getBranchEmailAddress () {
                return this.branchEmailAddress;
        }

        /**
         * Getter for email address
         * <p>
         * @param branchEmailAddress Email address
         */
        public void setBranchEmailAddress (final String branchEmailAddress) {
                this.branchEmailAddress = branchEmailAddress;
        }

        /**
         * Getter for house number
         * <p>
         * @return House number
         */
        public Short getBranchHouseNumber () {
                return this.branchHouseNumber;
        }

        /**
         * Setter for house number
         * <p>
         * @param branchHouseNumber House number
         */
        public void setBranchHouseNumber (final Short branchHouseNumber) {
                this.branchHouseNumber = branchHouseNumber;
        }

        /**
         * Getter for house number's extension
         * <p>
         * @return House number's extension
         */
        public String getBranchHouseNumberExtension () {
                return this.branchHouseNumberExtension;
        }

        /**
         * Setter for house number's extension
         * <p>
         * @param branchHouseNumberExtension House number's extension
         */
        public void setBranchHouseNumberExtension (final String branchHouseNumberExtension) {
                this.branchHouseNumberExtension = branchHouseNumberExtension;
        }

        /**
         * Getter for branch office's id number
         * <p>
         * @return Branch office's id number
         */
        public Long getBranchId () {
                return this.branchId;
        }

        /**
         * Setter for branch office's id number
         * <p>
         * @param branchId Branch office's id number
         */
        public void setBranchId (final Long branchId) {
                this.branchId = branchId;
        }

        /**
         * Getter for last house number
         * <p>
         * @return Last house number
         */
        public Short getBranchLastHouseNumber () {
                return this.branchLastHouseNumber;
        }

        /**
         * Setter for last house number
         * <p>
         * @param branchLastHouseNumber Last house number
         */
        public void setBranchLastHouseNumber (final Short branchLastHouseNumber) {
                this.branchLastHouseNumber = branchLastHouseNumber;
        }

        /**
         * Getter for branch office number
         * <p>
         * @return Branch office number
         */
        public Long getBranchNumber () {
                return this.branchNumber;
        }

        /**
         * Setter for branch office number
         * <p>
         * @param branchNumber Branch office number
         */
        public void setBranchNumber (final Long branchNumber) {
                this.branchNumber = branchNumber;
        }

        /**
         * Getter for opening times of this branch office
         * <p>
         * @return Opening times
         */
        @SuppressWarnings ("ReturnOfCollectionOrArrayField")
        public List<OpeningTime> getBranchOpeningTimes () {
                return BRANCH_OPENING_TIMES;
        }

        /**
         * Setter for opening times of this branch office
         * <p>
         * @param branchOpeningTimes Opening times
         */
        @SuppressWarnings ("AssignmentToCollectionOrArrayFieldFromParameter")
        public void setBranchOpeningTimes (final List<OpeningTime> branchOpeningTimes) {
                BRANCH_OPENING_TIMES = branchOpeningTimes;
        }

        /**
         * Getter for branch office contact person
         * <p>
         * @return Branch office contact person
         */
        public Contact getBranchOwnerEmployee () {
                return this.branchOwnerEmployee;
        }

        /**
         * Setter for branch office contact person
         * <p>
         * @param branchOwnerEmployee Branch office contact person
         */
        public void setBranchOwnerEmployee (final Contact branchOwnerEmployee) {
                this.branchOwnerEmployee = branchOwnerEmployee;
        }

        /**
         * Getter for store
         * <p>
         * @return Store
         */
        public Short getBranchStore () {
                return this.branchStore;
        }

        /**
         * Setter for store
         * <p>
         * @param branchStore Store
         */
        public void setBranchStore (final Short branchStore) {
                this.branchStore = branchStore;
        }

        /**
         * Getter for street name
         * <p>
         * @return Street name
         */
        public String getBranchStreet () {
                return this.branchStreet;
        }

        /**
         * Setter for street name
         * <p>
         * @param branchStreet Street name
         */
        public void setBranchStreet (final String branchStreet) {
                this.branchStreet = branchStreet;
        }

        /**
         * Getter for suite number
         * <p>
         * @return Suite number
         */
        public Short getBranchSuiteNumber () {
                return this.branchSuiteNumber;
        }

        /**
         * Setter for suite number
         * <p>
         * @param branchSuiteNumber Suite number
         */
        public void setBranchSuiteNumber (final Short branchSuiteNumber) {
                this.branchSuiteNumber = branchSuiteNumber;
        }

        /**
         * Getter for owning user instance
         * <p>
         * @return Owning user instance
         */
        public User getBranchUserOwner () {
                return this.branchUserOwner;
        }

        /**
         * Setter for owning user instance
         * <p>
         * @param branchUserOwner Owning user instance
         */
        public void setBranchUserOwner (final User branchUserOwner) {
                this.branchUserOwner = branchUserOwner;
        }

        /**
         * Getter for ZIP code\
         * <p>
         * @return ZIP code
         */
        public Integer getBranchZipCode () {
                return this.branchZipCode;
        }

        /**
         * Setter for ZIP code\
         * <p>
         * @param branchZipCode ZIP code
         */
        public void setBranchZipCode (final Integer branchZipCode) {
                this.branchZipCode = branchZipCode;
        }

        /**
         * Getter for current branch office
         * <p>
         * @return Current branch office
         */
        public BranchOffice getCurrentBranchOffice () {
                return this.currentBranchOffice;
        }

        /**
         * Setter for current branch office
         * <p>
         * @param currentBranchOffice Current branch office
         */
        public void setCurrentBranchOffice (final BranchOffice currentBranchOffice) {
                this.currentBranchOffice = currentBranchOffice;
        }

        /**
         * Getter for fax number's area code
         * <p>
         * @return Fax number's area code
         */
        public Integer getFaxAreaCode () {
                return this.faxAreaCode;
        }

        /**
         * Setter for fax number's area code
         * <p>
         * @param faxAreaCode Fax number's area code
         */
        public void setFaxAreaCode (final Integer faxAreaCode) {
                this.faxAreaCode = faxAreaCode;
        }

        /**
         * Getter for fax's country instance
         * <p>
         * @return Fax' country instance
         */
        public Country getFaxCountry () {
                return this.faxCountry;
        }

        /**
         * Setter for fax's country instance
         * <p>
         * @param faxCountry Fax' country instance
         */
        public void setFaxCountry (final Country faxCountry) {
                this.faxCountry = faxCountry;
        }

        /**
         * Getter for fax number
         * <p>
         * @return Fax number
         */
        public Long getFaxNumber () {
                return this.faxNumber;
        }

        /**
         * Setter for fax number
         * <p>
         * @param faxNumber Fax number
         */
        public void setFaxNumber (final Long faxNumber) {
                this.faxNumber = faxNumber;
        }

        /**
         * Getter for land-line number's area code
         * <p>
         * @return Land-line number's area code
         */
        public Integer getLandLineAreaCode () {
                return this.landLineAreaCode;
        }

        /**
         * Setter for land-line number's area code
         * <p>
         * @param landLineAreaCode Land-line number's area code
         */
        public void setLandLineAreaCode (final Integer landLineAreaCode) {
                this.landLineAreaCode = landLineAreaCode;
        }

        /**
         * Getter for land-line number's country instance
         * <p>
         * @return Land-line number's country instance
         */
        public Country getLandLineCountry () {
                return this.landLineCountry;
        }

        /**
         * Setter for land-line number's country instance
         * <p>
         * @param landLineCountry Land-line number's country instance
         */
        public void setLandLineCountry (final Country landLineCountry) {
                this.landLineCountry = landLineCountry;
        }

        /**
         * Getter for land-line number
         * <p>
         * @return Land-line number
         */
        public Long getLandLineNumber () {
                return this.landLineNumber;
        }

        /**
         * Setter for land-line number
         * <p>
         * @param landLineNumber Land-line number
         */
        public void setLandLineNumber (final Long landLineNumber) {
                this.landLineNumber = landLineNumber;
        }

        /**
         * Getter for ending week day
         * <p>
         * @return Ending week day
         */
        public DayOfTheWeek getOpeningEndDay () {
                return this.openingEndDay;
        }

        /**
         * Setter for ending week day
         * <p>
         * @param openingEndDay Ending week day
         */
        public void setOpeningEndDay (final DayOfTheWeek openingEndDay) {
                this.openingEndDay = openingEndDay;
        }

        /**
         * Getter for ending time
         * <p>
         * @return Ending time
         */
        @SuppressWarnings ("ReturnOfDateField")
        public Date getOpeningEndTime () {
                return this.openingEndTime;
        }

        /**
         * Getter for ending time
         * <p>
         * @param openingEndTime Ending time
         */
        @SuppressWarnings ("AssignmentToDateFieldFromParameter")
        public void setOpeningEndTime (final Date openingEndTime) {
                this.openingEndTime = openingEndTime;
        }

        /**
         * Getter for starting week day
         * <p>
         * @return Starting week day
         */
        public DayOfTheWeek getOpeningStartDay () {
                return this.openingStartDay;
        }

        /**
         * Getter for starting week day
         * <p>
         * @param openingStartDay Starting week day
         */
        public void setOpeningStartDay (final DayOfTheWeek openingStartDay) {
                this.openingStartDay = openingStartDay;
        }

        /**
         * Getter for starting time
         * <p>
         * @return Starting time
         */
        @SuppressWarnings ("ReturnOfDateField")
        public Date getOpeningStartTime () {
                return this.openingStartTime;
        }

        /**
         * Getter for starting time
         * <p>
         * @param openingStartTime Starting time
         */
        @SuppressWarnings ("AssignmentToDateFieldFromParameter")
        public void setOpeningStartTime (final Date openingStartTime) {
                this.openingStartTime = openingStartTime;
        }

        /**
         * Updates currently worked on branch office data
         * <p>
         * @return Redirection outcome
         */
        public String updateBranchOffice () {
                // Validate current product instance and id
                if (this.getCurrentBranchOffice() == null) {
                        // Throw NPE
                        throw new NullPointerException("this.product is null"); //NOI18N
                } else if (this.getCurrentBranchOffice().getBranchId() == null) {
                        // Throw NPE again
                        throw new NullPointerException("this.product.branchId is null"); //NOI18N
                } else if (this.getCurrentBranchOffice().getBranchId() < 1) {
                        // Not valid
                        throw new IllegalStateException(MessageFormat.format("this.product.branchId={0} is not valid.", this.getCurrentBranchOffice().getBranchId())); //NOI18N
                } else if (this.getBranchId() == null) {
                        // Throw NPE
                        throw new NullPointerException("this.branchId is null"); //NOI18N
                } else if (this.getBranchId() < 1) {
                        // Throw ISE
                        throw new IllegalStateException(MessageFormat.format("this.branchId={0} is not valid.", this.getBranchId())); //NOI18N
                }

                // Init instance with fresh data
                final BranchOffice branchOffice = this.createBranchOffice();

                // Does current (not updated) and just created (maybe updated) match?
                if (Objects.equals(this.getCurrentBranchOffice(), branchOffice)) {
                        // Yes, then output message
                        this.showFacesMessage("form-admin-edit-branch-office:branchCompany", "ADMIN_BRANCH_OFFICE_NOT_UPDATED", FacesMessage.SEVERITY_WARN); //NOI18N

                        // Skip below code
                        return ""; //NOI18N
                }

                // Copy all fields
                BranchOffices.copyBranchOfficeData(this.getCurrentBranchOffice(), branchOffice);

                // Initialize updated instance
                final BranchOffice updatedBranchOffice;

                // Try it
                try {
                        // Invoke EJB
                        updatedBranchOffice = this.adminBranchOfficeBean.updateBranchOffice(branchOffice);
                } catch (final BranchOfficeNotFoundException ex) {
                        // Throw as a cause
                        throw new FacesException(ex);
                }

                // Fire event
                this.updatedBranchOfficeEvent.fire(new AdminBranchOfficeUpdatedEvent(updatedBranchOffice));

                // Redirect to list view
                return "admin_list_branch_offices"; //NOI18N
        }

        /**
         * Clears this bean data
         */
        private void clear () {
                // Clear all branch office data
                this.setBranchCity(null);
                this.setBranchCompany(null);
                this.setBranchContactEmployee(null);
                this.setBranchCountry(null);
                this.setBranchEmailAddress(null);
                this.setBranchHouseNumber(null);
                this.setBranchHouseNumberExtension(null);
                this.setBranchLastHouseNumber(null);
                this.setBranchNumber(null);
                this.setBranchOwnerEmployee(null);
                this.setBranchStore(null);
                this.setBranchStreet(null);
                this.setBranchSuiteNumber(null);
                this.setBranchUserOwner(null);
                this.setBranchZipCode(null);

                // Opening times list
                this.setBranchOpeningTimes(new ArrayList<OpeningTime>(1));

                // Fax and land-line number
                this.setFaxAreaCode(null);
                this.setFaxCountry(null);
                this.setFaxNumber(null);
                this.setLandLineAreaCode(null);
                this.setLandLineCountry(null);
                this.setLandLineNumber(null);

                // Extra-clear opening time
                this.clearOpeningTime();
        }

        /**
         * Clears all opening time fields
         */
        private void clearOpeningTime () {
                // Clear all opening time fields
                this.setOpeningEndDay(null);
                this.setOpeningEndTime(null);
                this.setOpeningStartDay(null);
                this.setOpeningStartTime(null);
        }

        /**
         * Prepares an instance of a BranchOffice object (entity) with all data from
         * this bean. If a complete fax number or land-line number was provided, it
         * will be set in the instance as well.
         * <p>
         * @return An instance of a BranchOffice class (entity)
         */
        private BranchOffice createBranchOffice () {
                // Create new branch office instance
                final BranchOffice branchOffice = new BusinessBranchOffice(
                                                   this.getBranchCity(),
                                                   this.getBranchCompany(),
                                                   this.getBranchCountry(),
                                                   this.getBranchStreet(),
                                                   this.getBranchZipCode(),
                                                   this.getBranchHouseNumber()
                                   );

                // Add all other fields, too
                branchOffice.setBranchId(this.getBranchId());
                branchOffice.setBranchContactEmployee(this.getBranchContactEmployee());
                branchOffice.setBranchEmailAddress(this.getBranchEmailAddress());
                branchOffice.setBranchHouseNumberExtension(this.getBranchHouseNumberExtension());
                branchOffice.setBranchLastHouseNumber(this.getBranchLastHouseNumber());
                branchOffice.setBranchNumber(this.getBranchNumber());
                branchOffice.setBranchOwnerEmployee(this.getBranchOwnerEmployee());
                branchOffice.setBranchStore(this.getBranchStore());
                branchOffice.setBranchSuiteNumber(this.getBranchSuiteNumber());
                branchOffice.setBranchUserOwner(this.getBranchUserOwner());

                // Init variables
                DialableLandLineNumber landLine = null;
                DialableFaxNumber fax = null;

                // Are all required fields set?
                if (this.getLandLineAreaCode() != null && this.getLandLineCountry() instanceof Country && this.getLandLineNumber() != null) {
                        // Initialize land-line instance
                        landLine = new LandLineNumber(this.getLandLineCountry(), this.getLandLineAreaCode(), this.getLandLineNumber());
                }

                // Are all required fields set?
                if (this.getFaxAreaCode() != null && this.getFaxCountry() instanceof Country && this.getFaxNumber() != null) {
                        // Initialize fax instance
                        fax = new FaxNumber(this.getFaxCountry(), this.getFaxAreaCode(), this.getFaxNumber());
                }

                // Don't set null or wrong references
                if ((landLine instanceof DialableLandLineNumber) && (landLine.getPhoneCountry() instanceof Country) && (this.getLandLineAreaCode() != null) && (this.getLandLineNumber() != null) && (this.getLandLineAreaCode() > 0) && (this.getLandLineNumber() > 0)) {
                        // Now the number must be given
                        if (landLine.getPhoneAreaCode() == null) {
                                // Is null
                                throw new NullPointerException("phone.phoneAreaCode is null"); //NOI18N
                        } else if (landLine.getPhoneAreaCode() < 1) {
                                // Abort here
                                throw new IllegalArgumentException("phone.phoneAreaCode is zero or below."); //NOI18N
                        } else if (landLine.getPhoneNumber() == null) {
                                // Is null
                                throw new NullPointerException("phone.phoneNumber is null"); //NOI18N
                        } else if (landLine.getPhoneNumber() < 1) {
                                // Abort here
                                throw new IllegalArgumentException("phone.phoneNumber is zero or below."); //NOI18N
                        }

                        // Set phone number
                        branchOffice.setBranchLandLineNumber(landLine);
                }

                // Don't set null or wrong references
                if ((fax instanceof DialableFaxNumber) && (fax.getPhoneCountry() instanceof Country) && (this.getFaxAreaCode() != null) && (this.getFaxNumber() != null) && (this.getFaxAreaCode() > 0) && (this.getFaxNumber() > 0)) {
                        // Now the number must be given
                        if (fax.getPhoneAreaCode() == null) {
                                // Is null
                                throw new NullPointerException("fax.phoneAreaCode is null"); //NOI18N
                        } else if (fax.getPhoneAreaCode() < 1) {
                                // Abort here
                                throw new IllegalArgumentException("fax.phoneAreaCode is zero or below."); //NOI18N
                        } else if (fax.getPhoneNumber() == null) {
                                // Is null
                                throw new NullPointerException("fax.phoneNumber is null"); //NOI18N
                        } else if (fax.getPhoneNumber() < 1) {
                                // Abort here
                                throw new IllegalArgumentException("fax.phoneNumber is zero or below."); //NOI18N
                        }

                        // Set fax number
                        branchOffice.setBranchFaxNumber(fax);
                }
                // Is the opening times list filled?
                if (!this.getBranchOpeningTimes().isEmpty()) {
                        // Yes, then set in branch office, too
                        branchOffice.setBranchOpeningTimes(this.getBranchOpeningTimes());
                }

                // Return fully prepared instance
                return branchOffice;
        }

        /**
         * Prepares an instance of a OpeningTimes object (entity) with all data from
         * this bean. If a complete fax number or land-line number was provided, it
         * will be set in the instance as well.
         * <p>
         * @return An instance of a OpeningTimes class (entity)
         */
        private OpeningTime createOpeningTimes () {
                // Create new openingTime instance
                final OpeningTime openingTime = new BusinessOpeningTime(
                                                  this.getOpeningEndDay(),
                                                  this.getOpeningEndTime(),
                                                  this.getOpeningStartDay(),
                                                  this.getOpeningStartTime()
                                  );

                // Return fully prepared instance
                return openingTime;
        }

        /**
         * Checks whether the given branch office's address is already found in
         * local cache. Please note that this method fully relies on the cache, so
         * you must always fire proper events that add/update/delete entries in
         * cache.
         * <p>
         * @param branchOffice Branch office to check it's address
         * <p>
         * @return Whether the address has been found
         */
        private boolean isBranchOfficeCreatedBySameAddress (final BranchOffice branchOffice) {
                // Default is not found
                boolean isFound = false;

                // Now check each entry
                for (final BranchOffice bo : this.branchOfficeListController.getAllBranchOffices()) {
                        // Is same address?
                        if (BranchOffices.isSameAddress(bo, branchOffice)) {
                                // Found one
                                isFound = true;
                                break;
                        }
                }

                // Return flag
                return isFound;
        }

        /**
         * Checks if given opening time is already added
         * <p>
         * @param openingTime Opening time to be checked
         * <p>
         * @return Whether it has been added already
         */
        private boolean isOpeningTimeFound (final OpeningTime openingTime) {
                // Default is not found
                boolean isFound = false;

                // Loop through list
                for (final OpeningTime ot : this.getBranchOpeningTimes()) {
                        // Check it
                        if (Objects.equals(ot, openingTime)) {
                                // Found same match
                                isFound = true;
                                break;
                        }
                }

                // Return it
                return isFound;
        }

}