KindEditor插件之图片上传
前序:由于工作需要使用在线编辑器,找了几个对比了下KindEditor还是不错的,国产的.但文档还是不全,还好能参考官方插件,套出来一些插件.本文章分为4个部分,分别介绍图片上传插件、代码高亮插件、引用文本以及附件插件的制作。网上大部分都是直接或改官方的JSP文件，连action都没有用，太不专业了。在上传附件或图片的时候写action上传不了居然还将web.xml中的<url-pattern>/*</url-pattern>换为：<url-pattern>*.action</url-pattern>这样以来势必会影响到其他地方。本文主要讲解插件的详细制作过程以及问题的处理，均为结合Struts2的标准方式，绝无什么水货处理方式！
KindEditor官方:http://www.kindsoft.net/
KindEditor4.0测试版Demo:http://www.kindsoft.net/ke4/php/demo.php
注意：KindEditor官方4.0下月发布正式版，已经有了代码高亮、附件上传等插件，如果你能等的话就暂扫一下我的文章就可以了！！！
KindEditor插件之图片上传
第一步是什么呢？当然是参考官方的图片上传DEMO！
在下载的包中找到jsp/demo.jsp打开看下源码，直接粘到你的页面中吧！注意js，css等路径就行了。fileManager这个是浏览远程图片的，基本没人用这个吧？没什么意义，所以关掉吧！
看下我的：
<%@ page language="java" import="java.util.*" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<%
String path = request.getContextPath();
String basePath = request.getScheme() + "://"+ request.getServerName() + ":" + request.getServerPort()+ path + "/";
%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<head>
<base href="<%=basePath%>">
<title>KindEditor示例</title>
<link rel="shortcut icon" type="image/x-icon" href="./favicon.png" />
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta http-equiv="pragma" content="no-cache">
<meta http-equiv="cache-control" content="no-cache">
<meta http-equiv="expires" content="0">
<script src="<%=basePath%>js/jquery.js" type="text/javascript"></script>
<script src="<%=basePath%>js/kindeditor.js" type="text/javascript"></script>
<script type='text/javascript'>
<!--
$(document).ready(function(){
KE.show({
id : 'content',
resizeMode : 1,
shadowMode : false,
allowPreviewEmoticons : false,
allowUpload : true,
syncType : 'auto',
urlType : 'domain',
cssPath : 'css/ke.css',
imageUploadJson : '<%=basePath%>fileUpDown/onUploadImg.do',
items : [ 'bold', 'italic', 'underline', 'strikethrough',
'removeformat', '|', 'insertorderedlist',
'insertunorderedlist', '|', 'textcolor', 'bgcolor',
'fontname', 'fontsize', '|', 'link', 'unlink',
'emoticons', 'code', 'image', 'flash', 'quote',
'attach', '|', 'selectall', 'source', 'about' ],
afterCreate : function(id) {
KE.event.ctrl(document, 13, function() {
if(KE.isEmpty('content')){
alert('文章为空');
}else{
KE.util.setData(id);
document.forms['editform'].submit();
}
});
KE.event.ctrl(KE.g[id].iframeDoc, 13, function() {
if(KE.isEmpty('content')){
alert('文章为空');
}else{
KE.util.setData(id);
document.forms['editform'].submit();
}
});
}
});
});
var check={
form_submit:function(){
if(KE.isEmpty('content')){
alert('文章为空');
return false;
}else{
return true;
}
}
};
//-->
</script>
</head>
<body>
<form id="editform" name="editform" action="article/showDemo_DemoEditContent.do" method="post" onsubmit="return check.form_submit();">
<textarea id="content" name="content" style="width: 580px; height: 250px; visibility: hidden;"></textarea>
<br />
您当前输入了
<span id="word_count1">0</span> 个文字。（字数统计包含HTML代码。）
<br />
您当前输入了
<span id="word_count2">0</span> 个文字。（字数统计包含纯文本、IMG、EMBED，不包含换行符，IMG和EMBED算一个文字。）
<br />
<button id="id_submit">
提交
</button>(提交快捷键: Ctrl + Enter)
<br />
<input type="button" name="button" value="取得HTML" onclick="javascript:alert(KE.html('content'));" />
<input type="button" name="button" value="判断是否为空" onclick="javascript:alert(KE.isEmpty('content'));" />
<input type="button" name="button" value="取得文本" onclick="javascript:alert(KE.text('content'));" />
<input type="button" name="button" value="取得文本(包含img,embed)"
onclick="javascript:alert(KE.util.getPureData('content'));" />
<input type="button" name="button" value="取得选中HTML" onclick="javascript:alert(KE.selectedHtml('content'));" />
<br />
<br />
<input type="button" name="button" value="设置HTML"
onclick="javascript:KE.html('content', '<h3>Hello KindEditor</h3>');" />
<input type="button" name="button" value="设置文本"
onclick="javascript:KE.text('content', '<h3>Hello KindEditor</h3>');" />
<input type="button" name="button" value="插入HTML"
onclick="javascript:KE.insertHtml('content', '<strong>测试内容</strong>');" />
<input type="button" name="button" value="添加HTML"
onclick="javascript:KE.appendHtml('content', '<strong>Append HTML</strong>');" />
<input type="button" name="button" value="清空内容" onclick="javascript:KE.html('content', '');" />
</form>
</body>
</html>
imageUploadJson的参数action这个我们还没有写呢！不要着急，如果你急的已经部署打开了该页面你会发现缺了三个图标，那是我们以后文章中实实在在写的三个插件的图标。
cssPath : 'css/ke.css' 这个是编辑器内容里的一些自定义的样式，比如我们要写引用文本插件，代码高亮插件的时候就用得着了！暂时别急，写上了就写上了也没什么问题。我们稍后完成！
第二步写我们的重中之重的action：
首先声明下我访问action的时候结尾不是以action结尾的，我是以do结尾的(你喜欢什么就配什么,改不改无所谓!菜鸟别纠结这个问题)，在struts中怎么配置为.do结尾滴呢?
顺便给菜鸟补下课:
在src根目录下创建struts.properties文件,内容为:struts.action.extension=do即可大功告成!!!哇哈哈,简单嘛?
然后参考解压包jsp/upload_json.jsp，接下来我们要将其转换成action
第一步直接写类吧:
怎么写?为什么有人说拿不到request的任何参数?还说是KindEditor或Struts2的Bug?污蔑!纯属污蔑,误人子弟的人们最可恨!
废话下:struts2对文件上传进行了包装,也就是说你可以直接拿到页面中的file!不需要像写Servlet那样写了!
好直接复制upload_json.jsp的代码到action中吧?然后改改?
我们要记得在struts2中action获取文件的时候: 页面<input type="file" name="imgFile">(哪里来的这个?参看你下载官方压缩包中的:plugins\image\image.html)
那么action类属性就应当为:
action属性
1 private File imgFile;
2 /**
3 * 文件名称
4 */
5 private String imgFileFileName;
6
7 /**
8 * 图片宽度
9 */
10 private String imgWidth;
11
12 /**
13 * 图片高度
14 */
15 private String imgHeight;
16
17 /**
18 * 图片对齐方式
19 */
20 private String align;
21
22 /**
23 * 图片标题
24 */
25 private String imgTitle;
其他的属性还是和原来action中的写法一样,哪里不一样呢?再给菜鸟补下课:
取文件名的话你的属性要这么写:页面file对象的name+FileName
取文件类型的话你的属性要这么写:页面file对象的name+ContentType
别忘了你的getter\setter方法!!!要不然你真死了都拿不到值!(纯属废话,我咋那么多废话?)
action的具体方法请看:
action的具体方法
1 public String uploadImg() {
2
3 response.setContentType("text/html; charset=UTF-8");
4 // 文件保存目录路径
5 String savePath = ServletActionContext.getServletContext().getRealPath("/") +"attached/";
6 // 文件保存目录URL
7 String saveUrl = request.getContextPath() +"/attached/";
8 // 定义允许上传的文件扩展名
9 String[] fileTypes =new String[] { "gif", "jpg", "jpeg", "png", "bmp" };
10 // 最大文件大小
11 long maxSize = getMaxSize(Constant.FILE_SIZE_IMG);
12 PrintWriter out =null;
13 try {
14 out = response.getWriter();
15 } catch (IOException e1) {
16 log.error(e1);
17 }
18
19 if (imgFile ==null) {
20 out.println(getError("请选择文件。"));
21 returnnull;
22 }
23
24 // 检查目录
25 File uploadDir =new File(savePath);
26 if (!uploadDir.isDirectory()) {
27 out.println(getError("上传目录不存在。"));
28 returnnull;
29 }
30 // 检查目录写权限
31 if (!uploadDir.canWrite()) {
32 out.println(getError("上传目录没有写权限。"));
33 returnnull;
34 }
35 // 创建文件夹
36 SimpleDateFormat sdf =new SimpleDateFormat("yyyyMMdd");
37 String ymd = sdf.format(new Date());
38 savePath += ymd +"/";
39 saveUrl += ymd +"/";
40 File dirFile =new File(savePath);
41 if (!dirFile.exists()) {
42 dirFile.mkdirs();
43 }
44 String fileExt = imgFileFileName.substring(imgFileFileName.lastIndexOf(".") +1).toLowerCase();
45 if (!Arrays.<String> asList(fileTypes).contains(fileExt)) {
46 out.println(getError("上传文件扩展名["+ fileExt +"]是不允许的扩展名。"));
47 returnnull;
48 }
49 if (imgFile.length() > maxSize) {
50 out.println(getError("[ "+ imgFileFileName +" ]超过单个文件大小限制，文件大小[ "+ imgFile.length() +" ]，限制为[ "+ maxSize +" ] "));
51 returnnull;
52 }
53 SimpleDateFormat df =new SimpleDateFormat("yyyyMMddHHmmss");
54 String newFileName = df.format(new Date()) +"_"+new Random().nextInt(1000) +"."+ fileExt;
55 File uploadedFile =new File(savePath, newFileName);
56 try {
57 FileUtil.Copy(imgFile, uploadedFile);
58 JSONObject obj =new JSONObject();
59 obj.put("error", 0);
60 obj.put("url", saveUrl + newFileName);
61 log.debug(obj);
62 out.println(obj.toString());
63 log.debug("上传图片:["+ uploadedFile.getName() +"]"+">>>["+ newFileName +"]成功");
64 } catch (IOException e) {
65 log.error("图片上传失败:"+ e);
66 }
67 returnnull;
68 }
69 private String getError(String message) {
70 JSONObject obj =new JSONObject();
71 obj.put("error", 1);
72 obj.put("message", message);
73 log.debug(obj);
74 return obj.toString();
75 }
然后你问我:getMaxSize(Constant.FILE_SIZE_IMG);哪来的,不好意思我有个配置文件里放的图片文件限制大小.
如果你想上传2M的文件那么就应当为:2*1024*1024
FileUtil.Copy(imgFile, uploadedFile);同理,就是个拷贝文件的方法而已没有什么大不同,这里还牵扯到文件上传的一个经典问题!
有人说临时文件没有删掉或struts报临时文件的错误.别急一会一起解决掉!
如果你写到这就着急的运行鸟,那么你伤心的看着404页面吧....
最后一步:配置struts
1.记得我们刚才改action的访问后缀了吗?继续在刚才的struts.properties中加入:
upload配置
1 ### Parser to handle HTTP POST requests, encoded using the MIME-type multipart/form-data
2 # struts.multipart.parser=cos
3 # struts.multipart.parser=pell
4 struts.multipart.parser=jakarta
5 # uses javax.servlet.context.tempdir by default
6 struts.multipart.saveDir=c:\\temp
7 # -1 nolimit
8 struts.multipart.maxSize=-1
最后一个是上传文件大小,因为我们在action中配置的,所以这里就直接不限制了.默认2M
中间的是临时文件存放目录,我们随便配吧,默认空所以就跑到你的tomcat下了.
第一个...你想让我解释嘛?我X你!X完了就告诉你,那个是说你用什么组件来实现上传功能!支持commons-fileupload就是默认的jakarta,cos很出名,另一个偶土了没听说过.
然后我们忘了我们的action还没有配置呢!
<action name="onUploadImg" class="xxx.x.UploadAction" method="uploadImg"></action>
我直接指定method方法了...当然你也可以直接默认execute...随你,最基础的东西.
