org.opoo.ootp.client

接口 FileClient

所有已知实现类:

FileClientImpl

public interface FileClient

字段概要

字段

限定符和类型	字段和说明
static int	DEFAULT_BUFFER_SIZE
static java.lang.String	STORAGE_DEFAULT
static java.lang.String	STORAGE_FS

方法概要

限定符和类型	方法和说明
static int	copy(java.io.InputStream in, java.io.OutputStream out) 将数据从输入流复制到输出流。
default void	copy(java.lang.String fileId, java.io.File destination) 复制到本地文件。
default void	copy(java.lang.String fileId, java.io.OutputStream outputStream) 复制到本地输出。
default void	copy(java.lang.String fileId, java.nio.file.Path destination) 复制到本地文件。
default void	copy(java.net.URI uri, java.io.File destination)
default void	copy(java.net.URI uri, java.io.OutputStream outputStream)
default void	copy(java.net.URI uri, java.nio.file.Path destination)
ExsMessage	getFile(java.lang.String fileId) 获取文件及附加信息。
default java.io.InputStream	getStream(java.lang.String fileId) 下载文件。
default java.io.InputStream	getStream(java.net.URI uri) 获取 URI 对应的文件的输入流，如果远程文件是解密的，这里是解密后的输入流。
ExsMessage	getUri(java.net.URI uri) 获取 URI 对应的文件的文件信息，如果远程文件是解密的，这里是解密后的文件信息。
default java.lang.String	upload(ExsMessage message) 上传文件。
default java.lang.String	upload(ExsMessage message, java.lang.String storage) 上传文件。
java.lang.String	upload(ExsMessage message, java.lang.String storage, java.lang.String pathInfo) 上传文件。
default java.lang.String	upload(java.io.InputStream stream, ExsMetadata metadata) 上传文件
default java.lang.String	upload(java.io.InputStream stream, ExsMetadata metadata, java.lang.String storage) 上传文件
default java.lang.String	upload(java.io.InputStream stream, ExsMetadata metadata, java.lang.String storage, java.lang.String pathInfo) 上传文件
default java.lang.String	upload(java.lang.String storage, java.lang.String to, java.lang.String contentType, java.io.File file) 上传文件。
default java.lang.String	upload(java.lang.String storage, java.lang.String to, java.lang.String contentType, java.io.File file, java.lang.String pathInfo) 上传文件。
default java.lang.String	upload(java.lang.String storage, java.lang.String to, java.lang.String contentType, java.io.InputStream file, java.lang.String fileName, long fileSize, long lastModified) 上传文件。
default java.lang.String	upload(java.lang.String storage, java.lang.String to, java.lang.String contentType, java.io.InputStream file, java.lang.String fileName, long fileSize, long lastModified, java.lang.String pathInfo) 上传文件。
default java.lang.String	uploadToCustomStorage(java.lang.String storage, java.lang.String contentType, java.io.File file) 上传到个性化的存储器中。
default java.lang.String	uploadToCustomStorage(java.lang.String storage, java.lang.String contentType, java.io.File file, java.lang.String pathInfo) 上传到个性化的存储器中。
default java.lang.String	uploadToCustomStorage(java.lang.String storage, java.lang.String contentType, java.io.InputStream file, java.lang.String fileName, long fileSize, long lastModified) 上传到个性化的存储器中。
default java.lang.String	uploadToCustomStorage(java.lang.String storage, java.lang.String contentType, java.io.InputStream file, java.lang.String fileName, long fileSize, long lastModified, java.lang.String pathInfo) 上传到个性化的存储器中。
default java.lang.String	uploadToDefaultStorage(java.lang.String to, java.lang.String contentType, java.io.File file) 上传文件到默认文件中转服务。
default java.lang.String	uploadToDefaultStorage(java.lang.String to, java.lang.String contentType, java.io.File file, java.lang.String pathInfo) 上传文件到默认文件中转服务。
default java.lang.String	uploadToDefaultStorage(java.lang.String to, java.lang.String contentType, java.io.InputStream file, java.lang.String fileName, long fileSize, long lastModified) 上传文件到默认文件中转服务。
default java.lang.String	uploadToDefaultStorage(java.lang.String to, java.lang.String contentType, java.io.InputStream file, java.lang.String fileName, long fileSize, long lastModified, java.lang.String pathInfo) 上传文件到默认文件中转服务。
default java.lang.String	uploadToFsStorage(java.lang.String repo, java.lang.String contentType, java.io.File file) 上传文件到文件服务文件库。
default java.lang.String	uploadToFsStorage(java.lang.String repo, java.lang.String contentType, java.io.File file, java.lang.String pathInfo) 上传文件到文件服务文件库。
default java.lang.String	uploadToFsStorage(java.lang.String repo, java.lang.String contentType, java.io.InputStream file, java.lang.String fileName, long fileSize, long lastModified) 上传文件到文件服务文件库。
default java.lang.String	uploadToFsStorage(java.lang.String repo, java.lang.String contentType, java.io.InputStream file, java.lang.String fileName, long fileSize, long lastModified, java.lang.String pathInfo) 上传文件到文件服务文件库。

