OutputStream

1.概要

OutputStream位于java.io，它在Java 实现的IO类库中是一个很基础的抽象类。在层级上，是所有字节输出流类的父类，在功能上，表示接受字节并把它们输出。

 

2.实现类及子类简介

OutputStream有诸多子类：
ByteArrayOutputStream
FileOutputStream
PipedOutputStream
ObjectOutputStream
FilterOutputStream
BufferedOutputStream
DataOutputStream
PrintStream
其中后3个BufferedOutputStream，DataOutputStream，PrintStream继承自FilterOutputStream。这些子类有不同实现，完成向特定介质写入数据。

3.方法

OutputStream有5个方法：

Public abstract void write(int b) throws IOException
Public void write(byteb[])throws IOException
Public void write(byteb[],intoff,intlen) throws IOException
Public void flush()throws IOException
Public void close()throws IOException

 

3个write方法中的write(int b)是基础方法，另外2个write方法都围绕它来实现，并最终会调用到它。该Write(int b)方法被声明为abstract，具体的实现开放给子类。

尽管OutputStream的诸多子类会有各自的write实现，但write(int b)本身这个方法标签表示的是一个处理单字节的方法。它期待一个int入参，是因为java中没有无符号字节类型，所以使用int类型代替，因此4个字节的int其实只会使用低8位，高位的24个bits会被放弃掉。子类可以有灵活的实现，但不应使write(int b)有歧义。

如确实需要一个处理int值的方法时，可以封装一个writeInt方法：

    public final void writeInt(int v) throws IOException {
        out.write((v >>> 24) & 0xFF);
        out.write((v >>> 16) & 0xFF);
        out.write((v >>>  8) & 0xFF);
        out.write((v >>>  0) & 0xFF);
        incCount(4);
    } 

这里使用了独立的方法签名，并在内部调用单字节的write(int b)，经4次把一个真正的int 值输出。

 

也可以在write(int b)内部实现不同的输出方式，如除了单字节输出给介质外，也可将单字节的数据汇集到某个缓冲区，或交给一个特殊处理的方法：

    public void write(int b) throws IOException {
        temp[0] = (byte)b;
        socketWrite(temp, 0, 1);
    }

这里temp[]可以看作内存中的一个缓冲区，一个私有方法socketWrite接管了处理，它可以调用一个native方法完成最终输出，它也可以是别的任何处理。

但最终，write(int b)方法的签名不应有歧义，它是单字节处理的意思--使用int的低8位接受一个字节的数据。

ASCII是一个7位字符集，每个字符都能单个字节描述，可以直接使用write(int b)方法实现。当使用更丰富的字符集，使用别的入口。

【有些第三方类库实现中--相较于java.io放弃掉高24的实现，当写入大于255的值时(超出了8位)，可能会报一个不合法参数错误illegalargumentexception或总是写入255。】

 

 与在网络硬件中缓存一样，流可以在软件中缓冲，即可以用Java代码缓冲。

一般通过bufferedOutputstream或bufferedWriter链到底层流上处理。所以刷新flush很重要，它可以强制缓冲的数据发送出去，即使缓冲区未满。这有时可以打破一种相互等待的死锁:

1.客户端发送了一个请求，总长100字节，发送后就开始等待服务端的响应。
2.但缓冲区有1024字节大小，在接受100字节请求后认为小数据不值得发送，继续等待装载。
3.而此时服务端正等待着客户端的请求，陷入了相互等待的境地。

 

 结束流处理时应释放申请的资源。

OutputStream out=null;
try{
    out = new FileOutputSteam("/temp/data.txt");
    //处理...
}catch(IOException ex){
    System.err.println(ex.getMessage());
}finally{
    if(out!=null){
        try{
            out.close();
        }catch(IOException e){
            // 
        }
    }
}

这种一般称为释放模式，java7中代码可以简洁一些：

try(OutputStream out=new OutputSteam("data.txt")){
    //处理
}catch(IOException ex){
    System.err.println(ex.getMessage());
}