集成Eclipse和InforWeb开发第一个Struts应用

<script type=text/javascript> </script> <script src="http://pagead2.googlesyndication.com/pagead/show_ads.js" type=text/javascript> </script>

　　 涉及的软件：
　　 Struts：当前最流行的J2EE Web应用框架，它基于Model-View-Controller（MVC）模式，可以 从http://struts.apache.org下载Struts
　　 Eclipse：一个非常好的集成开发环境，它采用基于插件的体系结构，可以从 http://www.eclipse.org下载Eclipse，在网上也有大量的免费的Eclipse插件
　　 InforWeb：J2EE Web应用需要在一个J2EE应用服务器中运行，这里我们选择中创软件商用中间件（ http://www.inforbus.com）的J2EE应用服务器InforWeb。当然，你也可以使用Tomcat之类的，不过我习惯使用InforWeb。

　　虽然网上有很多Eclipse的插件，其中也包括为Struts提供的插件，但是在这里我们尝试不使用这些插件，而且采用几乎手工的方式来完成我们的第一个Struts，这样能够使我们更好的理解Web应用和Struts，而且据传言这有助于成为高手:)
　　好了，下面我们就白手起家建立我们的第一个Struts应用：
　　 第一步：取得相应软件，并搭建环境
　　 Eclipse，从Eclipse的站点 http://www.eclipse.org把它下载下来，解压到某个地方就行了，运行解压后目录下的eclipse.exe就可以进入Eclipse的开发环境。这里我下载的版本是3.0.1。
　　 InforWeb，这个就没法免费下载了，你需要同中创软件商用中间件有限公司（ http://www.inforbus.com）联系购买或者取得一个试用版。注意，在安装InforWeb之前，要先安装JDK，并配置JAVA_HOME。InforWeb的安装过程非常简单，完全是我们习惯的标准Windows安装过程，不用手册也能轻松完成（当然手册中有详细的安装说明）。
　　 Struts，从 http://struts.apache.org下载Struts来，这里我下载的版本是1.2.4，文件名是jakarta-struts-1.2.4.zip。把这个包解开，有如下东西：
　　contrib：这个目录下是struts-el，和JSTL相关，这次我们先不管它。
　　lib：这个目录是struts的核心jar包，以及所需的第三方jar包（主要是Jakarta Commons下的包），还有struts的TLD文件和DTD文件。
　　webapps：WAR形式的Struts文档和例子。
　　INSTALL、LICENSE、NOTICE、README：这几个文件就不用多说了。
　　反过来看一下，我们下面开发应用需要哪些关键东西：struts核心的jar包（这个当然少不了），所需的第三方jar包，要用struts的自定义标记就需要哪些TLD。
　　 第二步，建立Web应用目录
　　首先，按照Servlet规范建立Web应用目录，如下：
　　1．建立Web应用根目录，这里我建立的目录为D:/tech-art/firstapp
　　2．在firstapp下建立目录WEB-INF，注意目录名的所有字母一定要大写。
　　3．在WEB-INF下建立classes目录和lib目录。将struts安装包中lib目录下所有的.jar文件考到WEB-INF下新建的lib目录下。
　　4．在WEB-INF下建立src目录以存放java源文件
　　5．在WEB-INF下建立tlds目录，将struts安装包中lib目录下所有的.tld文件复制到这个目录中。
　　6．在WEB-INF下建立web.xml文件。这里为了简单起见，我们直接复制struts安装包webapps目录下struts-blank应用的web.xml，先放到这里稍后再做处理。
　　7．将struts安装包webapps目录下struts-blank应用的struts-config.xml、validation.xml和validator-rules.xml复制到WEB-INF目录下，先放到这里稍后再做处理（struts-config.xml是struts的核心配置文件，validation.xml和validator-rules.xml用于配置校验规则）。
　　 第三步，建立Eclipse工程
　　按照下面步骤建立Eclipse工程用于开发Web应用：
　　1．双击Eclipse下的eclipse.exe，运行Eclipse
　　2．进入Eclipse后，点击工具条的新建图标，进入新建向导，选择Java 项目，点击下一步进入“创建Java项目”对话框。
　　3．在“创建Java项目”对话框中，输入项目名称，这里我输入“My First App”；选择在外部位置创建项目，目录设置为上面第二步中建立的Web应用根目录，这里是D:/tech-art/firstapp。然后点击下一步进入“Java设置对话框”。
　　4．在“Java设置对话框”中有几项比较重要的设置：在“源”标签中，点击“添加文件夹”按扭选择WEB-INF下的src目录；点击“确省输出文件夹”后面的“浏览”，选择WEB-INF下的classes目录；到“库”标签下点击“添加外部JAR”，选择InforWeb的lib目录下的common.jar。这样，src目录下的.java文件将被Eclipse编译，编译生成的.class文件会被输出到classes目录下，同时src目录下的非.java文件会被直接复制到classes目录下。
　　5．点击“完成”按扭进入工程。建成工程后，有多种透视图可以选择，比如“Java透视图”，我习惯上使用“资源透视图”。
　　 第四步，开发第一个Struts应用
我们来建立一个简单的应用，首先是一个输入界面，你可以在这个界面中输入你的名字，然后点击提交，服务方就会生成一个新的页面向您问好。我们按照下面的步骤进行：
　　1．定义web.xml。主要是定义Struts的控制器ActionServlet，以及定义TLD文件的引用路经。我们直接修改上面复制过来的web.xml，如下：

