A complete copy of this site can be obtained by downloading and unzipping the following file:
pongLab.zip file is unzipped, a directory named
pongLab will be created. The contents of the
pongLab directory and each of its sub-directories are discussed below.
pongLab directory contains the following materials:
facultydirectory are discussed in detail below.
studentdirectory are discussed in detail below.
student directory contains a copy of the Pong Lab assignment exactly as it was distributed to students at Dickinson College in the Spring 2003 semester. This directory includes the web page describing the assignment, the class files for the Pong application and the java documentation for the classes to be implemented by the students. More specifically the
student directory contains the following materials:
studentdirectory was placed on the web server and a link to the
pongLab.htmlfile was provided to the students.
These files should not be edited directly when adapting the Pong Lab for use at other institutions. The preferred process for adapting the Pong Lab is described below.
faculty directory contains a complete working version of the Pong application, with source code, and a number of additional resources to facilitate the adaptation of the Pong lab for use at other institutions. More specifically, the
faculty directory contains the following materials:
Pongclass will run a complete working version of the Pong application.
PongBallTestwill create a number of
PongBallobjects and use them test each of the methods in the
PongBallclass. These test programs can be used to evaluate the correctness of the student implementations.
The remaining materials in the
faculty directory have been included to facilitate the adaptation of the Pong lab for use at other institutions. The typical process for making changes to the Pong Lab is to edit the files contained in the
faculty directory or its sub-directories and then execute a script which deletes and recreates the
student directory. The new
student directory, which incorporates the changes, can then be made available to students. Details on how to adapt the Pong Lab are provided below.
labFilessub-directory of the
facultydirectory contains all of the materials necessary to change the lab assignment web page. The
labFilesdirectory contains a copy of the
pongLab.htmlfile. This directory also contains the source files for the class diagrams which appear in the assignment web page. To change the text of the assignment, edit or replace the contents of the
pongLab.htmlfile. The class diagrams may be edited using the
xfiggraphics program. The edited class diagrams should be exported to
pngformat. When all edits have been completed, executing the
makeStudentscript (see below) will create a new
studentdirectory containing the edited assignment.
PongPaddle.javafiles contained in the
facultydirectory. To modify the Java documenation seen by the students, edit the JavaDoc comments in these files and follow the directions in the section on distributing your changes to the Pong lab (see below).
PongBallTimer.javafiles in the
facultydirectory. The behavior of the Pong application can be changed by editing the code contained in these files. To update the application that is distributed to the students, edit these files and follow the directions in the section on distributing your changes to the Pong lab (see below).
PongPaddleclasses are contained in the
stubSolnsub-directory of the
facultydirectory. To change the stub files that are distributed to the students, edit the files in this directory and follow the directions in the section on distributing your changes to the Pong lab (see below).
studentdirectory to reflect the changes. To update the
makeStudentscript contained in the
facultydirectory. (Note: The
makeStudentscript is a unix shell script. A windows version is not provided, though creation of one should be a straight forward process.) The execution of this script deletes the existing
studentdirectory and creates a new one which reflects any changes that have been made to the materials in the
facultydirectory. To distribute the Pong Lab to the students, make the new
studentdirectory avaialble on-line and provide the students with a link to the