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 >