Ueditor1.4.3.3+springMvc+maven 实现图片上传

前记：由于项目中需要有一个新增数据并且要能支持表格图片上传的功能。使用了ueditor控件。为实现这个功能，从一开始什么都看不懂，到一直连着弄了5天，总算是有了眉目。在此记录一下以便能帮到可以和我一样遇到问题的人！本人使用的是ueditor 1.4.3.3 的jsp 版本的。

首先下载ueditor 开发版 到本地目录

下载地址：http://ueditor.baidu.com/website/download.html



 下载后：


解压后：文件夹名字是  utf8-jsp，

解压后目录是：



为了能更好的根据自己的项目进行扩展，最好是引入ueditor 源码进行调试修改。当然也可以直接引入ueditor jar 包。但是这种方法不推荐，你无法调试，出了错误也很难定义问题。

下载源码：



下载后：


 解压后：名称是


解压后的目录为：



到此我们的准备工作就基本完成了，下面开始我们就要引入这些文件并且开始做一些配置了。

第一步：把下载的ueditor 1.4.3.3 的jsp版本的所有东西copy到你的项目的特定的目录下。

在我的项目中我是放在webapp/WEB-INF/scripts/MyEditor下



想实现ueditor 的图片上传功能，其实主要的配置文件有config.json,  ueditor.config.js 及你的页面和后台controller。

使用之前，我们需要先引入相关的jar 包和源码。 相关jar包在jsp/lib 下面。可直接在 utf8-jsp/jsp/lib 下看到



jar包引入：我的项目中是使用的maven管理jar包。 所以我直接在pom.xml 中添加相关的依赖。在此我们只需要添加前四个jar包即可。不需要添加ueditor-1.1.2.jar。因为ueditor-1.1.2.jar 是源码打包而来，我们引入源码后，就不需要引入此jar包了。



然后我们再来引入源码：源码的文件需要去ueditor-1.4.3.3\jsp\src  目录下copy.

把src下的所有东西copy到你的项目中的后台代码的位置。



前台页面部分：

首先要引入相关的js文件。



页面使用：ueditor 支持个性化定制。toolbars 是定义你需要的部分。如果不定义，则会调用ueditor.config.js中的toolbars配置。

下图中有一个window.UEDITOR_HOME_URL的配置，此路径是指你的相关js及css 文件存入的位置。请注意不要弄错，否则页面会报js错误，提示找不到相关文件

例如我把我的路径改为  window.UEDITOR_HOME_URL = "${jsUrl}/test/"; 页面报错为:


<div style="width:97%;padding-left:10px;">

<SCRIPT
id="myEditor" align="center" name="myEditor" type=text/plain></SCRIPT>
</div>



接下来看ueditor.config.js 这个文件里配置信息。 此文件中，有两个比较关键的地方，一个是URL, 一个是serverUrl. serverUrl是请求后台读取config.json配置文件的入口。一定不能配错。原生态的配置是  jsp/controller.jsp.   在此，controller.jsp 其实是一个java 文件。一定不能当成简单的jsp去理解。由于原生态的代码里，controller.jsp  和config.json 是在同一个目录下，所以此处serverUrl  用的是
 URL+"jsp/controller.jsp". 但是实际上我们的项目的java 代码可能不在此目录下，这就需要修改入口了。

修改前：



修改后：




上图中， getRootPath方法是获取你的项目的根目录。 例如在我的项目中， getRootPath 返回的就是 http://10.36.0.215:8080/lomsV5-web/  

我的项目名称是lomsV5-web

 

serverUrl 中的  jiKaiPiaoCommonSense 是要请求的controller 的映射。 config 是方法的名称

 

controller 文件：





config 方法即为查找并读取config.json文件信息。注意画红色线的部分有一个actionEnter的类。 

点击进入ActionEnter的构造方法， 你会发现有一个叫ConfigManager 的类，一步步查找会发现有一个getConfigPath的方法。

这个方法是获取config.json 文件存入的位置。 我的是放在web-inf 下的classes 下面  所以我的这个方法修改为：



然后我们打开config.json
文件。 此文件中imageActionName是指图片上传的action名称。 如果配置为uploadimage, 则是调用ueditor 本身原生态的上传方法。应该也是可以自定义自己的上传方法。 然后名称配置成自己的映射。（此问题本人还未测试）。 imageUrlPrefix 是访问路径的缀。 imagePathFormat 是你上传的文件要保存在哪里。



