2 * Copyright (C) 2016 - 2020 Free Software Foundation
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.
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.
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/>.
17 package org.mxchange.jjobs.beans.phone.list;
19 import java.io.Serializable;
20 import java.util.List;
21 import org.mxchange.jphone.exceptions.phone.PhoneEntityNotFoundException;
22 import org.mxchange.jphone.model.phonenumbers.fax.DialableFaxNumber;
23 import org.mxchange.jphone.model.phonenumbers.landline.DialableLandLineNumber;
26 * An interface for a request web controller (bean) for administrative phone
29 * @author Roland Häder<roland@mxchange.org>
31 public interface JobsPhoneListWebViewController extends Serializable {
34 * Returns a list of all fax numbers. For performance reasons, the
35 * controller (bean) should be view-scoped as from user to user nothing
36 * changes. And the controller's post-construct method should load all
37 * numbers and cache it in the controller.
39 * @return List of all fax numbers
41 List<DialableFaxNumber> getAllFaxNumbers ();
44 * Returns a list of all land-line numbers. For performance reasons, the
45 * controller (bean) should be view-scoped as from user to user nothing
46 * changes. And the controller's post-construct method should load all
47 * numbers and cache it in the controller.
49 * @return List of all land-line numbers
51 List<DialableLandLineNumber> getAllLandLineNumbers ();
54 * Finds a fax entry by given id number
56 * @param faxNumberId Fax entry id number
58 * @return A valid fax instance
60 * @throws PhoneEntityNotFoundException If the entity was not found
62 DialableFaxNumber findFaxNumberById (final Long faxNumberId) throws PhoneEntityNotFoundException;
65 * Finds a land-line entry by given id number
67 * @param landLineNumberId Land-line entry id number
69 * @return A valid land-line instance
71 * @throws PhoneEntityNotFoundException If the entity was not found
73 DialableLandLineNumber findLandLineNumberById (final Long landLineNumberId) throws PhoneEntityNotFoundException;