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

Interface ScatteringByteChannel

    • 方法详细信息

      • read

        long read​(ByteBuffer[] dsts,
                  int offset,
                  int length)
           throws IOException
        从该通道读取一系列字节到给定缓冲区的子序列。

        调用此方法会尝试从此通道读取最多r个字节,其中r是给定缓冲区数组的指定子序列剩余的总字节数,即

         dsts[offset].remaining()
             + dsts[offset+1].remaining()
             + ... + dsts[offset+length-1].remaining()
        此时调用此方法。

        假设读取长度为n的字节序列,其中0 <= n <= r 直到该序列的第一个dsts[offset].remaining()字节被转移到缓冲器dsts[offset] ,直到下一个dsts[offset+1].remaining()字节被转移到缓冲器dsts[offset+1] ,依此类推,直到整个字节序列被转移到给定的缓冲器中。 尽可能多的字节传输到每个缓冲区,因此每个更新缓冲区的最终位置(最后更新的缓冲区除外)保证等于该缓冲区的限制。

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

        参数
        dsts - 要传输字节的缓冲区
        offset - 要传输字节的第一个缓冲区的缓冲区数组内的偏移量; 必须是非负数且不大于dsts.length
        length - 要访问的最大缓冲区数; 必须是非负数且不大于dsts.length - offset
        结果
        如果通道已到达流末尾,则读取的字节数(可能为零)或 -1
        异常
        IndexOutOfBoundsException - 如果 offsetlength参数的前提条件不成立
        NonReadableChannelException - 如果未打开此频道进行阅读
        ClosedChannelException - 如果此频道已关闭
        AsynchronousCloseException - 如果另一个线程在读取操作正在进行时关闭此通道
        ClosedByInterruptException - 如果另一个线程在读操作正在进行时中断当前线程,从而关闭通道并设置当前线程的中断状态
        IOException - 如果发生其他一些I / O错误
      • read

        long read​(ByteBuffer[] dsts)
           throws IOException
        从该通道读取一系列字节到给定的缓冲区。

        调用c.read(dsts)形式的此方法的行为与调用的方式完全相同

         c.read(dsts, 0, dsts.length);
        参数
        dsts - 要传输字节的缓冲区
        结果
        如果通道已到达流末尾,则读取的字节数(可能为零)或 -1
        异常
        NonReadableChannelException - 如果未打开此频道进行阅读
        ClosedChannelException - 如果此渠道已关闭
        AsynchronousCloseException - 如果另一个线程在读取操作正在进行时关闭此通道
        ClosedByInterruptException - 如果另一个线程在读操作正在进行时中断当前线程,从而关闭通道并设置当前线程的中断状态
        IOException - If some other I/O error occurs