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

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