Hello World in Java on Windows

This document instructs you on how to set up our Java programming environment for your Windows computer. It also provides a step-by-step guide for creating, compiling, and executing your first Java program using either DrJava or the Command Prompt. All of the software used is freely available on the Web.

These instructions apply to 32-bit and 64-bit Windows 7, Vista SP1, and XP SP3.

If you have previously used the introcs.exe installer from the textbook Introduction to Programming in Java, your Java programming environment should be set up already.

0. Install the Programming Environment

Our installer downloads, installs, and configures the Java programming environment you will be using, including Java SE 6, DrJava, the textbook libraries, and the Command Prompt.

Log in to the user account in which you will be programming. Your account must have Administrator privileges and you must be connected to the Internet.
You will need a Java runtime. Use this link to test if the Java runtime is installed. You should see something like Java SE 6 Update 27 or Java 6 Standard Edition; if not, download and install a Java runtime from java.com. We recommend all of the default options except for allowing optional 3rd party installations. Relaunch your browser for the changes to take effect.
If a Java runtime is not installed, download and install a Java runtime from java.com/download. We recommend all of the default options except for allowing optional 3rd party installations. You may need to relaunch your browser for the changes to take effect.
Download algs4.exe and double-click it to perform the installation. If you receive a User Account Control alert before the installation, click Yes or Allow; if you receive a Program Compatibility Assistant alert after the installation, click This program installed correctly.
If the installation succeeds, you will see the following:
- A Command Prompt windows containing approximately this execution log.
- A Standard Drawing window containing a blue bullseye and textbook graphic.
Delete algs4.exe.

1. Create the Program in DrJava

Now you are ready to write your first Java program. You will develop your Java programs in an application called DrJava. DrJava features many specialized programming tools including syntax highlighting, bracket matching, auto indenting, and line numbering.

The installer creates a shortcut on the desktop to DrJava. Double-click it to launch DrJava. If you receive a Windows Security Alert, click either Unblock or Allow Access.
In the main DrJava window, type the Java program HelloWorld.java exactly as it appears below. If you omit even a semicolon, the program won't work.
public class HelloWorld { public static void main(String[] args) { System.out.println("Hello, World"); } }
As you type, DrJava does the indenting for you.
Finally, click the Save button to save the file. Use DrJava to create the folder C:\Users\username\algs4\hello and name the file HelloWorld.java. The file name is case sensitive and must exactly match the name of the class in the Java program.

2. Compile the Program from DrJava

It is now time to convert your Java program into a form more amenable for execution on a computer. To do this, click the Compile button. If all goes well, you should see the following message in the Compiler Output pane at the bottom:

Compilation completed.

If DrJava complains in some way, you mistyped something. Check your program carefully, using the error messages in the Compiler Output pane as a guide.

3. Execute the Program from DrJava

Now it is time to run your program. This is the fun part.

Type the following in the Interactions pane at the bottom. By convention, we highlight the text you type in boldface.
> java HelloWorld
If all goes well, you should see the following message:
Welcome to DrJava. Working directory is C:\Users\username\algs4\hello > java HelloWorld Hello, World
You may need to repeat this edit-compile-execute cycle a few times before it works.

4. Command-Line Interface

The command-line provides capabilities beyond those available in DrJava, including redirection and piping. You will type commands in an application called the Command Prompt.

The installer creates a Shortcut on the desktop to the Command Prompt. Double-click it to launch the Command Prompt. You should see something like:
Microsoft Windows [Version 6.1.7601] Copyright (c) 2009 Microsoft Corporation. All rights reserved.
To confirm that the Java compiler is installed, type the command in boldface below and check that the output matches:
C:\Users\username>javac -version javac 1.6.0_27

To confirm that the Java interpreter is installed, type the command in boldface below and check that the output matches:

C:\Users\username>java -version
java version "1.6.0_27"
Java(TM) SE Runtime Environment (build 1.6.0_27-b07)
Java HotSpot(TM) 64-Bit Server VM (build 20.2-b06, mixed mode)

If you have a 32-bit machine, the last line will be:

Java HotSpot(TM) Client VM (build 20.2-b06, mixed mode, sharing)

5. Compile the Program from the Command Prompt

You will use the javac command to convert your Java program into a form more amenable for execution on a computer.

From the Command Prompt, navigate to the directory containing HelloWorld.java, say C:\Users\username\algs4\hello, by typing the cd (change directory) commands below:
C:\Users\username>cd algs4 C:\Users\username\algs4>cd hello C:\Users\username\algs4\hello>
Compile it by typing the javac command below:
C:\Users\username\algs4\hello>javac HelloWorld.java C:\Users\username\algs4\hello>
Assuming the file HelloWorld.java is in the current working directory, you should see no error messages.

6. Execute the Program from the Command Prompt

You will use the java command to execute your program.

From the Command Prompt, type the java command below.
C:\Users\username\algs4\hello>java HelloWorld Hello, World
You should see the output of the program.

7. Checkstyle and Findbugs

You can use Checkstyle and Findbugs to check the style of your programs and identify common bugs.

To run Checkstyle, type the following command in the Command Prompt:
C:\Users\username\algs4\hello>checkstyle HelloWorld.java Running checkstyle on HelloWorld.java: Starting audit... Audit done.
Here is a list of available checks. You can customize the settings by editing the file C:\Users\username\algs4\checkstyle-5.4\checkstyle.xml.
To run Findbugs, type the following command in the Command Prompt:
C:\Users\username\algs4findbugs HelloWorld.class Running findbugs on HelloWorld.class:
Here is a list of bug descriptions. You can customize the settings by editing the file C:\Users\username\algs4\findbugs-1.3.9\findbugs.xml.

