com.actionsoft.bpms.server.fs.dc

类 DCUtil

java.lang.Object

com.actionsoft.bpms.server.fs.dc.DCUtil

public final class DCUtil
extends java.lang.Object

操作DC的工具方法封装

另请参阅:

DC上下文, DC封装给开发者的常用API

构造器概要

构造器

构造器和说明
DCUtil()

方法概要

限定符和类型	方法和说明
static java.io.InputStream	cloneInputStream(java.io.InputStream in) 克隆输入流
static void	close(java.io.InputStream is)
static boolean	copyDCFile(DCContext sourceContext, DCContext targetContext) 复制源文件至目标，如果目标对象未设置文件名，默认为源文件名
static DCContext	createTempFileContext(java.lang.String appId, java.lang.String fileSuffix) 获得一个临时文件路径的上下文声明（并不真实创建文件），如果路径不存在则建立文件夹。
static DCContext	createTempFileContext(java.lang.String appId, java.lang.String groupValue, java.lang.String fileValue, java.lang.String fileSuffix) 获得一个临时文件路径的上下文声明（并不真实创建文件），如果路径不存在则建立文件夹。
static java.io.InputStream	decryptFile(DCContext context) 已过时。
static java.lang.String	decryptFileName_history(java.lang.String fileName) 解密文件名，后缀不变
static java.lang.String	decryptFileName(java.lang.String fileName) 解密文件名，后缀不变
static ResponseObject	downloadPackage(UserContext me, java.util.List<DCContext> dcList, java.lang.String zipFilePath, java.lang.String zipFileName, java.lang.String repositoryName) 打包下载一系列DC文件
static int	encryptFile(DCContext context) 加密指定的文件
static java.lang.String	encryptFileName_history(java.lang.String fileName) 加密文件名（历史）
static java.lang.String	encryptFileName(java.lang.String fileName) 加密文件名，后缀不变
static java.lang.String	encryptFileName(java.lang.String fileName, java.lang.String charsetName) 根据指定字符编码加密文件名，后缀不变
static boolean	existColdPath()
static java.lang.String	genRepositoryName(java.lang.String name, boolean deepFile, boolean encrypt, boolean RWBytes) 造附件RepositoryName的工具方法
static java.lang.String	getColdPath()
static DCUtil	getInstance() 返回实例对象
static java.lang.String	getMobileDownloadUrl(DCContext dcContext) 获取移动端的下载地址
static java.lang.String	getPath()
static java.lang.String	getSecurityKey(java.lang.String path) 获得加/解密文件正文的key
static boolean	handlerWriteDCDefault(java.io.InputStream in, DCContext context, java.util.Map<java.lang.String,java.lang.Object> param) 从ready事件后接管附件上传动作
static boolean	isBigStorage(java.lang.String repositoryName) 是否需要支持大容量4级结构的存储算法，采用该算法可以突破文件系统的单一目录文件数容量限制，理论可从原来存储3万至5万文件增容至3亿至5亿
static boolean	isDangerFileName(java.lang.String fileName) 判断附件路径中某目录名称是否安全
static boolean	isDangerFileName(java.lang.String fileName, boolean checkSuffix) 判断文件/文件夹名命名是否存在潜在危险
static boolean	isDiyContent(java.lang.String repositoryName) 是否自定义DC内容处理，而非默认DC文件
static boolean	isHighSecurityStorage(java.lang.String repositoryName) 是否需要高级别的安全存储，对该类文件正文和文件名进行加/解密处理
static boolean	isIgnoreRepositoryName(DCContext context) 云存储上传时忽略的RepositoryName
static void	setExtParam(DCContext dc, java.lang.String key, java.lang.Object v)
static java.lang.String	writeSysFile(DCContext context, java.lang.String appId, long fileSize, java.lang.String cloudId, java.lang.String cloudAppId, java.lang.String cloudInfo) 云文档插入sys_files表

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

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

构造器详细资料

DCUtil

public DCUtil()

方法详细资料

getInstance

public static DCUtil getInstance()

返回实例对象

返回:

实例对象

setExtParam

public static void setExtParam(DCContext dc,
                               java.lang.String key,
                               java.lang.Object v)

genRepositoryName

public static java.lang.String genRepositoryName(java.lang.String name,
                                                 boolean deepFile,
                                                 boolean encrypt,
                                                 boolean RWBytes)

造附件RepositoryName的工具方法

参数:

name -

deepFile - 是否四级算法存储

encrypt - 是否加密存储

RWBytes - 是否diy内容处理

返回:

RepositoryName

isDiyContent

public static boolean isDiyContent(java.lang.String repositoryName)

是否自定义DC内容处理，而非默认DC文件

参数:

repositoryName - 文档仓库根目录名

handlerWriteDCDefault

public static boolean handlerWriteDCDefault(java.io.InputStream in,
                                            DCContext context,
                                            java.util.Map<java.lang.String,java.lang.Object> param)

从ready事件后接管附件上传动作

参数:

in - 输入流

context - 文件上下文

param - 参数

抛出:

java.lang.Exception

isIgnoreRepositoryName

public static boolean isIgnoreRepositoryName(DCContext context)

云存储上传时忽略的RepositoryName

参数:

context - 文件上下文

返回:

true/false

isHighSecurityStorage

public static boolean isHighSecurityStorage(java.lang.String repositoryName)

是否需要高级别的安全存储，对该类文件正文和文件名进行加/解密处理

参数:

