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:
-
checked
The class is a checked exception, which means that it extends
java.lang.Exception
, but notjava.lang.RuntimeException
. In other words, it must be declared in thethrows
clause of any method that may throw it.-
cloneable
The class, or superclass, implements
java.lang.Cloneable
.-
unchecked
The class is an unchecked exception, which means it extends
java.lang.RuntimeException
and therefore does not need to be declared in thethrows
clause of a method that may throw it.
Description ...
Get JXTA in a Nutshell now with the O’Reilly learning platform.
O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.