字段详细资料

DEFAULT_BUFFER_SIZE

static final int DEFAULT_BUFFER_SIZE

另请参阅:

常量字段值

STORAGE_DEFAULT

static final java.lang.String STORAGE_DEFAULT

另请参阅:

常量字段值

STORAGE_FS

static final java.lang.String STORAGE_FS

另请参阅:

常量字段值

方法详细资料

upload

java.lang.String upload(ExsMessage message,
                        java.lang.String storage,
                        java.lang.String pathInfo)
                 throws java.io.IOException,
                        OotpException

上传文件。

参数:

message - 文件消息

storage - 存储器名称

pathInfo - 后置处理路径

返回:

上传后生成的文件ID

抛出:

java.io.IOException - 文件处理异常

OotpException - 通常是 Http 请求异常，或者服务器返回错误消息

upload

default java.lang.String upload(ExsMessage message,
                                java.lang.String storage)
                         throws java.io.IOException,
                                OotpException

上传文件。

参数:

message - 文件消息

storage - 存储器名称

返回:

上传后生成的文件ID

抛出:

java.io.IOException - 文件处理异常

OotpException - 通常是 Http 请求异常，或者服务器返回错误消息

upload

default java.lang.String upload(ExsMessage message)
                         throws java.io.IOException,
                                OotpException

上传文件。

参数:

message - 文件消息

返回:

上传后生成的文件ID

抛出:

java.io.IOException - 文件处理异常

OotpException - 通常是 Http 请求异常，或者服务器返回错误消息

upload

default java.lang.String upload(java.io.InputStream stream,
                                ExsMetadata metadata,
                                java.lang.String storage,
                                java.lang.String pathInfo)
                         throws java.io.IOException,
                                OotpException

上传文件

参数:

stream - 文件内容

metadata - 元数据

storage - 存储器

pathInfo - 后置处理路径

返回:

文件ID

抛出:

java.io.IOException - 文件处理异常

OotpException - 通常是 Http 请求异常，或者服务器返回错误消息

upload

default java.lang.String upload(java.io.InputStream stream,
                                ExsMetadata metadata,
                                java.lang.String storage)
                         throws java.io.IOException,
                                OotpException

上传文件

参数:

stream - 文件内容

metadata - 元数据

storage - 存储器

返回:

文件ID

抛出:

java.io.IOException - 文件处理异常

OotpException - 通常是 Http 请求异常，或者服务器返回错误消息

upload

default java.lang.String upload(java.io.InputStream stream,
                                ExsMetadata metadata)
                         throws java.io.IOException,
                                OotpException

上传文件

参数:

stream - 文件内容

metadata - 元数据

返回:

文件ID

抛出:

java.io.IOException - 文件处理异常

OotpException - 通常是 Http 请求异常，或者服务器返回错误消息

uploadToFsStorage

default java.lang.String uploadToFsStorage(java.lang.String repo,
                                           java.lang.String contentType,
                                           java.io.File file)
                                    throws java.io.IOException,
                                           OotpException

