ofbiz_web设置
目 录
1. 背景
OFBIZ的Web应用框架严格遵循MVC模式。 OFBizMVC中Model有它的封装业务逻辑的事件和服务承担. Control有controller承担， View有传统的jsp, 和FreeMarker,JPublish,Beanshell承担。 这里我主要说明 Control (Model, View将在相应技术的模块阐述). 在OFBiz框架中,Controller是一组管理web表示层对象, 其目的是将业务逻辑和表示层完全地分离开来，其配置相当于配置servlet的web.xml
2.基本原则
web.xml 配置原必须半严格按照xml规则，必须有且只有一个根节点，大小写敏感，标签不嵌套，必须配对。
web.xml是否必须的呢？不是的，只要你不用到里面的配置信息就好了，不过在大型web工程下使用该文件是很方便的，若是没有也会很复杂。
那么web.xml能做的所有事情都有那些？其实，web.xml的模式文件中定义了多少种标签元素，web.xml中就可以出现它的模式文件所定义的标签元素，它就能拥有定义出来的那些功能。web.xml的模式文件是由Sun公司定义的，每个web.xml文件的根元素<web-app>中，都必须标明这个web.xml使用的是哪个模式文件。
3. 相关标签说明
| 序号 | 标签 | 说明 |
| 1 | icon | icon元素指出IDE和GUI工具用来表示Web应用的一个和两个图像文件的位置。 |
| 2 | display-name | display-name元素提供GUI工具可能会用来标记这个特定的Web应用的一个名称。 |
| 3 | description | description元素给出与此有关的说明性文本。 |
| 4 | context-param | context-param元素声明应用范围内的初始化参数。 |
| 5 | filter | 过滤器元素将一个名字与一个实现javax.servlet.Filter接口的类相关联。 |
| 6 | filter-mapping | 一旦命名了一个过滤器，就要利用filter-mapping元素把它与一个或多个servlet或JSP页面相关联。 |
| 7 | listener | servlet API的版本2.3增加了对事件监听程序的支持，事件监听程序在建立、修改和删除会话或servlet环境时得到通知。Listener元素指出事件监听程序类。 |
| 8 | servlet | 在向servlet或JSP页面制定初始化参数或定制URL时，必须首先命名servlet或JSP页面。Servlet元素就是用来完成此项任务的。 |
| 9 | servlet-mapping | 服务器一般为servlet提供一个缺省的URL：http://host/webAppPrefix/servlet/ServletName。但是，常常会更改这个URL，以便servlet可以访问初始化参数或更容易地处理相对URL。在更改缺省URL时，使用servlet-mapping元素。 |
| 10 | session-config | 如果某个会话在一定时间内未被访问，服务器可以抛弃它以节省内存。可通过使用HttpSession的setMaxInactiveInterval方法明确设置单个会话对象的超时值，或者可利用session-config元素制定缺省超时值。 |
| 11 | mime-mapping | 如果Web应用具有想到特殊的文件，希望能保证给他们分配特定的MIME类型，则mime-mapping元素提供这种保证。 |
| 12 | welcom-file-list | welcome-file-list元素指示服务器在收到引用一个目录名而不是文件名的URL时，使用哪个文件。 |
| 13 | error-page | error-page元素使得在返回特定HTTP状态代码时，或者特定类型的异常被抛出时，能够制定将要显示的页面。 |
| 14 | taglib | taglib元素对标记库描述符文件（Tag Libraryu Descriptor file）指定别名。此功能使你能够更改TLD文件的位置，而不用编辑使用这些文件的JSP页面。 |
| 15 | resource-env-ref | resource-env-ref元素声明与资源相关的一个管理对象。 |
| 16 | resource-ref | resource-ref元素声明一个资源工厂使用的外部资源。 |
| 17 | security-constraint | security-constraint元素制定应该保护的URL。它与login-config元素联合使用 |
| 18 | login-config | 用login-config元素来指定服务器应该怎样给试图访问受保护页面的用户授权。它与sercurity-constraint元素联合使用。 |
| 19 | security-role | security-role元素给出安全角色的一个列表，这些角色将出现在servlet元素内的security-role-ref元素的role-name子元素中。分别地声明角色可使高级IDE处理安全信息更为容易。 |
| 20 | env-entry | env-entry元素声明Web应用的环境项。 |
| 21 | ejb-ref | ejb-ref元素声明一个EJB的主目录的引用。 |
4、 具体说明
4.1 指定欢迎页面
<welcome-file-list>
<welcome-file>index.jsp</welcome-file>
<welcome-file>index.html</welcome-file>
<welcome-file>index.htm</welcome-file>
</welcome-file-list>
上面的例子指定了3个欢迎页面，显示时按顺序从第一个找起，如果第一个存在，就显示第一个，后面的不起作用。如果第一个不存在，就找第二个，以此类推
4.2 命名与定制URL
<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>
4.3 上下文参数
<context-param>
<param-name>webSiteId</param-name>
<param-value>InStockSite</param-value>
<description>A uniqueID used to look up the WebSite entity</description>
</context-param>
<context-param>
<param-name>localDispatcherName</param-name>
<param-value>InStock</param-value>
<description>A uniquename used to identify/recognize the local dispatcher for the ServiceEngine</description>
</context-param>
<context-param>
<param-name>serviceReaderUrls</param-name>
<param-value>/WEB-INF/services.xml</param-value>
<description>Configuration File(s) For The ServiceDispatcher</description>
</context-param>
<context-param>
<param-name>entityDelegatorName</param-name>
<param-value>default</param-value>
<description>The Nameof the Entity Delegator to use, defined in entityengine.xml</description>
</context-param>
<context-param>
<param-name>mainDecoratorLocation</param-name>
<param-value>component://InStock/widget/CommonScreens.xml</param-value>
<description>Thelocation of the main-decorator screen to use for this webapp; referred to as acontext variable in screen def XML files.</description>
</context-param>
4.4 设置过滤器
<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:/script</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>
4.5 设置监听器
<listener><listener-class>org.ofbiz.webapp.control.ControlEventListener</listener-class></listener>
4.6 设置会话
<session-config>
<session-timeout>60</session-timeout>
</session-config>