Time estimate: 45 min.

1.2. Why Programming? Why Java?

What do Android phones, Minecraft, and Netflix have in common? They’re all programmed in Java! Many of the apps you use in an Android phone or tablet are written in Java. If you’ve used App Inventor before, those apps are translated to Java before they are run on a phone or tablet. Netflix uses Java for some of its software too. Java is a programming language that is used worldwide to create software that we all use.

The following video introduces this first lesson in CSAwesome.

1.2.1. First Java Program

Every program in Java is written as a class. Java is an object-oriented language and we’ll learn more about classes and objects in Unit 2. Inside the class, there can be a main method that starts the program. When you ask the Java run-time to run a class, it will always start execution in the main method. Here is the template for a simple Java program with a main method:

public class MyClass
{
    public static void main(String[] args)
    {
        // Put your code here!
    }
}

Note

In Java every open curly brace { must have a matched close curly brace }. These are used to start and end class definitions and method definitions.

coding exercise Coding Exercise: Click on the run button button below to have the computer execute the main method in the following class. Then, change the code to print your name. Be sure to keep the starting " and ending ". Click on the run button button to run the modified code. If you revisit this page later and login, click on Load History and move the bar above it to see your previous code changes.

Run this code to see the output below it. Then change the code to print your name, for example “Hi Pat!”, and run again.

You can copy the Java source code shown in this book into a file and save it if you want to run it locally in an integrated development environment (IDE) on your local computer (see section 1.1. for different IDEs). You must name the file the same name as the class name with “.java” as the extension. All code (programs) in Java must be defined inside a class in a source file, and the name of the class must match the file name.

Drag or click on the blocks you need to move them from the top section into the yellow area to create the first line for the main method. There are extra blocks that you don’t need.

Drag or click on the blocks you need to move them from the top section into the yellow area to create the first line for the main method. There are extra blocks that you don’t need.

Drag or click on the blocks you need to move them from the top section into the yellow area to create the first line for the main method. There are extra blocks that you don’t need.

1.2.3. Syntax Errors and Debugging

Computers don’t actually speak Java so we have to compile (translate) Java source files that we write into class files which is code that a computer can understand and run. In this e-book, the Java code is actually being sent to a Java server to compile and run, and the output is sent back to show on the same page.