repositoryName - 文档仓库根目录名

返回:

true/false

isBigStorage

public static boolean isBigStorage(java.lang.String repositoryName)

是否需要支持大容量4级结构的存储算法，采用该算法可以突破文件系统的单一目录文件数容量限制，理论可从原来存储3万至5万文件增容至3亿至5亿

参数:

repositoryName - 文档仓库根目录名

返回:

true/false

getSecurityKey

public static java.lang.String getSecurityKey(java.lang.String path)

获得加/解密文件正文的key

返回:

key

encryptFileName

public static java.lang.String encryptFileName(java.lang.String fileName,
                                               java.lang.String charsetName)

根据指定字符编码加密文件名，后缀不变

参数:

fileName - 文件名

charsetName - 字符编码

返回:

加密后的文件名

encryptFileName

public static java.lang.String encryptFileName(java.lang.String fileName)

加密文件名，后缀不变

参数:

fileName - 文件名

返回:

加密后的文件名

decryptFileName

public static java.lang.String decryptFileName(java.lang.String fileName)

解密文件名，后缀不变

参数:

fileName - 文件名

返回:

解密后的文件名

decryptFile

@Deprecated
public static java.io.InputStream decryptFile(DCContext context)

已过时。

应用层不应该知道加解密细节，通过设置DCContext的

参数:

context -

返回:

encryptFile

public static int encryptFile(DCContext context)

加密指定的文件

参数:

context - 上下文

返回:

加密后文件大小(单位k)

createTempFileContext

public static DCContext createTempFileContext(java.lang.String appId,
                                              java.lang.String fileSuffix)

获得一个临时文件路径的上下文声明（并不真实创建文件），如果路径不存在则建立文件夹。适用于为自己的App程序生成、处理临时文件， 该文件超过n天后会由AWS平台自动删除

参数:

appId - 应用id，数据将存于该应用下

fileSuffix - 临时文件名的后缀，如xls、jar，可以为null

返回:

构造一个DCContext对象, 如果给定的appId不存在返回null

createTempFileContext

public static DCContext createTempFileContext(java.lang.String appId,
                                              java.lang.String groupValue,
                                              java.lang.String fileValue,
                                              java.lang.String fileSuffix)

获得一个临时文件路径的上下文声明（并不真实创建文件），如果路径不存在则建立文件夹。适用于为自己的App程序生成、处理临时文件， 该文件超过n天后会由AWS平台自动删除

参数:

appId - 应用id，数据将存于该应用下

groupValue - 任意，临时目录的第1分类。不包含空格的英文字母，不建议包含怪字符，可以为null

fileValue - 任意，临时目录的第2分类。不包含空格的英文字母，不建议包含怪字符，可以为null

fileSuffix - 临时文件名的后缀，如xls、jar，可以为null

返回:

构造一个DCContext对象, 如果给定的appId不存在返回null

copyDCFile

public static boolean copyDCFile(DCContext sourceContext,
                                 DCContext targetContext)

复制源文件至目标，如果目标对象未设置文件名，默认为源文件名

参数:

sourceContext - 要复制的文件对象上下文

targetContext - 目标，可以设置文件名也可忽略

返回:

成功返回true

isDangerFileName

public static boolean isDangerFileName(java.lang.String fileName)

判断附件路径中某目录名称是否安全

参数:

fileName - 文件名

返回:

true/false

isDangerFileName

public static boolean isDangerFileName(java.lang.String fileName,
                                       boolean checkSuffix)

判断文件/文件夹名命名是否存在潜在危险

参数:

fileName - 文件夹/文件名

返回:

有高危险返回true

getMobileDownloadUrl

public static java.lang.String getMobileDownloadUrl(DCContext dcContext)

获取移动端的下载地址

参数:

dcContext - 文件上下文

返回:

下载地址

encryptFileName_history

public static java.lang.String encryptFileName_history(java.lang.String fileName)

加密文件名（历史）

参数:

fileName - 文件名

返回:

加密后的文件名

decryptFileName_history

public static java.lang.String decryptFileName_history(java.lang.String fileName)

解密文件名，后缀不变

参数:

fileName - 文件名

返回:

解密后的文件名

writeSysFile

public static java.lang.String writeSysFile(DCContext context,
                                            java.lang.String appId,
                                            long fileSize,
                                            java.lang.String cloudId,
                                            java.lang.String cloudAppId,
                                            java.lang.String cloudInfo)

云文档插入sys_files表

参数:

context - 文件上下文

appId - 应用id

fileSize - 文件大小

cloudId - 云存储id

cloudAppId - 云存储应用id

cloudInfo - 云存储信息

返回:

id

existColdPath

public static boolean existColdPath()

getColdPath

public static java.lang.String getColdPath()

getPath

public static java.lang.String getPath()

cloneInputStream

public static java.io.InputStream cloneInputStream(java.io.InputStream in)

克隆输入流

参数:

in - 被克隆的流

返回:

克隆后的流

downloadPackage

public static ResponseObject downloadPackage(UserContext me,
                                             java.util.List<DCContext> dcList,
                                             java.lang.String zipFilePath,
                                             java.lang.String zipFileName,
                                             java.lang.String repositoryName)
                                      throws java.lang.Exception

打包下载一系列DC文件

参数:

dcList - 文件上下文集合

zipFilePath - 生成的zip路径

zipFileName - 生成的zip文件名称

返回:

下载信息json

抛出:

java.lang.Exception

close

public static void close(java.io.InputStream is)