CSCI 2600代做、代写Java设计程序

日期：2024-08-13 09:56

CSCI 2600 — Principles of Software

Optional Extra Credit Homework 8:

RPI Campus Paths GUI

Due: Friday, Aug. 16, 2024, 11:59:59 pm

Submission Instructions

ˆ This assignment uses the same repository as Homework assignments 4, 5, 6, and 7, so when

you are ready to start working on Homework 8, pull Homework 8 ffles from the repository

by right-clicking on your Homework 4, 5, 6 and 7 project in Eclipse and selecting Team →

Pull... Make sure that When pulling is set to Merge, then click Finish.

ˆ Be sure to commit and push the ffles to Submitty. Follow the directions in the version control

handout for adding and committing ffles.

ˆ Be sure to add any additional ffles to your repo using Team/Add to Index.

ˆ Important: You must press the Grade My Repository button, or your answers will not

be graded.

IMPORTANT NOTES:

You should have package hw8 with the usual directory structure. Write your code under

src/main/java/hw8 and your tests under src/test/java/hw8 (shows as hw8 under src/test/java

in Package Explorer).

Introduction

In Homework 7, you wrote a program that found shortest routes between buildings on the RPI

Campus. Now we are asking for a graphical user interface (GUI) that visually draws routes.

You will build your GUI using Java’s JavaFX library. In completing this assignment, you will get

practice using JavaFX, event-driven programming, and the MVC (Observer) design pattern.

Important note: you are not allowed to use Swing, AWT, or any library or framework other than

JavaFX and the standard Java library.

You are expected to ffx any bugs from Homework 7 that affect the correctness or performance of

your application in Homework 8. Furthermore, your Homework 8 should use the model you created

in Homework 7. This may require that you modify your Homework 7 code, that is OK, but be sure

that Homework 7 continues to pass all tests!GUI Requirements

You will write a GUI and a main class to launch it named RPICampusPathsMain.java. This

assignment is deliberately open-ended: the exact appearance and functionality of your GUI are up

to you. The only requirements are documented below.

For the most part, we are not grading on aesthetics: it doesn’t matter whether your GUI looks

pretty as long as it implements the required features. Nevertheless, a design which is genuinely

confusing or hard to use (at our discretion) may not receive full credit. For example, we will deduct

points if we can’t easily ffgure out how to select the two buildings, if it’s hard to see the selected

path, or if we can only see the whole GUI on a 27-inch screen. In addition, your program should

be generally responsive: for instance, the GUI should not take an unusually long time to ffnd and

display paths.

Your GUI is a new View and Controller for your Campus Paths application. Ideally, you should

not have to make any changes to your Homework 7 model classes — they already implement all

the model functionality that you need. If you have to make any small changes (for instance, if your

design in Homework 7 was poor and some model methods were too closely tied to your text view),

then you may do so. As always, all tests from previous homework assignments must continue to

pass, so you may also need to change your Homework 7 View and Controller in that case. In ffle

answers/hw8 model-changes.pdf, list any changes you made to the model. For each, write a 1-2

sentence explanation of why the change was necessary and what you could have done differently on

Homework 7 to create a more general and reusable Model. If you made no changes, write “None”

for this section.

Window size

At startup, your GUI must fft and be usable on a screen with resolution 1024 x 768 and above.

Most computers provide a way to change the screen resolution, which you can use for testing.

Required features

Your GUI must provide the following features:

ˆ At startup, load the map data from data/RPI map data Edges.csv and

data/RPI map data Nodes.csv which you should already have in your repository from Homework

7. This should be in your model, not your view. There is no need to duplicate ffles;

load them directly from the data/ directory.

ˆ Display the map of RPI campus. You may remove the part at the bottom with the building

names if you need.

Important note: download the map from the course Web site and save it into your data/

directory: data/RPI campus map 2010 extra nodes edges.png. DO NOT commit the map

as the large ffle may break the limit on repo size. When testing, we will copy the map into

your data/ directory under the name RPI campus map 2010 extra nodes edges.png.

ˆ Allow the user to select two buildings for ffnding a route. You need to allow the user toselect endpoints of a path by clicking with the mouse on the map. In addition, you may also

implement some other approach, like selection using menus or dropdown lists.

ˆ Mark or highlight the selected buildings and/or path endpoints on the map.

ˆ Draw the shortest route between the selected buildings on the map. The map should automatically

be zoomed in or out when a route is drawn, so that the route is almost as large as