上传文件到文件服务文件库。

参数:

repo - 目标文件库

contentType - 文件内容类型

file - 文件

返回:

上传后返回的文件ID

抛出:

java.io.IOException - 文件处理异常

OotpException - 通常是 Http 请求异常，或者服务器返回错误消息

uploadToFsStorage

default java.lang.String uploadToFsStorage(java.lang.String repo,
                                           java.lang.String contentType,
                                           java.io.File file,
                                           java.lang.String pathInfo)
                                    throws java.io.IOException,
                                           OotpException

上传文件到文件服务文件库。

参数:

repo - 目标文件库

contentType - 文件内容类型

file - 文件

pathInfo - 文件上传的后置处理

返回:

上传后返回的文件ID

抛出:

java.io.IOException - 文件处理异常

OotpException - 通常是 Http 请求异常，或者服务器返回错误消息

uploadToFsStorage

default java.lang.String uploadToFsStorage(java.lang.String repo,
                                           java.lang.String contentType,
                                           java.io.InputStream file,
                                           java.lang.String fileName,
                                           long fileSize,
                                           long lastModified)
                                    throws java.io.IOException,
                                           OotpException

上传文件到文件服务文件库。

参数:

repo - 目标文件库

contentType - 文件内容类型

file - 文件内容

fileName - 文件名

fileSize - 文件大小，未知大小传 -1

lastModified - 文件最后更新时间

返回:

上传后返回的文件ID

抛出:

java.io.IOException - 文件处理异常

OotpException - 通常是 Http 请求异常，或者服务器返回错误消息

uploadToFsStorage

default java.lang.String uploadToFsStorage(java.lang.String repo,
                                           java.lang.String contentType,
                                           java.io.InputStream file,
                                           java.lang.String fileName,
                                           long fileSize,
                                           long lastModified,
                                           java.lang.String pathInfo)
                                    throws java.io.IOException,
                                           OotpException

上传文件到文件服务文件库。

参数:

repo - 目标文件库

contentType - 文件内容类型

file - 文件内容

fileName - 文件名

fileSize - 文件大小，未知大小传 -1

lastModified - 文件最后更新时间

pathInfo - 文件上传的后置处理

返回:

上传后返回的文件ID

抛出:

java.io.IOException - 文件处理异常

OotpException - 通常是 Http 请求异常，或者服务器返回错误消息

uploadToDefaultStorage

default java.lang.String uploadToDefaultStorage(java.lang.String to,
                                                java.lang.String contentType,
                                                java.io.File file)
                                         throws java.io.IOException,
                                                OotpException

上传文件到默认文件中转服务。

参数:

to - 目标接收方

contentType - 文件内容类型

file - 文件

返回:

上传后返回的文件ID

抛出:

java.io.IOException - 文件处理异常

OotpException - 其它异常

uploadToDefaultStorage

default java.lang.String uploadToDefaultStorage(java.lang.String to,
                                                java.lang.String contentType,
                                                java.io.File file,
                                                java.lang.String pathInfo)
                                         throws java.io.IOException,
                                                OotpException

上传文件到默认文件中转服务。

参数:

to - 目标接收方

contentType - 文件内容类型

file - 文件

pathInfo - 文件上传的后置处理

返回:

上传后返回的文件ID

抛出:

java.io.IOException - 文件处理异常

OotpException - 其它异常

uploadToDefaultStorage

default java.lang.String uploadToDefaultStorage(java.lang.String to,
                                                java.lang.String contentType,
                                                java.io.InputStream file,
                                                java.lang.String fileName,
                                                long fileSize,
                                                long lastModified)
                                         throws java.io.IOException,
                                                OotpException

上传文件到默认文件中转服务。

参数:

to - 目标接收方

contentType - 文件内容类型

file - 文件内容

fileName - 文件名

fileSize - 文件大小，未知大小传 -1

lastModified - 文件最后更新时间

返回:

上传后返回的文件ID

抛出:

java.io.IOException - 文件处理异常

OotpException - 其它异常

uploadToDefaultStorage

