com.qcloud.cos.model

Class COSVersionSummary

java.lang.Object

com.qcloud.cos.model.COSVersionSummary

All Implemented Interfaces:

Serializable

public class COSVersionSummary
extends Object
implements Serializable

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected String	bucketName The name of the bucket in which this version is stored

Constructor Summary

Constructors

Constructor and Description
COSVersionSummary()

Method Summary

Modifier and Type	Method and Description
String	getBucketName() Gets the name of the COS bucket in which this version is stored.
String	getETag() Gets the hex encoded 128-bit MD5 hash of this version's contents as computed by COS.
String	getKey() Gets the key under which this version is stored in COS.
Date	getLastModified() Gets the date according to COS at which this version was last modified.
Owner	getOwner() Gets the owner of this version.
long	getSize() Gets the size of this version in bytes.
String	getStorageClass() Gets the storage class used by COS for this version.
String	getVersionId() Gets the version ID which uniquely identifies this version of an object.
boolean	isDeleteMarker() Returns whether or not this version represents a delete marker.
boolean	isLatest() Returns whether or not this version is the latest version for the associated object.
void	setBucketName(String bucketName) Sets the name of the COS bucket in which this version is stored.
void	setETag(String eTag) Sets the hex encoded 128-bit MD5 hash of this version's contents as computed by COS.
void	setIsDeleteMarker(boolean isDeleteMarker) Intended for internal use only in the COS client code.
void	setIsLatest(boolean isLatest) For internal use only.
void	setKey(String key) Sets the key under which this version is stored in COS.
void	setLastModified(Date lastModified) Sets the date according to COS at which this version was last modified.
void	setOwner(Owner owner) For internal use only.
void	setSize(long size) Sets the size of this version in bytes.
void	setStorageClass(String storageClass) Sets the storage class used by COS for this version.
void	setVersionId(String id) Sets the version ID which uniquely identifies this version of an object.

Methods inherited from class java.lang.Object

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

Field Detail

bucketName

protected String bucketName

The name of the bucket in which this version is stored

Constructor Detail

COSVersionSummary

public COSVersionSummary()

Method Detail

getBucketName

public String getBucketName()

Gets the name of the COS bucket in which this version is stored.

Returns:

The name of the COS bucket in which this version is stored.

See Also:

setBucketName(String)

setBucketName

public void setBucketName(String bucketName)

Sets the name of the COS bucket in which this version is stored.

Parameters:

bucketName - The name of the COS bucket in which this version is stored.

See Also:

getBucketName()

getKey

public String getKey()

Gets the key under which this version is stored in COS.

Returns:

The key under which this version is stored in COS.

See Also:

setKey(String)

setKey

public void setKey(String key)

Sets the key under which this version is stored in COS.

Parameters:

key - The key under which this version is stored in COS.

See Also:

getKey()

getVersionId

public String getVersionId()

Gets the version ID which uniquely identifies this version of an object.

Objects created before versioning was enabled or when versioning is suspended will be given the default/null version ID (see Constants#NULL_VERSION_ID). Note that the Constants#NULL_VERSION_ID is a valid version ID and is not the same as not having a version ID.

Returns:

The version ID which uniquely identifies this version of an object.

See Also:

setVersionId(String)

setVersionId

public void setVersionId(String id)

Sets the version ID which uniquely identifies this version of an object.

Parameters:

id - The version ID which uniquely identifies this version of an object.

See Also:

getVersionId()

isLatest

public boolean isLatest()

Returns whether or not this version is the latest version for the associated object.

Returns:

The value true if this version is the latest version for the associated object; returns the value false if otherwise.

setIsLatest

public void setIsLatest(boolean isLatest)

For internal use only. Sets whether this version is the latest version for the associated object. This method is intended to be used only by the client internals and developers shouldn't need to use it.

Parameters:

isLatest - True if this version represents the latest version for the associated object in COS.

getLastModified

public Date getLastModified()

Gets the date according to COS at which this version was last modified.

Returns:

The date according to COS at which this version was last modified.

See Also:

setLastModified(Date)

setLastModified

public void setLastModified(Date lastModified)

Sets the date according to COS at which this version was last modified.

Parameters:

lastModified - The date according to COS at which this version was last modified.

See Also:

getLastModified()

getOwner

public Owner getOwner()

Gets the owner of this version. Returns null if the requester doesn't have Permission.ReadAcp permission for this version or owns the bucket in which it resides.

Returns:

The owner of this version. Returns null if the requester doesn't have permission to see object ownership for this version.

See Also:

setOwner(Owner)

setOwner

public void setOwner(Owner owner)

For internal use only. Sets the owner of this version. This method is intended to be used only by the client internals and developers shouldn't need to use it.

Parameters:

owner - The owner of this version.

See Also:

getOwner()

isDeleteMarker

public boolean isDeleteMarker()

Returns whether or not this version represents a delete marker.

Delete markers are special types of versions that have no data associated with them. When deleting a versioned object in COS without specifying an explicit version ID, a new delete marker is created as the latest version of that object to mark that the object was deleted. This occurs even though the previous versions still exist in COS.

Delete markers have no data associated with them and therefore have no associated ACL, size or storage class. Only requesters with read access to a bucket can learn of their existence by listing the versions in a bucket.

Returns:

The value true if this version represents a delete marker. Returns the value false if otherwise.

setIsDeleteMarker

public void setIsDeleteMarker(boolean isDeleteMarker)

Intended for internal use only in the COS client code. Sets the value of the isDeleteMarker property to record if this is a delete marker or not.

Parameters:

isDeleteMarker - Specify true if this version summary represents a delete marker, otherwise false if it is a regular version summary.

getETag

public String getETag()

Gets the hex encoded 128-bit MD5 hash of this version's contents as computed by COS.

Returns:

The hex encoded 128-bit MD5 hash of this version's contents as computed by COS.

See Also:

setETag(String)

setETag

public void setETag(String eTag)

Sets the hex encoded 128-bit MD5 hash of this version's contents as computed by COS.

Parameters:

eTag - The hex encoded 128-bit MD5 hash of this version's contents as computed by COS.

See Also:

getETag()

getStorageClass

public String getStorageClass()

Gets the storage class used by COS for this version.

Returns:

The storage class used by COS for this version.

See Also:

setStorageClass(String)

setStorageClass

public void setStorageClass(String storageClass)

Sets the storage class used by COS for this version.

Parameters:

storageClass - The storage class used by COS for this version.

See Also:

getStorageClass()

getSize

public long getSize()

Gets the size of this version in bytes.

Returns:

The size of this version in bytes.

See Also:

setSize(long)

setSize

public void setSize(long size)

Sets the size of this version in bytes.

Parameters:

size - The size of this version in bytes.

See Also:

getSize()