Fx.netdisk：网盘
1. exportNpathByFolderId 导出网盘npath
Fx.netdisk.exportNpathByFolderId(<String nodeCategory>, <List folderIDs>, <Integer userId>)
参数说明
| 参数 | 类型 | 说明 |
|---|---|---|
| nodeCategory | String | 文件夹类型(公司：Company 个人：Personal 共享 ：Shared) |
| folderIDs | List | 文件夹id |
| userId | Integer | 人员id，文件的归属人 |
返回值类型
APIResult
返回值说明
返回的数据类型: Map
Java举例
List<String>list = Lists.newArrayList("476d9244b9304c8abfde59d0f8274933","903d7c1172e24d4198136ebfada198a1", 1000);
APIResult ret = Fx.netdisk.exportNpathByFolderId("Company", list);
if (ret.isError()) {
log.info("error :"+ ret.message());
} else {
log.info(ret.getData());
}
Groovy举例
def (Boolean error, Map data, String message) = Fx.netdisk.exportNpathByFolderId("Company", ["476d9244b9304c8abfde59d0f8274933","903d7c1172e24d4198136ebfada198a1"], 1000)
if (error) {
log.info("error :" + message)
} else {
log.info(data['fileMessageInfos'])
}
2. list list该网盘文件夹
Fx.netdisk.list(<String nodeCategory>, <String dir>, <String order>, <Integer desc>, <Integer start>, <Integer limit>, <Integer folder>, <Integer showEmpty>, <Integer employeeId>)
参数说明
| 参数 | 类型 | 说明 |
|---|---|---|
| nodeCategory | String | 文件夹类型(公司、个人、共享) |
| dir | String | 文件夹名称 |
| order | String | 排序字段(name,time,size默认为name) time表示先按文件类型排序，后按修改时间排序； name表示先按文件类型排序，后按文件名称排序； size表示先按文件类型排序，后按文件大小排序。 |
| desc | Integer | 默认为升序,设置为1实现降序 |
| start | Integer | 分页起始位置,从0开始 |
| limit | Integer | 查询数目，默认为1000，建议最大不超过1000 |
| folder | Integer | 是否只返回文件夹，0 返回所有，1 只返回文件夹，且属性只返回path字段 |
| showEmpty | Integer | 是否返回dir_empty属性，0 不返回，1 返回 |
| employeeId | Integer | 人员id |
返回值类型
APIResult
返回值说明
返回的数据类型: Map
Java举例
String nodeCategory = "Company";
String dir = "阿里巴巴Java开发手册";
String orderField = "name";
Integer desc = 1;
Integer start = 0;
Integer limit = 10;
Integer folder = 0;
Integer showEmpty = 1;
Integer employeeId = 1017;
APIResult ret = Fx.netdisk.list(nodeCategory, dir, orderField, desc, start, limit, folder, showEmpty, employeeId);
if (ret.isError()) {
log.info("error :"+ ret.message());
} else {
log.info(ret.getData());
}
Groovy举例
String nodeCategory = "Company"
String dir = "阿里巴巴Java开发手册"
String orderField = "name"
Integer desc = 1
Integer start = 0
Integer limit = 10
Integer folder = 0
Integer showEmpty = 1
Integer employeeId = 1017
def(Boolean error, Map data, String message) = Fx.netdisk.list(nodeCategory, dir, orderField, desc, start, limit, folder, showEmpty, employeeId)
if (error) {
log.info("error:" + message)
} else {
List fileMessageInfos = data["fileMessageInfos"] as List
log.debug(fileMessageInfos)
}
3. saveFileToDir 将文件保存到网盘指定文件夹
Fx.netdisk.saveFileToDir(<List departmentIds>, <String path>, <String fileName>, <Integer category>, <String folderPath>, <Boolean autoCreateDir>, <Boolean allowReName>, <Boolean takeOwnership>)
参数说明
| 参数 | 类型 | 说明 |
|---|---|---|
| departmentIds | List | 用户所属部门编号 |
| path | String | 要保存到网盘的文件path,目前仅支持企业文件类型 |
| fileName | String | 文件名,需要携带后缀 |
| category | Integer | 网盘文件夹类型 1公司,2个人,3共享(共享暂不支持) |
| folderPath | String | 网盘文件夹路径,以/开头以文件夹名称结尾 |
| autoCreateDir | Boolean | 是否自动迭代创建缺失文件路径 |
| allowReName | Boolean | 是否允许以增量形式重命名文件名称 |
| takeOwnership | Boolean | 越权操作,获取网盘管理员权限 |
返回值类型
APIResult
返回值说明
返回的数据类型: Map
Java举例
// 用户所属部门编号（可以为空，普通用户需要保存到部门文件夹时使用）
List<Integer>departmentIds;
// 需要保存到网盘的文件path（目前只支持企业文件，即以N_或TN_开头的文件）
String path="N_202304_10_f438201727394b018e62e0ba48b6f349.pdf";
// 文件名 （需要携带文件类型扩展名,文件名总长度不允许超过128,扩展名长度不允许超过20）
String fileName="test15.pdf";
// 网盘文件夹类型 （1 公司 2 个人 3 分享，目前暂不支持保存到分享文件夹）
Integer category=1;
// 文件路径 (绝对路径,必须以/ 开始 以文件名结束，最大支持嵌套层级 9)
String folderPath="/2023/04/10/合同";
// 是否自动迭代创建缺失文件路径 (默认false)
Boolean autoCreateDir=true;
// 是否允许以增量形式重命名文件名称 (例如：test.pdf->test(1).pdf 依次递增，默认 false)
Boolean allowReName=true;
// 越权操作，获取网盘管理员权限 （用于普通用户将文件保存到公司文件夹下 慎用！！！）
Boolean takeOwnership=false;
APIResult ret = Fx.netdisk.saveFileToDir(departmentIds, path, fileName, category, folderPath, autoCreateDir, allowReName, takeOwnership);
if (ret.isError()) {
log.info("error :"+ ret.message());
} else {
log.info(ret.getData());
}
Groovy举例
// 用户所属部门编号（可以为空，普通用户需要保存到部门文件夹时使用）
List<Integer>departmentIds;
// 需要保存到网盘的文件path（目前只支持企业文件，即以N_或TN_开头的文件）
String path="N_202304_10_f438201727394b018e62e0ba48b6f349.pdf";
// 文件名 （需要携带文件类型扩展名,文件名总长度不允许超过128,扩展名长度不允许超过20）
String fileName="test15.pdf";
// 网盘文件夹类型 （1 公司 2 个人 3 分享，目前暂不支持保存到分享文件夹）
Integer category=1;
// 文件路径 (绝对路径,必须以/ 开始 以文件名结束，最大支持嵌套层级 9)
String folderPath="/2023/04/10/合同";
// 是否自动迭代创建缺失文件路径 (默认false)
Boolean autoCreateDir=true;
// 是否允许以增量形式重命名文件名称 (例如：test.pdf->test(1).pdf 依次递增，默认 false)
Boolean allowReName=true;
// 越权操作，获取网盘管理员权限 （用于普通用户将文件保存到公司文件夹下 慎用！！！）
Boolean takeOwnership=false;
def (boolean error,Map data,String message) = Fx.netdisk.saveFileToDir(departmentIds, path, fileName, category, folderPath, autoCreateDir, allowReName, takeOwnership);
if (error) {
log.info("error:" + message)
} else {
log.info("data:" + data)
}