2110215 Lab 1-Object-oriented Programming Solution

1. Problem Statement: Guild Member Database

You have been transported into a fantasy world by a magical truck, and was found by a desperate guildmaster who does not know how to use computers. As the only person in this fantasy world who knows how to use a computer, you are asked to implement a system that allows him to manage guild data, including member information and department information.

The program example is shown below. The program should be run from the Main class in the package main.

There are 6 options to do.

2. New Department. Creates a new department of the guild. However, department name cannot be duplicate. If a department with a certain name already exists, then it will be rejected.
Department name also cannot be blank.

3. Remove Department. Removes a chosen department. If the removed department has members in it, all of the members in that department will be moved to the unassigned department at index 0.

4. New Member. Adds a new guild member to the list by inputting name, job title, and salary. If left blank, the program will input “Anon”, “Adventurer”, and “0” respectively. Then, the user chooses the department to put the new member in.

5. Remove Member. Simply removes a member from the guild. Unlike remove department, removed members are permanently removed.

The diagram of the program is illustrated below. There are 4 classes: Main, GuildDatabase, Department, and GuildMember.

* Note that Access Modifier Notations can be listed below
* Also note that while other methods have been provided, only methods that you have to implement are listed here
+ (public)
# (protected)
- (private)

2.1 Class GuildMember (package logic)
2.1.1 Fields
- String name The member’s name. Can contain space. Cannot be blank. If blank, will be set to “Anon”.
- String jobTitle The member’s job title. Can contain space. Cannot be blank. If blank, will be set to “Adventurer”.
- String myDepartment The member’s department.
- int salary The member’s salary. Must be greater than 0 and lesser than 100000.


2.1.2 Constructors
+ GuildMember(String, String, int) /*Fill Code*/
Initialize all fields. For Department, set it as “Unassigned” here.

Note: You should use setter to set the value of all fields in order to handle negative value case and special case.
2.1.3 Methods
+ void setName(String) /*Fill Code*/
This method will set name of the member. If the String is empty, the method will set the name as “Anon”.

Hint: There is a non-static method called isBlank() in the String class. It returns true if a String consists of only whitespace.

Example:
String exampleString = “ “; exampleString.isBlank() will return true.
+ void setJobTitle(String) /*Fill Code*/
This method will set the job title of the member. If the String is empty, the method will set the job title as “Adventurer”.

- void setSalary(int) /*Fill Code*/
This method will set the salary of the member. If the salary is less than 0, it will be set as 0. If the salary is greater than 100000, it will be set as 100000.
Getter & Setter methods for all remaining variables /*Fill Code*/

2.2 Class Department (package logic)
2.2.1 Fields
- String name The name of the department. It should never be empty.
- ArrayList<GuildMembers> departmentMembers The GuildMembers in this department, contained in a list.

2.2.2 Constructors
+ Department(String) /*Fill Code*/
Initialize the list, as well as set the name of the department.

Note: You should use setter to set the value of all fields in order to handle negative value case and special case.

2.2.3 Methods
+ boolean setName(String) /*Fill Code*/
Set the name of the department and returns
whether or not the name change was a success.
- If the name is not blank, then change the department name and return true.
- If the name is blank, then DO NOT change the department name and return false.
+ String getName() /*Fill Code*/
Returns the name of the department.
+ void addMember(GuildMember) /*Fill Code*/
Add the given member to the list of members, as well as call setMyDepartment(String) to set their department to match this department’s name.
+ void
addMultipleMembers(ArrayList<GuildMembe r>) /*Fill Code*/
Add all the members in the given arraylist to this list. Make sure you call setMyDepartment(String) to set all of their deparments to match this department’s name.
+ GuildMember removeMember(int) /*Fill Code*/
Removes a member from the given index from the list of members, and return the removed member.
+ GuildMember getMember(int) /*Fill Code*/
Returns a member from the given index.
+ ArrayList<GuildMember> getAllMembers() /*Fill Code*/
Returns all members in the department.

2.3 Class GuildDatabase (package logic)
2.3.1 Fields
- ArrayList<Department> myDepartments The list of departments contained in this database.

2.3.2 Constructors
+ GuildDatabase() /*Fill Code*/
Initialize myDepartments as an empty ArrayList.

2.3.3 Methods
+ boolean createDepartment(String) /*Fill Code*/
Attempts to create a new department with the given name. Returns true or false depends on whether or not a department was successfully created.
- If the department’s name duplicates another department inside myDepartments, DO NOT create the department and return false.
- Otherwise, create a new department with the given name and return true.
+ boolean isExists(String) /*Fill Code*/
This method runs a check with all departments currently in the databas, using the String given.
- If there is a department with the same name as the given name, return true.
- If there are no departments with the same name as the given name, return false.
+ ArrayList<GuildMember> removeDepartment(int) /*Fill Code*/
Remove a department from the given index, and return a list of all members that was in that department before it got removed.

2.4 Class Main (Static class): (package Main)
Details on DuplicateGuildNameException and EmptyGuildNameException will be given to you in the next part.
2.4.1 Fields
+ GuildDatabase myDatabase
/*Fill Code*/
The database system.
+ Scanner kb /*Fill Code*/
Scanner for getting input.
2.4.2 Constructors
This class does not need a constructor.
2.4.3 Methods
public static boolean addDepartment(String) /*Fill Code*/
Create a new department using the given name. Returns true or false depending on whether or not the department is successfully created.
- If the given name is blank, DO NOT create the department. Throw EmptyGuildNameException and return false, as well as print the exception to tell the user that the name cannot be blank.
- If the given name duplicates a department’s name that already exists, DO NOT create the department. Throw
DuplicateGuildNameException and return false, as well as print the exception to tell the user that the name cannot be duplicate.
- Otherwise, create the department and return true.
NOTE: Program should still be running after throwing exception. It should return you to the main menu.

NOTE 2: Don’t throw exceptions in the method’s declaration. Instead, you should use try/catch to throw exceptions here.
public static void
removeDepartmentFromDatabase(int) /*Fill Code*/
Remove a department at the given index from the database, and put all the members that used to be in that department into the Unassigned department, which can be called with the getUnassignedDepartment() method. Finally, confirm the user the number of members that are moved to the unassigned department.

2.5 Exception Classes (package exception)
There are two exception classes provided for you in the package exception.
• EmptyGuildNameException should be thrown when inputting an empty guild name. When printed, it will display an error message that says guild name should not be empty.
• DuplicateGuildNameException should be thrown when inputting a duplicate guild name. When printed, it will display an error message that says guild name should not be duplicate.
• To throw an exception, do:
o throw new EmptyGuildNameException(); o throw new DuplicateGuildNameException();

3. Test Scenario
(User input is in green.)


4. Exception Scenarios
Throwing DuplicateGuildNameException

Throwing EmptyGuildNameException