Class S3VersionSummary

    • Field Summary

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

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      String getBucketName()
      Gets the name of the Amazon S3 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 Amazon S3.
      String getKey()
      Gets the key under which this version is stored in Amazon S3.
      Date getLastModified()
      Gets the date according to Amazon S3 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 Amazon S3 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 Amazon S3 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 Amazon S3.
      void setIsDeleteMarker​(boolean isDeleteMarker)
      Intended for internal use only in the Amazon S3 client code.
      void setIsLatest​(boolean isLatest)
      For internal use only.
      void setKey​(String key)
      Sets the key under which this version is stored in Amazon S3.
      void setLastModified​(Date lastModified)
      Sets the date according to Amazon S3 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 Amazon S3 for this version.
      void setVersionId​(String id)
      Sets the version ID which uniquely identifies this version of an object.
    • Field Detail

      • bucketName

        protected String bucketName
        The name of the bucket in which this version is stored
    • Constructor Detail

      • S3VersionSummary

        public S3VersionSummary()
    • Method Detail

      • getBucketName

        public String getBucketName()
        Gets the name of the Amazon S3 bucket in which this version is stored.
        Returns:
        The name of the Amazon S3 bucket in which this version is stored.
        See Also:
        setBucketName(String)
      • setBucketName

        public void setBucketName​(String bucketName)
        Sets the name of the Amazon S3 bucket in which this version is stored.
        Parameters:
        bucketName - The name of the Amazon S3 bucket in which this version is stored.
        See Also:
        getBucketName()
      • getKey

        public String getKey()
        Gets the key under which this version is stored in Amazon S3.
        Returns:
        The key under which this version is stored in Amazon S3.
        See Also:
        setKey(String)
      • setKey

        public void setKey​(String key)
        Sets the key under which this version is stored in Amazon S3.
        Parameters:
        key - The key under which this version is stored in Amazon S3.
        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 S3.
      • getLastModified

        public Date getLastModified()
        Gets the date according to Amazon S3 at which this version was last modified.
        Returns:
        The date according to Amazon S3 at which this version was last modified.
        See Also:
        setLastModified(Date)
      • setLastModified

        public void setLastModified​(Date lastModified)
        Sets the date according to Amazon S3 at which this version was last modified.
        Parameters:
        lastModified - The date according to Amazon S3 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 Amazon S3 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 Amazon S3.

        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 Amazon S3 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 Amazon S3.
        Returns:
        The hex encoded 128-bit MD5 hash of this version's contents as computed by Amazon S3.
        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 Amazon S3.
        Parameters:
        eTag - The hex encoded 128-bit MD5 hash of this version's contents as computed by Amazon S3.
        See Also:
        getETag()
      • getStorageClass

        public String getStorageClass()
        Gets the storage class used by Amazon S3 for this version.
        Returns:
        The storage class used by Amazon S3 for this version.
        See Also:
        setStorageClass(String)
      • setStorageClass

        public void setStorageClass​(String storageClass)
        Sets the storage class used by Amazon S3 for this version.
        Parameters:
        storageClass - The storage class used by Amazon S3 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()