Module 
Package org.xnio.streams

Class ChannelInputStream

  • All Implemented Interfaces:
    java.io.Closeable, java.lang.AutoCloseable
    public class ChannelInputStream
extends java.io.InputStream
    An input stream which reads from a stream source channel. All read operations are directly performed upon the channel, so for optimal performance, a buffering input stream should be used to wrap this class.
    Since:
    1.2

    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      void close()
      long getReadTimeout​(java.util.concurrent.TimeUnit unit)
      Get the read timeout.
      int read()
      int read​(byte[] b)
      int read​(byte[] b, int off, int len)
      void setReadTimeout​(long timeout, java.util.concurrent.TimeUnit unit)
      Set the read timeout.
      long skip​(long n)
      Skip bytes in the stream.

      • Methods inherited from class java.io.InputStream

        available, mark, markSupported, nullInputStream, readAllBytes, readNBytes, readNBytes, reset, transferTo

      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

    • Constructor Detail

      • ChannelInputStream

        public ChannelInputStream​(StreamSourceChannel channel)
        Construct a new instance. The stream will have no read timeout.
        Parameters:
        channel - the channel to wrap

      • ChannelInputStream

        public ChannelInputStream​(StreamSourceChannel channel,
                          long timeout,
                          java.util.concurrent.TimeUnit timeoutUnit)
        Construct a new instance.
        Parameters:
        channel - the channel to wrap
        timeout - the read timeout, or O for none
        timeoutUnit - the time unit for read timeouts

    • Method Detail

      • getReadTimeout

        public long getReadTimeout​(java.util.concurrent.TimeUnit unit)
        Get the read timeout.
        Parameters:
        unit - the time unit
        Returns:
        the timeout in the given unit

      • setReadTimeout

        public void setReadTimeout​(long timeout,
                           java.util.concurrent.TimeUnit unit)
        Set the read timeout. Does not affect read operations in progress.
        Parameters:
        timeout - the read timeout, or 0 for none
        unit - the time unit

      • read

        public int read()
         throws java.io.IOException
        Specified by:
        read in class java.io.InputStream
        Throws:
        java.io.IOException

      • read

        public int read​(byte[] b)
         throws java.io.IOException
        Overrides:
        read in class java.io.InputStream
        Throws:
        java.io.IOException

      • read

        public int read​(byte[] b,
                int off,
                int len)
         throws java.io.IOException
        Overrides:
        read in class java.io.InputStream
        Throws:
        java.io.IOException

      • skip

        public long skip​(long n)
          throws java.io.IOException
        Skip bytes in the stream.
        Overrides:
        skip in class java.io.InputStream
        Parameters:
        n - the number of bytes to skip
        Returns:
        the number of bytes skipped (0 if the end of stream has been reached)
        Throws:
        java.io.IOException - if an I/O error occurs

      • close

        public void close()
           throws java.io.IOException
        Specified by:
        close in interface java.lang.AutoCloseable
        Specified by:
        close in interface java.io.Closeable
        Overrides:
        close in class java.io.InputStream
        Throws:
        java.io.IOException