Interface ReadChannel (2.7.1)

Version 2.7.1

• 2.47.0 (latest)
• 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 to allow saving the reader's state to continue reading afterwards.

Implements

ReadableByteChannel, Closeable, 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
RestorableState<ReadChannel>	a 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
long	the current limit for this channel

limit(long limit)

public default ReadChannel limit(long limit)

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

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	long the maximum number of bytes to limit this channel to

Returns

Type	Description
ReadChannel	The instance of channel which will respect the limit.

seek(long position)

public abstract void seek(long position)

Parameter

Name	Description
position	long

Exceptions

Type	Description
IOException

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	int