Installing BlueJ (and the JDK) on a PC
Installing the JDK
- Access the CD-ROM that came with your textbook by placing it in your PC's
CD drive and opening the CD.
- Open the JDK5 folder. There are several interesting documents in this
folder, including a README file. You might want to check these out at some
point. (If you are on a Vista-powered PC, you should use JDK6.) For now, though, we're just interested in...
- Running the application "j2sdk-1_5_0_09-windows-i586.exe" by double-clicking
on it. This will pop up a window that says something about "extracting
- After a while, you will be asked a series of questions. You can accept the
default answers, but make sure you note the directory under which you are
installing SDK. (I think the default is something like "C:/j2sdk1.5"
or something like that.)
- After much whirring and clanking from the CD and your hard drive the installation
should finish. (You will click on the "Finish" button. At your discretion
you can choose, here, to read the associated README file by clicking on the
corresponding "check box".)
Installing the BlueJ IDE
- Use your web browser (Firefox or Internet Explorer) to access http://www.bluej.org/download/download.html.
- Follow the directions to download the latest version of BlueJ. (As of this
writing, it is version 2.2.0.) Note the directory in which you save the downloaded
.exe file. You may--but probably won't--need this when you get to "step
3" of BlueJ.org's instructions.
- To test your installation, go ahead and run BlueJ. Use the Project menu
to open one of the sample projects from the Example directory, located in
the directory at which you installed BlueJ. Compile the file there, and run
it, as we discussed in class.
Installing the JDK Documentation
If you'd like, you can install the on-line Java documentation associated with
JDK. (The documentation is written in HTML, allowing you can read it from a
browser.) The instructions for doing this can be found at http://java.sun.com/javase/downloads/index_jdk5.jsp (look for the "J2SE 5.0 Documentation" header.) You may need a compression/decompression utility, such as winzip.
You can download it for free onto your PC, if you don't already have such a
- When asked where to extract the documentation to, select
the same directory where you placed the JDK ("C:/j2sdk1.5", or whatever it was).
This will create a subdirectory, "docs", within your JDK directory.
- To access the JDK documentation, use the Help menu from within BlueJ. Select
"Java Class Libraries". Now, by default, this will only work if
you are on-line, because BlueJ tries to access the on-line documentation provided
by the Sun Corporation, which supports Java. As you have just downloaded the
documentation onto your own PC, you want to set up BlueJ so that it simply
accesses your on-board documentation, instead of browsing the Web. To do that....
- In BlueJ, select the BlueJ menu, and then Preferences (or the Project menu, and then Preferences, depending on the version.) This will bring up
a dialog box. Select the "Miscellaneous" tab.
- At the top of the page you will see "JDK documentation URL"
adjacent to a text box. The text box will have "http://..../api/index.html"
there. Replace the "http://..../" with the directory where you downloaded
your documentation. This will be something like "C:/j2sdk1.5/docs",
yielding a complete file name something like: "C:/j2sdk1.5/docs/api/index.html".
- Okay, now to test everything, start or restart BlueJ, and select the "Java
Class Libraries" entry from the Help menu (in the upper right-hand corner
of BlueJ). This should open a browser window showing the table of contents
of the JDK's documentation.