com.qcloud.cos.model

类 ObjectListing

java.lang.Object

com.qcloud.cos.model.ObjectListing

所有已实现的接口:

Serializable

public class ObjectListing
extends Object
implements Serializable

Contains the results of listing the objects in an Qcloud COS bucket. This includes a list of COSObjectSummary objects describing the objects stored in the bucket, a list of common prefixes if a delimiter was specified in the request, information describing if this is a complete or partial listing, and the original request parameters.

另请参阅:

COS#listObjects(String, String), COS#listObjects(ListObjectsRequest), COS#listNextBatchOfObjects(ObjectListing), 序列化表格

构造器概要

构造器

构造器和说明
ObjectListing()

方法概要

方法

限定符和类型	方法和说明
String	getBucketName() Gets the name of the Qcloud COS bucket containing the objects listed in this ObjectListing.
List<String>	getCommonPrefixes() Gets the common prefixes included in this object listing.
String	getDelimiter() Gets the delimiter parameter originally used to request this object listing, or null if no delimiter specified.
String	getEncodingType() Gets the encoding type used by Qcloud COS to encode object key names in the XML response.
String	getMarker() Gets the marker parameter originally used to request this object listing, or null if no marker was specified.
int	getMaxKeys() Gets the maxKeys parameter originally used to request this object listing, or the default maxKeys value provided by Qcloud COS if the requester didn't specify a value.
String	getNextMarker() Gets the marker to use in the next listObjects request in order to see the next page of results.
List<COSObjectSummary>	getObjectSummaries() Gets the list of object summaries describing the objects stored in the COS bucket.
String	getPrefix() Gets the prefix parameter originally used to request this object listing, or null if no prefix was specified.
boolean	isTruncated() Gets whether or not this object listing is complete.
void	setBucketName(String bucketName) For internal use only.
void	setCommonPrefixes(List<String> commonPrefixes) For internal use only.
void	setDelimiter(String delimiter) For internal use only.
void	setEncodingType(String encodingType) For internal use only.
void	setMarker(String marker) For internal use only.
void	setMaxKeys(int maxKeys) For internal use only.
void	setNextMarker(String nextMarker) For internal use only.
void	setPrefix(String prefix) For internal use only.
void	setTruncated(boolean isTruncated) For internal use only.

从类继承的方法 java.lang.Object

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

构造器详细资料

ObjectListing

public ObjectListing()

方法详细资料

getObjectSummaries

public List<COSObjectSummary> getObjectSummaries()

Gets the list of object summaries describing the objects stored in the COS bucket. Listings for large buckets can be truncated for performance reasons. Always check the isTruncated() method to see if the returned listing is complete or if additional calls are needed to get more results. Callers might need to make additional calls to COS#listNextBatchOfObjects(ObjectListing) to get additional results.

返回:

A list of the object summaries describing the objects stored in the COS bucket.

getCommonPrefixes

public List<String> getCommonPrefixes()

Gets the common prefixes included in this object listing. Common prefixes are only present if a delimiter was specified in the original request.

Each common prefix represents a set of keys in the COS bucket that have been condensed and omitted from the object summary results. This allows applications to organize and browse their keys hierarchically, similar to how a file system organizes files into directories.

For example, consider a bucket that contains the following keys:

• "foo/bar/baz"
• "foo/bar/bash"
• "foo/bar/bang"
• "foo/boo"

If calling listObjects with the prefix="foo/" and the delimiter="/" on this bucket, the returned COSObjectListing will contain one entry in the common prefixes list ("foo/bar/") and none of the keys beginning with that common prefix will be included in the object summaries list.

返回:

The list of common prefixes included in this object listing, which might be an empty list if no common prefixes were found.

setCommonPrefixes

public void setCommonPrefixes(List<String> commonPrefixes)

For internal use only. Sets the common prefixes for this object listing, representing the key prefixes that were rolled up because of the request's delimiter parameter.

参数:

commonPrefixes - The common prefixes for this object listing.

getNextMarker

public String getNextMarker()

Gets the marker to use in the next listObjects request in order to see the next page of results. If an object listing is not truncated, this method will return null. For truncated requests, this value is equal to the greatest lexicographical value of the object keys and common prefixes included in this listing.

返回:

The marker to use in the next listObjects request in order to see the next page of results if this object listing is truncated. Returns null if this object listing isn't truncated.

