认知IO流之 — InputStream

简介: InputStream 是一个抽象类,这个抽象类是代表所有字节流输入的父类,应用程序需要定义一个InputStream 的子类,该子类需要提供一个返回下一个输入字节的方法。

InputStream 结构概述

InputStream 是一个抽象类,这个抽象类是代表所有字节流输入的父类,应用程序需要定义一个InputStream 的子类,该子类需要提供一个返回下一个输入字节的方法。

下面是 InputStream 的继承体系:

0.jpg


下面是针对 InputStream 的子类做的图表,从图表中可以对 InputStream 的子类有一个大致的了解

类和功能 构造器参数解释
FileInputStream 用于从文件系统的文件中读取字节。 字符串,表示文件名,文件或 FileDescriptor 对象
FilterInputStream 包含一些其他的输入流,并将其作为基本的数据源,提供数据转换和其他功能 InputStream 类型,包含其任意子类
ObjectInputStream 是将对象的原始数据序列化的输入流 一个可以接收InputStream 类型的构造函数,一个包级私有的无参构造函数
PipedInputStream 管道输入流提供写入管道输出流的任何数据字节,实现管道化的概念 PipedOutputStream管道输出流,也可控制管道容量的大小
SequenceInputStream 将两个或者多个InputStream 转换成单一 InputStream 两个InputStream 对象或一个容纳 InputStream 对象的容器 Enumeration
ByteArrayInputStream 允许内存的缓冲区当作 InputStream 使用 缓冲区,从缓冲区取出字节

InputStream 特性

InputStream 中有一个常量 MAX_SKIP_BUFFER_SIZE,它用来确定最大能够跳过的字节缓冲,主要用于 skip() 方法

privatestaticfinalint MAX_SKIP_BUFFER_SIZE = 2048;

read 方法

作为一个抽象类,InputStream 必须至少有一个抽象方法才可以,这个唯一的抽象方法就是 read()方法

public abstract int read() throws IOException;

read() 方法表示从输入流读取下一个字节的数据,byte字节的值作为 int 返回,其范围在0 - 255 之间。如果到达流的末尾而没有可用的字节的话,则返回 -1, 一般用 -1 来判断字节流是否到了末尾。此方法会被锁住直到有输入数据的时候,这种 IO 流也叫做 BIO阻塞IO,它的效率比较低。子类必须提供此方法的实现。

另外一个同名方法也是 read() 方法,不过这个方法不是抽象方法

public int read(byte b[]) throws IOException {

return read(b, 0, b.length);
}

从输入流中读取一定数量的字节并把它们存储在缓冲数组中。实际读取的字节数以整数形式返回。如果参数 b 的长度是0 ,就不会读取字节并且返回 0;这个方法会尝试读取至少一个字节并存储在b数组中。第一个读取并存储的字节是 b[0],下一个是 b[1],以此类推。读取的字节最多等于 b数组的长度。

这个方法会调用 read(b, 0, b.length) 方法,来看一下此方法的定义

public int read(byte b[], int off, int len) throws IOException {
if (b == null) {
thrownew NullPointerException();
} elseif (off < 0 || len < 0 || len > b.length - off) {
thrownew IndexOutOfBoundsException();
} elseif (len == 0) {
return0;
}
int c = read();
if (c == -1) {
return -1;
}
b[off] = (byte)c;
int i = 1;
try {
for (; i < len ; i++) {
c = read();
if (c == -1) {
break;
}
b[off + i] = (byte)c;
}
} catch (IOException ee) {
}
return i;
}

如果没有可读取的数组,直接抛出空指针异常,如果起始读取位置小于0,或者读取长度小于0,或者需要读取的长度要比实际的长度大,抛出数组越界异常,若读取的长度为0,那么就不会读取任何字节。上面代码调用的 read() 无参数的方法交给子类去实现,如果子类读取到了 -1 ,那么就直接返回 -1。

skip 方法

public long skip(long n) throws IOException {
long remaining = n;
int nr;
if (n <= 0) {
return0;
}
int size = (int)Math.min(MAX_SKIP_BUFFER_SIZE, remaining);
byte[] skipBuffer = newbyte[size];
while (remaining > 0) {
nr = read(skipBuffer, 0, (int)Math.min(size, remaining));
if (nr < 0) {
break;
}
remaining -= nr;
}
return n - remaining;
}

跳过并丢弃此输入流中的字节数据。由于各种原因,skip 方法最终可能会跳过一些较小的字节数,可能是0。这可能是由许多条件中的任何一个引起的;只有一种可能性就是在跳过 n 个字节之前到达末尾。此方法会返回跳过的实际字节数。如果 n 是负数,skip 方法总是返回 0,并且不跳过任何字节。

available 方法

public int available() throws IOException {
return0;
}

返回下一个方法调用能不受阻塞地从此读取(或者跳过)的估计字节数。注意,InputStream 的某些实现将返回流中的总字节数,但是许多实现则不会。

如果输入流通过调用 close() 方法关闭后,此方法的子类实现还会抛出 IOException。InputStream 类的 available 方法总是返回 0 。

close 方法

public void close() throws IOException {}

关闭这个输入流并且释放流分配的系统资源。InputStream 的 close 方法不做任何操作。

mark 方法

public synchronized void mark(int readlimit) {}

用于标记输入流当前的位置。随后对 reset 方法的调用会在最后标记的位置处重新定位此流的位置以便后续重新读取相同的字节。

