Errata for
The Java Class Libraries: Second Edition, Volume 1

NumberFormat.setMaximumFractionDigits()

Page 1210-1212

These four methods are missing the following detail from the newValue parameter description: setMaximumFractionDigits(), setMaximumIntegerDigits(), setMinimumFractionDigits(), setMinimumIntegerDigits()

newValue - If less than zero, then zero is used. The concrete subclass may enforce an upper limit to this value appropriate to the numeric type being formatted.

Object.notify()

Page 1222

Add the following paragraph to the EXAMPLE section:

The example as shown is designed for a single Retriever/Stacker pair. If the program uses multiple Retriever and/or Stacker threads, it must replace invocations of notify() with notifyAll() in order to avoid deadlocks.

OutputStreamWriter

Page 1308

The first statement of the example in the Usage section has a right parenthesis in the wrong place. It should read:

OutputStreamWriter out = 
    new OutputStreamWriter(new FileOutputStream("outputfile"), "UTF8");

Random.nextGaussian()

Page 1400, 1404

Change the nextGaussian() entry in the MEMBER SUMMARY on Page 1400, and the PURPOSE section of nextGaussian() on Page 1404 to read:

Generates the next pseudorandom, Gaussian ("normally") distributed double with mean 0.0 and standard deviation 1.0.

Replace the DESCRIPTION section with:

This pseudorandom sequence is generated by using the polar method of G. E. P. Box, M. E. Muller, and G. Marsaglia, as described by Donald E. Knuth in The Art of Computer Programming, Volume 2: Seminumerical Algorithms, section 3.4.1, subsection C, algorithm P.

Replace the RETURNS section with:

A pseudorandom, Gaussian ("normally") distributed double with mean 0.0 and standard deviation 1.0 from this random number generator's sequence.

Reader.read()

Page 1431

In the RETURNS section, enumeration of the different forms is mixed up. The first sentence should read: "The second form returns the character read; the first and third forms return the actual number of characters read."

Runtime

Pages 1468, 1470, 1474, 1476

In the EXAMPLE sections of exec(), freeMemory(), runFinalization(), traceInstructions(), traceMethodCalls(), add the following line before rt is used.

Runtime rt = Runtime.getRuntime();

Runtime.loadLibrary()

Page 1473

The last sentence of the first paragraph in the DESCRIPTION section is incorrect. It should instead say:

On Solaris, the library search path is specified by the environment variable LD_LIBRARY_PATH. On Windows, the library search order is as follows:

1. The directory from which the application is loaded.
2. The current directory.
3. The "SYSTEM" directory (on NT, "SYSTEM32" first, then "SYSTEM")
4. The "Windows" directory.
5. The PATH environment variable.

SecurityManager.checkAwtEventQueueAccess()

Page 1485

Delete the first paragraph in the DESCRIPTION section.

Serializable

Page 1514

The Class1.java and Class2.java files were omitted from the source listing, but they are included in the ZIP file of examples that you can download from the FTP site. They should be included on page 1514 of the book as follows:

public class Class1 implements Serializable {
    int field1;
    String field2;
    transient int field3;

    public Class1() {
	field1 = 10;
	field2 = "a string";
	field3 = -1;
    }
}

public class Class2 implements Serializable {
    int field1;
    String field2;
    transient int field3;

    public Class2() {
	field1 = 10;
	field2 = "a string";
	field3 = -1;
    }

    private void writeObject(ObjectOutputStream out) throws IOException {
	out.writeInt(field1);
	out.writeUTF(field2);
    }

    private void readObject(ObjectInputStream in) 
	throws IOException, ClassNotFoundException {
	field1 = in.readInt();
	field2 = in.readUTF();
    }
}

SimpleDateFormat

Page 1542

The example in the result column for E and EEE should be "Tue" (not "Tues"). The full set of abbreviated days of the week for U.S. English are: Sun, Mon, Tue, Wed, Thu, Fri, Sat. The full set of abbreviated months of the year are: Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec. The thirteenth month is the empty string.

