2.73.0 (latest) 2.72.0 2.71.0 2.70.0 2.69.0 2.66.0 2.65.0 2.64.1 2.63.1 2.62.2 2.61.0 2.60.3 2.59.0 2.58.2 2.57.0 2.56.0 2.55.0 2.53.1 2.52.0 2.51.0 2.50.0 2.49.1 2.48.0 2.47.0 2.45.0 2.44.1 2.43.0 2.42.0 2.41.0 2.40.0 2.39.0 2.38.1 2.37.0 2.36.1 2.35.0 2.33.0 2.32.0 2.31.0 2.29.0 2.28.0 2.27.0 2.26.0 2.25.0 2.24.1 2.23.0 2.22.1 2.21.1 2.20.1 2.13.0 2.12.0 2.11.0 2.9.4 2.8.27 2.7.1 2.6.1 2.5.11 2.4.0 2.3.5

    public interface ReadChannel extends ReadableByteChannel, Closeable, Restorable<ReadChannel>

A channel for reading data from a Google Cloud object.

Implementations of this class may buffer data internally to reduce remote calls. This
interface implements [Restorable](https://docs.cloud.google.com/java/docs/reference/google-cloud-core/latest/com.google.cloud.Restorable) to allow saving the reader's state to continue reading
afterwards.

## Implements

[ReadableByteChannel](https://docs.oracle.com/javase/8/docs/api/java/nio/channels/ReadableByteChannel.html), [Closeable](https://docs.oracle.com/javase/8/docs/api/java/io/Closeable.html), com.google.cloud.Restorable\<com.google.cloud.ReadChannel\>

## Methods

### capture()

    public abstract RestorableState<ReadChannel> capture()

Captures the read channel state so that it can be saved and restored afterwards.

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-cloud-core/latest/com.google.cloud.RestorableState<https://docs.cloud.google.com/java/docs/reference/google-cloud-core/latest/com.google.cloud.ReadChannel>` | a [RestorableState](https://docs.cloud.google.com/java/docs/reference/google-cloud-core/latest/com.google.cloud.RestorableState) object that contains the read channel state and can restore it afterwards. |

### close()

    public abstract void close()

Overridden to remove IOException.
See Also: java.nio.channels.Channel#close()

### limit()

    public default long limit()

The currently defined limit for this channel. Initial value is Long#MAX_VALUE

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` | the current limit for this channel |

### limit(long limit)

    public default ReadChannel limit(long limit)

Limit the maximum number of bytes to be read from the objects content, counting from the
beginning of the object, which will be available to read from this channel. If the limit is
larger than the actual size of the content this will have no material impact.

If used in conjunction with [#seek(long)](https://docs.cloud.google.com/java/docs/reference/google-cloud-core/latest/com.google.cloud.ReadChannel#com_google_cloud_ReadChannel_seek_long_) the total number of returned bytes from this
channel will be reduced by the number of bytes specified to seek.

The value provided as `limit` will define a [left-closed,
right-open](https://en.wikipedia.org/wiki/Interval_(mathematics)#Classification_of_intervals) interval along with either `0` or any value provided to [#seek(long)](https://docs.cloud.google.com/java/docs/reference/google-cloud-core/latest/com.google.cloud.ReadChannel#com_google_cloud_ReadChannel_seek_long_), i.e. `[`[#seek(long)](https://docs.cloud.google.com/java/docs/reference/google-cloud-core/latest/com.google.cloud.ReadChannel#com_google_cloud_ReadChannel_seek_long_)`, `[#limit(long)](https://docs.cloud.google.com/java/docs/reference/google-cloud-core/latest/com.google.cloud.ReadChannel#com_google_cloud_ReadChannel_limit_long_)`)`.

### An example to help illustrate the relationship

Imagine some data `[A, B, C, D, E, F, G, H, I, J]`, 10 bytes total.

1. `limit(5)` would produce `[A, B, C, D, E]`
2. `seek(8)` would produce `[I, J]`
3. `seek(2)` `limit(5)` would produce `[C, D, E]`
4. `seek(3)` `limit(3)` would produce `[]`

*NOTE:*Implementers are not required to return a new instance from this method, however
they are allowed to. Users of this method should always use the instance returned from this
method.

*Default Implementation:*By default, this method will simply return `this`.

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `limit` | `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` the maximum number of bytes to limit this channel to |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-cloud-core/latest/com.google.cloud.ReadChannel` | The instance of channel which will respect the limit. |

### seek(long position)

    public abstract void seek(long position)

Set the offset to read from.

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `position` | `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` |

| **Exceptions** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/8/docs/api/java/io/IOException.html` |   |

### setChunkSize(int chunkSize)

    public abstract void setChunkSize(int chunkSize)

Sets the minimum size that will be read by a single RPC. Read data will be locally buffered
until consumed.

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `chunkSize` | `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` |