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 064145123ed91b7db5e58e20416252e42869e07f..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
@@ -24,25 +24,36 @@ 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 {
 
+       /**
+        * Checks whether the given email address is already registered. The email
+        * address should be validated by EmailAddressValidator before calling this
+        * method.
+        * <p>
+        * @param emailAddress Email address to check
+        * <p>
+        * @return Whether the email address is already registered
+        */
+       boolean isEmailAddressRegistered (final String emailAddress);
+
        /**
         * Checks if the given contact can be found by checking the whole list.
         * <p>
         * @param contact Contact instance to check
         * <p>
-        * @return Whether there is already an entry
+        * @return Whether the found instance or null
         */
-       boolean isContactFound (final Contact contact);
+       Contact lookupContact (final Contact contact);
 
        /**
         * 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
@@ -51,7 +62,18 @@ 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 mobile, land-line and fix
+        * numbers are updated, too.
+        * <p>
+        * @param contact Contact to update
+        * <p>
+        * @return Updated contact instance
+        */
+       Contact updateContactData (final Contact contact);
 
        /**
         * Returns a list of all found contacts
@@ -78,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;
+
 }