Page 1543

The following section should be added to the class description:

Centuries and Year 2000 for Abbreviated Year

When parsing a date string using the abbreviated year pattern "yy", SimpleDateFormat must interpret the abbreviated year relative to some century. It does this by adjusting dates to be within 80 years before and 20 years after the time the SimpleDateFormat instance is created. For example, using a pattern of "MM/dd/yy" and a SimpleDateFormat instance created on Jan 1, 1997, the string "01/11/12" would be interpreted as Jan 11, 2012 while the string "05/04/64" would be interpreted as May 4, 1964.

SimpleTimeZone

Pages 1559

The DESCRIPTION heading has an extraneous "1559" suffix that should be removed.

Socket.getLocalAddress()

Pages 1579

The SYNTAX section should read

public InetAddress getLocalAddress()

Socket.getSoLinger(), Socket.setSoLinger()

Pages 1581, 1583

The methods getSoLinger() and setSoLinger() deal with time-out periods in terms of seconds, not milliseconds as stated in the book. Replace all occurrences of "milliseconds" with "seconds" in the DESCRIPTION, RETURNS, and PARAMETERS sections of these two methods.

String.substring()

Page 1651

Add the following sentence to the DESCRIPTION section: "If endIndex has not been specified, it defaults to length()."

StringCharacterIterator subrange

Page 1672

For clarification, add this paragraph to the end of "Subrange":

Note that last() returns the last character in the subrange, which is one character ahead of setIndex(getEndIndex()).

System.in

Page 1717

The example is not portable because it assumes that \n is the line terminator. The recommended way to read a line from standard input, or any input stream, is to use BufferedReader. Replace the example with the following:

BufferedReader in = new BufferedReader(new InputStreamReader(System.in));
String str = in.readLine();

System.setOut()

Page 1721

In the SYNTAX section, the argument to setOut() should be an instance of PrintStream, not OutputStream.

Thread

Page 1728

In the class example, the updateList() method marks a thread that has not been interrupted as having been interrupted and vice versa. The problem is that the arguments to the t.isInterrupted() ? expression are reversed. Replace the t.isInterrupted() ? expression with:

(t.isInterrupted() ? "Interrupted" : "")

Thread.yield()

Page 1749

In the example, replace synchronized (this) with synchronized (Worker.class).

Throwable.getLocalizedMessage()

Page 1771

In the SYNTAX section, the method name should be getLocalizedMessage() instead of getMessage().

URL.getFile()

Page 1809

In the method example, u.getFile() returns "/new.html", not "new.html".

URLConnection.getHeaderField()

Page 1835

In the EXAMPLE section, change getHeaderField(2) to return "1224" (instead of "1223").

URLConnection.getHeaderFieldKey()

Page 1836-1837

When a field has no key, null is returned, not an empty string as stated in the book. Change the third sentence to

Note that some fields have no key, in which case null is returned (see example).

In the EXAMPLE section, change getHeaderField() to getHeaderFieldKey(). Also, change getHeaderField(0) to return null (instead of the empty string).

Writer.write()

Page 1890

In the SYNTAX section, the char parameter in the third method prototype is missing its array designation. It should read:

public void write(char[] buf) throws IOException

ZipFile

Page 1909

In the actionPerformed() method, delete the following line:

os.putNextENtry(new ZipEntry(ze.getName()));

ZipInputStream.getNextEntry()

Page 1917

Delete the last sentence of the first paragraph in the DESCRIPTION section. Contrary to what the sentence says, if this ZIP input stream contains another ZIP file, it will be ignored.

Errata for First and Second Printing

BigInteger.compareTo()

Page 111

In the sample code, replace usage of DataInputStream with

BufferedReader is = new BufferedReader(new InputStreamReader(System.in));

BigInteger.toString()

Page 132

In the sample code, replace usage of DataInputStream with

BufferedReader is = new BufferedReader(new InputStreamReader(System.in));

