1. Chapter 17 Binary I/O

2. Motivations
Data stored in a text file is represented in human-readable form.
Data stored in a binary file is represented in binary form. You cannot read binary files. They are designed to be read by programs.
For example, Java source programs are stored in text files and can be read by a text editor, but Java classes are stored in binary files and are read by the JVM.
The advantage of binary files is that they are more efficient to process than text files.

3. Objectives To discover how I/O is processed in Java (§17.2).
To distinguish between text I/O and binary I/O (§17.3).
To read and write bytes using FileInputStream and FileOutputStream (§17.4.1).
To read and write primitive values and strings using DataInputStream/DataOutputStream (§17.4.3).
To store and restore objects using ObjectOutputStream and ObjectInputStream, and to understand how objects are serialized and what kind of objects can be serialized (§17.6).
To implement the Serializable interface to make objects serializable (§17.6.1).
To serialize arrays (§17.6.2).
To read and write the same file using the RandomAccessFile class (§17.7).

4. How is I/O Handled in Java?
A File object encapsulates the properties of a file or a path, but does not contain the methods for reading/writing data from/to a file. In order to perform I/O, you need to create objects using appropriate Java I/O classes.
Scanner input = new Scanner(new File("temp.txt"));
System.out.println(input.nextLine());
input and output objects are called input and output streams.
PrintWriter output = new PrintWriter("temp.txt");
output.println("Java 101");
output.close();

5. Text File vs. Binary File
Data stored in a text file are represented in human-readable form.
Data stored in a binary file are represented in binary form. You cannot read binary files. Binary files are designed to be read by programs.
For example, the Java source programs are stored in text files and can be read by a text editor, but the Java classes are stored in binary files and are read by the JVM.
The advantage of binary files is that they are more efficient to process than text files.

6. Text File vs. Binary File
Although it is not technically precise and correct, you can imagine that a text file consists of a sequence of characters and a binary file consists of a sequence of bits.
For example, the decimal integer 199 is stored as the sequence of three characters: '1', '9', '9' in a text file and the same integer is stored as a byte-type value C7 in a binary file, because decimal 199 equals to hex C7.
Characters in a text file are encoded using a character-encoding scheme such as ASCII or Unicode

7. Binary I/O
Text I/O requires encoding and decoding. The JVM converts a Unicode to a file specific encoding when writing a character and coverts a file specific encoding to a Unicode when reading a character.
Binary I/O does not require conversions. When you write a byte to a file, the original byte is copied into the file. When you read a byte from a file, the exact byte in the file is returned.

8. Binary I/O Classes

9. InputStream
The value returned is a byte as an int type.

10. OutputStream
The value is a byte as an int type.

11. FileInputStream/FileOutputStream
FileInputStream/FileOutputStream associates a binary input/output stream with an external file. All the methods in FileInputStream/FileOuptputStream are inherited from its superclasses.

12. FileInputStream
To construct a FileInputStream, use the following constructors:
public FileInputStream(String filename)
public FileInputStream(File file)
A java.io.FileNotFoundException would occur if you attempt to create a FileInputStream with a nonexistent file.

13. FileOutputStream
To construct a FileOutputStream, use the following constructors:
public FileOutputStream(String filename)
public FileOutputStream(File file)
public FileOutputStream(String filename, boolean append)
public FileOutputStream(File file, boolean append)
  If the file does not exist, a new file would be created. If the file already exists, the first two constructors would delete the current contents in the file. To retain the current content and append new data into the file, use the last two constructors by passing true to the append parameter.
TestFileStream
Run

14. 1  import java.io.*;
2  
3  public class TestFileStream {
4   public static void main(String[] args) throws IOException {
5   try (
6   // Create an output stream to the file
7   FileOutputStream output = new FileOutputStream("temp.dat");
8   ) {
9   // Output values to the file
10   for (int i = 1; i <= 10; i++)
11   output.write(i);
12   }
13  
14   try (
15   // Create an input stream for the file
16   FileInputStream input = new FileInputStream("temp.dat");
17   ) {
18   // Read values from the file
19   int value;
20   while ((value = input.read()) != -1)
21   System.out.print(value + " ");
22   }
23   }
24  }