Troubleshooting

When running the installer, I get an access denied error message. What should I do? Make sure you are using an administrator account. Rerun the installer.

The installer doesn't execute. Why? The installer requires PowerShell. Run Windows Update to update your computer. If you are running Windows XP, you must have Service Pack 3. You can manually download PowerShell 2.0 for Windows XP or Vista by clicking the corresponding link under Windows Management Framework Core (WinRM 2.0 and Windows PowerShell 2.0).

The installer still doesn't work on my machine. What should I do? Please consult a staff member to identify what went wrong.

What does the installer do? In short, it downloads, installs, and configures Java, DrJava, Checkstyle, Findbugs, and the textbook libraries. Here is a more detailed list:

Downloads and installs Java SE 6, Update 27 from either java32.zip or java64.zip. This includes the Java Runtime Environment and part of the Java Development Kit (javac.exe and tools.jar). Adds Java to the PATH environment variable.
Downloads the textbook libraries from stdlib.jar and algs4.jar. Adds the textbook libraries to the CLASSPATH environment variable.
Downloads and installs Checkstyle 5.4 from checkstyle.zip. Downloads our checkstyle configuration file from checkstyle.xml.
Downloads and installs Findbugs 1.3.9 from findbugs.zip. Downloads our findbugs configuration file from findbugs.xml.
Downloads and installs the latest stable version of DrJava, from drjava.exe. Creates a shortcut on the desktop to DrJava. Downloads and installs the DrJava configuration file from drjava-config.txt to /Users/username/.drjava. Note that this will overwrite any existing .drjava configuration file.
Customizes the Command Prompt preferences by enabling QuickEdit and Insert modes and setting the Screen Buffer Size to 80-by-500. Creates a shortcut on the desktop to the Command Prompt.
Tests that the installation succeeded by compiling and executing TestAlgs4.java.

How do I completely uninstall algs4.exe?

Delete the C:\Users\username\algs4 folder (but save any of the .java files you created, if desired).
Delete these additions from your CLASSPATH environment variable.
- C:\Users\username\algs4\stdlib.jar
- C:\Users\username\algs4\algs4.jar
Delete these additions from your PATH environment variable.
- C:\Users\username\algs4\bin
- C:\Users\username\algs4\java\bin
Delete the DrJava configuration file C:\Users\username\.drjava.
Delete the shortcuts on the desktop to DrJava and the Command Prompt.

What happens if I rerun the installer? It will re-download, install, and configure Java, Checkstyle, Findbugs, DrJava, and the textbook libraries.

I couldn't get a Java runtime to install. Any advice? Try downloading Java using the Windows 7, XP offline installer.

What should I do if I have previously installed DrJava in another location? We suggest deleting it and using the version in C:\Users\username\algs4 by using the newly created DrJava shortcut on the desktop.

Why Java 6 instead of Java 7? The latest stable version of DrJava does not support Java 7.

Can I use a different version of Java? Yes, but you will have to configure the Windows environment variables (PATH and CLASSPATH) and DrJava compiler properties yourself.

Can I update DrJava to use a newer version? Yes, but you do not need to do so.

Can I use an IDE other than DrJava? Yes you can use another IDE (such as Eclipse) but you will have to configure the IDE properties yourself (such as the classpath). If you have a 64-bit version of Java, be sure to install a 64-bit version of Eclipse or you will get a "Failed to load the JNI shared library" error.

How do I break out of an infinite loop? In DrJava, click the Reset button in the menubar or select the menu option Tools -> Reset Interactions; from the Command Prompt, type Ctrl-c.

When using standard input, how do I signify that there is no more data? If you are entering input from the keyboard, type Ctrl-z for end of file (EOF).

How do I configure Windows to reveal the .java or .class file extensions? Many Windows machines are configured to hide the file extensions. If this is the case, select Start -> My Computer -> Tools -> Folder Options -> View, uncheck the box next to Hide file extensions for known file types, and click OK.

When I enter the command "java -version" or "javac -version" I get an error. First, verify that the following two files exists:

C:\Users\username\algs4\java\jdk\bin\javac.exe
C:\Users\username\algs4\java\jdk\bin\java.exe

If so, it is likely an issue with the Windows PATH environment variable. From the Command Prompt, type the following command to display it:

C:\Users\username> echo %PATH%

The PATH environment variable should include an entry for C:\Users\username\algs4\java\jdk\bin.

When I compile or execute a program from the Command Prompt that uses the textbook libraries I get an error. How can I fix this? First, verify that the following two files exists:

C:\Users\username\algs4\stdlib.jar
C:\Users\username\algs4\algs4.jar

If so, it is likely an issue with the Windows CLASSPATH environment variable. From the Command Prompt, type the following command to display it:

C:\Users\username> echo %CLASSPATH%

The CLASSPATH environment variable should include entries for C:\Users\username\algs4\stdlib.jar and C:\Users\username\algs4\algs4.jar.

How do I navigate to another drive from the Windows Command Prompt? From the Command Prompt, type H: to switch to the H: drive. Then, use the cd command to navigate to the desired directory.

Where can I learn more about Command Prompt? Microsoft maintains a command-line reference.

Can I use the Windows PowerShell instead of the Command Prompt? The Windows PowerShell is a more advanced command-line shell. However, it does not currently support the redirection of standard input.