把《威博文件管理系统》从JSF1.2升级到JSF2的过程

随着JavaEE6规范的推出，计划把《威博文件管理系统》迁移到JavaEE6的基础架构上，在做完《威博文件管理系统》3.1.1版后，决定首先进行，JSF1.2到JSF2的升级迁移，下面就是具体过程：

 

1、首先确保web.xml的版本如下：

 

 

Java代码 

1. <web-app   
2.     version="2.5"  
3.     xmlns="http://java.sun.com/xml/ns/javaee"  
4.     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
5.     xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">  

 

2、把JSF2的参考实现变更为majarra2.0.2，具体是把两个类库jsf-api.jar，jsf-impl.jar拷贝到/WEB-INF/lib目录下，同时删除原来JSF1.2的参考实现类库。

 

 

3、修改原来JSF1.2版本中faces-config.xml的版本号为JSF2要求的版本号如下：

 

Java代码 

1. <faces-config  
2.     xmlns="http://java.sun.com/xml/ns/javaee"  
3.     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
4.     xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-facesconfig_2_0.xsd"  
5.     version="2.0">  

 虽然在JSF2中可以通过注解可以大大减少xml文件的配置工作，但是在实际从JSF1.2迁移到JSF2时，有些配置还是必不可少的，特别是通过JSF提供的钩子，提供了自定义JSF框架行为时更是如此。

 

4、由于《威博文件管理系统》中使用了richfaces3.3.1增强库，所以应该进行相应的升级到richfaces3.3.3库，从Jboss网站下载richfaces3.3.3cr1版，拷贝三个文件richfaces-api-3.3.3.cr1.jar、richfaces-impl-jsf2-3.3.3.cr1.jar、richfaces-ui-3.3.3.cr1.jar到/WEB-INF/lib目录下。

 

5、由于目前richfaces3.3.3cr1版还不能支持JSF2内置的faceslet，所以在web.xml文件中设置参数，关闭faceslet，

具体参数如下：

 

Java代码 

1. <context-param>  
2.     <description>不使用JSF2内置的facelet视图处理器</description>  
3.     <param-name>javax.faces.DISABLE_FACELET_JSF_VIEWHANDLER</param-name>  
4.     <param-value>true</param-value>  
5. </context-param>  

 

6、修改完以上步骤后，重新生成《威博文件管理系统》的web部署归档包：webfile.war，把归档包投入到Tomcat6.0.20/webapps/目录下运行，一切正常。至此完成从JSF1.2到JSF2的迁移。