小编推荐

当多系统并行，且不共用一套文件存储服务时，可能会遇到历史文件多，迁移困难、开发工作量大等问题，如果仅仅是希望使用苍穹进行系统重构，但不使用自带的文件存储服务，需要如何处理呢？

别担心，接下来，小编手把手带你实现基于苍穹的阿里OSS扩展开发。

案例撰稿人：亚伟。

1 业务背景

客户使用金蝶云苍穹之前，有多套自研业务系统运行，这些业务系统共用一套阿里OSS（Object Storage Service）文件存储服务。因业务发展和技术更新，客户需将其中一套业务系统使用金蝶云·苍穹进行重构，但使用苍穹自带文件存储服务会产生以下问题：

1、历史文件较多，迁移困难；

2、其他业务系统对于文件的使用均需做开发调整，工作量很大。

客户期望使用苍穹重构的系统，文件存储服务不使用苍穹自带文件存储服务，继续使用阿里OSS。

2 解决方案

经分析，苍穹默认以磁盘文件的访问方式实现了文件存储服务，如果客户需要接入自己的文件存储，需做以下调整：

1、开发实现kd.bos.filestorage.spi.FileStorageService接口，重写upload、download、delete、exists、getInputStream等方法，在方法中自行实现OSS接口调用逻辑；FileStorageService接口方法说明如下所示：

上传图片

接口方法说明

2、通过MC(苍穹配置服务中心)基础数据维护/环境公共配置项(目录名称：/root/config/common/prop/attachmentServer.properties)，配置以下参数：

上传图片

参数说明

3 开发关键步骤

第一步，导入阿里SDK。阿里SDK获取链接：

https://help.aliyun.com/document_detail/32009.html?spm=a2c4g.32007.0.0.2f641146pq0JZ8。

第二步，启动类增加参数。相关代码示例如下：

System.setProperty("attachmentServer.fileStorage.className", " xxx.xxx.OssStorage");//附件存储实现类
    System.setProperty("imageServer.fileStorage.className", " xxx.xxx.OssStorage");//图片存储实现类
    System.setProperty("fileBucketName", "xx-files");//附件BucketName
    System.setProperty("imgBucketName","xx-images");//图片BucketName
    System.setProperty("OSSaccessKeyId", "xx");//AccessKey
    System.setProperty("OSSaccessKeySecret", "xx");//SecretKey
    System.setProperty("OSSendpoint", "https://oss-cn-hangzhou.aliyuncs.com");//Endpoint

第三步，反编译kd.bos.servicehelper.FileServiceFactory(开发本地调试使用)。本地环境debugserver启动后，进入测试单据后，注释掉FileServiceFactory.java文件中的代码，具体如下：

    // if (Instance.isLightWeightDeploy()){
//     return getLightFileService();//是否轻量级启动
// }

注：启动完成之前，先不要注释，也不要部署到该类服务器。

第四步，新增OSS实现类，实现kd.bos.filestorage.spi.FileStorageService接口，重写upload、download、delete、exists、getInputStream等方法，具体说明如下：

@Override
    public void setConfig(FileStorageConfig fileStorageConfig) {
        // 设置文件存储配置参数，创建OSSClient实例。https://help.aliyun.com/document_detail/32010.html?spm=a2c4g.123634.0.0.12c849bc4rjn7S
}
    @Override
    public List<String> getForbiddenExtensions() throws Exception {
            return new ArrayList<>();// 获取文件服务器禁止的文件扩展名集合
    }
    @Override
    public List<String> getAllowExtensions() throws Exception {
        return FileStorageService.super.getAllowExtensions();// 获取文件服务器允许的文件扩展名集合
    }

    @Override
    public String getTicket() throws Exception {
        return null; //获取文件服务器的TicketT
    }
    private String getBucketName(String filePath){
        return BucketName; //获取文件服务器的BucketName
    }
    @Override
    public String upload(InputStream inputStream, String filePath, String fileName, boolean b, Map<String, String> map) throws Exception {
        //参考阿里OSS上传文件代码实例，实现文件上传功能，https://help.aliyun.com/document_detail/84778.html?spm=a2c4g.32010.0.0.31a91cc8NFutbi
    }
    @Override
