jsf in action 笔记:web.xml配置(Configuration)--2008.04.11

2008.04.11 摘自 JSF in aciton 3.1.4 Configuration Page/126

1.JSF 中的Servlet叫FacesServlet,由JSF处理的请求首先要由这个Servlet来处理,这个配置在WEB-INF/web.xml文件中,

<web-app>
...
<servlet>
<servlet-name>Faces Servlet</servlet-name> 注:这个名称可以随意,只要与下面mapping中的名称一致就可以了
<servlet-class>javax.faces.webapp.FacesServlet</servlet-class>注:这里为FacesServlet的类的全名(包括包的名称)
</servlet>
<servlet-mapping>
<servlet-name>Faces Servlet</servlet-name>注:同上面的servlet-name
<url-pattern>/faces/**//*</url-pattern>
<!--注:由Faces Servlet这个类来处理的请求的url地址格式,表示为url地址中包含/faces/的就由这个servlet来处理,这种格式也叫前缀格式,也可以为后缀格式,比如"*.faces",表示只要请求url地址以.faces结尾,那么就由这个Servlet处理 -->
</servlet-mapping>
...
</web-app>

2. FacesServlet中可以配置的参数

Table 3.2 JSF application configuration parameters

Context Parameter	Description	Default	说明
javax.faces.CONFIG_FILES	Comma-delimited list of context-relative JSF configuration resource paths that JSF will load before it loads WEB-INF/facesconfig. xml	None	配置文件
javax.faces.DEFAULT_SUFFIX	Default suffix for resources to load when extension mapping is in use	.jsp
javax.faces.LIFECYCLE_ID	Identifier for the Lifecycle instance to be used when processing JSF requests within this application	The default Lifecycle instance
javax.faces.STATE_SAVING_METHOD	Indicates whether to save the state of UI components on the client side (client) or server side (server)	server	组件状态 存放

example web.xml

<web-app>
...
<context-param>
<param-name>javax.faces.STATE_SAVING_METHOD</param-name>
<param-value>server</param-value> 注:在服务器端存储组件的状态,放在服务器的Session中
</context-param>
<context-param>
<param-name>javax.faces.CONFIG_FILES</param-name>注:配置文件的名称,多个配置文件用逗号隔开
<param-value>/WEB-INF/navigation.xml,/WEB-INF/RegistrationWizard.xml
</param-value>
</context-param>
...
<web-app>