JAVA.STRUCT.EXCP.GEH : Generic Exception Handler (Java)

JavaScript is not currently enabled, but is required for full CodeSonar manual search and browse functionality.

If you are viewing this file in your hub's Web GUI, enable JavaScript in your browser: you will also need it for GUI functionality.

If you opened this file directly from disk, your browser may be directly suppressing JavaScript functionality: certain browsers perform this suppression on local files (but not files delivered by web servers) for security reasons.

If you access the manual through the hub's Web GUI, the functionality will not be suppressed because the hub is a web server.
Alternatively, your browser may allow you to explicitly disable the security setting that suppresses functionality. See the CodeSonar FAQ for more information.

CodeSonar^® 9.2p0

CONFIDENTIAL

CodeSecure Inc

Java

JAVA.STRUCT.EXCP.GEH : Generic Exception Handler (Java)

Summary

An exception handler is used for a very generic exception type.

When JAVA_ANALYSIS_PEDANTIC_MODE=Yes, warnings will be issued for all such exception handlers.
When JAVA_ANALYSIS_PEDANTIC_MODE=No, warnings will not be issued for exception handlers that always rethrow the exception.

This checker controls if exception handlers might be incorrect. For instance, an exception handler with an empty body might be an unfinished snippet of code; an exception handler for a very generic exception type might end up catching too many exceptions, also some that were not meant to be caught there.

Properties

Class Name

Generic Exception Handler (Java)

Significance

reliability

Mnemonic

JAVA.STRUCT.EXCP.GEH

Example

// Main.java 
import java.io.FileWriter;

public class Main {
  public static void main(String args[]) {
    FileWriter fw = null;
    try {
      fw = new FileWriter(args[0]);
      fw.close();
    }
    catch (IndexOutOfBoundsException e) {} // Empty Exception Handler (Java) warning issued here
    catch (Exception e) {                  // Generic Exception Handler (Java) warning issued here
      System.out.println("unusual");
    }
  }
}

These issues can be resolved as follows.

Add content to the first exception handler so that it is not empty. For example, it could output a warning message to the user specifying that the program must be invoked with an argument
Narrow the exception type caught by the second exception handler to java.io.IOException.

// Main.java, after modification 
import java.io.FileWriter;

public class Main {
  public static void main(String args[]) {
    FileWriter fw = null;
    try {
      fw = new FileWriter(args[0]);
      fw.close();
    }
    catch (IndexOutOfBoundsException e) {
      System.out.println("usage: Main filename");
    }
    catch (IOException e) {
      System.out.println("I/O error");
    }
  }
}

Resolution

Add a body to the exception handler, or narrow to the exception types.

Relevant Configuration File Parameters

The following configuration file parameters affect checks for this warning class.

To report problems with this documentation, please visit https://support.codesecure.com/.