alluxio.underfs.gcs.v2

Class GCSV2InputStream

java.lang.Object

java.io.InputStream

alluxio.underfs.gcs.v2.GCSV2InputStream

All Implemented Interfaces:

Closeable, AutoCloseable

@NotThreadSafe
public final class GCSV2InputStream
extends InputStream

A stream for reading a file from GCS using Google cloud API (GCS input stream version 2). The main purpose is to provide a faster skip method, as the underlying implementation will read and discard bytes until the number to skip has been reached. This input stream returns 0 when calling read with an empty buffer.

Method Summary

Modifier and Type	Method and Description
void	close()
int	read()
int	read(byte[] b)
int	read(byte[] b, int off, int len)
long	skip(long n) This method leverages the ability to open a stream from GCS from a given offset.

Methods inherited from class java.io.InputStream

available, mark, markSupported, reset

Methods inherited from class java.lang.Object

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

Method Detail

close

public void close()
           throws IOException

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Overrides:

close in class InputStream

Throws:

IOException

read

public int read()
         throws IOException

Specified by:

read in class InputStream

Throws:

IOException

read

public int read(byte[] b)
         throws IOException

Overrides:

read in class InputStream

Throws:

IOException

read

public int read(byte[] b,
                int off,
                int len)
         throws IOException

Overrides:

read in class InputStream

Throws:

IOException

skip

public long skip(long n)
          throws IOException

This method leverages the ability to open a stream from GCS from a given offset. When the underlying stream has fewer bytes buffered than the skip request, the stream is closed, and a new stream is opened starting at the requested offset.

Overrides:

skip in class InputStream

Parameters:

n - number of bytes to skip

Returns:

the number of bytes skipped

Throws:

IOException