Character.toTitleCase()

Page 303

In the sample code, replace isSpace() with isWhiteSpace().

CheckedInputStream

Page 336

In the class example, replace usage of DataInputStream with

BufferedReader is = new BufferedReader(new FileReader(args[0]));

Class.isAssignableFrom()

Page 369

Page 400

The Member Summary and PURPOSE section for isAssignableFrom() should read:

Determines if the class represented by this Class object is a superclass of a class.

The second bullet in the DESCRIPTION section should read:

This Class object represents a class and is a superclass of cls.

ClassLoader.loadClass()

Page424

Replace res with cl.getResource(args[2]). Replace is with cl.getResourceAsStream(args[2]).

ContentHandlerFactory

Page 491

In the class example, replace isLetterOrDigit(c) with Character.isLetterOrDigit(c).

DecimalFormat

Page 629

The list of patterns and formatted numbers in the upper half of the page do not appear in columns as they should. They should appear as follows:

Pattern       Formatted Number

-#0.##	      -1234.56          // Prefix minus sign for negative value
-#0.#         -1234.6           // 1 decimal place. Notice rounding up.
-#,##0.##     -1,234.56         // Grouping separator for thousands
-00,000.000   -01,234.560       // Leading and trailing zero
-####         -1234             // No decimal places or decimal separator
(###0.#)      (1234.5)          // Parentheses to show negative value
###0.#-       1234.5-           // Suffix minus sign
#,###%        -123,456%         // Percentage

Page 630

(Table 23) In JDK 1.1.6, the symbol 'E' has been removed from the set of special characters that can be used in a subpattern. Therefore, avoid using it. It has been included in JDK 1.2.

Modifier

Page 1146

In the class example, replace usage of DataInputStream with

BufferedReader is = new BufferedReader(new FileReader(args[0]));

Object.equals()

Page 1217

Add the following sentence to the second paragraph in the DESCRIPTION section:

If equals() is overridden, hashCode() should also be overridden so that two objects that are equal have the same hash code.

Object.hashCode()

Page 1220

Add the following sentence to the paragraph in the DESCRIPTION section:

If hashCode() is overridden, equals() should also be overridden so that two objects that are equal have the same hash code.

Object.notify()

Page 1221

Add the following sentences to the last paragraph in the DESCRIPTION section:

Furthermore, the thread does not release the monitor until it exits the synchronized method/block from which notify() is called, and consequently, the waiting thread being notified cannot grab the monitor until that time. In other words, the location of notify() within the synchronized block is irrelevant.

PrintWriter

Page 1356-1357

In the class example, place a try/catch clause around the assignment of the out field. Change b.length to buf.length.

SimpleDateFormat.parse()

Page 1556

Add '{' to end of the line for public static void main.

Socket.setSoTimeout()

Page 1584

Change "server socket" to "socket" in the PURPOSE section.

String.lastIndexOf()

Page 1644

Add to the DESCRIPTION section that if str is the empty string, this.length() is returned. For example, "abc".lastIndexOf("") returns 3.

StringBufferInputStream.available()

Page 1667

Because of a bug in the JDK, StringReader.ready() always returns true and therefore cannot be used as a replacement for StringBufferInputStream.available().

System.setErr()

Page 1720

In the sample code, use of the PrintStream constructors are for illustrative purposes only, as usage of these constructors are deprecated.

ZipFile

Page 1907-1908

The description of the class example incorrectly references a nonexistent example from Vector.setElementAt(). Instead, it should say that the example uses a variation of the QuickSort class from the java.lang.reflect.Array class example. This variation uses a Vector instead of an array. Also, in the sample code, change Comparable to Comparator.

ZipOutputStream

Page 1930

In the class example, replace "OutputStream os" with "OutputStream out" in the parameter list and in the code, replace the assignment to "os" with:

ZipOutputStream os = new ZipOutputStream(out);

Delete the extra closing parenthesis after calling the NullOutputStream constructor.

This page was updated: 19-Mar-2002