com.google.cloud.hadoop.gcsio.testing

Class InMemoryObjectEntry

java.lang.Object

com.google.cloud.hadoop.gcsio.testing.InMemoryObjectEntry

public class InMemoryObjectEntry
extends java.lang.Object

InMemoryObjectEntry represents a GCS StorageObject in-memory by maintaining byte[] contents alongside channels and metadata allowing interaction with the data in a similar way to the equivalent GCS API calls. Intended to be used only internally by the InMemoryGoogleCloudStorage class.

Constructor Summary

Constructors

Constructor and Description
InMemoryObjectEntry(java.lang.String bucketName, java.lang.String objectName, long createTimeMillis, java.lang.String contentType, java.util.Map<java.lang.String,byte[]> metadata)

Method Summary

Modifier and Type	Method and Description
java.lang.String	getBucketName() Returns the bucketName initially provided at construction-time of this InMemoryObjectEntry; it will never change over the lifetime of this InMemoryObjectEntry.
GoogleCloudStorageItemInfo	getInfo() Gets the GoogleCloudStorageItemInfo associated with this InMemoryObjectEntry, whose 'size' is only updated when the initial writer has finished closing the channel.
java.lang.String	getObjectName() Returns the objectName initially provided at construction-time of this InMemoryObjectEntry; it will never change over the lifetime of this InMemoryObjectEntry.
java.nio.channels.SeekableByteChannel	getReadChannel() Returns a SeekableByteChannel pointing at this InMemoryObjectEntry's byte contents; a previous writer must have already closed the associated WritableByteChannel to commit the byte contents and make them available for reading.
java.nio.channels.SeekableByteChannel	getReadChannel(GoogleCloudStorageReadOptions readOptions) Returns a SeekableByteChannel pointing at this InMemoryObjectEntry's byte contents; a previous writer must have already closed the associated WritableByteChannel to commit the byte contents and make them available for reading.
InMemoryObjectEntry	getShallowCopy(java.lang.String bucketName, java.lang.String objectName) Returns a copy of this InMemoryObjectEntry which shares the underlying completedContents data; it is illegal to call this method if the write channel has not yet been closed.
java.nio.channels.WritableByteChannel	getWriteChannel() Returns a WritableByteChannel for this InMemoryObjectEntry's byte contents; the same channel is returned on each call, and it is illegal to call this method if the channel has ever been closed already.
void	patchMetadata(java.util.Map<java.lang.String,byte[]> newMetadata) Updates the metadata associated with this InMemoryObjectEntry.

Methods inherited from class java.lang.Object

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

Constructor Detail

InMemoryObjectEntry

public InMemoryObjectEntry(java.lang.String bucketName,
                           java.lang.String objectName,
                           long createTimeMillis,
                           java.lang.String contentType,
                           java.util.Map<java.lang.String,byte[]> metadata)

Method Detail

getObjectName

public java.lang.String getObjectName()

Returns the objectName initially provided at construction-time of this InMemoryObjectEntry; it will never change over the lifetime of this InMemoryObjectEntry.

getBucketName

public java.lang.String getBucketName()

Returns the bucketName initially provided at construction-time of this InMemoryObjectEntry; it will never change over the lifetime of this InMemoryObjectEntry.

getShallowCopy

public InMemoryObjectEntry getShallowCopy(java.lang.String bucketName,
                                          java.lang.String objectName)
                                   throws java.io.IOException

Returns a copy of this InMemoryObjectEntry which shares the underlying completedContents data; it is illegal to call this method if the write channel has not yet been closed.

Throws:

java.io.IOException

getWriteChannel

public java.nio.channels.WritableByteChannel getWriteChannel()
                                                      throws java.io.IOException

Returns a WritableByteChannel for this InMemoryObjectEntry's byte contents; the same channel is returned on each call, and it is illegal to call this method if the channel has ever been closed already.

Throws:

java.io.IOException

getReadChannel

public java.nio.channels.SeekableByteChannel getReadChannel()
                                                     throws java.io.IOException

Returns a SeekableByteChannel pointing at this InMemoryObjectEntry's byte contents; a previous writer must have already closed the associated WritableByteChannel to commit the byte contents and make them available for reading.

Throws:

java.io.IOException

getReadChannel

public java.nio.channels.SeekableByteChannel getReadChannel(GoogleCloudStorageReadOptions readOptions)
                                                     throws java.io.IOException

Returns a SeekableByteChannel pointing at this InMemoryObjectEntry's byte contents; a previous writer must have already closed the associated WritableByteChannel to commit the byte contents and make them available for reading.

Throws:

java.io.IOException

getInfo

public GoogleCloudStorageItemInfo getInfo()

Gets the GoogleCloudStorageItemInfo associated with this InMemoryObjectEntry, whose 'size' is only updated when the initial writer has finished closing the channel.

patchMetadata

public void patchMetadata(java.util.Map<java.lang.String,byte[]> newMetadata)
                   throws java.io.IOException

Updates the metadata associated with this InMemoryObjectEntry. Any key in newMetadata which has a corresponding null value will be removed from the object's metadata. All other values will be added.

Throws:

java.io.IOException