Getting Started with Java under Windows^*

• Questions and Answers
• Adjusting Windows Setup
• Downloading JDK and Docs
• Installing JDK and Docs
• Downloading and Installing JCreator
• Running a Java Program in JCreator
• Downloading and Installing Eclipse
• Running a Java Program from Command Prompt

What software do I need?

You need a Java compiler and an IDE.

What is a compiler?

A compiler translates Java code into bytecodes.

Where do I get it?

There is essentially only one Java compiler.  It is part of JDK (Java Development Kit) and it is available free for downloading from Oracle's web site.  The latest version, as of June 2012, is JDK 7, Update 4.  JDK also includes an interpreter that runs Java applications, appletviewer used for testing Java applets, a few other utility programs, and Java class libraries.

What is an IDE?

An IDE (Integrated Development Environment) serves as a front end for the Java compiler and interpreter.  It also includes an editor for writing Java code, a project maker, sometimes a debugger, all conveniently packaged into one program with a graphical user interface.

Where do I get an IDE?

Several free IDEs are available for downloading.  One, called NetBeans, is available from Oracle in a "cobundle" with the JDK.  However, it may be too cumbersome for a beginner programmer.  A popular choice is JCreator LE from Xinox software. It is compact, easy to use, and it is free.  JCreator LE, the free version, does not have a debugger, which we consider a plus (see Top Ten Reasons Not to Use a Java Debugger in School).  On the opposite end of the spectrum is Eclipse: a professisonal IDE, highly configurable and loaded with convenience features, also available free.  It will take some getting used to, though.  Eclipse runs on both PCs and Macs.

What else do I need?

Get very proficient with viewing, moving, deleting, and renaming files and folders in Windows Explorer.

The following Windows configuration changes are not mandatory but will make working with Java easier:


• In any folder on the Tools menu choose Folder options. Click on the "View" tab, find and uncheck the "Hide extensions for known file types" box.
  
  
• You might find it more convenient to view folder contents as a list or a detailed list, rather than icons.
  
  
• You will use Windows Explorer often, so create a shortcut to it on the desktop.  To do that, go to Start/All Programs/Accessories and drag and drop Windows Explorer to the desktop while holding both Ctrl and Shift keys down.  It is possible to make Windows Explorer start in a particular folder.  To achieve that, right click on the shortcut, choose Properties, click on the Shortcut tab, and add /e, followed by a space and the folder name to the Target line.  For example:

  

  Click OK.
  
  

• If you plan to run your Java programs from Command Prompt, then under Programs/Accessories find Command Prompt and put a shortcut to it on the desktop.
  
  

• To download JDK, go to

    http://www.oracle.com/technetwork/java/javase/downloads/index.html

  Click on the leftmost icon "Java -- Java Platform (JDK 7u4)" (or the latest available update).  Accept the license agreement, then click on the installation file appropriate for your system, for example, jdk-7u4-windows-x64.exe for 64-bit Windows.  Click Save in the dialog box that pops up and save the JDK installation file (about 92 MB) to the desktop or a folder of your choice.

  JDK includes the compatible version of JRE (Java Run-Time environment).
  
  

• Now download the documentation.  To do that, return to the download page

    http://www.oracle.com/technetwork/java/javase/downloads/index.html

  Scroll all the way down to Java SE 7 Documentation and click Download.  Accept the license agreement and save jdk-7u4-apidocs.zip (or the latest version) (about 56 MB) to the desktop or a folder of your choice. 
  
  

• To download JCreator, go to

    http://www.jcreator.com/download.htm

  Choose the second link --

  JCreator LE v5.0

  It is free.

  Click on the Download button and download the JCreator setup file jcrea500_setup.exe (about 6 MB) to the desktop or a folder of your choice.
  
  

• To install JCreator, run jcrea500_setup.exe. Accept all the defaults.
  
  

• Start JCreator
• From the File menu choose New --> File, click on Java Classes, click on Empty Java File, click next.
• Type in the name of your file, for example, HelloWorld. Capitalization is important! Then click Finish. Browse to a folder where you want to save your file, for example, C:\mywork.
• Type in the text of a short Java program, for example:

  public class HelloWorld
  {
    public static void main(String[] args)
    {
      System.out.println("Hello, World!");
    }
  }

• From the Build menu choose Compile file or click on the "Compile file" button.
• From the Build menu choose Execute file or click on the "Execute file" button.
• In general, you will want to set up workspaces and projects in JCreator.  See detailed instructions for configuring and using JCreator.

• To download Eclipse, go to

    http://www.eclipse.org/downloads/

  Download the zipped Eclipse IDE for Java Developers (not EE) (about 128 MB).  Unzip it into a folder of your choice (for example C:\Program Files\Eclipse).  Unzipping may take quite a while.

  Eclipse does not require other installation: just create a shortcut to eclipse.exe on your desktop.  See detailed instructions for configuring and using Eclipse.