15. Binary Files
The file temp.dat created in this example is a binary file. It can be read from a Java program but not from a text editor

16. AutoClosable
The java.io.InputStream and java.io.OutputStream classes implement the AutoClosable interface.
The AutoClosable interface defines the close() method that closes a resource.
Any object of the AutoClosable type can be used with the try-with-resources syntax for automatic closing.

17. Appending to Text File
An instance of FileInputStream can be used as an argument to construct a Scanner
An instance of FileOutputStream can be used as an argument to construct a PrintWriter.
You can create a PrintWriter to append text into a file using
If temp.txt does not exist, it is created. If temp.txt already exists, new data are appended to the file
new PrintWriter(new FileOutputStream("temp.txt", true));

18. FilterInputStream/FilterOutputStream
Filter streams are streams that filter bytes for some purpose. The basic byte input stream provides a read method that can only be used for reading bytes. If you want to read integers, doubles, or strings, you need a filter class to wrap the byte input stream. Using a filter class enables you to read integers, doubles, and strings instead of bytes and characters. FilterInputStream and FilterOutputStream are the base classes for filtering data. When you need to process primitive numeric types, use DatInputStream and DataOutputStream to filter bytes.

19. DataInputStream/DataOutputStream
DataInputStream reads bytes from the stream and converts them into appropriate primitive type values or strings.
DataOutputStream converts primitive type values or strings into bytes and output the bytes to the stream.

20. DataInputStream
DataInputStream extends FilterInputStream and implements the DataInput interface.

21. DataInputStream
This class, which is in the java.io package, allows you to read data of any primitive type, or String objects, from a binary file.
The DataInputStream class by itself cannot directly access a file, however. It is used in conjunction with a FileInputStream object that has a connection to a file.

22. DataOutputStream
DataOutputStream extends FilterOutputStream and implements the DataOutput interface.

23. DataOutputStream
This class which is in the java.io package, allows you to write data of any primitive type or String objects to a binary file.
The DataOutputStream class by itself cannot directly access a file, however. It is used in conjunction with a FileOutputStream object that has a connection to a file.

24. Characters and Strings in Binary I/O (1)
A Unicode consists of two bytes.
The writeChar(char c) method writes the Unicode of character c to the output.
The writeChars(String s) method writes the Unicode for each character in the string s to the output.

25. Characters and Strings in Binary I/O (2) What is UTF-8?
UTF-8 is a coding scheme that allows systems to operate with both ASCII and Unicode efficiently.
Most operating systems use ASCII.
Java uses Unicode.
The ASCII character set is a subset of the Unicode character set.

26. Characters and Strings in Binary I/O (3) Why UTF-8?
Since most applications need only the ASCII character set, it is a waste to represent an 8-bit ASCII character as a 16-bit Unicode character.
The UTF-8 is an alternative scheme that stores a character using 1, 2, or 3 bytes.
ASCII values (less than 0x7F) are coded in one byte. Unicode values less than 0x7FF are coded in two bytes. Other Unicode values are coded in three bytes.

27. Using DataInputStream/DataOutputStream
Data streams are used as wrappers on existing input and output streams to filter data in the original stream. They are created using the following constructors:
public DataInputStream(InputStream instream)
public DataOutputStream(OutputStream outstream)
The statements given below create data streams. The first statement creates an input stream for file in.dat; the second statement creates an output stream for file out.dat.
DataInputStream infile =
new DataInputStream(new FileInputStream("in.dat"));
DataOutputStream outfile = new DataOutputStream(new FileOutputStream("out.dat"));
TestDataStream
Run

28. John 85.5 Susan 185.5 Kim 105.25 1 import java.io.*; 2
2  
3  public class TestDataStream {
4   public static void main(String[] args) throws IOException {
5   try ( // Create an output stream for file temp.dat
6   DataOutputStream output =
7   new DataOutputStream(new FileOutputStream("temp.dat"));
8   ) {
9   // Write student test scores to the file
10   output.writeUTF("John");
11   output.writeDouble(85.5);
12   output.writeUTF("Jim");
13   output.writeDouble(185.5);
14   output.writeUTF("George");
15   output.writeDouble(105.25);
16   }
17  
18   try ( // Create an input stream for file temp.dat
19   DataInputStream input =
20   new DataInputStream(new FileInputStream("temp.dat"));
21   ) {
22   // Read student test scores from the file
23   System.out.println(input.readUTF() + " " + input.readDouble());
24   System.out.println(input.readUTF() + " " + input.readDouble());
25   System.out.println(input.readUTF() + " " + input.readDouble());
26   }
27   }
28  }
John 85.5
Susan 185.5
Kim

