Inspectopedia Help

Overly broad 'throws' clause

Reports throws clauses with exceptions that are more generic than the exceptions that the method actually throws.

Example:

public void createFile() throws Exception { // warning: 'throws Exception' is too broad, masking exception 'IOException' File file = new File("pathToFile"); file.createNewFile(); }

After the quick-fix is applied:

public void createFile() throws IOException { File file = new File("pathToFile"); file.createNewFile(); }

Configure the inspection:

  • Use the Maximum number of hidden exceptions to warn field to ignore exceptions, that hide a larger number of other exceptions than specified.

  • Use the Only warn on RuntimeException, Exception, Error or Throwable option to have this inspection warn only on the most generic exceptions.

  • Use the Ignore exceptions declared on methods overriding a library method option to ignore overly broad throws clauses in methods that override a library method.

  • Use the Ignore exceptions which hide others but are themselves thrown option to ignore any exceptions that hide other exceptions but still may be thrown from the method body and thus are technically not overly broad.

Inspection options

Here you can find the description of settings available for the Overly broad 'throws' clause inspection, and the reference of their default values.

Maximum number of hidden exceptions to report

10

Only warn on RuntimeException, Exception, Error or Throwable

Not selected

Ignore exceptions declared on methods overriding a library method

Not selected

Ignore exceptions which hide others but are themselves thrown

Not selected

Inspection Details

Available in:

IntelliJ IDEA 2024.2, Qodana for JVM 2024.2,

Plugin:

Java, 242.SNAPSHOT

Last modified: 20 February 2024