public InputStream getInputStream(String fullFilePath, String userAgent) throws Exception {
//参考阿里OSS下载文件代码实例，获取文件流，https://help.aliyun.com/document_detail/84822.html?spm=a2c4g.84778.0.0.548d6c3aqYB2tJ
    }
    @Override
    public void download(String fullFilePath, OutputStream outputStream, String userAgent) throws Exception {
//参考阿里OSS下载文件代码实例，实现文件下载功能，https://help.aliyun.com/document_detail/84822.html?spm=a2c4g.84778.0.0.548d6c3aqYB2tJ
    }
    @Override
    public void delete(String fullFilePath) throws Exception {
//参考阿里OSS删除文件代码实例，实现文件删除功能，https://help.aliyun.com/document_detail/84842.html?spm=a2c4g.84822.0.0.67e96d317JTKyP
    }
    @Override
    public boolean exists(String fullFilePath) throws Exception {
   //参考阿里OSS查询文件代码实例，实现文件查询功能，判断文件是否存在https://help.aliyun.com/document_detail/123634.html?spm=a2c4g.84842.0.0.7bda6341uL38Fr
    }
    @Override
    public void close() throws IOException {
        // 关闭OSSClient。
}

4 部署关键步骤

私有云部署步骤：

1、阿里SDK包部署（建议部署到trd文件夹，也可和二开代码一起打包部署）；

2、二开实现类代码部署；

3、MC参数配置，如下图所示：

上传图片

MC参数配置

4、阿里SDK包和二开实现类代码需在web和mservice同时部署，如下图所示：

上传图片

部署阿里SDK包和二开实现类代码

公有云部署步骤：

第一步，阿里SDK包和二开实现类一起打包部署；

第二步，MC参数配置(提单找公有云运维同事修改租户级参数)；

第三步，阿里SDK包和二开实现类代码需在web和mservice同时部署。

效果展示：

上传文件后，在【开发平台】→【附件明细列表】中可查看文件路径，苍穹自带文件服务器上传文件后，附件明细列表中保存的文件路径为加密后的路径，如图：

上传图片

附件明细列表加密后的路径

阿里OSS存储服务替换之后，“附件明细列表”中保存的文件路径为相对路径，如图所示：

上传图片

附件明细列表相对路径

查看阿里OSS文件服务器存储的文件，如图：

上传图片

查看阿里OSS文件服务器存储的文件

下载文件，如图所示：

上传图片

下载文件

5 方案的可复用价值

1、适用范围广

适用于所有想替换阿里OSS文件服务器的客户。

2、提高实施效率

替换存储服务，历史文件无需初始化，节约初始化时间，提升实施效率。

3、节约开发成本

客户无需对其他业务系统进行调整，节约开发成本。

6 注意事项

1、反编译的类kd.bos.servicehelper.FileServiceFactory，部署时，无需部署该代码；在本地环境debugserver启动后，进入测试单据，再注释掉FileServiceFactory.java文件中的代码，如下所示：

// if (Instance.isLightWeightDeploy()){
//     return getLightFileService();//是否轻量级启动
// }

2、部署时，代码需在web和mservice同时部署二开代码。

7 相关资料

详细部署步骤：

https://dev.kingdee.com/dev/market/detail/1905134500405336064

文件存储扩展开发：

https://developer.kingdee.com/article/216492885707690240?productLineId=29&isKnowledge=2

1分钟了解苍穹自定义文件存储服务：

https://mp.weixin.qq.com/s/s9QXo94fNeqGhOcpbEh4cg

阿里OSS SDK示例：

https://help.aliyun.com/document_detail/32006.html?spm=a2c4g.32007.0.0.2f641146ckOXvT

#往期推荐#

# 实践案例 | 苍穹RPA集成网银机器人，自动化执行网银业务

# 实践案例 | 引出单据体数据，助力快速校对

# 实践案例 | 一体化门户与应用平台，满足企业员工多样化工作管理需求

更多精彩内容，“码”上了解！↓

实践案例 | 手把手带你实现基于苍穹的阿里OSS扩展开发

实践案例 | 手把手带你实现基于苍穹的阿里OSS扩展开发

恭喜您！