29. Concept of pipe line

30. Order and Format Checking End of File
CAUTION: You have to read the data in the same order and same format in which they are stored. For example, since names are written in UTF-8 using writeUTF, you must read names using readUTF.
Checking End of File
TIP: If you keep reading data at the end of a stream, an EOFException would occur. So how do you check the end of a file? You can use input.available() to check it. input.available() == 0 indicates that it is the end of a file.

31. 4.5 43.25 3.2 All data were read 1 import java.io.*; 2
2  
3  public class DetectEndOfFile {
4   public static void main(String[] args) {
5   try {
6   try (DataOutputStream output =
7   new DataOutputStream(new FileOutputStream("test.dat"))) {
8   output.writeDouble(4.5);
9   output.writeDouble(43.25);
10   output.writeDouble(3.2);
11   }
12  
13   try (DataInputStream input =
14   new DataInputStream(new FileInputStream("test.dat"))) {
15   while (true)
16   System.out.println(input.readDouble());
17   }
18   }
19   catch (EOFException ex) {
20   System.out.println("All data were read");
21   }
22   catch (IOException ex) {
23   ex.printStackTrace();
24   }
25   }
26  }
4.5
43.25
3.2
All data were read

32. BufferedInputStream/ BufferedOutputStream
Using buffers to speed up I/O
BufferedInputStream/BufferedOutputStream does not contain new methods. All the methods BufferedInputStream/BufferedOutputStream are inherited from the InputStream/OutputStream classes.

33. BufferedInputStream/ BufferedOutputStream
Using BufferedInputStream, the whole block of data on the disk is read into the buffer in the memory once.
The individual data are then loaded to your program from the buffer.
Using BufferedOutputStream, the individual data are first written to the buffer in the memory.
When the buffer is full, all data in the buffer are written to the disk once.

34. Constructing BufferedInputStream/BufferedOutputStream
You can wrap a BufferedInputStream/BufferedOutputStream on any InputStream/ OutputStream using the constructors
// Create a BufferedInputStream
public BufferedInputStream(InputStream in)
public BufferedInputStream(InputStream in, int bufferSize)
// Create a BufferedOutputStream
public BufferedOutputStream(OutputStream out)
public BufferedOutputStream(OutputStreamr out, int bufferSize)

35. Case Studies: Copy File
This case study develops a program that copies files. The user needs to provide a source file and a target file as command-line arguments using the following command:
java Copy source target
The program copies a source file to a target file and displays the number of bytes in the file. If the source does not exist, tell the user the file is not found. If the target file already exists, tell the user the file already exists.
Copy
Run

36. 1  import java.io.*;
2  
3  public class Copy {
4   /** Main method
args[0] for sourcefile
args[1] for target file
7   */
8   public static void main(String[] args) throws IOException {
9   // Check command-line parameter usage
10   if (args.length != 2) {
11   System.out.println(
12   "Usage: java Copy sourceFile targetfile");
13   System.exit(1);
14   }
15  
16   // Check if source file exists
17   File sourceFile = new File(args[0]);
18   if (!sourceFile.exists()) {
19   System.out.println("Source file " + args[0]
20   + " does not exist");
21   System.exit(2);
22   }

37. 24   // Check if target file exists
25   File targetFile = new File(args[1]);
26   if (targetFile.exists()) {
27   System.out.println("Target file " + args[1]
28   + " already exists");
29   System.exit(3);
30   }
31  
32   try (
33   // Create an input stream
34   BufferedInputStream input =
35   new BufferedInputStream(new FileInputStream(sourceFile));
36  
37   // Create an output stream
38   BufferedOutputStream output =
39   new BufferedOutputStream(new FileOutputStream(targetFile));
40   ) {
41   // Continuously read a byte from input and write it to output
42   int r, numberOfBytesCopied = 0;
43   while ((r = input.read()) != -1) {
44   output.write((byte)r);
45   numberOfBytesCopied++;
46   }
47  
48   // Display the file size
49   System.out.println(numberOfBytesCopied + " bytes copied");
50   }
51   }
52  }