Syntax errors are reported to you by the compiler if your Java code is not correctly written. Examples of syntax errors are a semicolon ; missing or if the code has a open curly brace { or open quote ", but no close curly brace } or close quote ". Informally, a syntax error is called a bug, and the process of removing errors is called debugging. An early computer science pioneer Grace Hopper documented a real bug, a moth that flew into a computer in 1947!

../_images/firstbug.jpg

Figure 2: Grace Hopper’s log showing a real bug, 1947.

The compiler tries to run your code, but if your code has syntax errors, you will see error messages displayed below the code. Compiler error messages will tell the line number that the compiler found the error and the type of error. The error messages are not always easy to understand and sometimes the actual error is before the line that the compiler says is the problem.

Watch the following video to see that all coders get bugs. Debugging is a normal part of coding. It can be frustrating at times, but you will get better at it with practice! Sometimes another pair of eyes really helps, so ask a friend if you get stuck or try explaining your code line by line to someone or even a rubber duck. Rubber duck debugging is a lot of fun!

Let’s practice debugging some code!

exercise Check Your Understanding: Mixed up programs

The following has all the correct code to print out “Hi my friend!” when the code is run, but the code is mixed up. Drag the blocks from left to right and put them in the correct order. Click on the “Check Me” button to check your solution. You will be told if any of the blocks are in the wrong order or if you need to remove one or more blocks. After three incorrect attempts you will be able to use the Help Me button to make the problem easier.

The following has all the correct code to print out “Hi there!” when the code is run, but the code is mixed up and contains some extra blocks with errors. Drag the needed blocks from left to right and put them in the correct order. Click on the “Check Me” button to check your solution.

1.2.4. Reading Error Messages

In the exercise below, you should click on the run button button to compile and run the code. Unfortunately you will find there is a syntax error in the code that you need to fix. Before you try to fix it, look for the error message below the code. This is called a compile time error because it is an error detected by the compiler.

It will be a lot easier to find the problem, and other problems like it, if you understand how to read the error message. So let’s take a closer look. It will look something like this:

FirstClass.java:5: error: unclosed string literal
       System.out.println("Hi there!);
                          ^
1 error

The first line starts with the name of the file that was being compiled. Because you submitted your code via this web page you didn’t actually name the file but it was named for you to match the name of your class. Then there’s a colon (:) followed by a number. That number tells you the line number in the file where the compiler detected the error, in this case line 5.

Error messages aren’t always 100% accurate about where the error actually is; sometimes you actually need to change something a bit earlier in the program and sometimes a bit later. But the line number is the best place to start looking.

After the line number and another colon, you will find the actual error message. These can be kind of cryptic but you should still read it. As you learn more Java vocabulary they will become more meaningful but they almost always contain some useful clues. For instance take this error message: “unclosed string literal”. You may not know what a string literal is (yet) but “unclosed” suggests something was opened and then not closed. Keep that thought in mind.

Now look at the next two lines. The very next line is just the line of code from your program. But below that is a very important line containing a single caret (^) positioned to point at exactly where in the line the Java compiler thinks the problem is. In this case it’s pointing at the quotation mark () before “Hi”. So it’s complaining about something being unclosed and it’s pointing us at a quotation mark. Usually quotation marks come in pairs called the open quote and the close quote, right? And if you look at the line of code you’ll see that there’s no closing quotation mark. Could that be the problem? Try adding a quotation mark and see if that fixes it!

It is worth getting in the habit of really reading error messages. The people who wrote the Java compiler put in lot of work to try to make the error messages useful. If you read them, you’ll soon learn to recognize common mistakes and will get much quicker at finding your syntax errors.

coding exercise Coding Exercise: Compile Time Error 1

Fix the code below.

coding exercise Coding Exercise: Compile Time Error 2

Click on the run button button below to try and run the following code. Look for an error message after the code. This time the error message will probably point even more exactly at the problem than in the previous exercise. Try to fix the code and run it again.

Fix the code below.

coding exercise Coding Exercise: Compile Time Error 3

Click on the run button button below to try and run the following code. What is wrong this time? The first error message will probably point you directly at the problem. But after you fix that you’ll probably get a new error! That happens sometimes because the compiler can’t even detect the second error until the first one is fixed.

This is another reason it’s important to read error messages. It’s very tempting when we see that there’s an error to jump immediately to trying to fix it. Arg, an error! Get rid of it! But if we don’t slow down and read the message in a case like this, we might not notice that we’ve actually fixed the first error. If we don’t notice that we fixed it, we might undo our change and unfix it!

So read the error messages—they’re there to help you. With that in mind, see if you can fix both errors in this code. A hint for the second error: capitalization matters.

Fix the code below.

Did you remember that System is capitalized in System.out.println? Did you find the missing semicolon?

1.2.5. Comments

In Java and many text-based coding languages, // is used to mark the beginning of a comment. For multi-line comments, use /* to start the comment and */ to end the comment. The compiler will skip over comments. However, it is a good idea to use comments to make notes to yourself and other programmers working with you. Here are some examples of good commenting:

/* MyClass.java
   Programmer: My Name
   Date:
*/

int max = 10; // this keeps track of the max score

1.2.6. groupwork Debugging Challenge

Rubber Duck

In this course, you are encouraged to work together in pairs to complete the programming challenges. Pair programming is a successful software development technique where two programmers work together at one computer. One, the driver, types in code while the other, the navigator, gives ideas and feedback. The two coders switch roles frequently. Another option is buddy programming, where two or three coders work on their own computers but help each other as needed. If you’re working alone, you may want to explain the code to a rubber duck or another toy using Rubber duck debugging.

Working in pairs, debug the following code. Can you find all the bugs and get the code to run?

Fix the code below.

1.2.7. Summary

  • A basic Java program looks like the following:

public class MyClass
{
    public static void main(String[] args)
    {
        System.out.println("Hi there!");
    }
}
  • A Java program starts with public class NameOfClass { }. If you are using your own files for your code, each class should be in a separate file that matches the class name inside it, for example NameOfClass.java.

  • Most Java classes have a main method that will be run automatically. It looks like this: public static void main(String[] args) { }.

  • The System.out.print() and System.out.println() methods display information given inside the parentheses on the computer monitor.

  • System.out.println moves the cursor to a new line after the information has been displayed, while System.out.print does not.

  • A string literal is enclosed in double quotes (’’ ‘’).

  • Java statements end in ; (semicolon). { } are used to enclose blocks of code. // and /* */ are used for comments.

  • A compiler translates Java code into a class file that can be run on your computer. Compiler or syntax errors are reported to you by the compiler if the Java code is not correctly written. Some things to check for are ; at end of lines containing complete statements and matching { }, (), and "".

1.2.8. AP Practice

You have attempted of activities on this page