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.events.fax.deleted.AdminDeletedFaxNumberEvent;
  25 import org.mxchange.jphone.events.fax.updated.AdminUpdatedFaxNumberEvent;
  26 import org.mxchange.jphone.events.landline.deleted.AdminDeletedLandLineNumberEvent;
  27 import org.mxchange.jphone.events.landline.updated.AdminUpdatedLandLineNumberEvent;
  28 import org.mxchange.jphone.events.mobile.deleted.AdminDeletedMobileNumberEvent;
  29 import org.mxchange.jphone.events.mobile.updated.AdminUpdatedMobileNumberEvent;
  30 import org.mxchange.jphone.phonenumbers.fax.DialableFaxNumber;
  31 import org.mxchange.jphone.phonenumbers.landline.DialableLandLineNumber;
  32 import org.mxchange.jphone.phonenumbers.mobile.DialableMobileNumber;
  33 import org.mxchange.jusercore.events.user.add.AdminAddedUserEvent;
  34
  35 /**
  36  * An interface for a request web controller (bean) for administrative phone
  37  * number purposes.
  38  * <p>
  39  * @author Roland Haeder<roland@mxchange.org>
  40  */
  41 @Local
  42 public interface JobsPhoneWebApplicationController extends Serializable {
  43
  44         /**
  45          * Event observer for newly added users by adminstrator
  46          * <p>
  47          * @param event Event being fired
  48          */
  49         void afterAdminAddedUserEvent (final AdminAddedUserEvent event);
  50
  51         /**
  52          * Observes events being fired when an administrator has added a new
  53          * contact.
  54          * <p>
  55          * @param event Event being fired
  56          */
  57         void afterAdminAddedContactEvent (final AdminAddedContactEvent event);
  58
  59         /**
  60          * Observes events being fired when an administrator has deleted a fax number
  61          * <p>
  62          * @param event Event being fired
  63          */
  64         void afterAdminDeletedFaxNumberEvent (final AdminDeletedFaxNumberEvent event);
  65
  66         /**
  67          * Observes events being fired when an administrator has deleted a land-line number
  68          * <p>
  69          * @param event Event being fired
  70          */
  71         void afterAdminDeletedLandLineNumberEvent (final AdminDeletedLandLineNumberEvent event);
  72
  73         /**
  74          * Observes events being fired when an administrator has deleted a mobile number
  75          * <p>
  76          * @param event Event being fired
  77          */
  78         void afterAdminDeletedMobileNumberEvent (final AdminDeletedMobileNumberEvent event);
  79
  80         /**
  81          * Observes events being fired when an administrator has updated a fax
  82          * number.
  83          * <p>
  84          * @param event Event being fired
  85          */
  86         void afterAdminUpdatedFaxNumberEvent (final AdminUpdatedFaxNumberEvent event);
  87
  88         /**
  89          * Observes events being fired when an administrator has updated a land-line
  90          * number.
  91          * <p>
  92          * @param event Event being fired
  93          */
  94         void afterAdminUpdatedLandLineNumberEvent (final AdminUpdatedLandLineNumberEvent event);
  95
  96         /**
  97          * Observes events being fired when an administrator has updated a mobile
  98          * number.
  99          * <p>
 100          * @param event Event being fired
 101          */
 102         void afterAdminUpdatedMobileNumberEvent (final AdminUpdatedMobileNumberEvent event);
 103
 104         /**
 105          * Event observer for updated contact data by administrators
 106          * <p>
 107          * @param event Updated contact data event
 108          */
 109         void afterAdminUpdatedContactDataEvent (final AdminUpdatedContactEvent event);
 110
 111         /**
 112          * Returns a list of all mobile numbers. For performance reasons, the
 113          * controller (bean) should be application-scoped as from user to user
 114          * nothing changes. And the controller's post-construct method should load
 115          * all numbers and cache it in the controller.
 116          * <p>
 117          * @return List of all mobile numbers
 118          */
 119         List<DialableMobileNumber> allMobileNumbers ();
 120
 121         /**
 122          * Returns a list of all fax numbers. For performance reasons, the
 123          * controller (bean) should be application-scoped as from user to user
 124          * nothing changes. And the controller's post-construct method should load
 125          * all numbers and cache it in the controller.
 126          * <p>
 127          * @return List of all fax numbers
 128          */
 129         List<DialableFaxNumber> allFaxNumbers ();
 130
 131         /**
 132          * Returns a list of all land-line numbers. For performance reasons, the
 133          * controller (bean) should be application-scoped as from user to user
 134          * nothing changes. And the controller's post-construct method should load
 135          * all numbers and cache it in the controller.
 136          * <p>
 137          * @return List of all land-line numbers
 138          */
 139         List<DialableLandLineNumber> allLandLineNumbers ();
 140
 141 }