1. <?xml version="1.0" encoding="ISO-8859-1"?>
2. <!DOCTYPE web-app
3.   PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.2//EN"
4.   "http://java.sun.com/j2ee/dtds/web-app_2_2.dtd">
5. <web-app>
6.   <display-name>My First App</display-name>
7.   <servlet>
8.     <servlet-name>action</servlet-name>
9.     <servlet-class>org.apache.struts.action.ActionServlet</servlet-class>
10.     <init-param>
11.       <param-name>config</param-name>
12.       <param-value>/WEB-INFstruts-config.xml</param-value>
13.     </init-param>
14.     <init-param>
15.       <param-name>debug</param-name>
16.       <param-value>2</param-value>
17.     </init-param>
18.     <init-param>
19.       <param-name>detail</param-name>
20.       <param-value>2</param-value>
21.     </init-param>
22.     <load-on-startup>2</load-on-startup>
23.   </servlet>
24.   <servlet-mapping>
25.     <servlet-name>action</servlet-name>
26.     <url-pattern>*.do</url-pattern>
27.   </servlet-mapping>
28.   <welcome-file-list>
29.     <welcome-file>index.jsp</welcome-file>
30.   </welcome-file-list>
31.   <taglib>
32.     <taglib-uri>/tagsstruts-bean</taglib-uri>
33.     <taglib-location>/WEB-INFtldsstruts-bean.tld</taglib-location>
34.   </taglib>
35.   <taglib>
36.     <taglib-uri>/tagsstruts-html</taglib-uri>
37.     <taglib-location>/WEB-INFtldsstruts-html.tld</taglib-location>
38.   </taglib>
39.   <taglib>
40.     <taglib-uri>/tagsstruts-logic</taglib-uri>
41.     <taglib-location>/WEB-INFtldsstruts-logic.tld</taglib-location>
42.   </taglib>
43.   <taglib>
44.     <taglib-uri>/tagsstruts-nested</taglib-uri>
45.     <taglib-location>/WEB-INFtldsstruts-nested.tld</taglib-location>
46.   </taglib>
47.   <taglib>
48.     <taglib-uri>/tagsstruts-tiles</taglib-uri>
49.     <taglib-location>/WEB-INFtldsstruts-tiles.tld</taglib-location>
50.   </taglib>
51. </web-app>

　　2．定义struts-config.xml。在这个文件中配置了应用的构件，对应用进行了描述。打开struts-config.xml修改为如下样子：

1. <?xml version="1.0" encoding="ISO-8859-1" ?>
2. <!DOCTYPE struts-config
3.     PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 1.2//EN"
4.     "http://jakarta.apache.org/struts/dtds/struts-config_1_2.dtd"
5. >
6. <struts-config>
7.     <form-beans>
8.         <form-bean
9.             name="helloForm"
10.             type="gongfei.cmc.articles.firststrutsapp.HelloForm" />
11.     </form-beans>
12.     <action-mappings>
13.         <action
14.             path="/index"
15.             forward="/input.jsp" />
16.         <action
17.             path="/hello"
18.             type="gongfei.cmc.articles.firststrutsapp.HelloAction"
19.             name="helloForm"
20.             scope="request"
21.             validate="true"
22.             input="/index" >
23.             <forward name="welcome" path="/welcome.jsp" />
24.             </action>
25.     </action-mappings>
26.     <message-resources
27.         parameter="gongfei.cmc.articles.firststrutsapp.MessageResources" />    
28.     <plug-in
29.         className="org.apache.struts.validator.ValidatorPlugIn">
30.         <set-property
31.             property="pathnames"
32.             value="/WEB-INF/validator-rules.xml,/WEB-INF/validation.xml" />
33.     </plug-in>
34. </struts-config>

　　3．实现Form Bean。这里只有一个输入项，非常简单，代码如下：

1. package gongfei.cmc.articles.firststrutsapp;
2. import javax.servlet.http.HttpServletRequest;
3. import org.apache.struts.action.ActionMapping;
4. import org.apache.struts.validator.ValidatorForm;
5. public class HelloForm extends ValidatorForm {
6.     private String name = null;
7.     public String getName() {
8.         return name;
9.     }
10.     public void setName(String name) {
11.         this.name = name;
12.     }
13.     public void reset(ActionMapping arg0, HttpServletRequest arg1) {
14.         name = null;
15.     }
16. }

　　4．建立输入界面。输入界面的核心是一个用于输入用户名的Form，需要使用Struts的自定义标记。在应用的根上点击右建选择：新建->文件，在弹出的对话筐中输入文件名input.jsp，点击完成，进入编辑器中，输入如下内容：

