Java Web项目中整合FCKeditor
一、初识FCKeditor
FCKeditor在网上大名鼎鼎，是一个受关注非常高的开源项目，并且能够跨浏览器支持。因此我选择FCKeditor。FCKeditor的最新版本是2.6.3，大家可以到http://www.fckeditor.net/download这里下载
下载并解压缩到fckeditor文件夹，打开该文件夹，我们可以看到如下文件及目录：
其中_samples目录下是示例，_testcases目录下是测试用例，editor目录下是编辑器的主要文件；此外，从该目录中的文件不难看出，FCKeditor提供支持asp、php、perl、python等等各种服务器技术的版本，但不支持.net和Java Web。不过不要担心，FCKeditor与Java Web之间的整合早就有人做好了，稍后我们就会用到。
了解浏览器技术的人都不难想到，Web编辑器其实应该是客户端技术，它是通过JavaScript来控制页面上的元素和通过弹出窗口来模拟对话框而做到的；只有在提交文章或者上传文件的时候才需要跟服务器端交互。因此，要将该编辑器快速整合到项目中以看到效果，是非常简单的。
二、使用JavaScript整合FCKeditor
将刚刚解压得到的fckeditor目录拷贝到我们的项目中的WebRoot目录下，打开index.jsp，加入如下代码：
<script src = "fckeditor/fckeditor.js" ></script>
<script language = "javascript">
window.onload =function () {
var oFCKeditor = new FCKeditor('myTextArea');
oFCKeditor.BasePath=" fckeditor/";
oFCKeditor.ReplaceTextarea();
}
</script>
在这里，第一行代码是引入fckeditor中的fckeditor.js文件，其中定义了FCKeditor类，第四行就是利用该类创建一个编辑器对象，而myTextArea是表单中文本区域的名字，在第六行，通过FCKeditor类的ReplaceTextArea方法，文本区域就被替换成了Web编辑器。
FCKeditor类提供几个基本属性，可以让我们对编辑器进行简单的控制，它们是：
InstanceName：返回编辑器示例的名字
Width：设置编辑器的宽度，默认为100%
Height：设置编辑器的高度，默认值为200
ToolbarSet：设置编辑器的工具条集合，默认值为"default"，稍后会讲到怎样自定义工具条
Value：设置显示在编辑器中的内容（包含HTML），默认值为空
BasePath：编辑器的目录，一定要设置正确，否则编辑器会找不到它需要的文件，在本例中，由于我们直接将fckeditor目录放到项目的根目录下，因此设置为"fckeditor/"
CheckBrowser：设置是否检测浏览器，默认为true
DisplayErrors：设置是否显示错误信息，默认为true
此外，FCKeditor类还有一个集合属性Config[ key ] = value，通过该集合属性，我们可以进行一个更高级的设置，如设置默认语言、更换皮肤等等。
综上所述，下面的代码将重新设置编辑器的高和宽、将工具条设置为基本工具条，将皮肤设置为office2003样式：
<script src="fckeditor/fckeditor.js"></script>
<script language="javascript">
window.onload = function(){
var oFCKeditor = new FCKeditor( 'myTextArea' ) ;
oFCKeditor.BasePath = "fckeditor/";
oFCKeditor.Width = "800";
oFCKeditor.Height = "300";
oFCKeditor.ToolbarSet = "Basic";
oFCKeditor.Config["SkinPath"] = "skins/office2003/";
oFCKeditor.ReplaceTextarea();
}
</script>
三、通过FCKeditor.java整合FCKeditor
使用JavaScript整合FCKeditor，我们很快就能看到编辑器的效果，并进行文章的编辑。但是，在需要和服务器端进行交互的时候（比如上传图片），就会出错。因此，我们不得不在服务器端做一点手脚。这里，我们需要使用的是FCKeditor.java，其最新版本是2.3，还是在刚才的下载页面，找到下载链接，如下图：
将下载文件解压，我们可以看到有doc目录，有src目录，甚至还有一个build.xml，让我们可以重新构建项目；但是，这些我们统统都不需要，我们只要web\WEB-INF目录下的东西，在这个目录下，提供了一个web.xml，同时在lib目录下提供了两个.jar文件，这便是全部。看到这里，大家肯定能够想到，Java Web项目的灵魂是什么？那就是web.xml。我们所要做的，就是把lib目录下的两个.jar文件拷贝到我们项目的src/main/webapp/WEB-INF/lib下，同时将web.xml中的内容整合到我们项目的WebRoot/WEB-INF/web.xml中。
web.xml中的内容很简单，只定义了两个Servlet映射，并且对上传文件的目录和允许哪些文件上传、拒绝哪些文件上传做了设置，如下：
<
servlet
>
<
servlet-name
>Connector
</
servlet-name
>
<
servlet-class
>com.fredck.FCKeditor.connector.ConnectorServlet
</
servlet-class
>
<
init-param
>
<
param-name
>baseDir
</
param-name
>
<
param-value
>/UploadFiles/
</
param-value
>
</
init-param
>
<
init-param
>
<
param-name
>debug
</
param-name
>
<
param-value
>true
</
param-value
>
</
init-param
>
<
load-on-startup
>1
</
load-on-startup
>
</
servlet
>
<
servlet
>
<
servlet-name
>SimpleUploader
</
servlet-name
>
<
servlet-class
>com.fredck.FCKeditor.uploader.SimpleUploaderServlet
</
servlet-class
>
<
init-param
>
<
param-name
>baseDir
</
param-name
>
<
param-value
>/UploadFiles/
</
param-value
>
</
init-param
>
<
init-param
>
<
param-name
>debug
</
param-name
>
<
param-value
>true
</
param-value
>
</
init-param
>
<
init-param
>
<
param-name
>enabled
</
param-name
>
<
param-value
>true
</
param-value
>
</
init-param
>
<
init-param
>
<
param-name
>AllowedExtensionsFile
</
param-name
>
<
param-value
></
param-value
>
</
init-param
>
<
init-param
>
<
param-name
>DeniedExtensionsFile
</
param-name
>
<
param-value
>php|php3|php5|phtml|asp|aspx|ascx|jsp|cfm|cfc|pl|bat|exe|dll|reg|cgi
</
param-value
>
</
init-param
>
<
init-param
>
<
param-name
>AllowedExtensionsImage
</
param-name
>
<
param-value
>jpg|gif|jpeg|png|bmp
</
param-value
>
</
init-param
>
<
init-param
>
<
param-name
>DeniedExtensionsImage
</
param-name
>
<
param-value
></
param-value
>
</
init-param
>
<
init-param
>
<
param-name
>AllowedExtensionsFlash
</
param-name
>
<
param-value
>swf|fla
</
param-value
>
</
init-param
>
<
init-param
>
<
param-name
>DeniedExtensionsFlash
</
param-name
>
<
param-value
></
param-value
>
</
init-param
>
<
load-on-startup
>1
</
load-on-startup
>
</
servlet
>
<
servlet-mapping
>
<
servlet-name
>Connector
</
servlet-name
>
<
url-pattern
>/fckeditor/editor/filemanager/browser/default/connectors/jsp/connector
</
url-pattern
>
</
servlet-mapping
>
<
servlet-mapping
>
<
servlet-name
>SimpleUploader
</
servlet-name
>
<
url-pattern
>/fckeditor/editor/filemanager/upload/simpleuploader
</
url-pattern
>
</
servlet-mapping
>
请注意，这两个servlet的url-pattern我都在原来代码的前面加上了/fckeditor。
然后，我们就可以抛开JavaScript，而在服务器端使用标签来创建Web编辑器了。先在EditPosts.jsp中引入标签库：
<%
@ taglib uri="http://fckeditor.net/tags-fckeditor" prefix="FCK"
%>
再在原来放textarea的地方，放如下代码：
<
FCK:editor
id
="EditorDefault"
basePath
="/Test/fckeditor/"
imageBrowserURL
="/Test/fckeditor/editor/filemanager/browser/default/browser.html?Type=Image&Connector=connectors/jsp/connector"
linkBrowserURL
="/Test/fckeditor/editor/filemanager/browser/default/browser.html?Connector=connectors/jsp/connector"
flashBrowserURL
="/Test/fckeditor/editor/filemanager/browser/default/browser.html?Type=Flash&Connector=connectors/jsp/connector"
imageUploadURL
="/Test/fckeditor/editor/filemanager/upload/simpleuploader?Type=Image"
linkUploadURL
="/Test/fckeditor/editor/filemanager/upload/simpleuploader?Type=File"
flashUploadURL
="/Test/fckeditor/editor/filemanager/upload/simpleuploader?Type=Flash"
>
This is some
<
strong
>sample text
</
strong
>. You are using
<
a
href
="http://www.fredck.com/fckeditor/"
>FCKeditor
</
a
>.
</
FCK:editor
>
这里有一点一定要注意，那就是这里的属性都要避免使用相对路径。
刷新页面，又见编辑器，此时，可以顺利的上传文件了。
以上文章是从别处偷来的，原文地址如下http://www.blogjava.net/vjame/archive/2008/09/05/227257.html，感谢作者。这里只是为了自己将来寻找起来更方便一点。
结合书上，总结如下几点，具体分如下几步走
1>将FCKeditor所需的两个Jar包复制到WEB-INF/lib下
2>将FCKeditor所需的标签库复制到WEB-INF/lib
3>将FCKeditor所需的fckconfig.js 、fckeditor、fckstyles.xml和fcktemplates.xml四个文件复制到WebRoot下。
4>将FCKeditor所需的editor文件夹及其全部内容复制到WebRoot下。
5>在WebRoot下新建一个用于存放上传文件的目录UserFiles，并在UserFiles下分别再创建两个子目录，如Image和Flash。
6>在web.xml增加FCKeditor的配置
.....
<servlet>
<servlet-name>Connector</servlet-name>
<servlet-class>com.fredck.FCKeditor.connector.ConnectorServlet</servlet-class>
<init-param>
<param-name>baseDir</param-name>
<param-value>/UserFiles/<param-value>
</init-param>
<init-param>
<param-name>debug</param-name>
<param-value>true</param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet>
<servlet-name>SimpleUploader</servlet-name>
<servlet-class>com.fredck.FCKeditor.uploader.SimpleUploaderServlet</servlet-class>
<init-param>
<!--此参数用于设置文件上传路径-->
<param-name>baseDir</param-name>
<param-value>/UserFiles/<param-value>
</init-param>
<init-param>
<param-name>debug</param-name>
<param-value>true<param-value>
</init-param>
<init-param>
<!--此参数用于设置是否开启上传功能-->
<param-name>enable</param-name>
<param-value>true<param-value>
</init-param>
<init-param>
<param-name>AllowedExtensionsFile</param-name>
<param-value><param-value>
</init-param>
<init-param>
<!--此参数用于设置禁止上传的文件类型-->
<param-name>DeniedExtensionsFile</param-name>
<param-value>
php|php3|php5|doc|txt|exe<param-value>
</init-param>
<init-param>
<!--此参数用于设置允许上传的文件类型-->
<param-name>AllowdExtensionsImage</param-name>
<param-value>
jpg|gif|jpeg|png<param-value>
</init-param>
<init-param>
<!--此参数用于设置禁止上传的文件类型-->
<param-name>DeniedExtensionsImage</param-name>
<param-value>
<param-value>
</init-param>
<init-param>
<!--此参数用于设置禁止上传的文件类型-->
<param-name>AllowedExtensionsFlash</param-name>
<param-value>
swf|fla<param-value>
</init-param>
<init-param>
<!--此参数用于设置禁止上传的文件类型-->
<param-name>DeniedExtensionsFlash</param-name>
<param-value>
<param-value>
</init-param>
<load-on-startup>1</load-on-startup>
<servlet>
<servlet-mapping>
<servlet-name>Connector</servlet-name>
<url-pattern>/editor/filemanager/browser/default/connectors/jsp/connector</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>SimpleUploader</servlet-name>
<url-pattern>/editor/filemanager/upload/simpleuploader</url-pattern>
</servlet-mapping>
.....
8>在JSP页面中正常使用，如test.jsp
<%@page contentType="text/html;charset=GB2312" language="java"%>
<%@ taglib uri="/WEB-INF/FCKeditor.tld" prefix="fck"%>
<html>
<head><title>在线编辑器FCKeditor的应用</title></head>
<body>
<h2>在线编辑器FCKeditor的应用</h2><hr>
<form action="process.jsp">
<fck:editor id="testfck" basePath="/FCKeditor/" height="60%" toolbarSet="Default" skinPath="/FCKeditor/editor/skins/default/" imageBrowserURL="/FCKeditor/editor/filemanager/browser/default/browser.html?Type=Image&Connection=connectors/jsp/connector"
flashBrowserURL="/FCKeditor/editor/filemanager/browser/default/browser.html?Type=Flash&Connection=connectors/jsp/connector"
imageUploadURL="/FCKeditor/editor/filemanger/upload/simpleuploader?Type=Image"
linkUploadURL="/FCKeditor/editor/filemanager/upload/simpleuploader?Type=File"
flashUploadURL="/FCKeditor/editor/filemanager/upload/simpleuploader?Type=Flash">
</fck:editor>
<input type="submit" name="submit" value="提交"/>
</form>
</body>
</html>
默认情况下，由于将Struts2的核心控制器FileterDispatcher配置成拦截所有请求
<filter>
<filter-name>struts2</filter-name>
<filter-class>org.apache.struts2.dispatcher.FileterDispatcher</filter-class>
</filter>
<filter-mapping>
<filter-name>struts2</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
这样意外地导致FCKeditor组件的上传功能失常，我们希望Struts2仅仅拦截自己关心的目标，对于其余无需经过FilterDispatcher过滤处理的请求不予拦截。
进行如下配置
<filter>
<filter-name>struts2</filter-name>
<filter-class>org.apache.struts2.dispatcher.FileterDispatcher</filter-class>
</filter>
<filter-mapping>
<filter-name>struts2</filter-name>
<url-pattern>*.action</url-pattern>
</filter-mapping>
<filter-mapping>
<filter-name>struts2</filter-name>
<url-pattern>*.jsp</url-pattern>
</filter-mapping>
<filter-mapping>
<filter-name>struts2</filter-name>
<url-pattern>*.js</url-pattern>
</filter-mapping>
扫一扫
151
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
