src/java/org/mxchange/jjobs/beans/phone/JobsPhoneWebApplicationController.java

   1 /*
   2  * Copyright (C) 2016 Roland Haeder
   3  *
   4  * This program is free software: you can redistribute it and/or modify
   5  * it under the terms of the GNU Affero General Public License as
   6  * published by the Free Software Foundation, either version 3 of the
   7  * License, or (at your option) any later version.
   8  *
   9  * This program is distributed in the hope that it will be useful,
  10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12  * GNU Affero General Public License for more details.
  13  *
  14  * You should have received a copy of the GNU Affero General Public License
  15  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  16  */
  17 package org.mxchange.jjobs.beans.phone;
  18
  19 import java.io.Serializable;
  20 import java.util.List;
  21 import javax.ejb.Local;
  22 import org.mxchange.jcontacts.events.contact.add.AdminAddedContactEvent;
  23 import org.mxchange.jcontacts.events.contact.update.AdminUpdatedContactEvent;
  24 import org.mxchange.jphone.phonenumbers.fax.DialableFaxNumber;
  25 import org.mxchange.jphone.phonenumbers.landline.DialableLandLineNumber;
  26 import org.mxchange.jphone.phonenumbers.mobile.DialableMobileNumber;
  27 import org.mxchange.jusercore.events.user.add.AdminAddedUserEvent;
  28
  29 /**
  30  * An interface for a request web controller (bean) for administrative phone
  31  * number purposes.
  32  * <p>
  33  * @author Roland Haeder<roland@mxchange.org>
  34  */
  35 @Local
  36 public interface JobsPhoneWebApplicationController extends Serializable {
  37
  38         /**
  39          * Event observer for newly added users by adminstrator
  40          * <p>
  41          * @param event Event being fired
  42          */
  43         void afterAdminAddedUserEvent (final AdminAddedUserEvent event);
  44
  45         /**
  46          * Observes events being fired when an administrator has added a new
  47          * contact.
  48          * <p>
  49          * @param event Event being fired
  50          */
  51         void afterAdminAddedContact (final AdminAddedContactEvent event);
  52
  53         /**
  54          * Event observer for updated contact data by administrators
  55          * <p>
  56          * @param event Updated contact data event
  57          */
  58         void afterAdminUpdatedContactDataEvent (final AdminUpdatedContactEvent event);
  59
  60         /**
  61          * Returns a list of all mobile numbers. For performance reasons, the
  62          * controller (bean) should be application-scoped as from user to user
  63          * nothing changes. And the controller's post-construct method should load
  64          * all numbers and cache it in the controller.
  65          * <p>
  66          * @return List of all mobile numbers
  67          */
  68         List<DialableMobileNumber> allMobileNumbers ();
  69
  70         /**
  71          * Returns a list of all fax numbers. For performance reasons, the
  72          * controller (bean) should be application-scoped as from user to user
  73          * nothing changes. And the controller's post-construct method should load
  74          * all numbers and cache it in the controller.
  75          * <p>
  76          * @return List of all fax numbers
  77          */
  78         List<DialableFaxNumber> allFaxNumbers ();
  79
  80         /**
  81          * Returns a list of all land-line numbers. For performance reasons, the
  82          * controller (bean) should be application-scoped as from user to user
  83          * nothing changes. And the controller's post-construct method should load
  84          * all numbers and cache it in the controller.
  85          * <p>
  86          * @return List of all land-line numbers
  87          */
  88         List<DialableLandLineNumber> allLandLineNumbers ();
  89
  90 }