模块  java.base
软件包  java.nio.channels

Interface WritableByteChannel

    • 方法详细信息

      • write

        int write​(ByteBuffer src)
           throws IOException
        从给定缓冲区向该通道写入一个字节序列。

        尝试向通道写入最多r个字节,其中r是缓冲区中剩余的字节数,即src.remaining() ,此时调用此方法。

        假设写入长度为n的字节序列,其中0 <= n <= r 该字节序列将从索引p开始从缓冲区传输,其中p是调用此方法时缓冲区的位置; 写入的最后一个字节的索引将是p + n - 1 返回时,缓冲区的位置将等于p + n ; 它的限制不会改变。

        除非另有说明,否则只有在写入所有r请求的字节后才会返回写操作。 某些类型的通道(取决于它们的状态)可能只写入一些字节,或者根本不写。 例如,处于非阻塞模式的套接字通道不能再写入套接字输出缓冲区中可用的字节数。

        可以随时调用此方法。 但是,如果另一个线程已经在此通道上启动了写操作,则此方法的调用将阻塞,直到第一个操作完成。

        参数
        src - 要从中检索字节的缓冲区
        结果
        写入的字节数,可能为零
        异常
        NonWritableChannelException - 如果未打开此频道进行写入
        ClosedChannelException - 如果此渠道已关闭
        AsynchronousCloseException - 如果另一个线程在写入操作正在进行时关闭此通道
        ClosedByInterruptException - 如果另一个线程在写操作正在进行时中断当前线程,从而关闭通道并设置当前线程的中断状态
        IOException - 如果发生其他一些I / O错误