Java.io.SequenceInputStream类介绍

Java.io.SequenceInputStream类是一个输入流，它把两个或者多个输入流串起来，使它们看起来像一个单独的输入流。SequenceInputStream 会按照它们被传入的顺序依次读取这些输入流，并将它们的内容组合到一个整体的输入流中。该类实现了InputStream接口。

构造方法

SequenceInputStream(InputStream s1, InputStream s2)

该构造方法通过将s1和s2流连接起来创建一个SequenceInputStream对象。

InputStream s1 = new FileInputStream("file1.txt");
InputStream s2 = new FileInputStream("file2.txt");
SequenceInputStream sis = new SequenceInputStream(s1, s2);

SequenceInputStream(Enumeration<? extends InputStream> e)

该构造方法通过一个流集合创建一个SequenceInputStream对象。

InputStream s1 = new FileInputStream("file1.txt");
InputStream s2 = new FileInputStream("file2.txt");
InputStream s3 = new FileInputStream("file3.txt");
Vector<InputStream> v = new Vector<InputStream>();
v.add(s1);
v.add(s2);
v.add(s3);
Enumeration<InputStream> e = v.elements();
SequenceInputStream sis = new SequenceInputStream(e);

方法

int available()

返回可以从输入流中读取的字节数。

int av = sis.available();

void close()

关闭输入流并释放与之关联的系统资源。

sis.close();

void mark(int readlimit)

在当前位置设置标记，以便在后续调用reset()方法时能够更改到该位置。

sis.mark(0);

boolean markSupported()

判断此输入流是否支持mark()方法。

boolean b = sis.markSupported();

int read()

从输入流中读取一个字节。

int b = sis.read();

int read(byte[] b, int off, int len)

从输入流中读取len个字节，并将它们存储在缓冲区b中，从偏移量off处开始存储。

byte[] b = new byte[1024];
int length = sis.read(b, 0, 1024);

void reset()

将该流的位置设置为最近的mark()方法调用之后的位置。

sis.reset();

long skip(long n)

从输入流中跳过n个字节，并返回实际跳过的字节数。

long skipped = sis.skip(10);

示例

以下代码示例将两个文件(file1.txt和file2.txt)的内容合并到一个文件(output.txt)里。

try {
  InputStream s1 = new FileInputStream("file1.txt");
  InputStream s2 = new FileInputStream("file2.txt");
  OutputStream out = new FileOutputStream("output.txt");
  SequenceInputStream sis = new SequenceInputStream(s1, s2);
  byte[] b = new byte[1024];
  int length = 0;
  while ((length = sis.read(b, 0, 1024)) != -1) {
    out.write(b, 0, length);
  }
  sis.close();
  out.flush();
  out.close();
} catch (IOException e) {
  e.printStackTrace();
}

总结

Java.io.SequenceInputStream类是一个将两个或者多个输入流串起来的输入流，可以用来将多个流的数据合并为一个输入流，以供后续操作。它的构造函数可以接收InputSteam类型的参数，也可以接收Enumeration<? extends InputStream>类型的参数。除了常规的IO方法之外，SequenceInputStream类还提供了mark()和reset()方法，支持流的标记和重置。