Java IO: InputStream
原文链接 作者: Jakob Jenkov 译者: 李璟(jlee381344197@gmail.com)
InputStream类是Java IO API中所有输入流的基类。InputStream子类包括FileInputStream,BufferedInputStream,PushbackInputStream等等。参考Java IO概述这一小节底部的表格,可以浏览完整的InputStream子类的列表。
Java InputStream例子
InputStream用于读取基于字节的数据,一次读取一个字节,这是一个InputStream的例子:
[code lang="java"] 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(); [/code]
这个例子创建了FileInputStream实例。FileInputStream是InputStream的子类,所以可以把FileInputStream实例赋值给InputStream变量。
注意:为了清晰,代码忽略了一些必要的异常处理。想了解更多异常处理的信息,请参考Java IO异常处理。
从Java7开始,你可以使用“try-with-resource”结构确保InputStream在结束使用之后关闭,链接指向了一篇关于“try-with-resource”是如何工作的文章,这里只是一个简单的例子:
[code lang="java"] try( InputStream inputstream = new FileInputStream("file.txt") ) { int data = inputstream.read(); while(data != -1){ System.out.print((char) data); data = inputstream.read(); } } [/code]
当执行线程退出try语句块的时候,InputStream变量会被关闭。
read()
read()方法返回从InputStream流内读取到的一个字节内容(译者注:0~255),例子如下:
[code lang="java"] int data = inputstream.read(); [/code]
你可以把返回的int类型转化成char类型:
[code lang="java"] char aChar = (char) data; [/code]
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 b[])
- int read(byte b[], 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[])的例子:
[code lang="java"] 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(); [/code]
在代码中,首先创建了一个字节数组。然后声明一个叫做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概述文章中介绍过了。
原创文章,转载请注明: 转载自并发编程网 – ifeve.com本文链接地址: Java IO: InputStream
InputStream包含了2个从InputStream中读取数据并将数据存储到缓冲数组中的read()方法,他们分别是:
int read(byte[])
int read(byte, int offset, int length)
这两个方法应该是
read(byte[] b)
read(byte[] b, int offset, int length)
原文:read(byte[])方法会尝试读取与给定字节数组容量一样大的字节数,返回值说明了已经读取过的字节数。如果InputStream内可读的数据不足以填满字节数组,那么数组剩余的部分将包含本次读取之前的数据。
原文中的“数组剩余的部分将包含本次读取之前的数据”说的不容易理解,好像是用翻译软件翻出来的。大意应该是“剩余的部分应该保持数组原来的样子”
比如数组是:[1,2,3,4,5]
本次读取的有效数据:[a,b]
那最终应该为:[a,b,3,4,5]
你的翻译更准确,不过更新之后文章样式出现问题了
这个源码很头痛
感觉这一篇翻译的不是很好啊,好多东西原文中有,这个翻译没有