Programming Languages and Techniques (CIS120)

Transcription

1 Programming Languages and Techniques (CIS120) Lecture 30 November 13, 2015 ExcepEons / IO Chapter 27

2 HW7: PennPals Chat Due: Tuesday, November 17 th Announcements Start today if you haven't already!

3 Poll Have you started HW 07 PennPals? 1. No 2. I've thought about the ServerModel structure 3. I've got the basics working 4. I'm done

4 ExcepEons Dealing with the unexpected

5 Catching ExcepEons There can be more than one catch clause associated with each try Matched in order, according to the dynamic class of the excepeon thrown The first clause that declares a supertype of the excepeon is triggered Helps refine error handling try { // do something with the IO library catch (FileNotFoundException e) { // handle an absent file catch (IOException e) { // handle other kinds of IO errors.

6 Finally try {... catch (Exn1 e1) {... catch (Exn2 e2) {... finally {... A finally clause of a try/catch/finally statement always gets run, regardless of whether there is no excepeon, a propagated excepeon, or a caught excepeon. even if the method returns from inside the try.

7 Using Finally Finally is o^en used for releasing resources that might have been held/created by the try block: public void dosomeio (String file) { FileReader r = null; try { r = new FileReader(file); // do some IO catch (FileNotFoundException e) { // handle the absent file catch (IOException e) { // handle other IO problems finally { if (r!= null) { // don t forget null check! try { r.close(); catch (IOException e) {

8 InformaEve ExcepEon Handling

9 ExcepEon Class Hierarchy Type of all throwable objects. Object Subtypes of ExcepEon must be declared. Throwable ExcepEon Error Fatal Errors: should never be caught. IOExcepEon RunEmeExcepEon IllegalArgumentExcepEon FileNotFoundExcepEon Subtypes of RunEmeExcepEon do not have to be declared.

10 Checked (Declared) ExcepEons ExcepEons that are subtypes of Exception but not RuntimeException are called checked or declared. A method that might throw a checked excepeon must declare it using a throws clause in the method type. The method might raise a checked excepeon either by: directly throwing such an excepeon public void maybedoit (String file) throws AnException { if ( ) throw new AnException(); // directly throw or by calling another method that might itself throw a checked excepeon public void dosomeio (String file) throws IOException { Reader r = new FileReader(file); // might throw

11 Unchecked (Undeclared) ExcepEons Subclasses of RunEmeExcepEon do not need to be declared via throws even if the method does not explicitly handle them. Many pervasive types of errors cause RunEmeExcepEons NullPointerExcepEon IndexOutOfBoundsExcepEon IllegalArgumentExcepEon public void mightfail (String file) { if (file.equals( dictionary.txt ) { // file could be null! The original intent was that such excepeons represent disastrous condieons from which it was impossible to sensibly recover

12 Checked vs. Unchecked ExcepEons Which methods need a "throws" clause? Note: IllegalArgumentExcepEon is a subtype of RunEmeExcepEon. IOExcepEon is not. Answer: n, q and s should say throws IOExcepEon public class ExceptionQuiz { public void m(object x) { if (x == null) throw new IllegalArgumentException(); public void n(object y) { if (y == null) throw new IOException(); public void p() { m(null); public void q() { n(null); public void r() { try { n(null); catch (IOException e) { public void s() { n(new Object());

13 Declared vs. Undeclared? Tradeoffs in the so^ware design process: Declared = befer documentaeon forces callers to acknowledge that the excepeon exists Undeclared = fewer staec guarantees but, much easier to refactor code In pracece: test- driven development encourages fail early/fail o^en model of code design and lots of code refactoring, so undeclared excepeons are prevalent. A reasonable compromise: Use declared excepeons for libraries, where the documentaeon and usage enforcement are criecal Use undeclared excepeons in client code to facilitate more flexible development

14 Good Style for ExcepEons In Java, excepeons should be used to capture excep6onal circumstances Try/catch/throw incur performance costs and complicate reasoning about the program, don t use them when befer solueons exist Re- use exiseng excepeon types when they are meaningful to the situaeon e.g. use NoSuchElementExcepEon when implemeneng a container Define your own subclasses of ExcepEon if doing so can convey useful informaeon to possible callers that can handle the excepeon.

15 Good Style for ExcepEons It is o^en sensible to catch one excepeon and re- throw a different (more meaningful) kind of excepeon. e.g. when implemeneng WordScanner (in upcoming lectures), we catch IOException and throw NoSuchElementException in the next method. Catch excepeons as near to the source of failure as makes sense i.e. where you have the informaeon to deal with the excepeon Catch excepeons with as much precision as you can BAD: try { catch (Exception e) { BETTER: try { catch (IOException e) {

16 java.io

17 Poll How many of these these classes have you used before CIS 120 (all part of the Java standard library)? Scanner Reader InputStream (e.g. System.in) FileReader BufferedReader Something else from java.io?

18 I/O Streams The stream abstraceon represents a communicaeon channel with the outside world. can be used to read or write a poteneally unbounded number of data items (unlike a list) data items are read from or wrifen to a stream one at a Eme The Java I/O library uses subtyping to provide a unified view of disparate data sources and sinks.

19 Low- level Streams At the lowest level, a stream is a sequence of binary numbers The simplest IO classes break up the sequence into 8- bit chunks, called bytes. Each byte corresponds to an integer in the range

20 InputStream and OutputStream Abstract classes that provide basic operaeons for the Stream class hierarchy: int read (); // Reads the next byte of data void write (int b); // Writes the byte b to the output These operaeons read and write int values that represent bytes range represents a byte value -1 represents no more data (when returned from read) java.io provides many subclasses for various sources/sinks of data: files, audio devices, strings, byte arrays, serialized objects Subclasses also provides rich funceonality: encoding, buffering, formaqng, filtering

21 Binary IO example InputStream fin = new FileInputStream(filename); int[] data = new int[width][height]; for (int i=0; i < data.length; i++) { for (int j=0; j < data[0].length; j++) { int ch = fin.read(); if (ch == -1) { fin.close(); throw new IOException("File ended early"); data[j][i] = ch; fin.close();

22 BufferedInputStream Reading one byte at a Eme can be slow! Each Eme a stream is read there is a fixed overhead, plus Eme proporeonal to the number of bytes read. disk - > operaeng system - > JVM - > program disk - > operaeng system - > JVM - > program disk - > operaeng system - > JVM - > program A BufferedInputStream presents the same interface to clients, but internally reads many bytes at once into a buffer (incurring the fixed overhead only once) disk - > operaeng system - >>>> JVM - > program JVM - > program JVM - > program JVM - > program

23 Buffering Example FileInputStream fin1 = new FileInputStream(filename); InputStream fin = new BufferedInputStream(fin1); int[] data = new int[width][height]; for (int i=0; i < data.length; i++) { for (int j=0; j < data[0].length; j++) { int ch = fin.read(); if (ch == -1) { fin.close(); throw new IOException("File ended early"); data[j][i] = ch; fin.close();

24 The Standard Java Streams java.lang.system provides an InputStream and two standard PrintStream objects for doing console I/O. System.in System.out System.err Note that System.in, for example, is a sta6c member of the class System this means that the field in is associated with the class, not an instance of the class. Recall that staec members in Java act like global variables.

25 PrintStream Methods PrintStream adds buffering and binary- conversion methods to OutputStream void println(boolean b); // write b followed by a new line void println(string s); // write s followed by a newline void println(); // write a newline to the stream void print(string s); void flush(); // write s without terminaeng the line (output may not appear unel the stream is flushed) // actually output characters waieng to be sent Note the use of overloading: there are mul6ple methods called println The compiler figures out which one you mean based on the number of arguments, and/ or the sta6c type of the argument you pass in at the method s call site. The java I/O library uses overloading of constructors pervasively to make it easy to glue together the right stream processing rouenes

26 Character based IO A character stream is a sequence of 16- bit binary numbers ,762 \u0251 \ub6aa a The character- based IO classes break up the sequence into 16- bit chunks, of type char. Each character corresponds to a lefer (specified by a character encoding).

27 Reader and Writer Similar to the InputStream and OutputStream classes, including: int read (); // Reads the next character void write (int b); // Writes the char to the output These operaeons read and write int values that represent unicode characters read returns an integer in the range 0 to (i.e. 16 bits) value -1 represents no more data (when returned from read) requires an encoding (e.g. UTF- 8 or UTF- 16, set by a Locale) Like byte streams, the library provides many subclasses of Reader and Writer Subclasses also provides rich funceonality. use these for portable text I/O Gotcha: System.in, System.out, System.err are byte streams So wrap in an InputStreamReader / PrintWriter if you need unicode console I/O