Java Test Cases

What is a Test Case?

In the Problem Solving chapter, you tested a program by running it with different temperatures, and checking the output. Each of these checks is called a test case.

A test case has two parts: an input, and the expected output (the output that a correct program prints).

Here are the test cases for the practice problem Even or Odd. Read a whole number, and print Even if it can be divided by 2, or Odd if it cannot:

Check Even or Odd

How do you know if a number is even? Use the modulus operator % (see Arithmetic Operators). It gives the remainder of a division: what is left over.

• 7 % 2 is 1: 7 divided by 2 is 3, and 1 is left over.
• 4 % 2 is 0: 4 divided by 2 is 2, and nothing is left over.

So if n % 2 is 0, the number is even. If not, it is odd:

public class Main {
  public static void main(String[] args) {
    int n = 7;
    if (n % 2 == 0) {
      System.out.println("Even");
    } else {
      System.out.println("Odd");
    }
  }
}

Odd

Click "Try it Yourself", change n to 4, and run the code again. Now it prints Even.

The Output Must Match Exactly

When you submit a practice problem, your program runs once for each test case. Each time, it gets the input, and its output is compared with the expected output.

The output must be exactly the same, letter by letter. If the input is 7, only the first output passes:

So print exactly what the problem asks for, and nothing more.

Edge Cases

When you test a program, you should not only test normal values, like 5 or 42. You should also test unusual values, because many bugs hide there.

These unusual values are called edge cases.

Here are edge cases to try for common kinds of input:

In Even or Odd, the input is a number. So test 0, and a negative number like -7:

• 0: is 0 even? Yes. 0 divided by 2 is 0, and nothing is left over, so 0 % 2 is 0.
• -7: it is odd, but in Java, -7 % 2 is -1, not 1. So if your code checks n % 2 == 1, it says that -7 is even! You will see this in the tests below.

Run the Tests

Here are three solutions to Even or Odd. Choose a solution, and click "Run tests" to check it with five test cases, just like the practice editor does:

Test Your Own Code

You can also test your code yourself, before you submit it. Put the solution in a method, and write a small test() method. It compares the output with the expected output, and prints PASS or FAIL:

public class Main {
  static String evenOrOdd(int n) {
    if (n % 2 == 0) {
      return "Even";
    } else {
      return "Odd";
    }
  }

  static void test(int input, String expected) {
    String output = evenOrOdd(input);
    if (output.equals(expected)) {
      System.out.println("PASS: " + input);
    } else {
      System.out.println("FAIL: " + input + " (expected " + expected + ", got " + output + ")");
    }
  }

  public static void main(String[] args) {
    test(7, "Odd");
    test(4, "Even");
    test(0, "Even");
    test(13, "Odd");
    test(-7, "Odd");
  }
}

PASS: 7
PASS: 4
PASS: 0
PASS: 13
PASS: -7

Strings are compared with equals(), not with == (see Strings). Try to change "Odd" to "odd" in evenOrOdd(), and run the tests again. The FAIL lines tell you exactly which test cases broke.

Your Turn

Now solve Even or Odd in our practice editor. The starter code already reads the number from input. Remember the edge cases, and print exactly Even or Odd!

Summary

• A test case is an input, together with the expected output.
• Practice problems run your program once for each test case. Your output must be exactly the same as the expected output.
• Edge cases, like 0 and negative numbers, are where bugs often hide.
• A test() method lets you check your own code with many test cases at once.

You now know how to understand a problem, build the logic, and test your code. Use your new skills on our Java Practice Problems!