OFBiz 快速入门——续二
|
OFBiz 快速入门 2.5 创建一个文件，取名为（controller.xml），被OFBiz webapp控制器使用的。在没有额外增加功能时，这个文件内容非常的小与简单，如下： <?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"/> <description>Practice Component Site Configuration File</description> <owner>Copyright 2001-2009 The Apache Software Foundation</owner> <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://practice/widget/PracticeScreens.xml#main"/> <!-- end of view mappings --> </site-conf> 2.6 回到上一级目录，创建一个（error）目录， 完整路径是（hot-deploy/practice/webapp/practice/error） 2.6.1 在（error）目录中创建一个（error.jsp)文件。文件的内容，可以从 example或其他的组件拷贝过来。 这个目录结构，就是你在上一步骤中在controller.xml文件中的<errorpage>/error/error.jsp</errorpage>的位置。你会需要用到这个目录去显示一个错误信息给用户。内容如下（省去一些HTML代码，只贴出与OFBiz有关的，详细的请自己浏览）： <%@ page import="org.ofbiz.base.util.*" %> 先获得request中的错误信息，并保存在一个errorMsg的变量中 <% String errorMsg = (String) request.getAttribute("_ERROR_MESSAGE_"); %> 最后，在HTML页面中某处合适的位置，输出其错误信息： <%=UtilFormatOut.replaceString(errorMsg, "\n", "<br/>")%> 2.7 在组件目录（practice）中创建目录，命名为（widget），完整路径是，（hot-deploy/practice/widget）。这个目录的作用，包含你应用将要创建的UI，有forms、menus和screens等。 2.8 在（widget）目录中创建一个命名为（PracticeScreens.xml)的文件。类似地，其文件内容也可以从Example组件中获取并拷贝到这文件中。 在创建Views前，推荐你先去阅读以下有关内容（注意，这个是告诉我自己要去阅读的） ² HTML and CSS Best Practice ² Managing Your Source Differences ² Methodology Recommendations ² User Interface Layout Best Practices 阅读以上文档后，会对你产生莫大的帮助，但在这里，可以先使用下面的代码： <?xml version="1.0" encoding="UTF-8"?> <screens xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation ="http://ofbiz.apache.org/dtds/widget-screen.xsd"> <screen name="main"> <section> <widgets> <label text="This is first practice"/> </widgets> </section> </screen> </screens> 2.9 完成了一个基本应用（practice）。首先，客户端的一个request会去查看一个特定的资源，举个例子：localhost:8080/practice/cntrol/main。 当OFBiz接收到这个请求，就会查看/practice这个项。为什么呢？因为我们在ofbiz-component.xml已经声明webapps加载点是/practice。现在OFBiz知道处理（practice）组件请求的剩余部分了。 经历了OFBiz在ofbiz-component.xml查找到挂载点（/practice）后，OFBiz这时将会查看controller.xml文件。这个文件里，我们已经定义了request-maps和view-maps。如果找到request-map是路径后面的（main），就会使用相关联的view-map，其他也如此。在request-map中，能或者指定一个view或者是一个事件或一个服务这都将会在后面所见到的。如果指定的是一个view，就会进一步查看request-map元素中查找到指定的名称并返回。看如下xml内容： <request-map uri="main"> <security https="false" auth="false"/> <response name="success" type="view" value="main"/> </request-map> <view-map name="main" type="screen" page="component://practice/widget/PracticeScreens.xml#main"/> 在这里就可很清楚的知道，如果uri是main的时候，就会在request-map标签中进行下一步的查找，如果是success时，就会得到一个类型为view值为main的返回。那么，OFBiz就会索引到view-map中与其（main）值相等的标签。跟着，就会在PracticeScreens.xml文件中读取元素名为main的内容（#） 最后，就可以启动OFBiz，在浏览器中输入以下的URL： http://localhost:8080/practice/control/main 2.11 在webapp（practice）目录创建一个名为（index.jsp)的文件。当然，类似地，其文件内容也可以从Example组件中拷贝过来。这个文件的作用是为了响应如下的URL的http://localhost:8080/practice/。如果你给了一个错误的URL，如http://localhost:8080/practice/unknown/request将会重定向到在web.xml定义好的redirectPath中的文件路径。 In the case, ContextFilter will filter out the request and use the redirect path to redirect the request. 第二部分 3.做进一步的一些操作待续待续ing |