com.qiniu.storage

Class UploadManager

java.lang.Object

com.qiniu.storage.UploadManager

public final class UploadManager
extends java.lang.Object

七牛文件上传管理器，通过该类上传文件时，会自动根据定义的Configuration.putThreshold 来判断是采用表单上传还是分片上传的方法，超过了定义的Configuration.putThreshold就会采用 分片上传的方法，可以在构造该类对象的时候，通过Configuration类来自定义这个值。 一般默认可以使用这个类的方法来上传数据和文件。这个类自动检测文件的大小，

Constructor Summary

Constructors

Constructor and Description
UploadManager(Configuration config) 构建一个非断点续传的上传对象
UploadManager(Configuration config, Recorder recorder) 构建一个支持断点续传的上传对象。只在文件采用分片上传时才会有效。 分块上传中，将每一块上传的记录保存下来。上传中断后可在上一次断点记录基础上上传剩余部分。 对于不同的文件上传需要支持断点续传的情况，请定义不同的UploadManager对象，而不要共享。

Method Summary

Modifier and Type	Method and Description
void	asyncPut(byte[] data, java.lang.String key, java.lang.String token, StringMap params, java.lang.String mime, boolean checkCrc, UpCompletionHandler handler) 异步上传数据
Response	put(byte[] data, java.lang.String key, java.lang.String token) 上传字节数组
Response	put(byte[] data, java.lang.String key, java.lang.String token, StringMap params, java.lang.String mime, boolean checkCrc) 上传字节数组
Response	put(java.io.File file, java.lang.String key, java.lang.String token) 上传文件
Response	put(java.io.File file, java.lang.String key, java.lang.String token, StringMap params, java.lang.String mime, boolean checkCrc) 上传文件
Response	put(java.io.InputStream stream, java.lang.String key, java.lang.String token, StringMap params, java.lang.String mime) 流式上传，通常情况建议文件上传，可以使用持久化的断点记录。
Response	put(java.lang.String filePath, java.lang.String key, java.lang.String token) 上传文件
Response	put(java.lang.String filePath, java.lang.String key, java.lang.String token, StringMap params, java.lang.String mime, boolean checkCrc) 上传文件

Methods inherited from class java.lang.Object

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

Constructor Detail

UploadManager

public UploadManager(Configuration config)

构建一个非断点续传的上传对象

Parameters:

config - 配置类对象

UploadManager

public UploadManager(Configuration config,
                     Recorder recorder)

构建一个支持断点续传的上传对象。只在文件采用分片上传时才会有效。 分块上传中，将每一块上传的记录保存下来。上传中断后可在上一次断点记录基础上上传剩余部分。 对于不同的文件上传需要支持断点续传的情况，请定义不同的UploadManager对象，而不要共享。

Parameters:

config - 配置类对象

recorder - 断点记录对象

Method Detail

put

public Response put(byte[] data,
                    java.lang.String key,
                    java.lang.String token)
             throws QiniuException

上传字节数组

Parameters:

data - 上传的数据

key - 上传数据保存的文件名

token - 上传凭证

Throws:

QiniuException

put

public Response put(byte[] data,
                    java.lang.String key,
                    java.lang.String token,
                    StringMap params,
                    java.lang.String mime,
                    boolean checkCrc)
             throws QiniuException

上传字节数组

Parameters:

data - 上传的数据

key - 上传数据保存的文件名

token - 上传凭证

params - 自定义参数，如 params.put("x:foo", "foo")

mime - 指定文件mimetype

checkCrc - 是否验证crc32

Returns:

Throws:

QiniuException

put

public Response put(java.lang.String filePath,
                    java.lang.String key,
                    java.lang.String token)
             throws QiniuException

上传文件

Parameters:

filePath - 上传的文件路径

key - 上传文件保存的文件名

token - 上传凭证

Throws:

QiniuException

put

public Response put(java.lang.String filePath,
                    java.lang.String key,
                    java.lang.String token,
                    StringMap params,
                    java.lang.String mime,
                    boolean checkCrc)
             throws QiniuException

上传文件

Parameters:

filePath - 上传的文件路径

key - 上传文件保存的文件名

token - 上传凭证

params - 自定义参数，如 params.put("x:foo", "foo")

mime - 指定文件mimetype

checkCrc - 是否验证crc32

Throws:

QiniuException

put

public Response put(java.io.File file,
                    java.lang.String key,
                    java.lang.String token)
             throws QiniuException

上传文件

Parameters:

file - 上传的文件对象

key - 上传文件保存的文件名

token - 上传凭证

Throws:

QiniuException

put

public Response put(java.io.File file,
                    java.lang.String key,
                    java.lang.String token,
                    StringMap params,
                    java.lang.String mime,
                    boolean checkCrc)
             throws QiniuException

上传文件

Parameters:

file - 上传的文件对象

key - 上传文件保存的文件名

token - 上传凭证

mime - 指定文件mimetype

checkCrc - 是否验证crc32

Throws:

QiniuException

asyncPut

public void asyncPut(byte[] data,
                     java.lang.String key,
                     java.lang.String token,
                     StringMap params,
                     java.lang.String mime,
                     boolean checkCrc,
                     UpCompletionHandler handler)
              throws java.io.IOException

异步上传数据

Parameters:

data - 上传的数据

key - 上传数据保存的文件名

token - 上传凭证

params - 自定义参数，如 params.put("x:foo", "foo")

mime - 指定文件mimetype

checkCrc - 是否验证crc32

handler - 上传完成的回调函数

Throws:

java.io.IOException

put

public Response put(java.io.InputStream stream,
                    java.lang.String key,
                    java.lang.String token,
                    StringMap params,
                    java.lang.String mime)
             throws QiniuException

流式上传，通常情况建议文件上传，可以使用持久化的断点记录。

Parameters:

stream - sha

key - 上传文件保存的文件名

token - 上传凭证

params - 自定义参数，如 params.put("x:foo", "foo")

mime - 指定文件mimetype

Throws:

QiniuException