38. Optional
Object I/O
DataInputStream/DataOutputStream enables you to perform I/O for primitive type values and strings. ObjectInputStream/ObjectOutputStream enables you to perform I/O for objects in addition for primitive type values and strings.

39. ObjectInputStream
ObjectInputStream extends InputStream and implements ObjectInput and ObjectStreamConstants.

40. ObjectOutputStream
ObjectOutputStream extends OutputStream and implements ObjectOutput and ObjectStreamConstants.

41. Using Object Streams
You may wrap an ObjectInputStream/ObjectOutputStream on any InputStream/OutputStream using the following constructors:
// Create an ObjectInputStream
public ObjectInputStream(InputStream in)
// Create an ObjectOutputStream
public ObjectOutputStream(OutputStream out)
TestObjectOutputStream
Run
TestObjectInputStream
Run

42. 1  import java.io.*;
2  
3  public class TestObjectOutputStream {
4   public static void main(String[] args) throws IOException {
5   try ( // Create an output stream for file object.dat
6   ObjectOutputStream output =
7   new ObjectOutputStream(new FileOutputStream("object.dat"));
8   ) {
9   // Write a string, double value, and object to the file
10   output.writeUTF("John");
11   output.writeDouble(85.5);
12   output.writeObject(new java.util.Date());
13   }
14   }
15  }

43. Notice that you must cast the return value to the desired class type
1  import java.io.*;
2  
3  public class TestObjectInputStream {
4   public static void main(String[] args)
5   throws ClassNotFoundException, IOException {
6   try ( // Create an input stream for file object.dat
7   ObjectInputStream input =
8   new ObjectInputStream(new FileInputStream("object.dat"));
9   ) {
10   // Read a string, double value, and object from the file
11   String name = input.readUTF();
12   double score = input.readDouble();
13   java.util.Date date = (java.util.Date)(input.readObject());
14   System.out.println(name + " " + score + " " + date);
15   }
16   }
17  }
John 85.5 Sun Dec 04 10:35:31 EST 2011
Notice that you must cast the return value to the desired class type

44. The Serializable Interface
Not all objects can be written to an output stream. Objects that can be written to an object stream is said to be serializable. A serializable object is an instance of the java.io.Serializable interface. So the class of a serializable object must implement Serializable.
The Serializable interface is a marker interface. It has no methods, so you don't need to add additional code in your class that implements Serializable.
Implementing this interface enables the Java serialization mechanism to automate the process of storing the objects and arrays.

45. The transient Keyword
If an object is an instance of Serializable, but it contains non-serializable instance data fields, can the object be serialized?
The answer is no.
To enable the object to be serialized, you can use the transient keyword to mark these data fields to tell the JVM to ignore these fields when writing the object to an object stream.

46. The transient Keyword, cont.
Consider the following class:
public class Foo implements java.io.Serializable {
private int v1;
private static double v2;
private transient A v3 = new A(); }
class A { } // A is not serializable
When an object of the Foo class is serialized, only variable v1 is serialized. Variable v2 is not serialized because it is a static variable, and variable v3 is not serialized because it is marked transient.
If v3 were not marked transient, a java.io.NotSerializableException would occur.

47. TestObjectStreamForArray
Serializing Arrays
An array is serializable if all its elements are serializable. So an entire array can be saved using writeObject into a file and later restored using readObject. Here is an example that stores an array of five int values and an array of three strings, and reads them back to display on the console.
TestObjectStreamForArray
Run

