本章我们将会开发基于Struts2框架的Hello World.我们的Hello World程序是你开发基于Struts2框架程序的第一步.这里我们会提供循序渐进的教程来开发基于Struts2框架的Hello World程序.

教程包含基本的步骤像创建目录结构,建立build.xml文件来使用Ant构建工具创建程序.接着我们会解释在这个程序中需要的Java,Jsp和配置文件.

创建项目的目录结构 :

第一步 : 解压你下载的Struts2并拷贝Struts2-blank-2.0.6.war(如果你使用的是最新版的那么本版本可能会与你的有所不同)到你的Tomcat的webapps目录.将Struts2-blank-2.0.6.war 重命名为 Struts2tutorial,在Tomcat的webapps中将其解压.现在启动Tomcat并在你的浏览器中键入http://localhost:8080/Struts2tutorial/.你的浏览器应该显示如下 :

恭喜你已经先完成了struts 2 blank程序的安装.

第二步 : 现在将Struts2tutorial\WEB-INF\src的内容和Struts2tutorial\WEB-INF\classes目录删除,因为我们不需要struts 2 blank附带的这些文件.

第三步 : 在Struts2tutorial\WEB-INF\src中创建build.xml文件,将下面的内容拷贝到build.xml文件中去

<?xml version="1.0" encoding="UTF-8"?>  
<project name="Struts 2 Tutorial" basedir="../" default="all">  
    <! -- Project settings -->  
    <property name="project.title" value="RoseIndia Struts 2 Tutorials" />  
    <property name="project.jar.file" value="Struts2tutorial.jar" />  
  
    <path id="class.path">  
  
        <fileset dir="lib">  
  
            <include name="**/*.jar" />  
  
        </fileset>  
  
        <fileset dir="libext">  
  
            <include name="**/*.jar" />  
  
        </fileset>  
  
    </path>  
  
    <!-- Classpath for Project -->  
  
    <path id="compile.classpath">  
  
        <pathelement path="lib/commons-beanutils.jar" />  
  
        <pathelement path="lib/commons-digester.jar" />  
  
        <pathelement path="lib/struts.jar" />  
  
        <pathelement path="libext/servlet-api.jar" />  
  
        <pathelement path="libext/catalina-ant.jar" />  
  
        <pathelement path="classes" />  
  
        <pathelement path="${classpath}" />  
  
    </path>  
  
    <!-- Check timestamp on files -->  
  
    <target name="prepare">  
  
        <tstamp />  
        <copy file="src/struts.xml" todir="src/classes" />  
  
  
    </target>  
    <!-- Copy any resource or configuration files -->  
  
    <target name="resources">  
  
        <copy todir="src/classes" includeEmptyDirs="no">  
  
            <fileset dir="src/java">  
  
                <patternset>  
  
                    <include name="**/*.conf" />  
  
                    <include name="**/*.properties" />  
  
                    <include name="**/*.xml" />  
  
                </patternset>  
  
            </fileset>  
  
        </copy>  
  
    </target>  
  
    <!-- Normal build of application -->  
  
    <target name="compile" depends="prepare,resources">  
  
        <javac srcdir="src" destdir="src/classes" debug="true"  
            debuglevel="lines,vars,source">  
  
            <classpath refid="class.path" />  
  
        </javac>  
  
        <jar jarfile="lib/${project.jar.file}" basedir="src/classes" />  
  
    </target>  
    <!-- Remove classes directory for clean build -->  
  
    <target name="clean" description="Prepare for clean build">  
  
        <delete dir="classes" />  
  
        <mkdir dir="classes" />  
  
    </target>  
  
    <!-- Build Javadoc documentation -->  
  
    <target name="javadoc" description="Generate JavaDoc API docs">  
  
        <delete dir="./doc/api" />  
  
        <mkdir dir="./doc/api" />  
  
        <javadoc sourcepath="./src/java" destdir="./doc/api"  
  
            classpath="${servlet.jar}:${jdbc20ext.jar}" packagenames="*" author="true"  
  
            private="true" version="true" windowtitle="${project.title} API Documentation"  
  
            doctitle="${project.title}   
                          Documentation (Version ${project.version})"   
  
            bottom="Copyright © 2002">  
  
            <classpath refid="compile.classpath" />  
  
        </javadoc>  
  
    </target>  
  
    <!-- Build entire project -->  
  
    <target name="project" depends="clean,prepare,compile" />  
  
    <!-- Create binary distribution -->  
  
    <target name="dist" description="Create binary distribution">  
  
        <mkdir dir="${distpath.project}" />  
  
        <jar jarfile="${distpath.project}/${project.distname}.jar"  
  
            basedir="./classes" />  
  
        <copy file="${distpath.project}/${project.distname}.jar" todir="${distpath.project}" />  
  
  
  
        <war basedir="../" warfile="${distpath.project}/${project.distname}.war"  
  
            webxml="web.xml">  
  
            <exclude name="${distpath.project}/${project.distname}.war" />  
  
        </war>  
  
    </target>  
  
  
    <!-- Build project and create distribution-->  
  
    <target name="all" depends="project" />  
  
</project>  

第四步 : 在Struts2tutorial\WEB-INF\下创建libext目录,然后将最新版的Servlets api的jar文件(在本例中是servlet-api.jar)拷贝到这.这个文件将会编译我们程序中的Servlets.

第五步 : 现在在Struts2tutorial\WEB-INF\src下创建java和classes文件夹.所有的java源文件都会放在Struts2tutorial\WEB-INF\src\java,而ant构建工具将会把存放所有编译的java文件存放在Struts2tutorial\WEB-INF\src\classes.

现在我们已经成功的创建了目录结构与Struts2 Hello World的ant构建文件.在下一章中我们将会创建JSP文件,Java文件和配置文件,然后测试我们的Struts 2 Hello World程序.