[原创]ECLIPSE环境下利用ANT进行JSF开发入门(一)

    本文将介绍在ECLIPSE环境下开始JSF开发的整个过程，主要侧重在环境的配置，ANT工具的基本用法，并且用ANT进行简单的工程构建，本文也会介绍JSF的一些基本标签.

       我先把整个过程分成若干个步骤:

       安装ECLIPSE，ANT以及TOMCAT并设置环境变量 à 配置工程环境(JSF) à编写测试文件(jsp&java) à 编写ANT构建文件 à 编写BAT文件

 

1.       安装ECLIPSE，ANT以及TOMCAT并设置环境变量

       在www.eclipse.org下载最新版本的ECLIPSE；ANT和TOMCAT可以在www.apache.org 下载到.假设这三个工具都是放在 F :\ 根目录下.将下载的ECLIPSE，ANT和TOMCAT解压后放在F:\根目录中.然后在“我的电脑”à属性à高级选项卡à环境变量à在环境变量中新建一个TOMCAT_HOME变量，其值为F:\Tomcat5.5;再另新建一个环境变量TOMCAT_BASE，其值为F:\Tomcat5.5;再设置ANT的环境变量，新建变量ANT_HOME，其值为F:\Ant-1.6.2，第一步到此就完成了.

 

2.       配置JSF工程环境

       首先在ECLIPSE中建立一个Java Project，在这里我将其命名为JSFWEBAPP，并且在工程文件夹下建立目录结构如下图:

      

      
     然后，在WEB-INF目录中新建一个XML文件web.xml，这个文件可以自己新建，也可以从%TOMCAT_HOME%\conf下复制。要进行JSF开发就必须要在web.xml目录中添加一段配置信息，如下:

      

 1 <context-param>
 2
 3        <param-name>com.sun.faces.verifyObjects</param-name>
 4
 5        <param-value>true</param-value>
 6
 7</context-param>
 8
 9 
10
11    <context-param>
12
13        <param-name>com.sun.faces.validateXml</param-name>
14
15        <param-value>true</param-value>
16
17</context-param>
18
19 
20
21    <context-param>
22
23        <param-name>javax.faces.CONFIG_FILES</param-name>
24
25        <param-value>/WEB-INF/faces-config.xml</param-value>
26
27</context-param>
28
29 
30
31    <context-param>
32
33        <param-name>javax.faces.STATE_SAVING_METHOD</param-name>
34
35        <param-value>client</param-value>
36
37    </context-param>
38
39    <servlet>
40
41        <servlet-name>FacesServlet</servlet-name>
42
43        <servlet-class>javax.faces.webapp.FacesServlet</servlet-class>
44
45        <load-on-startup>1</load-on-startup>
46
47    </servlet>
48
49 
50
51    <servlet-mapping>
52
53        <servlet-name>FacesServlet</servlet-name>
54
55        <url-pattern>/faces/*</url-pattern>
56
57</servlet-mapping>
58
59

    可以将上面一段配置信息直接复制到你的web.xml文件中.除了以上的配置以外，还要在TOMCAT中进行WEB应用的虚拟目录的配置，方法是在%TOMCAT_HOME%\conf\server.xml文件中添加:

<Context docBase="F:/workspace/JSFWebAppEx/webapp/web" path="/JSFApp" reloadable="true" workDir="f:\workspace\JSFWebAppEx\work"/>（docBase是WEB项目JSP页面文件所在目录，path是WEB项目的虚拟目录,work是编译后的JSP文件的存放目录）

也可以把这一段写在一个独立的XML文件中(XML文件的命名通常与WEB项目的名称相同，以便管理)，并将其保存在%TOMCAT_HOME%\conf\Catalina\localhost下.

       另外还要新建一个faces-config.xml文件，这个是支持JSF的配置文件.需要自己建立，其内容主要有两类基本配置，一类是页面导航规则，另一类是受管Bean的配置信息.下面给出一个配置例子:

      

     

 1  <!— 页面导航规则(格式) -->
 2
 3       <navigation-rule>
 4
 5        <from-view-id>/index.jsp</from-view-id>
 6
 7        <navigation-case>
 8
 9            <from-outcome>usrLogin</from-outcome>
10
11            <to-view-id>/responsePage.jsp</to-view-id>
12
13        </navigation-case>
14
15</navigation-rule>
16
17 
18
19<!— 受管Bean配置信息(格式) -->
20
21    <managed-bean>
22
23        <managed-bean-name>user</managed-bean-name>
24        <managed-bean-class>webapp.src.com.corejsf.UserBean</managed-bean-class>
25
26        <managed-bean-scope>session</managed-bean-scope>
27
28</managed-bean>
29

注意：以上的配置信息都要放在<faces-config></faces-config>之中.

 

同样也可以把上面的配置格式套用(注意这里是套用不是复制，只是利用上面配置的格式，要根据自己的具体情况更改以上黑字部分)到自己的faces-config.xml中。在下面会详细说明以上配置的含义。

       现在需要把支持JSF开发的若干个jar包放在web/WEB-INF/lib文件夹中. 下面是JSF开发相关jar包下载地址:

       1).http://java.sun.com/j2ee/javaserverfaces/download.html 选择其中Reference Implementation 这个是JSF的开发包.

              2).http://jakarta.apache.org/site/downloads/，  这里下载的是JSTL的开发包.

              将上面的两类jar包下载下来并且复制到web/WEB-INF/lib中.

              下面列出所有需要的jar包文件名：

                        commons-beanutils.jar

            commons-collections.jar

            commons-digester.jar

            commons-logging.jar

            jsf-api.jar

            jsf-impl.jar

            jstl.jar

            standard.jar
(未完...)