在JSF/JSP中集成FCKEditor 2.6

本文摘自：http://tailsherry.iteye.com/blog/197824

 

目前，FCKEditor (http://www.fckeditor.net/) 是开源社区一款强大的HTML编辑器，目前最新版本是2.6，支持Java的插件版本是2.4Beta1。

 

对于一般的Java Web应用，我们可以通过直接插入JavaScript代码来构造页面，这种方式操作起来比较简便，也是通用在所有web页面的一种方式。但是，在实际的Java Web应用中，我们除了用到普通的页面编辑功能之外，难免会考虑到页面上传图片、附件等功能。所以，单纯使用JavaScript方式的话，这一大堆的文件上传代码将由你自己来写了，工程量还是比较浩大的。自然而然，我们会想到Jsp Tag，有没有现成的快餐式的页面标签呢？答案是肯定的，就如我上文提到的Java插件就已经实现了这些功能，并集成了Apache Commons-FileUpload，以此来实现文件服务器上传。

 

2.4版的Java插件已经封装得更加简洁，不同于之前的其他版本。标签的使用方式是，

<%@taglib uri="http://java.fckeditor.net" prefix="FCK"%>  
<FCK:editor instanceName="EditorDefault" width="755" height="460" basePath="/fckeditor" value="Hello, world">  
  <jsp:body>  
    <FCK:config SkinPath="skins/office2003/" />  
  </jsp:body>  
</FCK:editor>  

 

在JSF应用中，由于页面都是JSF自定义标签，对于其他标签的内容，JSF不会自动将后台Bean中的值绑定到<FCK:editor/>，那么我们还要做做文章，通过一段JavaScript绑定到body_onload()事件中，以此将JSF标签的内容传递给<FCK:editor/>。

<script type="text/javascript">      
    function renderMessage() {  
        YAHOO.util.Dom.get("EditorDefault").value = YAHOO.util.Dom.get("form:content").value;  
    }  
</script>  
  
<f:view>  
  <h:form id="form">  
    <h:inputTextarea id="content" value="#{mainMessageEditBean.message.messageContent}" style="display:none"></h:inputTextarea>  
  </h:form>  
</f:view>  

 

保存HTML编辑内容的时候，你只需要通过获得到的HttpServletRequest对象获取页面提交中的Parameter对象，示例代码如下：

public Map getParamMap() {  
    return getFacesContext().getExternalContext().getRequestParameterMap();  
}  
  
public String getParamAsString(String paramName) {  
    Object obj = getParamMap().get(paramName);  
    if (obj != null) {  
        return obj.toString();  
    } else {  
        return "";  
    }  
}  
  
public String saveMessage() {  
    if (message == null) {  
        setErrMsg("Message does not exist.");  
        return null;              
    }  
    String content = getParamAsString("EditorDefault");  
    if (content == null || content.length() == 0) {  
        setErrMsg("Message must not be empty.");  
        return null;                          
    }  
}  

 

其他方面，我们需要在自己的web.xml中定义FCKEditor相关的Servlet：

<servlet>  
  <servlet-name>Connector</servlet-name>  
    <servlet-class>  
         net.fckeditor.connector.ConnectorServlet  
    </servlet-class>  
    <load-on-startup>1</load-on-startup>  
</servlet>  
<servlet-mapping>  
    <servlet-name>Connector</servlet-name>  
    <url-pattern>  
         /fckeditor/editor/filemanager/connectors/*  
    </url-pattern>  
</servlet-mapping>  

 

这里需要注明的是，/fckeditor这个web根目录下的目录来源于FCKEditor的核心包(Ver 2.6)，可以在官方网站上面下载得到。

 

在目录/fckeditor下面有一个重要的文件fckconfig.js，里面可以配置许多FCKEditor在页面上的展示风格，大家可以仔细慢慢研究 :)

 

PS: 考虑到安全问题，建议大家把FCKEditor界面上的Source Code按钮屏蔽掉，防止黑客的恶意脚本的破坏。

 

 

在我的实际应用中，因为要限制上传文件的权限，所以我要用到权限控制。幸好FCKEditor提供了相应的UserAction接口，可以让我自己实现一个类来控制权限。

package com.tail.utils;  
  
import javax.servlet.http.HttpServletRequest;  
import javax.servlet.http.HttpSession;  
  
import net.fckeditor.requestcycle.UserAction;  
  
import com.tail.beans.Principal;  
import com.tail.objects.User;  
  
public class UserActionImpl implements UserAction {  
  
    public boolean isEnabledForFileBrowsing(HttpServletRequest req) {          
        return true;  
    }  
  
    public boolean isEnabledForFileUpload(HttpServletRequest req) {  
        HttpSession session = req.getSession();  
        Principal principal = (Principal) session.getAttribute(ConstantUtil.SESSION_PRINCIPAL);  
        if (principal != null) {    
            User user = principal.getUser();  
            if (user.isUploadable()) {  
                return true;  
            }  
        }  
        return false;  
    }  
  
}  

 

如何加载自定义的UserAction类呢？在classes的根目录下，你需要定义一个fckeditor.properties文件：

connector.userActionImpl=com.tail.utils.UserActionImpl  

 这样你就可以控制文件上传的权限了。