com.aliyun.openservices.oss.model
类 ObjectMetadata

java.lang.Object
  com.aliyun.openservices.oss.model.ObjectMetadata

public class ObjectMetadata
extends Object

OSS中Object的元数据。 包含了用户自定义的元数据，也包含了OSS发送的标准HTTP头(如Content-Length, ETag等）。

构造方法摘要

ObjectMetadata()

方法摘要

void	addUserMetadata(String key, String value) 添加一个用户自定义的元数据。
String	getCacheControl() 获取Cache-Control请求头，表示用户指定的HTTP请求/回复链的缓存行为。
String	getContentDisposition() 获取Content-Disposition请求头，表示MIME用户代理如何显示附加的文件。
String	getContentEncoding() 获取Content-Encoding请求头，表示Object内容的编码方式。
long	getContentLength() 获取Content-Length请求头，表示Object内容的大小。
String	getContentType() 获取Content-Type请求头，表示Object内容的类型，为标准的MIME类型。
String	getETag() 获取一个值表示与Object相关的hex编码的128位MD5摘要。
Date	getExpirationTime() 获取Expires请求头。
Date	getLastModified() 获取Last-Modified请求头的值，表示Object最后一次修改的时间。
Map<String,Object>	getRawMetadata() 返回内部保存的请求头的元数据（内部使用）。
Map<String,String>	getUserMetadata() 获取用户自定义的元数据。
void	setCacheControl(String cacheControl) 设置Cache-Control请求头，表示用户指定的HTTP请求/回复链的缓存行为。
void	setContentDisposition(String disposition) 设置Content-Disposition请求头，表示MIME用户代理如何显示附加的文件。
void	setContentEncoding(String encoding) 设置Content-Encoding请求头，表示Object内容的编码方式。
void	setContentLength(long contentLength) 设置Content-Length请求头，表示Object内容的大小。
void	setContentType(String contentType) 获取Content-Type请求头，表示Object内容的类型，为标准的MIME类型。
void	setExpirationTime(Date expirationTime) 设置Expires请求头。
void	setHeader(String key, Object value) 设置请求头（内部使用）。
void	setLastModified(Date lastModified) 设置Last-Modified请求头的值，表示Object最后一次修改的时间（内部使用）。
void	setUserMetadata(Map<String,String> userMetadata) 设置用户自定义的元数据，表示以x-oss-meta-为前缀的请求头。

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

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

构造方法详细信息

ObjectMetadata

public ObjectMetadata()

方法详细信息

getUserMetadata

public Map<String,String> getUserMetadata()

获取用户自定义的元数据。

OSS内部保存用户自定义的元数据时，会以x-oss-meta-为请求头的前缀。 但用户通过该接口处理用户自定义元数据里，不需要加上前缀“x-oss-meta-”。 同时，元数据字典的键名是不区分大小写的，并且在从服务器端返回时会全部以小写形式返回， 即使在设置时给定了大写字母。比如键名为：MyUserMeta，通过getObjectMetadata接口 返回时键名会变为：myusermeta。

返回：

用户自定义的元数据。

setUserMetadata

public void setUserMetadata(Map<String,String> userMetadata)

设置用户自定义的元数据，表示以x-oss-meta-为前缀的请求头。

参数：

userMetadata - 用户自定义的元数据。

setHeader

public void setHeader(String key,
                      Object value)

设置请求头（内部使用）。

参数：

key - 请求头的Key。

value - 请求头的Value。

addUserMetadata

public void addUserMetadata(String key,
                            String value)

添加一个用户自定义的元数据。

参数：

key - 请求头的Key。 这个Key不需要包含OSS要求的前缀，即不需要加入“x-oss-meta-”。

value - 请求头的Value。

getLastModified

public Date getLastModified()

获取Last-Modified请求头的值，表示Object最后一次修改的时间。

返回：

Object最后一次修改的时间。

setLastModified

public void setLastModified(Date lastModified)

设置Last-Modified请求头的值，表示Object最后一次修改的时间（内部使用）。

参数：

lastModified - Object最后一次修改的时间。

getExpirationTime

public Date getExpirationTime()

获取Expires请求头。 如果Object没有定义过期时间，则返回null。

返回：

Expires请求头。

setExpirationTime

public void setExpirationTime(Date expirationTime)

设置Expires请求头。

参数：

expirationTime - 过期时间。

getContentLength

public long getContentLength()

获取Content-Length请求头，表示Object内容的大小。

返回：

Object内容的大小。

setContentLength

public void setContentLength(long contentLength)

设置Content-Length请求头，表示Object内容的大小。 当上传Object到OSS时，请总是指定正确的content length。

参数：

contentLength - Object内容的大小。

抛出：

IllegalArgumentException - Object内容的长度大小大于最大限定值：5G字节。

getContentType

public String getContentType()

获取Content-Type请求头，表示Object内容的类型，为标准的MIME类型。

返回：

Object内容的类型，为标准的MIME类型。

setContentType

public void setContentType(String contentType)

获取Content-Type请求头，表示Object内容的类型，为标准的MIME类型。

参数：

contentType - Object内容的类型，为标准的MIME类型。

getContentEncoding

public String getContentEncoding()

获取Content-Encoding请求头，表示Object内容的编码方式。

返回：

Object内容的编码方式。

setContentEncoding

public void setContentEncoding(String encoding)

设置Content-Encoding请求头，表示Object内容的编码方式。

参数：

encoding - 表示Object内容的编码方式。

getCacheControl

public String getCacheControl()

获取Cache-Control请求头，表示用户指定的HTTP请求/回复链的缓存行为。

返回：

Cache-Control请求头。

setCacheControl

public void setCacheControl(String cacheControl)

设置Cache-Control请求头，表示用户指定的HTTP请求/回复链的缓存行为。

参数：

cacheControl - Cache-Control请求头。

getContentDisposition

public String getContentDisposition()

获取Content-Disposition请求头，表示MIME用户代理如何显示附加的文件。

返回：

Content-Disposition请求头

setContentDisposition

public void setContentDisposition(String disposition)

设置Content-Disposition请求头，表示MIME用户代理如何显示附加的文件。

参数：

disposition - Content-Disposition请求头

getETag

public String getETag()

获取一个值表示与Object相关的hex编码的128位MD5摘要。

返回：

与Object相关的hex编码的128位MD5摘要。

getRawMetadata

public Map<String,Object> getRawMetadata()

返回内部保存的请求头的元数据（内部使用）。

返回：

内部保存的请求头的元数据（内部使用）。