48. 1  import java.io.*;
2  
3  public class TestObjectStreamForArray {
4   public static void main(String[] args)
5   throws ClassNotFoundException, IOException {
6   int[] numbers = {1, 2, 3, 4, 5};
7   String[] strings = {"John", "Susan", "Kim"};
8  
9   try ( // Create an output stream for file array.dat
10   ObjectOutputStream output = new ObjectOutputStream(new
11   FileOutputStream("array.dat", true));
12   ) {
13   // Write arrays to the object output stream
14   output.writeObject(numbers);
15   output.writeObject(strings);
16   }

49. 18   try ( // Create an input stream for file array.dat
19   ObjectInputStream input =
20   new ObjectInputStream(new FileInputStream("array.dat"));
21   ) {
22   int[] newNumbers = (int[])(input.readObject());
23   String[] newStrings = (String[])(input.readObject());
24  
25   // Display arrays
26   for (int i = 0; i < newNumbers.length; i++)
27   System.out.print(newNumbers[i] + " ");
28   System.out.println();
29  
30   for (int i = 0; i < newStrings.length; i++)
31   System.out.print(newStrings[i] + " ");
32   }
33   }
34  }
John Susan Kim

50. Random Access Files
All of the streams you have used so far are known as read-only or write-only streams.
The external files of these streams are sequential files that cannot be updated without creating a new file.
It is often necessary to modify files or to insert new records into files.
Java provides the RandomAccessFile class to allow a file to be read from and write to at random locations.

51. RandomAccessFile

52. File Pointer A random access file consists of a sequence of bytes.
There is a special marker called file pointer that is positioned at one of these bytes.
A read or write operation takes place at the location of the file pointer. When a file is opened, the file pointer sets at the beginning of the file.
When you read or write data to the file, the file pointer moves forward to the next data.
For example, if you read an int value using readInt(), the JVM reads four bytes from the file pointer and now the file pointer is four bytes ahead of the previous location.

53. RandomAccessFile Methods
Many methods in RandomAccessFile are the same as those in DataInputStream and DataOutputStream. For example, readInt(), readLong(), writeDouble(), readLine(), writeInt(), and writeLong() can be used in data input stream or data output stream as well as in RandomAccessFile streams.

54. RandomAccessFile Methods, cont.
void seek(long pos) throws IOException;
Sets the offset from the beginning of the RandomAccessFile stream to where the next read or write occurs.
long getFilePointer() IOException;
Returns the current offset, in bytes, from the beginning of the file to where the next read or write occurs.

55. RandomAccessFile Methods, cont.
long length()IOException
Returns the length of the file.
final void writeChar(int v) throws IOException
Writes a character to the file as a two-byte Unicode, with the high byte written first.
final void writeChars(String s) throws IOException
Writes a string to the file as a sequence of characters.

56. RandomAccessFile Constructor
RandomAccessFile raf = new RandomAccessFile("test.dat", "rw"); // allows read and write
RandomAccessFile raf = new RandomAccessFile("test.dat", "r"); // read only

57. A Short Example on RandomAccessFile
TestRandomAccessFile
Run

58. 1  import java.io.*;
2  
3  public class TestRandomAccessFile {
4   public static void main(String[] args) throws IOException {
5   try ( // Create a random access file
6   RandomAccessFile inout = new RandomAccessFile("inout.dat", "rw");
7   ) {
8   // Clear the file to destroy the old contents if exists
9   inout.setLength(0);
10  
11   // Write new integers to the file
12   for (int i = 0; i < 200; i++)
13   inout.writeInt(i);
14  
15   // Display the current length of the file
16   System.out.println("Current file length is " + inout.length());
17  
18   // Retrieve the first number
19   inout.seek(0); // Move the file pointer to the beginning
20   System.out.println("The first number is " + inout.readInt());
21  
22   // Retrieve the second number
23   inout.seek(1 * 4); // Move the file pointer to the second number
24   System.out.println("The second number is " + inout.readInt());

59. Current file length is 800 The first number is 0  
26   // Retrieve the tenth number
27   inout.seek(9 * 4); // Move the file pointer to the tenth number
28   System.out.println("The tenth number is " + inout.readInt());
29  
30   // Modify the eleventh number
31   inout.writeInt(555);
32  
33   // Append a new number
34   inout.seek(inout.length()); // Move the file pointer to the end
35   inout.writeInt(999);
36  
37   // Display the new length
38   System.out.println("The new length is " + inout.length());
39  
40   // Retrieve the new eleventh number
41   inout.seek(10 * 4); // Move the file pointer to the eleventh number
42   System.out.println("The eleventh number is " + inout.readInt());
43   }
44   }
45  }
Current file length is 800
The first number is 0
The second number is 1
The tenth number is 9
The new length is 804
The eleventh number is 555