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