微服务迁移记（五）：WEB层搭建(5)-集成ueditor编辑器，伪分布式图片上传

一、redis搭建

二、WEB层主要依赖包

三、FeignClient通用接口

以上三项，参考《微服务迁移记（五）：WEB层搭建(1)》

四、SpringSecurity集成

参考：《微服务迁移记（五）：WEB层搭建(2)-SpringSecurity集成》

五、FreeMarker集成

参考：《微服务迁移记（五）：WEB层搭建(3)-FreeMarker集成》

六、简单权限管理

参考：《微服务迁移记（五）：WEB层搭建(4)-简单的权限管理》

七、集成多功能编辑器：ueditor，实现应用将图片等附件保存到应用外

对于一款MIS系统、CMS系统等，一多功能编辑器是必不可少的组件。目前用的比较多的有百度的ueditor、ckeditor等。本文将详细介绍集成ueditor的过程。

1. 下载ueditor

官网地址：http://ueditor.baidu.com/website/，下载utf8 jsp版本。

解压后删除jsp目录，然后拷到/resources/static/ueditor_1_4_3_3

2. 必要的包导入

注意：com.gitee.qdbp.thirdparty这个是一哥们扔到码云上的，可以直接拿来用。你也可以把源代码导出来放到自己项目中进行重构。

 <dependency>
            <groupId>commons-fileupload</groupId>
            <artifactId>commons-fileupload</artifactId>
            <version>1.4</version>
        </dependency>
        <dependency>
            <groupId>commons-codec</groupId>
            <artifactId>commons-codec</artifactId>
        </dependency>
        <dependency>
            <groupId>com.gitee.qdbp.thirdparty</groupId>
            <artifactId>ueditor</artifactId>
            <version>1.4.3.3</version>
        </dependency>

3. 前台html集成

<script type="text/javascript" charset="utf-8" src="/ueditor1_4_3_3/ueditor.config.js"></script>
<script type="text/javascript" charset="utf-8" src="/ueditor1_4_3_3/ueditor.all.min.js"></script>
<!--可选-->
<script type="text/javascript" src="/ueditor1_4_3_3/lang/zh-cn/zh-cn.js"></script>

$(function () {
        //ueditor初始化
        var um = UE.getEditor('article_content',{
            textarea:"article_content"
        });
        um.ready(function(){
            um.setContent('${article.article_content}');
        });
});

通过上面3个步骤，打开页面后，可以看到编辑器已经可以用了。但是图片、附件上传功能不可用，需要再做额外配置。

4. 文件上传配置

先看下官方示例,ueditor.config.js指定配置URL地址为jsp/controller.jsp，再由jsp/controller.jsp指定config.json的路径，在config.json里配置上传路径等信息。

明白这个原理后，我们就可以把URL地址改成任意我们定义的一个controller。

新建UeditorController，映射访问地址为：/ueconfig，然后我们把ueditor.config.js里的URL改为这个地址

// 服务器统一请求接口路径
 serverUrl:  "/ueconfig"

 控制器中，我们模仿官方示例编写如下代码：

@RequestMapping("/ueconfig")
    public void config(String action,HttpServletRequest request, HttpServletResponse response){
        response.setContentType("application/json");
        String rootPath = request.getSession().getServletContext().getRealPath("/");try {
            String exec = new ActionEnter(request, rootPath).exec();
            PrintWriter writer = response.getWriter();
            writer.write(exec);
            writer.flush();
            writer.close();
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

基本上到这里，我们把config.js拷到resources根目录下，就可以实现附件上传了。

我们再考虑一个问题：最终项目我是要打成war包发布到服务器，附件肯定不能放到项目目录，我们可以将附件放到磁盘目录下，每次访问附件时，需要再转换一下，这样还是比较麻烦，还需要改ueditor源码实现图片显示、在线管理等。

本人比较懒，一直不想把第三方源码导到项目里，灵机一动想了一个偷懒的办法： 

1）本地先扔一个tomcat，端口号：8081，在webapp下新建一个目录zyproject，启动后访问路径就是：http://127.0.0.1/zyproject

2）断点源码后发现，每次初始化编辑器，先访问ueconfig的时候，会传一个action过来，action可能有config（配置config.json路径）、listfile、listimage（这两个是ue编辑器在线管理显示已上传附件列表用的，后面会用到）。

我把config.json里，所有Prefix都加上一个前缀：http://127.0.0.1/zyproject。

如："imageUrlPrefix": "http://127.0.0.1:8081/zyproject", /* 图片访问路径前缀 */

config.json我也扔到附件的外部tomcat下了，所以在分布式配置中心加一条记录

INSERT INTO tb_config_server(akey,avalue,application,aprofile,label)
VALUES ('filePath','D:\tomcat\webapps\zyproject','zyproject-web','dev','dev');

这样以后，所有上传、涂鸦等均无问题了。但仍然存在另一个问题，就是在线管理，uedtiro会将所有上传的图片或附件列表展示出来，供选择插入内容中。跟踪代码发现，在线管理会自动把rootPath也加到列表附件的路径中，比如一个图片路径是：http://127.0.0.1/zyproject/upload/ueditor/editor/20200301/1583058554450067578.png，在线管理会解释成这样：

http://127.0.0.1/zyproject/D:/tomcat/webapps/zyproject/upload/ueditor/editor/20200301/1583058554450067578.png，造成图片查询不到，于是对UeditorController改造如下(把rootPath给替换掉)：

 @Value("${filePath}")
    private String filePath;

    @RequestMapping("/ueconfig")
    public void config(String action,HttpServletRequest request, HttpServletResponse response){
        response.setContentType("application/json");
        //String rootPath = Thread.currentThread().getContextClassLoader().getResource("").getPath();
        String rootPath = filePath;
        try {
            String exec = new ActionEnter(request, rootPath).exec();
            //解决ueditor 列出文件或图片，会把rootpapth加上的问题
            if( action!=null &&
                    (action.equals("listfile") || action.equals("listimage") ) ){
                rootPath = rootPath.replace("\\", "/");
                exec = exec.replaceAll(rootPath, "");
            }
            PrintWriter writer = response.getWriter();
            writer.write(exec);
            writer.flush();
            writer.close();
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

最终效果如下：