public class ObjectMetadata
extends java.lang.Object
Modifier and Type | Field and Description |
---|---|
static java.lang.String |
AES_256_SERVER_SIDE_ENCRYPTION |
Constructor and Description |
---|
ObjectMetadata() |
Modifier and Type | Method and Description |
---|---|
void |
addUserMetadata(java.lang.String key,
java.lang.String value)
添加一个用户自定义的元数据。
|
java.lang.String |
getCacheControl()
获取Cache-Control请求头,表示用户指定的HTTP请求/回复链的缓存行为。
|
java.lang.String |
getContentDisposition()
获取Content-Disposition请求头,表示MIME用户代理如何显示附加的文件。
|
java.lang.String |
getContentEncoding()
获取Content-Encoding请求头,表示Object内容的编码方式。
|
long |
getContentLength()
获取Content-Length请求头,表示Object内容的大小。
|
java.lang.String |
getContentMD5() |
java.lang.String |
getContentType()
获取Content-Type请求头,表示Object内容的类型,为标准的MIME类型。
|
java.lang.String |
getETag()
获取一个值表示与Object相关的hex编码的128位MD5摘要。
|
java.util.Date |
getExpirationTime()
获取Expires响应头,返回其Rfc822日期表示形式。
如果Object没有定义过期时间,则返回null。
|
java.util.Date |
getLastModified()
获取Last-Modified请求头的值,表示Object最后一次修改的时间。
|
java.lang.String |
getObjectType()
获取Object存储类型,目前支持Normal、Appendable两类。
|
java.lang.String |
getRawExpiresValue()
获取原始的Expires响应头,不对其进行日期格式解析,返回其字符串表示形式。
如果Object没有定义过期时间,则返回null。
|
java.util.Map<java.lang.String,java.lang.Object> |
getRawMetadata()
返回内部保存的请求头的元数据(内部使用)。
|
java.lang.String |
getServerSideEncryption()
获取一个值表示Object的服务器加密的熵编码
|
java.util.Map<java.lang.String,java.lang.String> |
getUserMetadata()
获取用户自定义的元数据。
|
void |
setCacheControl(java.lang.String cacheControl)
设置Cache-Control请求头,表示用户指定的HTTP请求/回复链的缓存行为。
|
void |
setContentDisposition(java.lang.String disposition)
设置Content-Disposition请求头,表示MIME用户代理如何显示附加的文件。
|
void |
setContentEncoding(java.lang.String encoding)
设置Content-Encoding请求头,表示Object内容的编码方式。
|
void |
setContentLength(long contentLength)
设置Content-Length请求头,表示Object内容的大小。
当上传Object到OSS时,请总是指定正确的content length。
|
void |
setContentMD5(java.lang.String contentMD5) |
void |
setContentType(java.lang.String contentType)
获取Content-Type请求头,表示Object内容的类型,为标准的MIME类型。
|
void |
setExpirationTime(java.util.Date expirationTime)
设置Expires请求头。
|
void |
setHeader(java.lang.String key,
java.lang.Object value)
设置请求头(内部使用)。
|
void |
setLastModified(java.util.Date lastModified)
设置Last-Modified请求头的值,表示Object最后一次修改的时间(内部使用)。
|
void |
setServerSideEncryption(java.lang.String serverSideEncryption)
设置Object服务器端熵编码的类型
|
void |
setUserMetadata(java.util.Map<java.lang.String,java.lang.String> userMetadata)
设置用户自定义的元数据,表示以x-oss-meta-为前缀的请求头。
|
public static final java.lang.String AES_256_SERVER_SIDE_ENCRYPTION
public java.util.Map<java.lang.String,java.lang.String> getUserMetadata()
获取用户自定义的元数据。
OSS内部保存用户自定义的元数据时,会以x-oss-meta-为请求头的前缀。 但用户通过该接口处理用户自定义元数据里,不需要加上前缀“x-oss-meta-”。 同时,元数据字典的键名是不区分大小写的,并且在从服务器端返回时会全部以小写形式返回, 即使在设置时给定了大写字母。比如键名为:MyUserMeta,通过getObjectMetadata接口 返回时键名会变为:myusermeta。
public void setUserMetadata(java.util.Map<java.lang.String,java.lang.String> userMetadata)
userMetadata
- 用户自定义的元数据。public void setHeader(java.lang.String key, java.lang.Object value)
key
- 请求头的Key。value
- 请求头的Value。public void addUserMetadata(java.lang.String key, java.lang.String value)
key
- 请求头的Key。
这个Key不需要包含OSS要求的前缀,即不需要加入“x-oss-meta-”。value
- 请求头的Value。public java.util.Date getLastModified()
public void setLastModified(java.util.Date lastModified)
lastModified
- Object最后一次修改的时间。public java.util.Date getExpirationTime() throws java.text.ParseException
java.text.ParseException
- 无法将Expires解析为Rfc822格式,抛出该异常。public java.lang.String getRawExpiresValue()
public void setExpirationTime(java.util.Date expirationTime)
expirationTime
- 过期时间。public long getContentLength()
public void setContentLength(long contentLength)
contentLength
- Object内容的大小。java.lang.IllegalArgumentException
- Object内容的长度大小大于最大限定值:5G字节。public java.lang.String getContentType()
public void setContentType(java.lang.String contentType)
contentType
- Object内容的类型,为标准的MIME类型。public java.lang.String getContentMD5()
public void setContentMD5(java.lang.String contentMD5)
public java.lang.String getContentEncoding()
public void setContentEncoding(java.lang.String encoding)
encoding
- 表示Object内容的编码方式。public java.lang.String getCacheControl()
public void setCacheControl(java.lang.String cacheControl)
cacheControl
- Cache-Control请求头。public java.lang.String getContentDisposition()
public void setContentDisposition(java.lang.String disposition)
disposition
- Content-Disposition请求头public java.lang.String getETag()
public java.lang.String getServerSideEncryption()
public void setServerSideEncryption(java.lang.String serverSideEncryption)
public java.lang.String getObjectType()
public java.util.Map<java.lang.String,java.lang.Object> getRawMetadata()