Due: Ideally by the end of class, but not later than 11:59pm Friday Sep 29.
The purpose of this exercise is to give you practice with implementing the Controller component of the Model-View-Controller design pattern, by means of a textual, console-based controller.
You may work freely with other students on this exercise!
In the starter code, you are given an interface representing a controller for Tic Tac Toe, with a single method,
Your task is to implement the
TicTacToeController interface. Put your new controller code in the same package alongside your Tic Tac Toe model as it will depend on the model.
You are also given a class
Main with a
main method that will allow you to test your game interactively.
You will need to create one additional class: a public class named
TicTacToeConsoleController that implements
TicTacToeController, with a single public constructor that takes two arguments, a
Readable and an
Appendable (in that order).
You will fill in the fields and the method definitions as appropriate. You may also define other classes at your
option as needed.
The controller will output game state and prompts to the
Appendable, and read inputs from the
Readable corresponding to user moves. The
append() method on
Appendable throws a checked exception,
playGame() method should not throw this exception. If it occurs, your
playGame() should catch it and throw an
A single move consists of two numbers, specifying the row and column of the intended move position. Board positions
for these moves are numbered from 1. For example, to mark X in the upper left cell, the user would enter
"1 1" at the first prompt. To mark O in the upper right cell on the second move, the user would enter
To quit a game in progress, the user can enter
Q at any time.
The game state is the output of the model’s
toString() method, followed by a carriage return (
\n). The move prompt is
"Enter a move for " + model.getTurn().toString() + ":\n"
model is an instance of your Tic Tac Toe Model).
If a non-integer value is entered, it should be rejected with an error message. If an invalid move is entered, namely, two valid integers, but the proposed move was deemed invalid by the model, the controller should give an error message. The message text is up to you, but should end with a carriage return.
At the end of the game, the controller should output, in order on separate lines:
A final game state
"Game is over!"followed by
"Tie game."depending on the outcome
If the user quits, the controller should output
"Game quit! Ending game state:\n" + model.toString() + "\n"
and end the
We have supplied you with some basic JUnit tests as part of the starter code. Use these to verify that your implementation is correct. Write additional tests of your own: Assignment 3 is a testing-heavy assignment. Some of the additional cases you should implement are listed as comments in the test class you are given. Implement those tests at the least.
You will likely need a
while()loop; be aware that you can use the
breakstatement to break out of a loop prematurely (before the loop condition is false).
You will need to use the built-in
Scannerclass. See the lecture notes examples and explore the Oracle JavaDoc for this class for more information on how to use it.
Avoid duplicating code as much as possible. Consider using non-public methods as means of creating reusable pieces of functionality.
Be sure to use access modifiers,
public, as well as
Include JavaDoc for your classes and constructors as appropriate. You do not need to repeat JavaDoc already existing in a superclass or interface when you override a method. This is true for the course in general.
Submit your zip containing only your src and test directories to In-class Exercise 3 on the handin server. There is no self-evalulation for this exercise.
Your grade will be determined by code style
(70%) and JUnit
correctness (30%); this assignment is simply for your practice. We will not be doing manual grading,
but if you would like feedback on your design, and specifically your test coverage, contact a member of the course staff and we will review it.