Input and Output Text and Binary IO Chapter

Input and Output Text and Binary I/O Chapter 19 Introduction to Java Y. Daniel Liang 1

File Input and Output Programs to run are in the File. IO folder: 1. Scanner. Driver. java 2. Scanner. File. java Scanner. Textfile. txt Scanner. Outputfile. txt 3. Inventory. java (Driver) Inventory. Item. java input file: inventory. txt (input file) (output file) Introduction to Java Y. Daniel Liang 2

File Input and Output Programs to run contd. 4. Test. Print. java 5. Test. Print. Writer. java Team #1 output file: pw. txt 6. Test. File. Stream Team #2 7. Test. Data. Stream Team #3 output file: temp. dat Introduction to Java Y. Daniel Liang 3

File Input and Output Programs to run contd. 8. Copy. java Team #4 Welcome. java (source file) Temp. java (target file) 9. Test. Object. Stream. For. Array Team #5 Introduction to Java Y. Daniel Liang 4

Objectives • To understand how I/O is processed in Java • To distinguish between text I/O and binary I/O • To read data from the console using the Scanner class • To read data from a file using the Scanner class Introduction to Java Y. Daniel Liang 5

Objectives contd. • To write data to a file using the Print. Writer class • To read and write bytes using File. Input Stream and File. Output. Stream • To read and write primitive values and strings using Data. Input. Stream/ Data. Out. Put. Stream Introduction to Java Y. Daniel Liang 6

Objectives contd. • To store and restore objects using Object. Output. Stream and Object. Input. Stream and to understand how objects are serialized and what kind of objects can be serialized To use the Serializable interface to enable objects to be serializable To know how to serialize arrays Introduction to Java Y. Daniel Liang 7

Input and Output Introduction Data held in variables, arrays, and objects are temporary. Data are lost when the program ceases processing To save the data created during the life of the program, you must save the data in a file onto a disk, CD, or some other storage device. Then the file can be transported and can be read later by other programs Introduction to Java Y. Daniel Liang 8

Introduction Redirection of Input and Output It is tedious to test programs by typing data in for every test run. Testing is far easier if the program reads input from a file. You can prepare the file once and reuse it for many tests. The command line interfaces of most operating systems provide a way to link a file to the input of a program, as if all the characters in the file had actually been typed by the user. Introduction to Java Y. Daniel Liang 9

Introduction Redirection of Input and Output example: java Class. Name < data. txt > output. txt Use input redirection to avoid repetitive typing during testing. Use output redirection to save your program output in a file. Introduction to Java Y. Daniel Liang 10

Introduction contd. Data are stored in two basic formats: text and binary Text file is represented in human-readable form Examples of text files that you can read: Files that are created with a simple text exitor , such as Windows Vista Note. Pad, as well as Java source code, and HTML Files Introduction to Java Y. Daniel Liang 11

Introduction contd. Data stored in a binary file are represented in binary form. You cannot read binary files. The files are designed to be read by programs. Binary files consists of a series of bits Text file consist of a series of characters. Introduction to Java Y. Daniel Liang 12

Introduction contd. The advantages of binary files are that: 1. They are more efficient to process than text files. Text I/O requires encoding and decoding whereas binary I/O does not. 2. Binary files are independent of the encoding scheme on the host machine and thus are portable. Introduction to Java Y. Daniel Liang 13

The Scanner class The simplest tool for reading text files is the Scanner class. Class java. util. Scanner Introduction to Java Y. Daniel Liang 14

to Get Input from the Console Using the Scanner Class Run Scanner. Driver program in the File. IO Folder next(): reading a string. A string delimeter is a space next. Byte(): reading an integer of the byte type next. Short(): reading an integer of the short type next. Int(): reading an integer of the int type next. Long(): reading an integer of the long type next. Float(): reading a number of the float type next. Double(): reading number of the double type Introduction to Java Y. Daniel Liang 15

To Get Input from a text file Using the Scanner Class Run Scanner. File Program in the File. IO Folder The action of reading data from a file is called file input. Introduction to Java Y. Daniel Liang 16

To read text data from a disk file, we use the File. Reader and Buffered. Reader objects. • We first construct a File. Reader object with the name of the file • Then we associate a Buffered. Reader object to the file. • Then we read data, using the read. Line method of the Buffered. Reader class. • Finally, we convert the String to a primitive data type as necessary. • Run Programs: Inventory. Item (Driver) Inventory Use input file: inventory. txt Introduction to Java Y. Daniel Liang 17

