Java IO.pdf - Nguyen Dang Binh

Java I/O
DataInput and DataOutput to use big-endian numbers, and it's best not to go against such
common assumptions.
I also considered making the little-endian classes subclasses of DataInputStream and
DataOutputStream. While this would have eliminated some duplicated methods like
readBoolean() and writeBoolean(), it would also have required the new, little-endian
methods to have unwieldy names like readLittleEndianInt() and
writeLittleEndianInt(). Furthermore, it's unlikely you'll need to read or write both littleendian
and big-endian numbers from the same stream. Most streams will contain one or the
other but not both.
Example 7.8. A LittleEndianOutputStream Class
/*
* @(#)LittleEndianOutputStream.java 1.0 98/08/29
*/
package com.macfaq.io;
import java.io.*;
/**
* A little-endian output stream writes primitive Java numbers
* and characters to an output stream in a little-endian format.
* The standard java.io.DataOutputStream class which this class
* imitates uses big-endian integers.
*
* @author Elliotte Rusty Harold
* @version 1.0, 29 Aug 1998
* @see com.macfaq.io.LittleEndianInputStream
* @see java.io.DataOutputStream
*/
public class LittleEndianOutputStream extends FilterOutputStream {
/**
* The number of bytes written so far to the little-endian output stream.
*/
protected int written;
/**
* Creates a new little-endian output stream and chains it to the
* output stream specified by the out argument.
*
* @param out the underlying output stream.
* @see java.io.FilterOutputStream#out
*/
public LittleEndianOutputStream(OutputStream out) {
super(out);
}
/**
* Writes the specified byte value to the underlying output stream.
*
* @param b the byte value to be written.
* @exception IOException if the underlying stream throws an
IOException.
*/
112