Course contentsShow
← Java
Lesson 743 of 2,87018. Exception Handling FundamentalsFree lesson

Method Signatures and throws Declaration

Understand how the throws clause in method signatures declares which checked exceptions a method may propagate.

Method Signatures and throws Declaration

What You'll Learn

You'll learn how to declare which checked exceptions a method may throw, communicating potential errors to callers through the method signature.

The Core Idea

When a method contains code that might throw a checked exception but doesn't catch it itself, Java requires you to advertise this fact in the method's signature using the throws clause. This acts as a contract: "Warning—calling this method might result in these exceptions propagating up to you."

Think of it like a warning label on a product. Just as a medication bottle lists potential side effects so users can prepare, the throws declaration tells other programmers what exceptions they need to handle when calling your method.

The Syntax

public void readFile(String filename) throws IOException {
    // Code that might throw IOException
    throw new IOException("File not found");
}

The throws keyword comes after the parameter list but before the method body. You can list multiple exceptions, separated by commas:

public void processData(String data) throws IOException, SQLException {
    // Code that might throw either exception
}

When You Must Use throws

  • Checked exceptions that your method doesn't catch must be declared with throws
  • Unchecked exceptions (like RuntimeException) don't require declaration (though you can declare them)
  • If you call another method that declares throws, and you don't catch those exceptions, you must also declare them

Example in Context

public void saveReport() throws IOException {
    writeFile("report.txt"); // This method throws IOException
    // We're not catching it, so we declare it with throws
}

Key Takeaway: The throws clause in a method signature declares which checked exceptions may propagate from that method, forming a contract that callers must handle or further propagate those exceptions.