到了这里，那么你的配置已基本完成
http://10.36.0.215:8080/lomsV5-web/jiKaiPiaoCommonSense/config?action=config
在浏览器输入这个访问路径会出现一串json字符串，是我们在config.json 中配置的信息



下面主要是说一些在配置过程中可能会遇到的问题：

 1. 请求后台配置项http错误，上传功能将不能正常使用！

如果ueditor.config.js 中路径不对或是action名称不对，前台js会报此错误。例如我的修改为：   serverUrl: applicationPath + "/jiKaiPiaoCommonSense/test"





解决办法：自己添加一个过滤器，对上传的url进行过滤



在application-context.xml
中配置这个过滤器。过滤器名称不能修改否则不能识别。



4.  无效的Action

当config.json 中imageActionName 配置不正确时会出现此问题。如我的项目中把 "imageActionName": "uploadimage", /* 执行上传图片的action名称 */

修改为： "imageActionName": "test", /* 执行上传图片的action名称 */   则出现此问题



5. 图片上传后显示不了。

这是因为图片访问路径配置不对。例如我的配置是如下：

"imageUrlPrefix": "/lomsV5-web", /* 图片访问路径前缀 */

"imagePathFormat": "/WEB-INF/images/jkpCategory/{time}{rand:6}", /* 上传保存路径,可以自定义保存路径和文件名格式 */

我的本意是想图片上传后保存在http://10.36.0.215:8080/lomsV5-web/WEB-INF/images/jkpCategory/ 下面。 但是访问图片的时候由于我前台做了映射，所以访问的时候应该是   http://10.36.0.215:8080/lomsV5-web/img/jkpCategory/xx.jpg  才能访问到。   如果只是这样配置会出现上传后图片无法访问。 



解决此问题的方法是：

代码跟踪到BinaryUploader  的 save 方法的 80行，你会发现这里有保存一个url的值。 这个url 便是访问图片的路径的值。 需要修改成正常的访问路径便能正常显示。



所以我的本地修改为：  

storageState.putInfo("url", PathFormat.format(savePath.substring(8, savePath.length()).replace("images", "img")));

 

到了这里，图片便可正常上传访问



另外需要注意的是： 当你在本地开发完成后，把相应代码部署到服务器上后需要修改的是。

1. 项目名称修改为你服务器上项目。 例如，我本地工程名称是  lomsV5-web.  但是服务器上却是 bms.  注意修改。



 2.
 要正常使用功能。请先清除浏览器缓存。 本人使用的是chrome 浏览器。 因为首次访问项目，浏览器会下载相关的js文件。当第二次再访问时，即使你修改了部分js代码，也是不会起作用的。 必须要先清除浏览器缓存，使其重新下载。 否则会出现以下问题(请求后台配置项http错误，上传功能将不能正常使用！)



 3.
  起初出现上面第二的问题的时候，我以为是js引入有问题， 于是把ueditor.all.min.js 文件的引入去掉了，于是出现了UE.getEditor is not a function的问题。


不断的发现问题，解决问题并且记录下这些问题，以便能帮到和我一样遇到同样的问题的人。

问题一：web保存的数据（文字和图片相结合的软文）， 在我们的app上，不能正常显示图片。 

问题出现原因： a.  你的项目有权限验证。 而且你上传了这些图片后，并未给相应的路径赋查看的权限。 例如，在我的项目中，我们是shiro 框架来验证权限的。我上传图片的路径是   "/WEB-INF/images/jkpCategory/uploadimage/。。。。。 “   ， 那么在shiro的配置文件中需要增加权限 。在applicationContext-shiro.xml中添加如下配置。



b.  也许你添加了这个权限后，app端的图片依然不能正常显示。 那就要查看你的数据库中保存的图片的数据src 属性的路径是否正确。 这里就不得不再提下config.json的重要性了。
这个配置文件很重要。要引起重视。  你可以发现在每一荐的图片的配置荐中都有一个 *prefix  的配置。 这是配置图片上传路径前缀的。可配相对路径，也可配置绝对路径。选择配置相对路径的话，你在web查看 内容是没有影响的。 但是，在app端不能正常显示了， 因为传到app端的数据的src 属性是 src="/bms/.....jpg".  而真正的我们要保存成src="http://www....:host/bms/...jpg".   那么我们要修改config.json 中  *prefix 的配置项。



 问题二：从网上直接复制的新闻或是软文中的图片不能正常显示。
这个问题要关注config.json中这一部分的配置。



还要关注ImageHunter.java
的第95行。 这个url是前台访问网络复制过来的图片的地址。 我这个是针对自己的项目而修改的。