updated own name and resources

[jcontacts-lib.git] / src / org / mxchange / jcontacts / contact / ContactSessionBeanRemote.java

diff --git a/src/org/mxchange/jcontacts/contact/ContactSessionBeanRemote.java b/src/org/mxchange/jcontacts/contact/ContactSessionBeanRemote.java
index d03546382cb0bcc5f8e7c8d912a00ae264ce2039..8203cc3313f5daf21d11421bd179d48f0c4314f5 100644 (file)
--- a/src/org/mxchange/jcontacts/contact/ContactSessionBeanRemote.java
+++ b/src/org/mxchange/jcontacts/contact/ContactSessionBeanRemote.java
@@ -1,5 +1,5 @@
 /*
- * Copyright (C) 2016 Roland Haeder<roland@mxchange.org>
+ * 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
@@ -19,30 +19,26 @@ package org.mxchange.jcontacts.contact;
 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.
@@ -57,7 +53,7 @@ public interface ContactSessionBeanRemote extends Serializable {
         * 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
@@ -66,11 +62,11 @@ public interface ContactSessionBeanRemote extends Serializable {
         * <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
@@ -104,4 +100,15 @@ public interface ContactSessionBeanRemote extends Serializable {
         */
        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;
+
 }