com.google.cloud.hadoop.gcsio.testing

Class InMemoryObjectEntry

java.lang.Object

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

public class InMemoryObjectEntry
extends 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(String bucketName, String objectName, long createTimeMillis, String contentType, Map<String,byte[]> metadata)

Method Summary

Modifier and Type	Method and Description
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.
String	getObjectName() Returns the objectName initially provided at construction-time of this InMemoryObjectEntry; it will never change over the lifetime of this InMemoryObjectEntry.
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.
InMemoryObjectEntry	getShallowCopy(String bucketName, 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.
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(Map<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(String bucketName,
                           String objectName,
                           long createTimeMillis,
                           String contentType,
                           Map<String,byte[]> metadata)

Method Detail

getObjectName

public 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 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(String bucketName,
                                          String objectName)
                                   throws 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:

IOException

getWriteChannel

public WritableByteChannel getWriteChannel()
                                    throws 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:

IOException

getReadChannel

public SeekableByteChannel getReadChannel()
                                   throws 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:

IOException

getInfo

public GoogleCloudStorageItemInfo getInfo()
                                   throws IOException

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

Throws:

IOException

patchMetadata

public void patchMetadata(Map<String,byte[]> newMetadata)
                   throws 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:

IOException