ofbiz_web设置

目　　录

1.            背景... 1

2.            基本原则... 1

3.            相关标签说明... 1

4、          具体说明... 2

4.1            指定欢迎页面... 2

4.2            命名与定制URL. 3

4.3            上下文参数... 3

4.4            设置过滤器... 4

4.5            设置监听器... 4

4.6            设置会话... 4

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、            具体说明

 

1.    

2.    

3.    

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 ControlServlet</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>