default java.lang.String uploadToDefaultStorage(java.lang.String to,
                                                java.lang.String contentType,
                                                java.io.InputStream file,
                                                java.lang.String fileName,
                                                long fileSize,
                                                long lastModified,
                                                java.lang.String pathInfo)
                                         throws java.io.IOException,
                                                OotpException

上传文件到默认文件中转服务。

参数:

to - 目标接收方

contentType - 文件内容类型

file - 文件内容

fileName - 文件名

fileSize - 文件大小，未知大小传 -1

lastModified - 文件最后更新时间

pathInfo - 文件上传的后置处理

返回:

上传后返回的文件ID

抛出:

java.io.IOException - 文件处理异常

OotpException - 其它异常

uploadToCustomStorage

default java.lang.String uploadToCustomStorage(java.lang.String storage,
                                               java.lang.String contentType,
                                               java.io.File file)
                                        throws java.io.IOException,
                                               OotpException

上传到个性化的存储器中。

参数:

storage - 存储器名称

contentType - 文件内容类型

file - 文件

返回:

上传后返回的文件ID

抛出:

java.io.IOException - 文件处理异常

OotpException - 其它异常

uploadToCustomStorage

default java.lang.String uploadToCustomStorage(java.lang.String storage,
                                               java.lang.String contentType,
                                               java.io.File file,
                                               java.lang.String pathInfo)
                                        throws java.io.IOException,
                                               OotpException

上传到个性化的存储器中。

参数:

storage - 存储器名称

contentType - 文件内容类型

file - 文件

pathInfo - 文件上传的后置处理

返回:

上传后返回的文件ID

抛出:

java.io.IOException - 文件处理异常

OotpException - 其它异常

uploadToCustomStorage

default java.lang.String uploadToCustomStorage(java.lang.String storage,
                                               java.lang.String contentType,
                                               java.io.InputStream file,
                                               java.lang.String fileName,
                                               long fileSize,
                                               long lastModified)
                                        throws java.io.IOException,
                                               OotpException

上传到个性化的存储器中。

参数:

storage - 存储器名称

contentType - 文件内容类型

file - 文件内容

fileName - 文件名

fileSize - 文件大小，未知大小传 -1

lastModified - 文件最后更新时间

返回:

上传后返回的文件ID

抛出:

java.io.IOException - 文件处理异常

OotpException - 其它异常

uploadToCustomStorage

default java.lang.String uploadToCustomStorage(java.lang.String storage,
                                               java.lang.String contentType,
                                               java.io.InputStream file,
                                               java.lang.String fileName,
                                               long fileSize,
                                               long lastModified,
                                               java.lang.String pathInfo)
                                        throws java.io.IOException,
                                               OotpException

上传到个性化的存储器中。

参数:

storage - 存储器名称

contentType - 文件内容类型

file - 文件内容

fileName - 文件名

fileSize - 文件大小，未知大小传 -1

lastModified - 文件最后更新时间

pathInfo - 文件上传的后置处理

返回:

上传后返回的文件ID

抛出:

java.io.IOException - 文件处理异常

OotpException - 其它异常

upload

default java.lang.String upload(java.lang.String storage,
                                java.lang.String to,
                                java.lang.String contentType,
                                java.io.File file)
                         throws java.io.IOException,
                                OotpException

上传文件。

参数:

storage - 存储器的名称

to - 目标接收方

contentType - 文件内容类型

file - 文件

返回:

上传后返回的文件ID

抛出:

java.io.IOException - 文件处理异常

OotpException - 其它异常

upload

default java.lang.String upload(java.lang.String storage,
                                java.lang.String to,
                                java.lang.String contentType,
                                java.io.File file,
                                java.lang.String pathInfo)
                         throws java.io.IOException,
                                OotpException

上传文件。

参数:

storage - 存储器的名称

to - 目标接收方

contentType - 文件内容类型

file - 文件

pathInfo - 文件上传的后置处理

返回:

上传后返回的文件ID

抛出:

java.io.IOException - 文件处理异常

OotpException - 其它异常

upload

