CloudkdService (Bropen Framework 4.8.1 API)

bropen.framework.plugins.si.storage.CloudkdService

云创智企（cloudkd.com.cn）网盘集成服务
集成方式：
- 在网盘系统中创建一个名为的用户（如 bropen），存储空间设置为不限，并创建一个和应用同名的文件夹，并将文件夹 ID 记录下来，用于保存系统附件。
- 网盘系统的用户名和本系统的用户名保持一致（都不区分大小写）。
- 在应用中，创建一个名为 AttachmentDataService 的服务类，并继承本类，内容为空。
- 在 grails-app/conf/application.xxx 中启用，配置
  bropen.framework.resource.attachment.storage.clazz = CloudkdService.name bropen.framework.resource.attachment.storage.cloudkd.saveas = 是否可以另存为 bropen.framework.resource.attachment.storage.cloudkd.account = 上面创建的用户名 bropen.framework.resource.attachment.storage.cloudkd.catalogid = 上面记录的文件夹ID bropen.framework.resource.attachment.storage.cloudkd.url = 网盘服务器地址（如 http://xxxx:xxx） bropen.framework.resource.attachment.storage.cloudkd.ssourl = 网盘单点登录 API 的地址后缀（默认为 /api/user/loginSSO）。

Properties Summary

Properties
Type	Name and description
`ErrorService`	`errorService`

Methods Summary

Methods
Type	Name and description
`Integer`	`delete(List<String> saveNames, List<String> syncIds)` 删除网盘文件
`boolean`	`exists(String saveName, String syncId)`
`protected String`	`getAccount()`
`protected String`	`getCatalogId()` 用户 account(bropen) 的附件同步文件夹的 ID
`EncodedInputStreamWrapper`	`getEncodedInputStream(javax.servlet.http.HttpServletRequest request, String saveName, String syncId)`
`java.io.InputStream`	`getInputStream(String saveName, String syncId)` 下载网盘文件
`Long`	`getLength(String saveName, String syncId, Long length)`
`protected String`	`getServerUrl()` 网盘 API 接口地址
`protected String`	`getSsoUrl()` 单点登录的 API 路径
`protected String`	`getToken(Employee emp)` 获取 sso token 以便调用网盘 API
`Map`	`getTree(Employee employee)` 获取个人网盘文件夹树列表
`String`	`getUrl(String saveName, String syncId, String fileName, Long length, String contentType, Date expiration)`
`String`	`save(String saveName, java.io.InputStream is, String fileName, Long length, String md5)` 上传文件到网盘
`bropen.toolkit.api.Response`	`saveAs(Employee employee, Attachment att, String folderId)` 文件另存到网盘
`boolean`	`shouldKeepLocalCopy(String fileName, Long length)`

Inherited Methods Summary

Inherited Methods
Methods inherited from class	Name
`class AbstractStorageService`	`delete, deleteFailed, deleteRetry, exists, getEncodedInputStream, getInputStream, getLength, getUrl, isEnabled, save, setEnabled, shouldKeepLocalCopy, transfer`
`class Object`	`Object#wait(long, int), Object#wait(long), Object#wait(), Object#equals(Object), Object#toString(), Object#hashCode(), Object#getClass(), Object#notify(), Object#notifyAll()`

- Property Detail
  - ErrorService errorService
- Method Detail
  - @Override Integer delete(List<String> saveNames, List<String> syncIds)
    
    删除网盘文件
```
接口参数说明：
 token：    必填，令牌
 fileIds：  必填，要删除的文件ID，多选则文件ID间用逗号分割；如果文件不存在，仍然返回删除成功
 folderIds：选填，要删除的文件夹ID，多选则文件夹ID间用逗号分割
 
```
  - @Override boolean exists(String saveName, String syncId)
  - protected String getAccount()
  - protected String getCatalogId()
    
    用户 account(bropen) 的附件同步文件夹的 ID
  - @Override EncodedInputStreamWrapper getEncodedInputStream(javax.servlet.http.HttpServletRequest request, String saveName, String syncId)
  - @Override java.io.InputStream getInputStream(String saveName, String syncId)
    
    下载网盘文件
```
接口参数说明：
 token： 必填，令牌
 fileId： 必填，文件ID
 pos： 必填，文件位置(字节位置)
 
```
  - @Override Long getLength(String saveName, String syncId, Long length)
  - protected String getServerUrl()
    
    网盘 API 接口地址
  - protected String getSsoUrl()
    
    单点登录的 API 路径
  - protected String getToken(Employee emp)
    
    获取 sso token 以便调用网盘 API
    Returns:
    token
  - Map getTree(Employee employee)
    
    获取个人网盘文件夹树列表
```
接口参数说明：
 token 必填，令牌
 pid： 选填，父文件夹ID，根文件夹的 pid 传参为 0 或 null
 
```
    Returns:
    支持 o:treeField 的目录树
  - @Override String getUrl(String saveName, String syncId, String fileName, Long length, String contentType, Date expiration)
  - @Override String save(String saveName, java.io.InputStream is, String fileName, Long length, String md5)
    
    上传文件到网盘
```
接口参数说明：
 token：  必填，令牌
 catalogId： 必填，所属文件夹
 fileName： 必填，文件名字
 fileHash： 必填，文件MD5
 pos：  必填，文件位置(字节位置)
 fileSize： 必填，文件大小
 file：  选填，文件流
```
  - bropen.toolkit.api.Response saveAs(Employee employee, Attachment att, String folderId)
    
    文件另存到网盘
```
copyTo 接口参数说明：
 token：  必填，令牌
 fileIds： 选填，文件ID，多选则文件ID间用逗号分割
 folderIds： 选填，文件夹ID，多选则文件夹ID间用逗号分割
 toFolderId： 必填，复制到的目标文件夹ID
 isCover： 必填，确认操作。参数说明 2：不覆盖, 1：覆盖, 0：第一次操作参数.
 
```
  - @Override boolean shouldKeepLocalCopy(String fileName, Long length)

| Detail:
Field
Property
Constructor
Method

BROPEN Documentation, 2020-04-21 11:00

[Groovy] Class CloudkdService

Properties Summary

Methods Summary

Inherited Methods Summary

Property Detail

ErrorService errorService

Method Detail

@Override Integer delete(List<String> saveNames, List<String> syncIds)

@Override boolean exists(String saveName, String syncId)

protected String getAccount()

protected String getCatalogId()

@Override EncodedInputStreamWrapper getEncodedInputStream(javax.servlet.http.HttpServletRequest request, String saveName, String syncId)

@Override java.io.InputStream getInputStream(String saveName, String syncId)

@Override Long getLength(String saveName, String syncId, Long length)

protected String getServerUrl()

protected String getSsoUrl()

protected String getToken(Employee emp)

Map getTree(Employee employee)

@Override String getUrl(String saveName, String syncId, String fileName, Long length, String contentType, Date expiration)

@Override String save(String saveName, java.io.InputStream is, String fileName, Long length, String md5)

bropen.toolkit.api.Response saveAs(Employee employee, Attachment att, String folderId)

@Override boolean shouldKeepLocalCopy(String fileName, Long length)