Sample code for processing a text file: String file = “customer. txt”; String line; try{ File. Reader fr = new File. Reader (file); Buffered. Reader in. File = new Buffered. Reader(fr); line = in. File. read. Line(); while(line != null && count < MAX) { tokenizer = new String. Tokenizer(line); name = tokenizer. next. Token(); Introduction to Java Y. Daniel Liang 18

Cont’d. try{ cust. Number = Long. parse. Long (tokenizer. next. Token()); balance = Double. parse. Double(tokenizer. next. Token()); phone = tokenizer. next. Token(); custs. Array[count++] = new Customer(name, cust. Number, balance, phone); } // end inner try block catch (Number. Format. Exception e) { } line = in. File. read. Line(); }// end while block in. File. close(); Introduction to Java Y. Daniel Liang 19

Print. Writer is an object we use to generate an output text file. Print. Writer supports only two output methods: println (for print line) Run program Test. Printer. Writer output file: pw. txt Introduction to Java Y. Daniel Liang 20

Constructors of the Print. Writer • Print. Writer(Writer out) • Print. Writer(Writer out, boolean auto. Flush) • Print. Writer(Output. Stream out, boolean auto. Flush) Introduction to Java Y. Daniel Liang 21

Print. Writer Methods • • • void print(Object o) void print(String s) void println(String s) void print(char c) print(char[] c. Array) print(int i) print(long l) void print(float f) void print(double d) void print(boolean b) Introduction to Java Y. Daniel Liang 22

Streams In Java, all I/O is handled in streams. F F A stream is an abstraction of the continuous one-way flow of data. The program receives data thru the input stream and sends data thru the output stream. Any source of input or destination for output is called a stream. Introduction to Java Y. Daniel Liang 23

Streams F All streams except random-access file streams flow in only one direction; therefore if you want to input and output, you need two separate stream objects. F Streams are objects. Stream objects have methods that read and write data , flush the stream, close the stream, and count the number of bytes in the stream, etc. Introduction to Java Y. Daniel Liang 24

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. Introduction to Java Y. Daniel Liang 25 25

Binary I/O Classes The design of the Java I/O classes is a good example of applying inheritance, where common methods are generalized in superclasses, and sub classes provide specialized methods. See next slide. It list some of the classes for performing binary I/O. Input. Stream is the root for binary input classes. Output. Stream is the root for binary output classes Introduction to Java Y. Daniel Liang 26

Binary I/O Classes Introduction to Java Y. Daniel Liang 27 27

Stream Classes F F The stream classes can be categorized into two types: byte streams and character streams. The Input. Stream/Output. Stream class is the root of all byte stream classes, F the Reader/Writer class is the root of all character stream. F The subclasses of Input. Stream/ Output. Stream are analogous to the subclasses of Reader/Writer. Introduction to Java Y. Daniel Liang 28

To Read and Write Binary Data from /To a Disk File. Input. Stream and File. Output. Stream- all methods in these classes are inherited from Input. Stream and Output. Stream (java. io. File. Input. Stream and java. io. File. Output. Stream ) Create a File. Input. Stream: File. Input. Stream input. Stream = new File. Input. Stream input. Stream ( “input. bin”); To write Binary Data to a Disk File: File. Output. Stream output. Stream = new File. Output. Stream output. Stream ( “output. bin”); Introduction to Java Y. Daniel Liang 29

Input. Stream java. io. Input. Stream F int read(byte[] b) throws IOException abstract int read() throws IOException F void close() throws IOException F int available() throws IOException F long skip(long n) throws IOException F Note: The abstract Input. Stream class defines the methods for the input stream of bytes Introduction to Java Y. Daniel Liang 30

Output. Stream java. io. Output. Stream F abstract void write(int b) throws IOException F void write(byte[] b) throws IOException F void close() throws IOException F void flush() throws IOException F Note: The abstract Output. Stream class defines the methods for the output stream of bytes. Introduction to Java Y. Daniel Liang 31

File. Input. Stream/File. Output. Stream associates a binary input/output stream with an external file. All the methods in File. Input. Stream/File. Ouptput. Stream are inherited from its superclasses. Introduction to Java Y. Daniel Liang 32

File. Input. Stream To construct a File. Input. Stream, use the following constructors: public File. Input. Stream(String filename) public File. Input. Stream(File file) A java. io. File. Not. Found. Exception would occur if you attempt to create a File. Input. Stream with a nonexistent file. Introduction to Java Y. Daniel Liang 33

File. Output. Stream To construct a File. Output. Stream, use the following constructors: public File. Output. Stream(String filename) public File. Output. Stream(File file) public File. Output. Stream(String filename, boolean append) public File. Output. Stream(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. Introduction to Java Y. Daniel Liang 34

File. Output. Stream The program Test. File. Stream uses binary I/O to write ten bytes values from 1 to 10 to a file named temp. dat Test. File. Stream Introduction to Java Y. Daniel Liang Run 35

Filter. Input. Stream/Filter. Output. Stream 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. Filter. Input. Stream and Filter. Output. Stream are the base classes for filtering data. When you need to process primitive numeric types, use Dat. Input. Stream and Data. Output. Stream to filter bytes. Introduction to Java Y. Daniel Liang 36

Data. Input. Stream/Data. Output. Stream Data. Input. Stream reads bytes from the stream and converts them into appropriate primitive type values or strings. Data. Output. Stream converts primitive type values or strings into bytes and output the bytes to the stream. Introduction to Java Y. Daniel Liang 37

Data. Input. Stream extends Filter. Input. Stream and implements the Data. Input interface. Introduction to Java Y. Daniel Liang 38

Data. Output. Stream extends Filter. Output. Stream and implements the Data. Output interface. Introduction to Java Y. Daniel Liang 39

Characters and Strings in Binary I/O A Unicode consists of two bytes. The write. Char(char c) method writes the Unicode of character c to the output. The write. Chars(String s) method writes the Unicode for each character in the string s to the output. Introduction to Java Y. Daniel Liang 40

Characters and Strings in Binary I/O Why UTF-8? What is UTF-8? UTF-8 (8 -bit UCS/Unicode Transformation Format) 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. 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. Introduction to Java Y. Daniel Liang 41 41

Characters and Strings in Binary I/O Why UTF-8? What is UTF-8? The UTF-8 is an alternative scheme that stores a character using 1, 2, or 3 bytes. ASCII values (less than 0 x 7 F) are coded in one byte. Unicode values less than 0 x 7 FF are coded in two bytes. Other Unicode values are coded in three bytes. Introduction to Java Y. Daniel Liang 42 42

Using Data. Input. Stream/Data. Output. Stream 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 Data. Input. Stream(Input. Stream instream) public Data. Output. Stream(Output. Stream 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. Data. Input. Stream infile = new Data. Input. Stream(new File. Input. Stream("in. dat")); Data. Output. Stream outfile = new Data. Output. Stream(new File. Output. Stream("out. dat")); Introduction to Java Y. Daniel Liang

Using Data. Input. Stream/Data. Output. Stream Data. Input. Stream and Data. Output. Stream read and write data primitive types values and strings in a machine-independent fashion. Thereby enabling you to write a data file on one machine and read it on another machine that has a different operating system or file structure. An application uses a data output stream to write data that can later be read by a program using a data input stream. Introduction to Java Y. Daniel Liang

Using Data. Input. Stream/Data. Output. Stream The Test. Data. Stream program writes student names and scores to a file named temp. dat and reads the data back from the file. Test. Data. Stream Introduction to Java Y. Daniel Liang Run

Order and Format See program Test. Data. Stream 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 write. UTF, you must read names using read. UTF. 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. Introduction to Java Y. Daniel Liang 46

Buffered. Input. Stream/Buffered. Output. Stream Reduces the number of reads and writes Using buffers to speed up I/O Buffered. Input. Stream/Buffered. Output. Stream does not contain new methods. All the methods Buffered. Input. Stream/Buffered. Output. Stream are inherited from the Input. Stream/Output. Stream classes. 47 Introduction to Java Y. Daniel Liang 47

Constructing Buffered. Input. Stream/Buffered. Output. Stream // Create a Buffered. Input. Stream public Buffered. Input. Stream(Input. Stream in) public Buffered. Input. Stream(Input. Stream in, int buffer. Size) // Create a Buffered. Output. Stream public Buffered. Output. Stream(Output. Stream out) public Buffered. Output. Stream(Output. Stream out, int buffer. Size) Introduction to Java Y. Daniel Liang 48

Constructing Buffered. Input. Stream/Buffered. Output. Stream Improve the performance of the Test. Data. Stream program by adding buffers in the streams in lines 6 -7 and 21 -22, as follows: Data. Output. Stream output = new Data. Output. Stream( new Buffered. Output. Stream(new File. Output. Stream(“temp. dat”)); Data. Input. Stream input = new Data. Input. Stream( new Buffered. Input. Stream(new File. Input. Stream(“temp. dat”)); Introduction to Java Y. Daniel Liang 49

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. Introduction to Java Y. Daniel Liang 50 50

Case Studies: Copy File The program uses the File class to check whether the source file and the target file exist. The program copies a Java source file to an identical Java file Copy Introduction to Java Y. Daniel Liang Run 51 51

Optional Object I/O Data. Input. Stream/Data. Output. Stream enables you to perform I/O for objects in addition to primitive type values and strings. Object. Input. Stream/Object. Output. Stream enables you to perform I/O for objects in addition for primitive type values and strings. Introduction to Java Y. Daniel Liang 52

Object. Input. Stream extends Input. Stream and implements Object. Input and Object. Stream. Constants. Introduction to Java Y. Daniel Liang 53

Object. Output. Stream extends Output. Stream and implements Object. Output and Object. Stream. Constants. Introduction to Java Y. Daniel Liang 54

Using Object Streams You may wrap an Object. Input. Stream/Object. Output. Stream on any Input. Stream/Output. Stream using the following constructors: // Create an Object. Input. Stream public Object. Input. Stream(Input. Stream in) // Create an Object. Output. Stream public Object. Output. Stream(Output. Stream out) Test. Object. Output. Stream Run Test. Object. Input. Stream Run Introduction to Java Y. Daniel Liang 55

Object Streams The Object. Input. Stream class can save entire object out to a disk, and the C class can read them back in. Objects are saved in binary format; therefore, you use streams and not writers. For example, you can write a Bank Account object to a file: Bank. Account bk = new …; Object. Output. Stream out = new Object. Output. Stream ( new File. Output. Stream(“bank. dat”)); Out. write. Object(bk); Introduction to Java Y. Daniel Liang 56

Object Streams Use Object streams to save and restore all instance fields of an object automatically. When reading the object back in, you use the read. Object method of the Object. Input. Stream class. That method returns an Object reference, so you need to remember the types of the objects that you saved and use a cast: Object. Input. Stream in = new Object. Input. Stream ( new File. Input. Stream(“bank. dat”)); Bank. Account bk = (Bank. Account) in. read. Object( ); The read. Object method can throw a Class. Not. Found. Exceptionit is a checked exception, so you need to catch or declare it. Introduction to Java Y. Daniel Liang 57

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 additional code in your class that implements Serializable. public My. Class implements Serializable{ // Definition of the class } Implementing this interface enables the Java serialization mechanism to automate the process of storing the objects and arrays. Introduction to Java Y. Daniel Liang 58

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. Introduction to Java Y. Daniel Liang 59

The transient Keyword, cont. Consider the following class: public class Foo implements java. io. Serializable { private int v 1; private static double v 2; private transient A v 3 = new A(); } class A { } // A is not serializable When an object of the Foo class is serialized, only variable v 1 is serialized. Variable v 2 is not serialized because it is a static variable, and variable v 3 is not serialized because it is marked transient. If v 3 were not marked transient, a java. io. Not. Serializable. Exception would occur. Introduction to Java Y. Daniel Liang 60

Serializing Arrays An array is serializable if all its elements are serializable. So an entire array can be saved using write. Object into a file and later restored using read. Object. Listing 16. 12 stores an array of five int values an array of three strings, and an array of two JButton objects, and reads them back to display on the console. Note : java. io. File implements Comparable and Serializable Test. Object. Stream. For. Array Introduction to Java Y. Daniel Liang Run 61

More about the Serializable Interface The process of saving objects to a stream is called serialization because each object is assigned a serial number on the stream. If the same object is saved twice, only the serial number is written out the second time. When the objects are read back in, duplicate serial numbers are restored as reference to the same object. Why don’t all classes implement Serializable? For security reasons, some programmers may not want to serialize classes with confidential contents. Once a class is serializable, anyone can write its objects to disk and analyze the disk file. There also some classes that contain values that are meaningless once a program exists, such as operating–system-specific font descriptors. These values should not be serialized. Introduction to Java Y. Daniel Liang 62

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 Random. Access. File class to allow a file to be read from and writen to at random locations. Introduction to Java Y. Daniel Liang 63

Random. Access. File Introduction to Java Y. Daniel Liang 64