web.xml中的welcome-file-list标签作用: 当用户在浏览器中输入的URL不包含某个servlet名或JSP页面时,welcome-file-list元素可指定显示的默认文件。 welcome-file子元素用于指定默认文件的名称。welcome-file-list元素可以包含一个或多个welcome-file子元素。如 果在第一个welcome-file元素中没有找到指定的文件,Web容器就会尝试显示第二个,以此类推。
在web.xml中配置FacesServlet核心控制器:
这里设置了拦截.jsf结尾的请求。
需要为JSF配置一些额外的参数,可以在web.xml中使用<context-param>元素进行配置。下面是常用的一些配置:
<!--配置JSF程序状态的保存位置,如果设置成server则保存在session中,
如果保存在client中可以保证服务器重启应用状态也不会丢失-->
<context-param>
<description>
指示是在客户端(client)还是在服务器端(server)保存UI组件的状态和
session信息,server表示保存到服务器端,client表示保存到客户端,
默认为server。
</description>
<param-name>javax.faces.STATE_SAVING_METHOD</param-name>
<!--程序状态保存在客户端-->
<param-value>client</param-value>
</context-param>
<!--指定JSF映射资源时的默认后缀,默认为.jsp-->
<context-param>
<param-name>javax.faces.DEFAULT_SUFFIX</param-name>
<param-value>.jsp</param-value>
</context-param>
<!--指定JSF所管理的生命周期实例的标识符-->
<context-param>
<description>
当在这个应用中处理JSF请求时,
所使用的生命周期实例的标识符.
默认的生命周期模型(没看懂)
</description>
<param-name>javax.faces.LIFECYCLE_ID</param-name>
<param-value></param-value>
</context-param>
<!--指定JSF配置文件的保存位置-->
<context-param>
<param-name>javax.faces.CONFIG_FILES</param-name>
<param-value>/WEB-INF/faces-config-beans.xml,/WEB-INF/faces-config-nav.xml</param-value>
</context-param>
<!--指定是否需要验证自定义组件-->
<context-param>
<description>
SetthisflagtotrueifyouwanttheJSF
ReferenceImplementationtoverifythatalloftheapplication
objectsyouhaveconfigured(components,converters,
renderers,andvalidators)canbesuccessfullycreated.
Defaultvalueisfalse.
</description>
<param-name>javax.faces.verifyObjects</param-name>
<param-value>true</param-value>
</context-param>
<!--指定是否需要验证XML文件-->
<context-param>
<description>
SetthisflagtotrueifyouwanttheJavaServerFaces
ReferenceImplementationtovalidatetheXMLinyour
faces-config.xmlresourcesagainsttheDTD.Default
valueisfalse.
</description>
<param-name>javax.faces.validateXml</param-name>
<param-value>true</param-value>
</context-param>
<!--当设置在服务器端保存状态时,控制session保存的视图数量,-1表示没有限制-->
<context-param>
<param-name>javax.faces.NUMBER_OF_VIEWS_IN_SESSION</param-name>
<param-value>-1</param-value>
</context-param>
最常用的两个配置元素:
<managed-bean>:JSF应用中所有的托管Bean都放在该元素下
<managed-bean>
<managed-bean-name>user</managed-bean-name>
<managed-bean-class>
onlyfun.caterpillar.UserBean
</managed-bean-class>
<managed-bean-scope>session</managed-bean-scope>
</managed-bean>
<navigaton-rule>用于管理JSF的应用导航规则
<navigation-rule>
<from-view-id>/pages/index.jsp</from-view-id>
<navigation-case>
<from-outcome>success</from-outcome>
<to-view-id>/pages/welcome.jsp</to-view-id>
</navigation-case>
<navigation-case>
<from-outcome>failure</from-outcome>
<to-view-id>/pages/index.jsp</to-view-id>
</navigation-case>
</navigation-rule>
其他的配置元素:
应用管理相关配置:
<application>:用于管理JSF应用相关配置
<referenced-bean>:配置被引用Bean
<referenced-bean>:配置被引用Bean
注册自定义组件的相关配置:
<converter>:注册自定义转换器
<validator>:注册自定义输入校验器
<component>:注册自定义组件
<render-kit>:注册自定义组件绘制器和绘制器包
<validator>:注册自定义输入校验器
<component>:注册自定义组件
<render-kit>:注册自定义组件绘制器和绘制器包
高级扩展配置:
<phase-listener>:注册生命周期监听器
<factory>:配置实例化JSF核心类的工厂
<factory>:配置实例化JSF核心类的工厂