OFBiz实战（1）：整合Groovy+FreeMaker

这是OFBiz实战系列的第一篇文件，该系列的目的是整合Groovy+FreeMaker开发一个图书管理系统，阐述在此过程中碰到的一系列问题，以及如何解决这些问题。第一篇文章说明如何使用Groovy+FreeMaker搭建基本的组件框架，并能够将数据从Groovy传到FreeMaker。|

1. 在hot-deploy目录下创建组件library基本目录结构。


2. 新建文件library/ofbiz-component.xml，编辑内容：

<?xml version="1.0" encoding="UTF-8"?>



<ofbiz-component name="library"

        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

        xsi:noNamespaceSchemaLocation="http://ofbiz.apache.org/dtds/ofbiz-component.xsd">



    <resource-loader name="main" type="component"/>

    

    <webapp name="library"

        title="Library"

        server="default-server"

        location="webapp/library"

        base-permission="OFBTOOLS"

        mount-point="/library"

        app-bar-display="false"/>

        

</ofbiz-component>

3. 新建文件library/webapp/library/WEB-INF/web.xml，编辑内容：

<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" "http://java.sun.com/dtd/web-app_2_3.dtd">



<web-app>

    <display-name>Library</display-name>



    <context-param>

        <param-name>webSiteId</param-name>

        <param-value>LIBRARY</param-value>

        <description>A unique ID used to look up the WebSite entity</description>

    </context-param>

    <context-param>

        <param-name>localDispatcherName</param-name>

        <param-value>library</param-value>

        <description>A unique name used to identify/recognize the local dispatcher for the Service Engine</description>

    </context-param>

    <context-param>

        <param-name>entityDelegatorName</param-name>

        <param-value>default</param-value>

        <description>The Name of the Entity Delegator to use, defined in entityengine.xml</description>

    </context-param>

    <context-param>

        <param-name>compressHTML</param-name>

        <param-value>false</param-value>

        <description>Remove unnecessary whitespace from HTML output.</description>

    </context-param>



    <filter>

        <filter-name>ContextFilter</filter-name>

        <display-name>ContextFilter</display-name>

        <filter-class>org.ofbiz.webapp.control.ContextFilter</filter-class>

        <init-param><param-name>disableContextSecurity</param-name><param-value>N</param-value></init-param>

        <init-param>

            <param-name>allowedPaths</param-name>

            <param-value>/error:/control:/select:/index.html:/index.jsp:/default.html:/default.jsp:/images:/includes/maincss.css</param-value>

        </init-param>

        <init-param><param-name>errorCode</param-name><param-value>403</param-value></init-param>

        <init-param><param-name>redirectPath</param-name><param-value>/control/main</param-value></init-param>

    </filter>

    <filter-mapping><filter-name>ContextFilter</filter-name><url-pattern>/*</url-pattern></filter-mapping>



    <listener><listener-class>org.ofbiz.webapp.control.ControlEventListener</listener-class></listener>

    <listener><listener-class>org.ofbiz.webapp.control.LoginEventListener</listener-class></listener>



    <servlet>

        <servlet-name>ControlServlet</servlet-name>

        <display-name>ControlServlet</display-name>

        <description>Main Control Servlet</description>

        <servlet-class>org.ofbiz.webapp.control.ControlServlet</servlet-class>

        <load-on-startup>1</load-on-startup>

    </servlet>

    <servlet-mapping>

        <servlet-name>ControlServlet</servlet-name>

        <url-pattern>/control/*</url-pattern>

    </servlet-mapping>



    <session-config><session-timeout>60</session-timeout><!-- in minutes --></session-config>



    <welcome-file-list>

        <welcome-file>index.jsp</welcome-file>

        <welcome-file>index.html</welcome-file>

        <welcome-file>index.htm</welcome-file>

    </welcome-file-list>

</web-app>

4. 新建文件library/webapp/library/WEB-INF/controller.xml，编辑内容：

<?xml version="1.0" encoding="UTF-8"?>



<site-conf xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

        xsi:noNamespaceSchemaLocation="http://ofbiz.apache.org/dtds/site-conf.xsd">



    <include location="component://common/webcommon/WEB-INF/common-controller.xml"/>

    <include location="component://common/webcommon/WEB-INF/portal-controller.xml"/>



    <request-map uri="main">

        <event type="groovy" path="component://library/webapp/library/WEB-INF/actions/main.groovy"/>

        <response name="success" type="view" value="main"/>

    </request-map>

    

    <view-map name="main" type="ftl" page="component://library/webapp/library/main.ftl"/>



</site-conf>

 

5. 新建文件library/webapp/library/WEB-INF/actions/main.groovy，编辑内容：

request.setAttribute("name", "奥特曼");



def books = [];

books[0] = ["name": "Java入门", "price": 85];

books[1] = ["name": "Java实战", "price": 70];

books[2] = ["name": "Java中级", "price": 63];

books[3] = ["name": "Java高级", "price": 81];

request.setAttribute("books", books);



return "success";

6. 新建文件library/webapp/library/main.ftl，编辑内容：

你的名字：<b>${requestAttributes.name}</b>



<table border='1'>

    <#list requestAttributes.books as book>

    <tr>

        <td>${book.name}</td>

        <td>${book.price?if_exists}</td>

    </tr>

    </#list>

</table>

7. 启动OFBiz，浏览http://localhost:8080/library/control/main，看到如下的结果：


有遗憾，为什么FreeMaker中每个变量都要带上requestAttributes，太难看了？下一篇文件想办法解决。