vjame

优化代码是无止境的
随笔 - 65, 文章 - 9, 评论 - 26, 引用 - 0
数据加载中……

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 <href="http://www.fredck.com/fckeditor/">FCKeditor</a>.
    
</FCK:editor>

 

  
  这里有一点一定要注意,那就是这里的属性都要避免使用相对路径。

  刷新页面,又见编辑器,此时,可以顺利的上传文件了。

posted on 2008-09-05 16:36 lanjh 阅读(1745) 评论(1)  编辑  收藏 所属分类: Java Web

评论

# re: Java Web项目中整合FCKeditor  回复  更多评论   

com.fredck.FCKeditor.connector.ConnectorServlet是什么
2014-06-19 18:11 | 蓝夕

只有注册用户登录后才能发表评论。


网站导航: