]> git.mxchange.org Git - jfinancials-swing.git/blobdiff - src/org/mxchange/addressbook/manager/contact/ManageableContactAddressbook.java
auto-formatted project + updated jars
[jfinancials-swing.git] / src / org / mxchange / addressbook / manager / contact / ManageableContactAddressbook.java
index f93c982fefa613e550d7dabca0cc41ff0917ce0f..7fb7f011f396632f4e006b56ca81dce2427d9f59 100644 (file)
@@ -26,97 +26,98 @@ import org.mxchange.jcore.model.contact.gender.Gender;
 
 /**
  * An interface for addressbook contact manager
- *
+ * <p>
  * @author Roland Haeder
  */
 public interface ManageableContactAddressbook extends Manageable {
+
        /**
         * Allows the user to enter own cellphone number.
-        *
+        * <p>
         * @return Cellphone number
         */
        public String enterOwnCellNumber ();
 
        /**
         * Allows the user to enter own city name.
-        *
+        * <p>
         * @return City name
         */
        public String enterOwnCity ();
 
        /**
         * Allows the user to enter comment for own entry.
-        *
+        * <p>
         * @return Comment
         */
        public String enterOwnComment ();
 
        /**
         * Allows the user to enter own company name.
-        *
+        * <p>
         * @return Company name
         */
        public String enterOwnCompanyName ();
 
        /**
         * Allows the user to enter own country code.
-        *
+        * <p>
         * @return Country code
         */
        public String enterOwnCountryCode ();
 
        /**
         * Allows the user to enter own email address.
-        *
+        * <p>
         * @return Email address
         */
        public String enterOwnEmailAddress ();
 
        /**
         * Allows the user to enter own family name.
-        *
+        * <p>
         * @return Family name
         */
        public String enterOwnFamilyName ();
 
        /**
         * Allows the user to enter own fax number.
-        *
+        * <p>
         * @return Fax number
         */
        public String enterOwnFaxNumber ();
 
        /**
         * Allows the user to enter own gender.
-        *
+        * <p>
         * @return Gender
         */
        public Gender enterOwnGender ();
 
        /**
         * Allows the user to enter own phone number.
-        *
+        * <p>
         * @return Phone number
         */
        public String enterOwnPhoneNumber ();
 
        /**
         * Allows the user to enter own street and house number.
-        *
+        * <p>
         * @return Street and house number
         */
        public String enterOwnStreet ();
 
        /**
         * Allows the user to enter own surname.
-        *
+        * <p>
         * @return Surname
         */
        public String enterOwnFirstName ();
 
        /**
         * Allows the user to enter own ZIP code.
-        *
+        * <p>
         * @return ZIP code
         */
        public int enterOwnZipCode ();
@@ -128,17 +129,17 @@ public interface ManageableContactAddressbook extends Manageable {
 
        /**
         * Adds given contact to address book
-        *
-        * @param contact Contact being added
-        * TODO Add check for book size
+        * <p>
+        * @param contact Contact being added TODO Add check for book size
         */
        public void registerContact (final Contact contact);
 
        /**
         * Adds given Contact instance to list
-        *
+        * <p>
         * @param contact Contact instance to add
-        * @throws org.mxchange.addressbook.exceptions.ContactAlreadyAddedException If the contact is already added
+        * @throws org.mxchange.addressbook.exceptions.ContactAlreadyAddedException
+        * If the contact is already added
         */
        public void addContact (final Contact contact) throws ContactAlreadyAddedException;
 
@@ -150,7 +151,7 @@ public interface ManageableContactAddressbook extends Manageable {
        /**
         * The user can change address data, like street, ZIP code, city and country
         * of given Contact instance.
-        *
+        * <p>
         * @param contact Instance to change data
         */
        public void doChangeAddressData (final Contact contact);
@@ -158,7 +159,7 @@ public interface ManageableContactAddressbook extends Manageable {
        /**
         * The user can change name data, like gender, surname, family name and
         * company name (if business contact).
-        *
+        * <p>
         * @param contact Instance to change data
         */
        public void doChangeNameData (final Contact contact);
@@ -170,20 +171,21 @@ public interface ManageableContactAddressbook extends Manageable {
 
        /**
         * The user can change other data, like phone numbers or comments.
-        *
+        * <p>
         * @param contact Instance to change data
         */
        public void doChangeOtherData (final Contact contact);
 
        /**
         * Let the user change own data
+        * <p>
         * @throws java.sql.SQLException If an SQL error occurs
         * @throws java.io.IOException If an IO error occurs
         * @throws java.lang.NoSuchMethodException If a method cannot be found
         * @throws java.lang.IllegalAccessException If a method is not accessible
         * @throws java.lang.reflect.InvocationTargetException Any other problems?
         */
-       public void doChangeOwnData () throws IOException , SQLException, NoSuchMethodException, IllegalAccessException, InvocationTargetException;
+       public void doChangeOwnData () throws IOException, SQLException, NoSuchMethodException, IllegalAccessException, InvocationTargetException;
 
        /**
         * Let the user delete other address
@@ -192,7 +194,9 @@ public interface ManageableContactAddressbook extends Manageable {
 
        /**
         * Asks user for own data
-        * @throws org.mxchange.addressbook.exceptions.ContactAlreadyAddedException If own contact is already added
+        * <p>
+        * @throws org.mxchange.addressbook.exceptions.ContactAlreadyAddedException
+        * If own contact is already added
         * @throws java.io.IOException If an IO error was found
         */
        public void doEnterOwnData () throws ContactAlreadyAddedException, IOException;
@@ -205,7 +209,7 @@ public interface ManageableContactAddressbook extends Manageable {
        /**
         * Checks whether own contact is already added by checking all entries for
         * isOwnContact flag
-        *
+        * <p>
         * @return Whether own contact is already added
         * @throws java.io.IOException If an IO error occurs
         */
@@ -213,39 +217,39 @@ public interface ManageableContactAddressbook extends Manageable {
 
        /**
         * Getter for translated column name at given index.
-        *
+        * <p>
         * @param columnIndex Column index
-        * @return Human-readable column name
-        * TODO: This is needed for TableModel in Swing
+        * @return Human-readable column name TODO: This is needed for TableModel in
+        * Swing
         */
        public String getTranslatedColumnName (final int columnIndex);
 
        /**
         * Somewhat "getter" for value from given row and column index
-        *
+        * <p>
         * @param rowIndex Row index
         * @param columnIndex Column index
         * @return Value from given row/column
         * @throws java.lang.NoSuchMethodException If the method was not found
-        * @throws java.lang.IllegalAccessException If the accessed method was not public
-        * @throws java.lang.reflect.InvocationTargetException Something else happened?
-        * TODO: This is needed for TableModel in Swing
+        * @throws java.lang.IllegalAccessException If the accessed method was not
+        * public
+        * @throws java.lang.reflect.InvocationTargetException Something else
+        * happened? TODO: This is needed for TableModel in Swing
         */
        public Object getValueFromRowColumn (final int rowIndex, final int columnIndex) throws NoSuchMethodException, IllegalAccessException, InvocationTargetException;
 
        /**
         * Getter for column name at given index.
-        *
+        * <p>
         * @param columnIndex Column index
-        * @return Database column name
-        * TODO: This is needed for TableModel in Swing
+        * @return Database column name TODO: This is needed for TableModel in Swing
         */
        public String getColumnName (final int columnIndex);
 
        /**
         * Getter for column count
-        * @return Column count
-        * TODO: This is needed for TableModel in Swing
+        * <p>
+        * @return Column count TODO: This is needed for TableModel in Swing
         */
        public int getColumnCount ();
 }