Metrowerks CodeWarrior Pro 5 is installed in the lab.  The TAs and proctors can help you with using it.  You can also purchase CodeWarrior for about $80.  If you install CodeWarrior at home you still need to install the Java SDK which should come on the compact disk.  You can also obtain the Java SDK directly from Sun.  CodeWarrior Pro for Windows version 5 and 5.3 work best with the Java SDK version 1.2.2.  I have had reports of problems when people tried to use the newest version of the Java SDK, version 1.3 with these versions of CodeWarrior.  If you are planning on buying and using CodeWarrior at home be aware of these.

You can also download Java from Sun and BlueJ, but they are very large files and I offer you somewhat less assistance with the Java SDK / BlueJ combination.  The upside however is both of these are FREE and you can work at home.

Creating projects. This page contains instructions for creating projects using Metrowerks CodeWarrior Pro for Windows, release 5 or 5.3 (the version of the software installed in the Elements Labs on campus).

CodeWarrior won't just run a Java program. It requires that you create a "project" first. This is sufficiently involved that projects will be provided in the lab. If you work only in the lab, you won't need to read further. You will need these instructions only if you want to use CodeWarrior outside the lab.

There is some help on this topic. To see it, click the Help menu, IDE topic. In the box, click "Create new projects"; in the new box, click "from Stationery". But the on-line help is incomplete and sometimes simply wrong, so try the following instead.

The following creates projects using Java Stationery. When you get to the point where you choose Java Stationery, you will see four other choices. I have tried them all and prefer Java Stationery. You may wish to experiment with the others, especially the Java Application Wizard — it may be simpler, but it creates 225 kbytes of files for an empty project.

Each project will contain several files and subdirectories (all but one created automatically by CodeWarrior), so it will need its own directory. I recommend creating one directory in which all project directories will be created. I will refer to this directory as the projects directory. It can be any directory you choose. In the Elements Labs, the projects directory is C:\cs303e\.

Creating a new project.

• Run CodeWarrior.
• Click the File menu, New... item. A dialog box entitled "New" is displayed.
• Click on the Project tab (if necessary) and then click on the project type "Java Stationery".
• In the Location box enter the projects directory, in which the new directory for the project will be created. In the Elements Labs, this is C:\Cs303e\, including the last "\". Alternatively, click the Set button and navigate to the projects directory.
• In the Project Name box, enter the name for the new project. It will be automatically appended to the directory in the Location box. We will use name below for this name; always substitute the correct project name for name below.
  • Click OK.
• A box entitled "New Project" appears. Click the "+" next to "Java2". Several lines will appear under it. Click "Java Application", then click OK.
• A box entitled "name.mcp" appears on the screen, showing the new project created.

Setting up the new project.

The new project contains a source file TrivialApplication.java containing a class TrivialApplication. Both these names need to be changed.

• Click on the "+" next to the folder Sources. The file name TrivialApplication.java will be displayed.
• Double-click on TrivialApplication.java. An editor window will appear displaying this skeleton Java program.
• In the editor, change the class name from TrivialApplication to name. Also change the comment at the top about TrivialApplication.
• From the File menu choose Save As... . In the dialog box, enter the name name.java and click Save.
• Close the editor box by clicking the close buttonx (X) in the upper-right corner.
• Notice that in the name.mcp box, TrivialApplication.java has been replaced by name.java.

Now we need to tell CodeWarrior that name, not TrivialApplication, is the main class.

• In the Edit menu, click Java Application Settings. Or click the Target Settings button on the button bar of the name.mcp box.
• In the dialog box, on the left, if there is a "+" next to Target, click it. Then under Target, click Java Target. On the right, in the box labeled "Main Class", replace "TrivialApplication" with name. Then click the Save button and then the close (X) button.

Now delete the original source file TrivialApplication.java.

• In the name.mcp window, right click on name.java. From the menu choose "Open in Windows Explorer".
• A Windows Explorer window will appear showing the directory containing the new project. Delete the file TrivialApplication.java.
• Close the Windows Explorer window with the close (X) button.

The ConsoleReader class from the Horstmann book and any other classes you will use need to be placed on your hard drive in a convenient directory so that your program can use ConsoleReader methods. I suggest that you create a directory named classes in the jdk directory. You needed to download jdk when installing CodeWarrior. (I know all of this jdk and sdk stuff is confusing.  The software you need from Sun to run Java used to be called the Java Development Kit or jdk.  Starting with Java version 1.2 the name of the software you need from Sun to run Java was changed to the Software Development Kit or sdk.)  The default location is \jdk1.2.2, but you can choose another location. I think this is the best place for the classes directory, but it may not be the only place. I will refer to this directory as the classes directory below.

• If ConsoleReader is somewhere on your hard drive, move or copy it to the your classes directory.
• Otherwise go to the Software page on the class web page and right click on the ConsoleReader link.
  • Download the ConsoleReader.java file to the classes directory on your hard drive.

Finally, the ConsoleReader.java file needs to be added to the project. This needs to be done for each new project.

• In CodeWarrior, in the name.mcp window, click on the "+" next to the Sources folder to open it.
• From a Windows Explorer window showing the classes directory, drag the ConsoleReader file into the Classes folder in the .mcp window.  You will see a message box that an access path has been added. Close the message box.

You can add as many files as you want to a project using the above method.

That's it — the file name.java is ready to be edited and run. These steps may seem daunting at first, but you will soon get used to the sequence and not need to use these instructions again.