/*
- * Copyright (C) 2016 Roland Haeder
+ * Copyright (C) 2016 Roland Häder
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
import java.io.Serializable;
import java.util.List;
import javax.ejb.Remote;
-import org.mxchange.jcontacts.exceptions.ContactAlreadyAddedException;
import org.mxchange.jcontacts.exceptions.ContactNotFoundException;
/**
* A remote interface for general contact purposes
* <p>
- * @author Roland Haeder<roland@mxchange.org>
+ * @author Roland Häder<roland@mxchange.org>
*/
@Remote
public interface ContactSessionBeanRemote extends Serializable {
/**
- * Adds (persists) given contact instance, if not found. If successfull, the
- * field contactId contains the running number, otherwise an exception is
- * thrown.
- *
- * @param contact Contact to be added
+ * Checks whether the given email address is already registered. The email
+ * address should be validated by EmailAddressValidator before calling this
+ * method.
* <p>
- * @return Updated contact instance
+ * @param emailAddress Email address to check
* <p>
- * @throws org.mxchange.jcontacts.exceptions.ContactAlreadyAddedException
- * Contact already found
+ * @return Whether the email address is already registered
*/
- Contact addContact (final Contact contact) throws ContactAlreadyAddedException;
+ boolean isEmailAddressRegistered (final String emailAddress);
/**
* Checks if the given contact can be found by checking the whole list.
* Updates given contact data
* <p>
* @param contact Contact data to update
- * @param isCellphoneUnlinked Whether a cellphone entry has been unlinked in
+ * @param isMobileUnlinked Whether a mobile entry has been unlinked in
* contact instance
* @param isLandlineUnlinked Whether a land-line entry has been unlinked in
* contact instance
* <p>
* @return Updated contact instance
*/
- Contact updateContactData (final Contact contact, final boolean isCellphoneUnlinked, final boolean isLandlineUnlinked, final boolean isFaxUnlinked);
+ Contact updateContactData (final Contact contact, final boolean isMobileUnlinked, final boolean isLandlineUnlinked, final boolean isFaxUnlinked);
/**
* Updates given contact in database. Please note that the id number must be
- * set. This method should also make sure that cellphone, land-line and fix
+ * set. This method should also make sure that mobile, land-line and fix
* numbers are updated, too.
* <p>
* @param contact Contact to update
*/
Contact findContactById (final Long contactId) throws ContactNotFoundException;
+ /**
+ * Returns a contact instance which has the given email address.
+ * <p>
+ * @param emailAddress Email address
+ * <p>
+ * @return Contact instance
+ * <p>
+ * @throws ContactNotFoundException If the contact was not found
+ */
+ Contact findContactByEmailAddress (final String emailAddress) throws ContactNotFoundException;
+
}