readlimit 参数会告诉输入流允许在标记位置失效之前读取多个字节。

mark 方法的一般约定是,如果方法 markSupported 返回 true,那么在调用mark方法后,流会以某种方式记录所有读取的字节。当调用reset方法后,能够再次提供同样的字节。但是,在调用reset之前,流不会记录readlimit以外的字节。在已经关闭的流上调用mark方法对流没有影响

InputStream 的 mark 方法不会做任何事情。

reset 方法

public synchronized void reset() throws IOException {
thrownew IOException("mark/reset not supported");
}

将此流重新定位到上次在此输入流上调用 mark 方法的位置。

reset 的一般规定是如果 markSupported 方法返回 true,则

自从流被创建后如果没有调用 mark 方法,或者 mark方法从最后一次调用后从流中读取的字节数量要大于最后一次调用时 mark 的参数的话,可能抛出 IOException。

如果没有抛出 IOException 的话,这时流会重置为一种状态,这时从最近一次调用 mark 以来所读取的所有字节将被提供给 read 方法的后续调用者。

如果 markSupported 返回 false,则这个 reset 调用可能抛出 IOException,如果没有抛出 IOException 的话,则将流重置为固定状态,该状态取决于输入流的特定类型及其创建方式。

markSupported 方法

public boolean markSupported() {
returnfalse;
}

markSupported 方法就是一个判断是否支持 mark 和 reset 方法的标示。返回 true 表示支持,默认是 false。

            </div>
目录
相关文章
|
JavaScript 前端开发
Vue嵌入式页面解决方案
Vue嵌入式页面解决方案
|
11月前
|
数据采集 JSON 测试技术
Grequests,非常 Nice 的 Python 异步 HTTP 请求神器
在Python开发中,处理HTTP请求至关重要。`grequests`库基于`requests`,支持异步请求,通过`gevent`实现并发,提高性能。本文介绍了`grequests`的安装、基本与高级功能,如GET/POST请求、并发控制等,并探讨其在实际项目中的应用。
234 3
|
监控 前端开发 JavaScript
如何处理异步请求中的错误?
【10月更文挑战第29天】通过以上多种方法的综合运用,可以全面地处理异步请求中的各种错误,提高应用程序的稳定性和可靠性,同时为用户提供更好的错误反馈和体验。在实际开发中,应根据具体的项目需求和应用场景,选择合适的错误处理策略和方法,并进行充分的测试和优化。
|
存储 前端开发 Java
Java一分钟之-Java GUI设计原则与模式
本文介绍了Java GUI开发的核心设计原则和模式,包括分层架构(MVC)、组件复用、用户体验和代码示例。强调了MVC模式以提高代码可维护性,组件化设计以增强复用性,以及响应式和简洁界面以提升用户体验。同时,提出了常见问题的避免策略,如布局管理、资源释放和国际化支持,建议开发者遵循这些原则以提升GUI应用质量。
484 3
|
存储 关系型数据库 MySQL
使用Docker快速部署Mysql服务器
本文介绍了如何使用Docker快速部署MySQL服务器,包括下载官方MySQL镜像、启动容器、设置密码、连接MySQL服务器以及注意事项。
1143 18
|
数据可视化 Java 程序员
通过文字图像——代码图形注释自动生成
大家在学(CTRL)习(C)别人代码的时候,看到别人的代码程序,在日志中有很多很酷的代码注释,或者是有一些图形化注释方便理解。之前本人以为都是一个个手敲出来的。然后在网上一番搜索,找到了很多神奇的好网站,以用于图形注释生成。 代码图形注释自动生成技术是一种将代码逻辑和结构可视化的创新工具。它通过解析编程代码,并将代码的功能、结构和逻辑关系转换成直观的图形注释,从而使得程序员能够更加轻松地理解和分析代码。这种技术特别适合于复杂代码的解读,帮助开发人员快速定位代码中的关键部分和潜在问题。此外,对于团队合作和代码教育来说,图形注释可以作为沟通和学习的桥梁,让代码的理解变得更加直观和高效。总的来说,
357 0
|
缓存 网络协议 分布式数据库
超级好用的C++实用库之DNS解析
超级好用的C++实用库之DNS解析
279 0
|
存储 网络协议 物联网
网络中的“客户端”和“服务器
【8月更文挑战第24天】
1367 0
|
设计模式 算法 编译器
【CMake中的链接权限详解 】深入理解CMake中PRIVATE、PUBLIC与INTERFACE的链接
【CMake中的链接权限详解 】深入理解CMake中PRIVATE、PUBLIC与INTERFACE的链接
454 0
软件设计原则-接口隔离原则讲解以及代码示例
接口隔离原则(Interface Segregation Principle,ISP)是面向对象设计中的一个原则,提倡使用多个专门的接口,而不使用单一的大接口。它最早由Robert C. Martin在其《敏捷软件开发:原则、模式与实践》一书中提出。 接口隔离原则的核心思想是:客户端不应该依赖于它不需要的接口。也就是说,一个类或模块不应该强迫它的用户去依赖无用的接口。相反,应该将大接口拆分成多个小接口,符合客户端的需求,使客户端只依赖于它真正需要的接口。 接口隔离原则的目标是降低类或模块之间的耦合度,提高代码的可维护性、可扩展性和可测试性。通过使用多个专门的接口,我们可以避免类或模块之间出现不
315 0