Espresso: A Concentrated Introduction to Java

Java Programming in Eclipse

Summary: We describe how to compile and use Java in the Eclipse software development enviornment.

Prerequisites: Unix basics. Java basics. Java packages.

Disclaimer: Although I use the term Unix throughout this document, the ideas apply equally well to Linux, the variant of Unix we use in MathLAN.

Contents:

• About Eclipse
• Detour: Naming Files
• Setting Up Your Program
• Running Your Program
• Importing Projects

About Eclipse

There are a variety of ways in which one can develop Java programs. It is certainly possible to develop Java programs using a simple editor, such as gedit, and command-line tools for compiling and running Java programs. However, many programmers find it easier to build programs in an environment designed explicitly for editing, running, and testing programs.

Eclipse is an industrial-strength integrated development environment designed generically for working with programs. Although Eclipse can be used to develop programs in a variety of languages, it is frequently used as a Java development environment. Eclipse has been implemented for all three major operating systems (Macintosh OS X, Microsoft Windows, and Unix variants, including Linux).

Because Eclipse is designed for professional software development, you may find it a bit cumbersome at first. However, after a week or two, you will find it relatively comfortable for software development, and a few weeks later, you'll find that it helps you work more efficiently.

Detour: Naming Files

For the purposes of your initial work in Java, you will find it most convenient to have one class per file. (As we will soon see, if you make changes to one class, this limits the amount of extra work the computer must do to incorporate changes.) The name of the file must match the name of the class. It must also end with the suffix .java. For example, if I created a class named First, it would go in the file First.java. Fortunately, Eclipse follows this naming convention.

Setting Up Your Program

As suggested above, it's a little bit cumbersome to set up Eclipse to edit a Java program (that is, a collection of .java files).

• First, you need to start Eclipse. How you do so differs from system to system.
• Next, you need to specify Eclipse's main working directory. For the purposes of this class, use /home/username/CSC152/Eclipse.
• Sometimes, Eclipse starts with a tutorial window. If it does, you should close that window.
• Next, you need to create a project in which you will develop related files. Projects provide a natural way to group files for large-scale programming endeavors. Unfortunately, Eclipse requires you to create a project for even small-scale programming endeavors. To create a Java project, select New from the File menu, then select Project, then select Java Project, and then name the project.
• Finally, you can create the actual file. From the File menu, select New and then Class. Eclipse will prompt you for the name of the class and the pacakge of the class.

Running Your Program

In comparison to all of the setup steps mentioned above, running your Java program is fairly easy. Save your file, and then select Run as Java application from the Run menu. In many cases, the output will appear in a console at the bottom of the screen.

Importing Projects

At times, you will find it more convenient to set up your project outside of Eclipse and then import the directory structure and .java files into Eclipse. It is also relatively straightforward to create projects that way.

• First, set up the directory structure.
  • The top-level directory should have the same name as the intended project. For example, if I want to create a project named Code, I would create the directory Code (or, more precisely, /home/username/CSC152/Code.
  • The package username.packagename requires two directories, a username directory direclty within the project directory, and a packagename directory within the username directory.
• Next, put files in the appropriate places in that structure (typically in the package directory).
• Finally, create a new project from that directory structure.
  • From the File menu, select New and then Project.
  • In the dialog box that appears, select Java Project and then click Next.
  • In the dialog box that appears, enter the project name, select Create Project from Existing Source, and type the path to the directory you created above (e.g., /home/username/CSC152/Code as the directory.
  • In that same dialog box, under JDK Compliance set the default compliance to 5.0.
  • Click Finish.

History

Sunday, 30 January 2005 [Samuel A. Rebelsky]

• Created as a set of command-line instructions (not for Eclipse).

Tuesday, 30 August 2005 [Samuel A. Rebelsky]

• Minor edits.

Wednesday, 25 January 2006 [Samuel A. Rebelsky]

• Began revision for Eclipse.

Thursday, 26 January 2006 [Samuel A. Rebelsky]

• First released Eclipse version.

Thursday, 30 March 2006 [Samuel A. Rebelsky]

• Minor edits to existing text.
• Added section on importing a project.