1. <%@ page contentType="text/html;charset=UTF-8" %>
2. <%@ taglib uri="/tags/struts-bean" prefix="bean" %>
3. <%@ taglib uri="/tags/struts-html" prefix="html" %>
4. <%@ taglib uri="/tags/struts-logic" prefix="logic" %>
5. <html:html>
6. <head>
7. <title><bean:message key="hello.input.title"/></title>
8. <html:base>
9. </head>
10. <body bgcolor="white">
11. <html:form action="hello" οnsubmit="return validateHelloForm(this);">
12.       <bean:message key="hello.input.lable.name"/>
13.       <html:text property="name" size="30" maxlength="30"/> 
14.       <html:submit property="submit" οnclick="bCancel=false;">
15.          <bean:message key="hello.input.submit"/>
16.       </html:submit> 
17. </html:form>
18. <html:javascript formName="helloForm"/>
19. </body>
20. </html:html>

　　5．在validation.xml中定义输入数据的校验规则。这里用户名输入不为空即可，如下：

1. <?xml version="1.0" encoding="ISO-8859-1" ?>
2. <!DOCTYPE form-validation PUBLIC
3.           "-//Apache Software Foundation//DTD Commons Validator Rules Configuration 1.1.3//EN"
4.           "http://jakarta.apache.org/commons/dtds/validator_1_1_3.dtd">
5. <form-validation>
6.     <formset>
7.         <form name="helloForm">
8.             <field
9.                 property="name"
10.                 depends="required">
11.                 <msg name="required" key="hello.input.error.required" /> 
12.             </field>
13.         </form>
14.     </formset>
15. </form-validation>

　　6．实现Action Bean。这里的逻辑非常简单，只需要将用户输入的用户名取出来放到Session中，以便在JSP页面中显示就可以了。当然实际应用中会涉及比这复杂的多的业务逻辑，并且经常会通过其它业务逻辑处理构件来完成业务逻辑（比如使用SessionBean）。代码如下：

1. package gongfei.cmc.articles.firststrutsapp;
3. import javax.servlet.http.HttpServletRequest;
4. import javax.servlet.http.HttpServletResponse;
5. import javax.servlet.http.HttpSession;
6. import org.apache.struts.action.Action;
7. import org.apache.struts.action.ActionForm;
8. import org.apache.struts.action.ActionForward;
9. import org.apache.struts.action.ActionMapping;
11. public class HelloAction extends Action {
13.     public ActionForward execute(ActionMapping mapping, ActionForm form,
14.             HttpServletRequest request, HttpServletResponse response)
15.             throws Exception {
17.         HelloForm helloForm = (HelloForm) form;
18.         String name = helloForm.getName();
19.         // 在这里可以实现更多的业务逻辑，或者调用专门的业务逻辑处理构件
20.         HttpSession session = request.getSession();
21.         session.setAttribute("my.first.app.Name", name);
23.         return (mapping.findForward("welcome"));
25.     }
26. }

　　7．建立输出页面。输出页面非常简单。在应用的根上点击右建选择：新建->文件，在弹出的对话筐中输入文件名welcome.jsp，点击完成，进入编辑器中，输入如下内容：

1. <%@ page contentType="text/html;charset=UTF-8"%>
2. <%@ taglib uri="/tags/struts-bean" prefix="bean" %>
3. <%@ taglib uri="/tags/struts-html" prefix="html" %>
4. <%@ taglib uri="/tags/struts-logic" prefix="logic" %>
5. <html:html>
6. <head>
7. <title><bean:message key="hello.welcome.title"/></title>
8. <html:base>
9. </head>
10. <body bgcolor="white">
11. <bean:message key="hello.welcome.hello"/><bean:write name="my.first.app.Name" />
12. </body>
13. </html:html>

　　8．建立message-resource资源文件。我们将所有的界面信息放到了message-resource资源文件中。在WEB-INF/src/gongfei/cmc/articles/firststrutsapp目录下新建名字为MessageResources.properties文件，输入如下内容：

1. hello.input.title=Who are you?
2. hello.input.lable.name=Your Name:
3. hello.input.submit=Go
4. hello.welcome.title=Hello
5. hello.welcome.hello=Hi,
6. hello.input.error.required=Please input you name!

　　 第五步，结合InforWeb进行调试
　　下面需要将上面建立的Web应用加入到InforWeb中，以便调试。这个过程比较简单：
　　启动InforWeb，从浏览器进入InforWeb的管理工具，新建一个web应用，存放路径设置为Web应用的根目录，这里为“D:/tech-art/firstapp”；访问路径设置为“/msa”；允许应用动态更新选择“是”，以便在修改类之后能自动装载（在最终业务环境中这个选项要选择“否”）。最后点击保存按钮就可以访问了。

　　 第六步，访问Web应用
　　打开浏览器，输入访问URL，这里是HTTP://127.0.0.1/msa/index.do，就进入了应用输入界面，输入你的名字，点击Go。好，访问成功！