在JSF/JSP中集成FCKEditor 2.6

目前，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

 

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

 

我的2.4Beta1版的JAR包在文件上传上还有一些问题，我已经下载了相应Java Source Code做了修改，一切都运行的比较正常！

 

PS: 下载的Java Project是基于Maven的，如果不懂Maven的同学抓紧温习温习吧！