Make sure you can build and execute an Android application on computer.
Will add functionality across the application stack to solidify understanding on Model-View-Controller.
Guidelines:
Model
Classes that hold data for the application, and the business rules. These are normally POJO (plain old java objects) and are independent of any development frameworks you are using.
View
Screens that display and get information from the user. (In Android, these are the .xml layout files)
Controller
Class associated with the view that has all the event handling code and code that interacts with the model to update information obtained from the model. In Android, these are called Activities.
================================================
Running the App
Download M3.zip file. Extract into IDE project directory (Or just import code files)
If run the project, should build and execute normally. Should be able to add a student and see list update.
New Feature
Be able to add student's class standing (freshman, sophomore, etc)
This requires a change in Model, View and Controller.
Usually start wherever (Prof prefers to start with Model)
================================================
Model Changes
Focus on student class.
To support the class standing, we will first need to create a new class named ClassStanding which is an enum with the values FRESHMAN, SOPHOMORE, JUNIOR, and SENIOR. Give each class a two character representation "FR", "SO", "JR" and "SR".
Now add an attribute to Student which holds the ClassStanding enum.
Add getter and setter for the ClassStanding
Make a new 3 param constructor which includes name, major and class standing. Keep the old two param constructor for backwards compatibility and use constructor chaining to give a default class standing of Freshman.
Change the toString method to contain the class standing also.
At this point the model should be runnable and we should see the changes reflected in the list. Go ahead and run the app at this point. You should see all the students listed as before except with their classes shown. If you don't see the classes, be sure your constructor chaining is passing the freshman value to the 3 param version. Also be sure you added the class standing to the toString method.
================================================
View Changes
Now you will need to add some widgets to the view so that when adding a new student, you can get the class standing from the user. Open the content_edit_student.xml file.
You will see that the dialog is laid out in a grid layout with labels and input fields. You will need to add to the grid some way to input the class standing. I used a combobox, but 4 radio buttons would work. You could use a text field and type in the standing, but that is error prone and you would need to validate that an incorrect entry was not made.
Once you have made the changes to the screen be sure and save the .fxml file.
Now you should be able to run the app again, just to make sure everything is ok. You should be able to hit the add student button and your dialog should pop up with your new UI features showing. It wont actually do anything yet, and if you used a combobox like me, it won't have any values in it. To make the display actually work, we have to edit one more class, the controller.
================================================
Controller Changes
We must add items to the StudentEditController class (since this is the controller for our view).
Add an @FXML reference to the widgets you added for class standing. This is how you will pull data out of the widget to pass to the model. Be sure the spelling for the fxid matches what is in the .fxml file exactly.
Edit the initialize method to handle any start up code you need. If you used a combobox like me, this is where you will populate the box with the different classes (Freshman, etc). Remember that calling values() on an enum will give you an array. You will need to wrap this in an ObservableList. I made a static helper function that did that for me in the model.
Edit the setStudent method to set your widget to a default value
Edit the OK button press to pull the information out of your new widget and put into the student instance.
If you used a free text entry field, you will need to edit the isInputValid method to check that a valid class was entered. If you used a constrained widget like radio buttons or combo box where it is impossible to enter a bad value, then you do not have to do any validation.
Now run the app. You should be able to enter new students and their standing and see it reflected in the UI. if not, then check your code through the complete stack. Are you calling the setters in the model to update the information? Are you pulling the information out of the widget correctly?
Purpose
Make sure you can build and execute an Android application on computer. Will add functionality across the application stack to solidify understanding on Model-View-Controller.
Guidelines:
Model
View
Controller
================================================ Running the App
New Feature
================================================ Model Changes Focus on student class.
At this point the model should be runnable and we should see the changes reflected in the list. Go ahead and run the app at this point. You should see all the students listed as before except with their classes shown. If you don't see the classes, be sure your constructor chaining is passing the freshman value to the 3 param version. Also be sure you added the class standing to the toString method.
================================================ View Changes Now you will need to add some widgets to the view so that when adding a new student, you can get the class standing from the user. Open the content_edit_student.xml file.
You will see that the dialog is laid out in a grid layout with labels and input fields. You will need to add to the grid some way to input the class standing. I used a combobox, but 4 radio buttons would work. You could use a text field and type in the standing, but that is error prone and you would need to validate that an incorrect entry was not made.
Once you have made the changes to the screen be sure and save the .fxml file.
Now you should be able to run the app again, just to make sure everything is ok. You should be able to hit the add student button and your dialog should pop up with your new UI features showing. It wont actually do anything yet, and if you used a combobox like me, it won't have any values in it. To make the display actually work, we have to edit one more class, the controller.
================================================ Controller Changes We must add items to the StudentEditController class (since this is the controller for our view).
Now run the app. You should be able to enter new students and their standing and see it reflected in the UI. if not, then check your code through the complete stack. Are you calling the setters in the model to update the information? Are you pulling the information out of the widget correctly?
================================================ Submission
Zip up your complete project directory and submit to the assignment.
================================================ Grading