possible while still fftting in the window.

ˆ As the window is resized, make the map shrink or grow to fft the window.

ˆ Maintain the proportions of the map so that it zooms in on a route without becoming distorted.

ˆ

Place the map in a ScrollPane so it can be displayed full-size. When displaying a route or

buildings, jump to that spot on the map to resize if needed. (Hint: you probably need to

override getPrefViewportHeight() and getPrefViewportWidth() in your “canvas” class

for scrolling to work.)

ˆ Allow the user to drag the map with the mouse to change the portion that is shown.

ˆ Add zoom buttons, possibly with a way to recenter the image for zooming if a hand is not

available to drag it (e.g., mouse double click).

ˆ Allow the user to reset the GUI by clicking a reset button. This button should clear all

markings on the map and all other controls (such as building selectors), setting the GUI back

to its initial state.

ˆ Operate robustly. No matter what the user does, your program should never allow an exception

message to bubble up to the console window, and your GUI should never crash, freeze,

display rendering artifacts, or reach a buggy/invalid state.

JavaFX scene elements and GUI builders

Use only components from the JavaFX library for this assignment.

Some IDEs, such as NetBeans, will let you specify the appearance and behavior of your GUI and

automatically generate the code for you. JavaFX also implements FXML, a markup language from

which GUI code can be generated. You may use these tools, if you wish.

1 Launching your GUI

We will launch your GUI from Run As → Java Application.

List all features you implemented in answers/hw8 features.pdf. You must commit

answers/hw8 features.pdf ffle to get credit for any features of your solution.

Writing automated tests for GUI is difffcult and usually involves special frameworks that are

beyond the scope of this course. For this reason, you are not required to write unit tests. We will

test your solution by running your main program.Reffection [0.5 points]

Please answer the following questions in a ffle named hw8 reflection.pdf in your answers/ directory.

Answer brieffy, but in enough detail to help you improve your own practice via introspection

and to enable the course staff to improve Principles of Software in the future.

(1) In retrospect, what could you have done better to reduce the time you spent solving this

assignment?

(2) What could the Principles of Software staff have done better to improve your learning experience

in this assignment?

(3) What do you know now that you wish you had known before beginning the assignment?

We will be awarding up to 1 extra credit point (at the discretion of the grader) for particularly

insightful, constructive, and helpful reffection statements.

Collaboration[0.5 points]

Please answer the following questions in a ffle named hw8 collaboration.pdf in your answers/

directory.

The standard integrity policy applies to this assignment.

State whether you collaborated with other students. If you did collaborate with other students,

state their names and a brief description of how you collaborated.

Grade Breakdown

ˆ Model Changes: 5 pts.

ˆ Basic Functionality of GUI Application: 8 pts.

ˆ Features of GUI Application: 3 pts. per required feature

ˆ Collaboration and reffection: 1 pt.

Hints

General GUI Advice

If you have never used JavaFX, it is well worth your time to study some tutorials, read the

example code, and generally get comfortable with GUI programming before diving into the

assignment.

Abstraction functions, representation invariants, and checkRep() are not required for GUI

classes because they generally do not represent ADTs.

User testing is a great way to verify that your interface is as easy to use as you think it is.

Show your GUI to your friend/roommate/family member. Can they ffgure out how to use

it without directions from you?As usual, remember to follow good methodology and class decomposition among other best

practices for style.

Programming With JavaFX

Oracle’s JavaFX tutorials are a useful resource. Also remember to use the Java API and

JavaFX documentation, to see what classes and methods are available and how to use them.

What to Turn In

You must commit and push the following ffles to Submitty. Don’t forget to click “Grade My

Repository” button on Submitty!

ˆ src/main/java/hw8/RPICampusPathsMain.java

ˆ src/main/java/hw8/*.java [your GUI classes]

ˆ src/main/resources/fxml/*.fxml [your FXML ffles, if any]

ˆ src/main/resources/img/*.* [your image ffles, if any]

ˆ answers/hw8 model-changes.pdf [list of changes to HW7. The ffle may simply contain

“None”.]

ˆ answers/hw8 features.pdf [list of all features you implemented.]

ˆ answers/hw8 reflection.pdf

ˆ answers/hw8 collaboration.pdf

Errata

Check the Submitty Discussion Forum for possible errata or other relevant information.

Q & A

None yet.

Parts of this homework were copied from the University of Washington Software Design and

Implementation class by Michael Ernst.