苍穹平台默认通过云盘模式预览文件，私有云客户需要准备一台Window Server，安装Office软件并部署转换插件，才能实现云盘模式的文件预览。

为了实现文件预览的灵活性，苍穹提供了文件预览二开的方式，可以对预览实现逻辑进行定制化开发，比如某客户通过对接在线预览服务，实现WPS预览的二次开发。

接下来，小编将通过“开发流程”和“MC参数配置”两个方面，带领大家开启“文件预览二开流程”的学习之旅。

1 开发流程

Step1 实现基类

实现基类的操作代码如下所示：

implements kd.bos.fileservice.preview.PreviewService

Step2 基类初始化

基类初始化的代码如下所示：

1 //实例化时会把当前文件服务实例传进来,供进行文件上传下载等操作，需要自己实现赋值
2    public void init(FileService fileService) {
3        this.fileService = fileService;
4    }

Step3 确认预览方式

目前苍穹支持的文件预览方式有“流式预览方式”和“WPS预览方式”两种。

流式预览方式：输出文件转换后的“PDF流”到浏览器渲染展示（云盘模式使用此预览方式）。

WPS预览方式：输出“URL”到前端并打开，以预览指定页面。

Step4 流式预览方式和WPS预览方式的二开实现

“流式预览方式”二开要实现“preview”和“previewFromCache”两个方法，方法介绍如下：

 1public Map<String, Object> preview(String fileName, String path, String userAgent) {
 2//fileName文件名；path文件存储路径；    该方法在预览保存后的文件时触发
 3
 4}
 5public Map<String, Object> previewFromCache(String fileName, String path, String userAgent, InputStream cacheIn) {
 6//cacheIn文件流；    该方法在预览刚上传的临时文件时触发
 7}
 8
 9//失败返回格式：
10    Map<String, Object> previewResult = new HashMap();   
11    Map<String, Object> desc = new HashMap();
12    previewResult.put(PreviewParams.STATUS.getEnumName(), PreviewParams.ERROR.getEnumName());
13    previewResult.put(PreviewParams.RESULT.getEnumName(), desc);  
14    result.put(PreviewParams.STATUS.getEnumName(), PreviewParams.ERROR.getEnumName());
15    result.put(PreviewParams.DESCRIPTION.getEnumName(), description);
16
17//成功返回格式：
18    //1、需要转换的返回转换后的流
19      previewResult.put(PreviewParams.STATUS.getEnumName(), PreviewParams.PDF_SUCCESS.getEnumName());
20      previewResult.put(PreviewParams.RESULT.getEnumName(), in);
21   //2、不需要转换的直接返回原来流
22    previewResult.put(PreviewParams.STATUS.getEnumName(), PreviewParams.NOT_NEED_CHANGE.getEnumName());
23    previewResult.put(PreviewParams.RESULT.getEnumName(), in);
24    if ("txt".equalsIgnoreCase(ext)) {
25         previewResult.put(PreviewParams.CHARSET.getEnumName(), FileUtil.getFilecharsetNew(in));//可以通知浏览器以什么编码展示txt文件
26    }

“WPS预览方式”二开要实现“previewWPS”和“previewFromCacheWPS”两个方法，方法介绍如下：

1public Map<String, Object> previewWPS(String fileName, String path, String userAgent, Map<String, String> config) { 
 2    //fileName文件名；path文件存储路径；config系统配置页面中配置的参数；    该方法在预览保存后的文件时触发
 3}
 4
 5public Map<String, Object> previewFromCacheWPS(String fileName, String path, String userAgent, InputStream cacheIn, Map<String, String> config) {
 6        //cacheIn文件流    该方法在预览刚上传的临时文件时触发
 7}
 8
 9//失败返回格式：
10          Map<String, Object> result = new HashMap();
11          result.put(PreviewParams.STATUS.getEnumName(), PreviewParams.ERROR.getEnumName());
12          result.put(PreviewParams.DESCRIPTION.getEnumName(), description);
13
14//返回成功的格式：
15    //1、需要转换的返回转换后的流
16      previewResult.put(PreviewParams.STATUS.getEnumName(), PreviewParams.URL.getEnumName());
17      previewResult.put(PreviewParams.RESULT.getEnumName(), url);
18
19    //2、不需要转换的直接返回原来流
20    previewResult.put(PreviewParams.STATUS.getEnumName(), PreviewParams.NOT_NEED_CHANGE.getEnumName());
21    previewResult.put(PreviewParams.RESULT.getEnumName(), in);
22    if ("txt".equalsIgnoreCase(ext)) {
23         previewResult.put(PreviewParams.CHARSET.getEnumName(), FileUtil.getFilecharsetNew(in));//可以通知浏览器以什么编码展示txt文件
24    }