轉載自? ?Java IO: InputStream

譯文鏈接?作者:?Jakob?Jenkov?譯者:?李璟(jlee381344197@gmail.com)

InputStream類是Java?IO?API中所有輸入流的基類。InputStream子類包括FileInputStream，BufferedInputStream，PushbackInputStream等等。參考Java?IO概述這一小節底部的表格，可以瀏覽完整的InputStream子類的列表。

Java?InputStream例子

InputStream用于讀取基于字節的數據，一次讀取一個字節，這是一個InputStream的例子：

InputStream inputstream = new FileInputStream("c:\\data\\input-text.txt"); int data = inputstream.read(); while(data != -1) { //do something with data... doSomethingWithData(data); data = inputstream.read(); } inputstream.close();

這個例子創建了FileInputStream實例。FileInputStream是InputStream的子類，所以可以把FileInputStream實例賦值給InputStream變量。

注意：為了清晰，代碼忽略了一些必要的異常處理。想了解更多異常處理的信息，請參考Java?IO異常處理。

從Java7開始，你可以使用“try-with-resource”結構確保InputStream在結束使用之后關閉，鏈接指向了一篇關于“try-with-resource”是如何工作的文章，這里只是一個簡單的例子：

try( InputStream inputstream = new FileInputStream("file.txt") ) {int data = inputstream.read();while(data != -1){System.out.print((char) data);data = inputstream.read();} }

當執行線程退出try語句塊的時候，InputStream變量會被關閉。

read()

read()方法返回從InputStream流內讀取到的一個字節內容(譯者注：0~255)，例子如下：

int data = inputstream.read();

你可以把返回的int類型轉化成char類型：

char aChar = (char) data;

InputStream的子類可能會包含read()方法的替代方法。比如，DataInputStream允許你利用readBoolean()，readDouble()等方法讀取Java基本類型變量int，long，float，double和boolean。

流末尾

如果read()方法返回-1，意味著程序已經讀到了流的末尾，此時流內已經沒有多余的數據可供讀取了。-1是一個int類型，不是byte或者char類型，這是不一樣的。

當達到流末尾時，你就可以關閉流了。

read(byte[])

InputStream包含了2個從InputStream中讀取數據并將數據存儲到緩沖數組中的read()方法，他們分別是：

• int?read(byte[])
• int?read(byte,?int?offset,?int?length)

一次性讀取一個字節數組的方式，比一次性讀取一個字節的方式快的多，所以，盡可能使用這兩個方法代替read()方法。

read(byte[])方法會嘗試讀取與給定字節數組容量一樣大的字節數，返回值說明了已經讀取過的字節數。如果InputStream內可讀的數據不足以填滿字節數組，那么數組剩余的部分將包含本次讀取之前的數據。記得檢查有多少數據實際被寫入到了字節數組中。

read(byte,?int?offset,?int?length)方法同樣將數據讀取到字節數組中，不同的是，該方法從數組的offset位置開始，并且最多將length個字節寫入到數組中。同樣地，read(byte,?int?offset,?int?length)方法返回一個int變量，告訴你已經有多少字節已經被寫入到字節數組中，所以請記得在讀取數據前檢查上一次調用read(byte,?int?offset,?int?length)的返回值。

這兩個方法都會在讀取到達到流末尾時返回-1。

這是一個使用InputStream的read(byte[])的例子：

InputStream inputstream = new FileInputStream("c:\\data\\input-text.txt"); byte[] data = new byte[1024]; int bytesRead = inputstream.read(data); while(bytesRead != -1) {doSomethingWithData(data, bytesRead);bytesRead = inputstream.read(data); } inputstream.close();

在代碼中，首先創建了一個字節數組。然后聲明一個叫做bytesRead的存儲每次調用read(byte[])返回值的int變量，并且將第一次調用read(byte[])得到的返回值賦值給它。

在while循環內部，把字節數組和已讀取字節數作為參數傳遞給doSomethingWithData方法然后執行調用。在循環的末尾，再次將數據寫入到字節數組中。

你不需要想象出read(byte,?int?offset,?int?length)替代read(byte[])的場景，幾乎可以在使用read(byte,?int?offset,?int?length)的任何地方使用read(byte[])。

輸入流和數據源

一個輸入流往往會和數據源聯系起來，比如文件，網絡連接，管道等，更多細節已經在Java?IO概述文章中介紹過了。

總結

以上是生活随笔為你收集整理的Java IO: InputStream的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。