[Google Guava笔记]（八）io

6        com.google.common.io：与 Java I/O相关的工具类和方法。

 

接口：

6.1    ByteArrayDataInput：从内存中读取 byte数组，它的方法都是在父接口中定义的，提供了相同的功能，但是不抛出 IOException，如果某个方法过早的到达数组的尾部，则会抛出 IllegalStateException。

6.2    ByteArrayDataOutput：将数据写到内存中的 byte数组， 它的方法大部分是在父接口中定义的，提供了相同的功能，但是不抛出 IOException。

6.3    ByteProcessor：处理输入 /输出流中的数据的回调接口。 processBytes(byte[] buf, int off, int len)方法用来处理输入流中的一个数据块 (被读入的一行数据 )。

6.4    InputSupplier<T>：提供可读的 byte/字符流的工厂类。 getInput()方法返回一个封装了可读资源的对象，它可能会在同一个资源上被调用多次，返回的是独立的通道，类似于 iterator，在一个通道上移动游标位置不会影响其它通道的游标。

6.5    LineProcessor<T>：和流的 readLines方法一起用的回调类。 processLine(String line)方法对读入的每行数据进行处理。

6.6    OutputSupplier<T>：提供可写的 byte/字符流的工厂类。 getOutput()方法返回一个封装了可写资源的对象，它可能会在同一个资源上被调用多次，返回的是独立的通道，类似于 iterator，在一个通道上移动游标位置不会影响其它通道的游标。

类：

6.7    AppendableWriter：继承自 java.io.Writer，把所有的输出放到内部封装的 target上，如果 target是可刷新或可关闭的， writer的 flush()和 close()会被委托给 target。

write(...)：将数据追加到 target中。

append(...)：将数据追加到 target中。

flush()：如果 target是可刷新的，则刷新 target。

close()：如果 target是可关闭的，则关闭 target。

6.8    ByteStreams：提供了与 byte数组和 I/O stream相关的工具方法。

静态方法：

newInputStreamSupplier(...)：返回 InputSupplier<ByteArrayInputStream>(继承 InputSupplier的匿名内部类 )的实例。

write(byte[] from, OutputSupplier<? Extends OutputStream> to)：将 from写到 to的输出流。

copy(...)：与 write功能类似。

toByteArray(...)：将输入转换为 byte数组并返回。

          newDataInput(...)：返回 ByteArrayDataInput(实现 ByteArrayDataInput的内部类—— ByteArrayDataInputSteam)的实例。

          newDataOutput(...)：返回 ByteArrayDataOutput(实现 ByteArrayDataOutput的内部类—— ByteArrayDataOutputSteam)的实例。

length(InputSupplier<? Extends InputStream> supplier)：返回提供的输入流的长度 (字节数 )。

          equal(InputSupplier<? Extends InputStream> supplier1, InputSupplier<? Extends InputStream> supplier2)：判断 supplier1和 supplier2是否相等。

readFully(InputStream in, byte[] b)：将 in中的数据读到 b中。

readFully(InputStream in, byte[] b, int off, int len)：将 in中从 off开始的 len个字节都到 b中。

skipFully(InputSteam in, long n)：忽略 in的 n个字节。

          readBytes(InputSupplier<? extends InputStream> supplier,ByteProcessor<T> processor )：将 supplier提供的输入流中的数据读入，并用 processor处理，返回处理后的结果。

          getChecksum(InputSupplier<? Extends InputStream>supplier, final Checksum checksum)：获取 supplier提供的流的校验和。

         getDigest(InputSupplier<? Extends InputStream>supplier, final MessageDigest md)：获取 supplier提供的流的摘要（ MessageDigest 类为应用程序提供信息摘要算法的功能，如 MD5 或 SHA 算法）。

         read(InputStream in, byte[] b, int off, int len)：将输入流 in读到 b中，返回读入的字节数。

         slice(final InputSupplier<? Extends InputStream>supplier, final long offset, final long length)：顾名思义，返回 supplier的分片。

join(...)：将多个 suppliers合在一起。

 

6.9 Closeables：提供了与 Closeable对象相关的工具方法。

静态方法：

          close(Closeable closeable, boolean swallowIOException)：尝试关闭 closeable，关闭失败的情况下，如果 swallowIOException为 true，不抛出异常，只在日志里记录关闭失败信息，如果 swallowIOException为 false，则抛出异常。

closeQuietly(Closeable closeable)：关闭 closeable，不抛出异常。

6.10 CountingInputStream：继承了 FilterInputStream类，提供了为读入的字节计数的功能。 封装了计数器 count和标记 mark。

    FilterInputStream 包含其他一些输入流，它将这些流用作其基本数据源，它可以直接传输数据或提供一些额外的功能。 FilterInputStream 类本身只是简单地重写那些将所有请求传递给所包含输入流的 InputStream 的所有方法。 FilterInputStream 的子类可进一步重写这些方法中的一些方法，并且还可以提供一些额外的方法和字段。

成员方法：

getCount()：返回 count。

read()：读入数据，如果读入成功， count自增，并返回读入的字节数。

read(byte[] b, int off, int len)：读入数据，如果读入成功，将读入的字节数加到 count中，并返回读入的字节数。

skip(long n)：跳过输入流中的 n个字节，将读入的字节数加到 count中，并返回读入的字节数。

