Apache OFBIZ快速上手（一）--简单例子

         本篇文章主要介绍简单例子，OFBIZ的其他介绍就先不说了，放在后面的博文中。

1、目录结构

                   

            说明：在hot-deploy目录下建立文件夹learning，为例。注意先把文件扔到hot-deploy目录下再启动服务器。

2、创建ofbiz-component.xml文件

          a.作用：创建此文件，负责让OFBIZ知道learning组件的信息，可以参考applications/accounting/ofbiz-component.xml。

          b.内容如下：

<span style="font-size:18px;"><?xml version="1.0" encoding="UTF-8"?><ofbiz-component name="learning" 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="learning" title="Learning" server="default-server" base-permission="OFBTOOLS"location="webapp/learning"mount-point="/learning"app-bar-display="false"/></ofbiz-component></span>

        说明：第一个节点中name=”learning”,指的是组件名，告诉OFBIZ加载我们自己定义的name组件，这个名字必须唯一，不能与OFBIZ其他组件名相同。

      Webapp节点：

                name: 定义web应用的名字

                  title: 这个是应用的标识，显示在应用工具条中的名字

              server: 让ofbiz知道是哪个server

             location：learning组件指向的webapp的路径，这里用的是相对路径

       mount-point：应用的访问路径

 app-bar-display：应用的title是否要显示

3、创建web.xml

         a.路径：${learning/webapp/learning}/WEB-INF

         b.内容：（基本每个web.xml都是一样的，从applications里面拷贝一个过来即可）

<span style="font-size:18px;"><?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>learning</display-name><description>The First Hello World Application</description><context-param><param-name>entityDelegatorName</param-name><param-value>default</param-value></context-param><!-- 本地调用名 start 刘腾腾 --><context-param><param-name>localDispatcherName</param-name><param-value>learning</param-value></context-param><!-- 本地调用名 end 刘腾腾 --><!-- 主修饰器位置，值应该与ofbiz-component.xml里的mount-point相匹配    start 刘腾腾 --><context-param><param-name>mainDecoratorLocation</param-name><param-value>component://simple/widget/CommonScreen.xml</param-value><description>The location of the main-decorator screen to use for              this webapplreferred to as a context variable in screen              def XML files.</description></context-param><!-- 主修饰器位置，值应该与ofbiz-component.xml里的mount-point相匹配    end 刘腾腾 --><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>/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/learning</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></session-config><welcome-file-list><welcome-file>index.jsp</welcome-file></welcome-file-list></web-app></span>

4、创建controller.xml

               a.作用:让OFBIZ根据不同的请求去做相应的事。

          b.内容

<span style="font-size:18px;"><?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"><!-- 引入OFBIZ的公共控制配置 ltt --><include location="component://common/webcommon/WEB-INF/common-controller.xml"/><description>Practice Component Site Configuration File</description><owner>Copyright 2001-2009 The Apache Software Foundation</owner><!-- OFBIZ调用该class处理screen中的xml --><handler name="screen" type="view" class="org.ofbiz.widget.screen.ScreenWidgetViewHandler"/><!-- Request Mappings --><request-map uri="main"><security https="false" auth="false"/><response name="success" type="view" value="main"/></request-map><!-- end of request mappings --><!-- View Mappings --><view-map name="main" type="screen" page="component://simple/widget/SimpleScreens.xml#main"/><!-- change the path to the following if the above doesn't work for you --><!-- end of view mappings --></site-conf></span>

5、简单页面

              a. 路径：${learning/widget}

           b. 建LearningScreen.xml

<span style="font-size:18px;"><?xml version="1.0" encoding="UTF-8"?><Screens xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="http://www.ofbiz.org/dtds/widget-screen.xsd"><screen name="main"><section><widgets><label text="===========liutengteng=======is a good girl!========"/></widgets></section></screen></Screens></span>

6、运行结果

          a.地址   http://localhost:8080/learning/control/main

          b. 效果

                                

7、总结

        这是一个简单的OFBIZ的入门小例子，通过一些配置文件，就将我们的系统搭起来了，很快捷，项目的加载部署也很快，灵活配置。下面博文将持续介绍OFBIZ。