2 * Copyright (C) 2015 Roland Haeder
\r
4 * This program is free software: you can redistribute it and/or modify
\r
5 * it under the terms of the GNU General Public License as published by
\r
6 * the Free Software Foundation, either version 3 of the License, or
\r
7 * (at your option) any later version.
\r
9 * This program is distributed in the hope that it will be useful,
\r
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
\r
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
\r
12 * GNU General Public License for more details.
\r
14 * You should have received a copy of the GNU General Public License
\r
15 * along with this program. If not, see <http://www.gnu.org/licenses/>.
\r
17 package org.mxchange.addressbook.client;
\r
19 import org.mxchange.addressbook.FrameworkInterface;
\r
20 import org.mxchange.addressbook.UnhandledUserChoiceException;
\r
21 import org.mxchange.addressbook.contact.Contact;
\r
22 import org.mxchange.addressbook.menu.item.SelectableMenuItem;
\r
25 * An interface for application clients
\r
27 * @author Roland Haeder
\r
29 public interface Client extends FrameworkInterface {
\r
32 * Displays a "box" for the address
\r
34 * @param contact Contact to show address from
\r
36 public void displayAddressBox (final Contact contact);
\r
39 * Displays a message to the user
\r
41 * @param message Message to show to the user
\r
43 public void outputMessage (final String message);
\r
46 * Displays a "box" for the name
\r
48 * @param contact Contact to show name from
\r
50 public void displayNameBox (final Contact contact);
\r
53 * Displays a "box" for other data
\r
55 * @param contact Contact to show other data from
\r
57 public void displayOtherDataBox (final Contact contact);
\r
60 * Let the user choose what to change on the address: [n]ame, [a]ddress,
\r
63 * @param contact Contact instance to let the user change data
\r
64 * @throws UnhandledUserChoiceException If choice is not supported
\r
66 public void userChooseChangeContactData (final Contact contact) throws UnhandledUserChoiceException;
\r
69 * Asks the user for a choice and proceeds accordingly
\r
71 * @throws UnhandledUserChoiceException If choice is not supported
\r
73 public void doUserMenuChoice () throws UnhandledUserChoiceException ;
\r
76 * Enables isRunning attribute which singals that the client is running
\r
78 public void enableIsRunning();
\r
81 * Asks the the user to enter a single character which must match validChars
\r
83 * @param validChars Valid chars that are accepted
\r
84 * @param message Message to user
\r
85 * @return Allowed character
\r
87 public char enterChar (final char[] validChars, final String message);
\r
90 * Reads a string of minimum and maximum length from the user. An empty
\r
91 * string should be generally not allowed, but might be okay for e.g.
\r
94 * @param minLength Minimum length of the string to read
\r
95 * @param maxLength Maximum length of the string to read
\r
96 * @param message Message to user
\r
97 * @param allowEmpty Whether empty strings are allowed
\r
98 * @return Entered string by user or null if empty string is allowed
\r
100 public String enterString (final int minLength, final int maxLength, final String message, final boolean allowEmpty);
\r
103 * Reads an integer (int) from the user
\r
105 * @param minimum Minimum allowed number
\r
106 * @param maximum Maximum allowed number
\r
107 * @param message Message to user
\r
108 * @return Entered string by user or null if empty string is allowed
\r
110 public int enterInt (final int minimum, final int maximum, final String message);
\r
113 * Setter for current menu choice
\r
115 * @param currentMenu Current menu choice
\r
117 public void setCurrentMenu (final String currentMenu);
\r
120 * Some "Getter" for menu item
\r
122 * @param accessKey Key to press to access this menu
\r
123 * @param text Text to show to user
\r
126 public SelectableMenuItem getMenuItem (final char accessKey, final String text);
\r
129 * Determines whether the client is still active by checking some
\r
132 * @return Whether the client is still active
\r
134 public boolean isRunning();
\r
137 * Shows given menu entry in client
\r
139 * @param item Menu item to show
\r
141 public void showEntry (final SelectableMenuItem item);
\r
144 * Shows introduction to user
\r
146 public void showWelcome();
\r
149 * Shows current menu selection to the user
\r
151 public void showCurrentMenu();
\r