Reading a Quick-Reference Entry
Each quick-reference entry contains quite a bit of information. The sections that follow describe the structure of a quick-reference entry, explaining what information is available, where it is found, and what it means. While reading the descriptions, you will find it helpful to flip through the reference section itself to find examples of the features being described.
Class Name, Package Name, Availability, and Flags
Each quick-reference entry begins with a four-part title that specifies the name, package, and availability of the class, and may also specify various additional flags that describe the class. The class name appears in bold at the upper left of the title. The package name appears, in smaller print, in the lower left, below the class name.
The upper-right portion of the title indicates the availability of the class. In the lower-right corner of the title you may find a list of flags that describe the class. The possible flags and their meanings are as follows:
The class is a checked exception, which means that it extends
java.lang.Exception, but not
java.lang.RuntimeException. In other words, it must be declared in the
throwsclause of any method that may throw it.
The class, or superclass, implements
The class is an unchecked exception, which means it extends
java.lang.RuntimeExceptionand therefore does not need to be declared in the
throwsclause of a method that may throw it.