mark(int readlimit)：在此输入流中标记当前的位置，将 mark标记为 count。

reset()：如果输入流支持标记，且已标记过，则将当前位置重置为 mark， count重置为 mark。

6.11  CountingOutputStream：继承了 FilterOutputStream类，提供了为写出的字节计数的功能。封装了计数器 count。只重载了 write(...)方法，提供了 getCount()方法。

6.12  FileBackedOutputStream：一般的输出流将数据缓存到一个 byte数组里，而这个类定义的输出流中，一旦数据量达到一定数量就将数据缓存到文件中。

6.13  Files：提供了与 File相关的工具方法。大部分方法都可以顾名思义，挑几个我根据名字看不懂的记一下。

静态方法：

touch(File file)：创建一个空文件，如果文件已经存在，则将最后修改时间改为当前时间。

map(...)：将文件映射到内存，返回 MappedByteBuffer。

          MappedByteBuffer是直接字节缓冲区，其内容是文件的内存映射区域。 映射的字节缓冲区是通过 FileChannel.map 方法创建的。此类用特定于内存映射文件区域的操作扩展 ByteBuffer 类。 映射的字节缓冲区和它所表示的文件映射关系在该缓冲区本身成为垃圾回收缓冲区之前一直保持有效。 映射的字节缓冲区的内容可以随时更改，例如，在此程序或另一个程序更改了对应的映射文件区域的内容的情况下。这些更改是否发生（以及何时发生）与操作系统无关，因此是未指定的。

6.14 Flushables：提供了与 Flushable相关的实用方法。

静态方法：

flush(Flushable flushable, boolean swallowIOException)：刷新流，可选择是否抛出异常。

flushQuietly(Flushable flushable)：与上面的方法类似，但不抛出异常。

6.15  LimitInputStream：继承了 FilterInputStream，这个类可限定读入的字节数。

6.16  LineBuffer：抽象类

6.17  LineReader：

6.18  LittleEndianDataInputStream：继承 FilterInputStream，实现了 DataInput接口，这个类用 little-endian byte ordering读 short、 int、 float、 double、 long型的数据。

以下内容引自 : http://www.cppblog.com/erran/archive/2007/10/13/34115.html。

         内存中一个 WORD值中的内容如下：
low byte high byte 
0x12      0x34 

那么这个 WORD中的值是 0x1234呢，还是 0x3412 ? 
熟悉 x86汇编的人立刻就知道这个值应为 0x3412，很对，但在一些情况下，比如说你在 SGI的机器上看到这种情况，则正好相反， 0x1234才是正确答 案，这与 CPU内部处理数据的方式有关。这两种处理方式都存在于不同厂商生产的 CPU之中，在上例中若此 WORD值为 0x3412的，我们称之为 little-endian, 若为 0x1234的，我们称之为 big-endian，这是两种不同的 byte orders。 MSDN中有比较精确的定 义如下：
Byte Ordering Byte ordering Meaning 
big-endian The most significant byte is on the left end of a word. 
little-endian The most significant byte is on the right end of a word. 

 

6.19  LittleEndianDataOutputStream：继承 FilterOutputStream，实现了 DataOutput接口，这个类用 little-endian byte ordering写 short、 int、 float、 double、 long型的数据。

6.20  MultiInputStream：继承 InputStream，内部封装了 InputSupplier列表的迭代器，一次只能打开一个流。

6.21  MultiReader：继承 Reader，与上面的方法类似。

6.22  NullOutputStream：继承 OutputStream，重载了 write方法，该方法不做任何事，意味着丢弃了被输出的字节。

6.23  PatternFilenameFilter：实现了 FilenameFilter接口，封装了一个 pattern，只接受文件名符合 pattern的文件。

6.24  Resources：提供了一组静态的实用方法，通过这些方法可以使用类路径下的资源。需要注意的是，虽然这些方法的参数中有 URL，但它与 HTTP或其它的类路径下的资源没有联系。使用范例（来自http://ajoo.iteye.com/blog/738286，非常感谢 ajoo！为什么我今天才看到他的blog呢？真是out啊...）：

URL url = Resources.getResource("mypackage/myfile.txt");  

得到了这个 URL, 就可以从里面读出内容 . 如果它是一个文本文件 , 可以用 Resources.toString():

String content = Resources.toString(url);  

 

          最近被问到为什么 Resources不能用于获取本地类加载器之外的资源，我看到上面的例子后，觉得可能是因为一般先通过 getResource()方法获取 URL，然后再把 URL作为参数调用 Resource的其他方法，而 getResource()方法是通过 Resources.class.getClassLoader()这个类加载器来获取资源的，所以这个资源必须由加载 Resources类的类加载器来加载。

       虽然这个类的注释里说URL和HTTP没有关系，但究竟可不可以获取HTTP的资源呢，做了以下尝试：

String content = Resources.toString(new URL(“http://www.iteye.com/ ”));

          结果发现其实是可以获取 网络资源的（只是 ITeye不允许用爬虫进行网页抓取，上面这样的访问被拒绝了，哈哈！），因为这个类的以URL为参数的那几个静态方法其实直接用的是URL的openStream()方法，和类加载器没有太大关系，类加载器只是在getResource()方法里涉及。

 

以上。