setNextMarker

public void setNextMarker(String nextMarker)

For internal use only. Sets the marker to use in the next list objects request in order to see the next page of results for a truncated object listing.

参数:

nextMarker - The marker to use in the next listObjects request in order to see the next page of results for a truncated object listing.

getBucketName

public String getBucketName()

Gets the name of the Qcloud COS bucket containing the objects listed in this ObjectListing.

返回:

The name of the Qcloud COS bucket containing the objects listed in this ObjectListing.

setBucketName

public void setBucketName(String bucketName)

For internal use only. Sets the name of the Qcloud COS bucket containing the objects listed in this COSObjectListing.

参数:

bucketName - The name of the Qcloud COS bucket containing the objects listed in this COSObjectListing.

getPrefix

public String getPrefix()

Gets the prefix parameter originally used to request this object listing, or null if no prefix was specified. All objects and common prefixes included in this object listing start with the specified prefix.

返回:

The prefix parameter originally used to request this object listing. Returns null if no prefix was specified.

setPrefix

public void setPrefix(String prefix)

For internal use only. Sets the prefix parameter originally used to request this object listing.

参数:

prefix - The prefix parameter originally used to request this object listing.

getMarker

public String getMarker()

Gets the marker parameter originally used to request this object listing, or null if no marker was specified. If specified, all objects and common prefixes included in this object listing will occur alphabetically after the specified marker.

返回:

The marker parameter originally used to request this object listing. Returns null if no marker was specified.

setMarker

public void setMarker(String marker)

For internal use only. Sets the marker parameter originally used to request this object listing.

参数:

marker - The marker parameter originally used to request this object listing.

getMaxKeys

public int getMaxKeys()

Gets the maxKeys parameter originally used to request this object listing, or the default maxKeys value provided by Qcloud COS if the requester didn't specify a value. The maxKeys parameter limits the combined number of objects and common prefixes included in this object listing. An object listing will never contain more objects plus common prefixes than indicated by the maxKeys, but can of course contain less.

返回:

The maxKeys parameter originally used to request this object listing. Returns the default maxKeys value applied by Qcloud COS if no value was specified.

setMaxKeys

public void setMaxKeys(int maxKeys)

For internal use only. Sets the maxKeys parameter originally used to request this object listing, or the default maxKeys applied by Qcloud COS if the requester didn't specify a value.

参数:

maxKeys - The maxKeys parameter originally used to request this object listing, or the default maxKeys value applied by Qcloud COS if the requester didn't specify a value.

getDelimiter

public String getDelimiter()

Gets the delimiter parameter originally used to request this object listing, or null if no delimiter specified.

The delimiter value allows callers to condense COS keys into common prefix listings. For example, if a caller specifies a delimiter of "/" (a common used value for delimiter), any keys that contain a common prefix between the start of the key and the first occurrence of "/" will not be included in the list of object summaries. Instead, the common prefixes list will have one entry for the common prefix.

返回:

The delimiter parameter originally used to request this object listing. Returns null if no delimiter was specified.

setDelimiter

public void setDelimiter(String delimiter)

For internal use only. Sets the delimiter parameter originally used to request this object listing.

参数:

delimiter - The delimiter parameter originally used to request this object listing.

isTruncated

public boolean isTruncated()

Gets whether or not this object listing is complete.

返回:

The value true if the object listing is not complete. Returns the value false if otherwise. When returning true, additional calls to Qcloud COS may be needed in order to obtain more results.

setTruncated

public void setTruncated(boolean isTruncated)

For internal use only. Sets the truncated property for this object listing, indicating if this is a complete listing or not and whether the caller needs to make additional calls to COS to get more object summaries.

参数:

isTruncated - The value true if the object listing is not complete. The value false if otherwise.

getEncodingType

public String getEncodingType()

Gets the encoding type used by Qcloud COS to encode object key names in the XML response. If you specify encodingType request parameter, Qcloud COS includes this element in the response, and returns encoded key name values in the following response elements: Delimiter, Marker, Prefix, NextMarker, Key.

返回:

Null if encodingType is not specified in the request parameter.

setEncodingType

public void setEncodingType(String encodingType)

For internal use only. Sets the encoding type used by Qcloud COS to encode object key names in the XML response.

参数:

encodingType - Null if encodingType is not specified in the request parameter.