2 * Copyright (C) 2016 Roland Haeder
4 * This program is free software: you can redistribute it and/or modify
5 * it under the terms of the GNU General Public License as published by
6 * the Free Software Foundation, either version 3 of the License, or
7 * (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 General Public License for more details.
14 * You should have received a copy of the GNU General Public License
15 * along with this program. If not, see <http://www.gnu.org/licenses/>.
17 package org.mxchange.jcontacts.contact;
19 import java.io.Serializable;
20 import java.util.List;
21 import javax.ejb.Remote;
22 import org.mxchange.jcontacts.exceptions.ContactAlreadyAddedException;
23 import org.mxchange.jcontacts.exceptions.ContactNotFoundException;
26 * A remote interface for general contact purposes
28 * @author Roland Haeder<roland@mxchange.org>
31 public interface ContactSessionBeanRemote extends Serializable {
34 * Deletes given contact instance
36 * @param contact Contact instance being deleted
38 void deleteContactData (final Contact contact);
41 * Checks whether the given email address is already registered. The email
42 * address should be validated by EmailAddressValidator before calling this
45 * @param emailAddress Email address to check
47 * @return Whether the email address is already registered
49 boolean isEmailAddressRegistered (final String emailAddress);
52 * Adds (persists) given contact instance, if not found. If successfull, the
53 * field contactId contains the running number, otherwise an exception is
56 * @param contact Contact to be added
58 * @return Updated contact instance
60 * @throws org.mxchange.jcontacts.exceptions.ContactAlreadyAddedException
61 * Contact already found
63 Contact addContact (final Contact contact) throws ContactAlreadyAddedException;
66 * Checks if the given contact can be found by checking the whole list.
68 * @param contact Contact instance to check
70 * @return Whether the found instance or null
72 Contact lookupContact (final Contact contact);
75 * Updates given contact data
77 * @param contact Contact data to update
78 * @param isCellphoneUnlinked Whether a cellphone entry has been unlinked in
80 * @param isLandlineUnlinked Whether a land-line entry has been unlinked in
82 * @param isFaxUnlinked Whether a fax entry has been unlinked in contact
85 * @return Updated contact instance
87 Contact updateContactData (final Contact contact, final boolean isCellphoneUnlinked, final boolean isLandlineUnlinked, final boolean isFaxUnlinked);
90 * Updates given contact in database. Please note that the id number must be
91 * set. This method should also make sure that cellphone, land-line and fix
92 * numbers are updated, too.
94 * @param contact Contact to update
96 * @return Updated contact instance
98 Contact updateContactData (final Contact contact);
101 * Returns a list of all found contacts
103 * @return A list of call contacts
105 List<Contact> getAllContacts ();
108 * Returns a list of all registered email addresses.
110 * @return A list of all email addresses
112 List<String> getEmailAddressList ();
115 * Returns a contact instance which has the given id number.
117 * @param contactId Contact id
119 * @return Contact instance
121 * @throws ContactNotFoundException If the contact was not found
123 Contact findContactById (final Long contactId) throws ContactNotFoundException;
126 * Returns a contact instance which has the given email address.
128 * @param emailAddress Email address
130 * @return Contact instance
132 * @throws ContactNotFoundException If the contact was not found
134 Contact findContactByEmailAddress (final String emailAddress) throws ContactNotFoundException;