default java.lang.String upload(java.lang.String storage,
                                java.lang.String to,
                                java.lang.String contentType,
                                java.io.InputStream file,
                                java.lang.String fileName,
                                long fileSize,
                                long lastModified)
                         throws java.io.IOException,
                                OotpException

上传文件。

参数:

storage - 存储器的名称

to - 目标接收方，接收方ID或者文件库ID

contentType - 文件内容类型

file - 文件内容

fileName - 文件名

fileSize - 文件大小，未知大小传 -1

lastModified - 文件最后更新时间

返回:

上传后返回的文件ID

抛出:

java.io.IOException - 文件处理异常

OotpException - 其它异常

upload

default java.lang.String upload(java.lang.String storage,
                                java.lang.String to,
                                java.lang.String contentType,
                                java.io.InputStream file,
                                java.lang.String fileName,
                                long fileSize,
                                long lastModified,
                                java.lang.String pathInfo)
                         throws java.io.IOException,
                                OotpException

上传文件。

参数:

storage - 存储器的名称

to - 目标接收方，接收方ID或者文件库ID

contentType - 文件内容类型

file - 文件内容

fileName - 文件名

fileSize - 文件大小，未知大小传 -1

lastModified - 文件最后更新时间

pathInfo - 文件后置处理路径

返回:

上传后返回的文件ID

抛出:

java.io.IOException - 文件处理异常

OotpException - 其它异常

getFile

ExsMessage getFile(java.lang.String fileId)
            throws java.io.IOException

获取文件及附加信息。

参数:

fileId - 文件ID

返回:

文件及附加信息

抛出:

java.io.IOException - 文件处理异常

getStream

default java.io.InputStream getStream(java.lang.String fileId)
                               throws java.io.IOException

下载文件。仅上传到默认中转服务的文件可以下载。

参数:

fileId - 文件ID

返回:

文件流

抛出:

java.io.IOException - 文件处理异常

copy

default void copy(java.lang.String fileId,
                  java.io.File destination)
           throws java.io.IOException

复制到本地文件。仅上传到默认中转服务的文件可以复制。

参数:

fileId - 文件ID

destination - 本地文件

抛出:

java.io.IOException - io 异常

copy

default void copy(java.lang.String fileId,
                  java.nio.file.Path destination)
           throws java.io.IOException

复制到本地文件。仅上传到默认中转服务的文件可以复制。

参数:

fileId - 文件ID

destination - 本地文件

抛出:

java.io.IOException - io 异常

copy

default void copy(java.lang.String fileId,
                  java.io.OutputStream outputStream)
           throws java.io.IOException

复制到本地输出。仅上传到默认中转服务的文件可以复制。

参数:

fileId - 文件ID

outputStream - 输出流

抛出:

java.io.IOException - io 异常

getUri

ExsMessage getUri(java.net.URI uri)
           throws java.io.IOException

获取 URI 对应的文件的文件信息，如果远程文件是解密的，这里是解密后的文件信息。

参数:

uri - 远程文件资源地址。一般是预签名的S3对象的URI地址。

返回:

解密/解码后的输入流

抛出:

java.io.IOException - io 异常

getStream

default java.io.InputStream getStream(java.net.URI uri)
                               throws java.io.IOException

获取 URI 对应的文件的输入流，如果远程文件是解密的，这里是解密后的输入流。

参数:

uri - 远程文件资源地址。一般是预签名的S3对象的URI地址。

返回:

解密/解码后的输入流

抛出:

java.io.IOException - io 异常

copy

default void copy(java.net.URI uri,
                  java.io.OutputStream outputStream)
           throws java.io.IOException

抛出:

java.io.IOException

copy

default void copy(java.net.URI uri,
                  java.io.File destination)
           throws java.io.IOException

抛出:

java.io.IOException

copy

default void copy(java.net.URI uri,
                  java.nio.file.Path destination)
           throws java.io.IOException

抛出:

java.io.IOException

copy

static int copy(java.io.InputStream in,
                java.io.OutputStream out)
         throws java.io.IOException

将数据从输入流复制到输出流。

参数:

in - 输入流

out - 输出流

返回:

字节数

抛出:

java.io.IOException - IO异常