Setting Up Java Programming Environments

This lesson is your starting point for learning Java in this course. It does not teach a full programming concept. Instead, it orients you to the learning process: where your code is expected to run, what setup information you will need, and how the course defines a successful first run. Think of it as the map you read before the journey begins. Once you know the map, the later lessons on writing and running Java programs make much more sense.

The purpose of this lesson is orientation, not instruction in Java syntax or programming techniques. A learner who reads it should come away knowing three things: where code is expected to run, which setup information the course relies on, and what counts as a successful first run. Those three answers shape every lesson that follows, so it is worth reading this one carefully even though it contains no Java code.

The course provides its own setup instructions, and you should use them to determine where Java code runs and what preparation is required. This lesson does not replace those instructions. It tells you that they exist and that they are the authority for your environment. The exact steps depend on the programming environment you use, so do not assume that a set of steps from another source applies to your course unless the course instructions say so.

The course's own example shows why environment-specific instructions matter. The TextIO class is not a built-in part of Java, so your program must be able to find it. What you need to do depends on your environment. In general, you add the folder named textio to the same folder that contains your main program, because that folder holds the file TextIO.java. The course points to a later section for how to use TextIO.

This lesson sits at the beginning of a sequence. The next topic in the course, Building Your First Java Application, covers Java syntax, semantics, pragmatics, creating and running a Java program, and program structure. Those are the lessons where you actually write and run code. A second later topic, also named Setting Up Java Programming Environments, covers approaches to Java development and execution environments in more detail than this orientation lesson does.

In this course, a successful first run means that the prescribed Java program executes in the intended environment. Two parts of that definition matter. The program is the one the course prescribes, not any program you happen to write or find. And the environment is the one the course intends, which is why the setup instructions come first. Running something that is not the prescribed program, or running it somewhere other than the intended environment, does not meet the course's definition.

The flowchart is a generalized picture of the path. The first two steps come from this lesson's purpose, and the preparation step reflects the course's note that some preparation is required. The check at the end is the course's definition of success. If the check fails, the sensible move is to go back to the setup instructions rather than to guess at a different fix.

When you read the course's setup instructions, you will be looking for how your environment provides this kind of software. The orientation lesson does not describe the steps for installing a JDK, so treat the definition as vocabulary you will recognize later rather than as a set of instructions.