来源:互联网 作者: 发布:我要购物网收集整理 发布时间:2006-8-31 人气:54 | |
[目标] 实现一个最简单的Struts程序。程序包括一个输入页和输出页,输入页。 对于学习程序设计,我们已习惯于从Hello程序开始,实践证明,这是一个最有效的入门方法。下面就着手设计我们的第一个Struts程序----Hello程序。Hello程序的目标是实现从一个输入JSP页面中的输入框输入一个“Hello”单词,在另一个输出JSP页面中显示“Hello”一词。根据Struts框架的要求,这个Hello程序将包含输入JSP文件、输出JSP文件、Action文件、FormAction文件及配置文件。也就是说,这个Hello程序是一个完整的Struts程序,它可直接在Tomact、Resin等服务器上运行。
[效果] 输入页面:
[背景知识] 以前使用servlet开发应用系统的人深深感受到在java代码中嵌入大量html代码是一件非常痛苦的事,于是sun推出了JSP,解决了java代码中嵌入html代码的问题。但是很快程序员们就知道,用JSP“在html代码中嵌入大量java代码”跟“在java代码中嵌入大量html代码”是一样的非常痛。JSP是这样,ASP也是这样。于是,Craig R. McClanahan借用MVC的思想,把Java web应用程序的java和html分离开放在不同的文件中,分成了三部分,也就是struts;后来,微软也学会了这种分离方法,但微软懒一些,只分成了两部分,也就是ASP.NET。 Struts (org.apache.struts)是一个开放源代码的Web应用框架,基于MVC设计模式,使用servlet和JSP API建立,可以用来构建复杂的Web应用。它允许我们分解一个应用程序的商业逻辑、控制逻辑和表现逻辑的代码,使它的重用性和维护性更好。Struts框架是Jakarta工程的一部分,由Apache软件基金会管理。Struts可以从http://jakarta.apache.org/ struts站点下载。 Struts框架提供以下服务。 作为MVC结构中的controller的servlet. JSP里用于bean管理、HTML和JavaScript生成、模板处理和流程控制的JSP标签库。 用于国际化消息的框架。国际化你的Web应用,意味着你的Web应用在使用时可以让用户以喜爱的语言显示。这意味着你需要创建一个应用资源文件,包含每种语言的信息。 一个JDBC的实现来定义数据源和数据库连接池。 一个通用的的错误和异常处理机制,包括从一个应用程序资源文件读取错误信息。 XML语法分析。 文件上载工具。 注册机制。 一个基于Struts的应用程序的表示层(view)使用Struts标签库(taglibs)构建。来自客户的请求被传递给叫ActionServlet的servlet,它作为controller.使用了Struts的应用程序,所有需要通过框架的请求都通过ActionServlet传递。这个ActionServlet把数据从请求传递到ActionForm JavaBean。 ActionForm是代表从一个表单View组件输入数据的JavaBean。这些表单由JSP用Struts html标签库产生。这个beam由 ActionServlet生成,带request参数,它还请求ActionForm来验证用户提交数据的合法性。 ActionServlet通过定义一组ActionMapping来配置。一个ActionMapping是一个对象,它将请求中的URL映射到由应用程序开发者提供的处理请求的组件。ActionServlet和ActionMapping的配置在XML配置文件中完成。 专用的应用程序用于处理请求的组件叫Action类。在MVC结构中,它们代表模型。它们可能用于验证用户输入的合法性,假如在信息处理过程中出现了应用程序错误,Action类可以创建一个error对象的实例,然后保存庆HTTP request对象中。如果在Action类中的逻辑成功地被招待类给Controller传递一个ActionForward对象,代表所需的描绘响应的JSP。ActionForward有两种:专门转发给特定的Action类或全局转发(任何一个Action类可以把这些ActionForwards转给Controller)。
[步骤]
1、打开Visual Struts开发环境: (1)把文件拷贝到本地硬盘的一个目录下,例如 F:/JavaWebStudio/ (2) 运行BIN目录下的JavaWebStudio.exe文件(同时自动在桌面建立一个快捷方式,第二次启动时,只需点击桌面的快捷方式即可),出现如下启动界面:
2、建立一个“空的Struts普通模板”应用程序: 选择菜单“文件”—“新建”—“新建项目”,弹出新建项目对话框,如图3-1所示: 在对话框中选择“空的Struts普通用模板”,在项目名称中输入“Simple”,package (包名)和位置(项目的路径)采用默认的值就行,当然也可以根据需要改变。最后点击“确定”按钮完成新项目的建立。
+------config +------lib +------src +------web -------build.xml -------hello.prj 在Simple项目根目录下包含四个子目录和两个文件,这是JSPStudio项目的标准结构,最好不要改变它们默认的名称,否则会出现问题。
3、利用Struts文件向导建立新的应用: 在JSPStudio文件管理器内点击鼠标右键,在弹出的菜单中选择“Struts文件向导”进入Struts文件向导对话框,也可以选择菜单“文件”—“新建”—“ Struts文件向导”进入Struts文件向导对话框。如图3-3所示:
刷新JSPStudio文件管理器,这时发现web目录下自动生成了两个文件,分别是HellWord.jsp和HellWord.jsp,前者是输入JSP文件,后者是输出JSP文件;src/emptyprj目录下自动生成了两个文件,分别是HellWord Action.java和HellWord Form.java,前者是Action文件,后者FormAction文件。
4、编译、启动服务器:
C:/Documents and Settings/Administrator/桌面>F: F:/>cd F:/JavaWebStudio/JavaWebStudioWorkDir/Simple F:/JavaWebStudio/JavaWebStudioWorkDir/Simple>ant -buildfile build.xml Buildfile: build.xml prepare: [mkdir] Created dir: F:/JavaWebStudio/jakarta-tomcat-5.0.24/webapps/Simple [copy] Copying 2 files to F:/JavaWebStudio/jakarta-tomcat-5.0.24/webapps/Simple [mkdir] Created dir: F:/JavaWebStudio/jakarta-tomcat-5.0.24/webapps/Simple/WEB-INF [copy] Copying 6 files to F:/JavaWebStudio/jakarta-tomcat-5.0.24/webapps/Simple/WEB-INF [mkdir] Created dir: F:/JavaWebStudio/jakarta-tomcat-5.0.24/webapps/Simple/WEB-INF/classes [copy] Copying 5 files to F:/JavaWebStudio/jakarta-tomcat-5.0.24/webapps/Simple/WEB-INF/classes [mkdir] Created dir: F:/JavaWebStudio/jakarta-tomcat-5.0.24/webapps/Simple/WEB-INF/lib [copy] Copying 18 files to F:/JavaWebStudio/jakarta-tomcat-5.0.24/webapps/Simple/WEB-INF/lib [mkdir] Created dir: F:/JavaWebStudio/JavaWebStudioWorkDir/wars compile: [javac] Compiling 3 source files to F:/JavaWebStudio/jakarta-tomcat-5.0.24/webapps/Simple/WEB-INF/classes dist: [jar] Building jar: F:/JavaWebStudio/JavaWebStudioWorkDir/wars/Simple.war BUILD SUCCESSFUL Total time: 5 seconds 上述输出表明利用ant 编译build.xml所设置的项目已成功。把编译结果拷贝到tomcat服务器webapps目录下,并生成打包文件Simple.war。
5、启动服务器: 点击工具条上的启动服务器按钮或选择菜单“运行”—“ 启动服务器”启动服务器jakarta-tomcat服务器。内容如下:
6、运行: 展开文件管理器Simple项目下web目录,可见到HelloWord.jap和HelloWordOut.jsp文件,通过双击打开HelloWord.jap文件,如图所示。编辑窗口分上下两部分,上部分是源程序编辑,下部分是可视化编辑,与Dreamweaver MX编辑窗口相似。 点击工具条上的运行按钮或选择菜单“运行”—“ 运行(web浏览)”这时打开显示出HelloWord.jsp的运行结果。在运行结果页面中的输入框中输入“Hello Word”,点击“提交”按钮,这时转发到HelloWordOut.jsp文件,HelloWordOut.jsp页面中输出“Hello Word”一词。
Hello Word
[项目文件结构]
lib包含了Struts库文件和带用其它库文件,例如struts.jar、struts-legacy.jar、commons-lang.jar和xerces.jar等文件。 src目录下包含了java原文件和资源文件,例如ApplicationResources.properties和ApplicationResources_ch.properties资源文件,前者是英语资源文件,后者是中文资源文件。新建时这个目录里还有一个子目录“emptyprj”,这个名称与建立项目时输入的package名称是一至的。Emptyprj目录下有“filters”、“jdbc”两个子目录,前者是过滤器目录,是中文解决方案,详细分析请看后面的有关滤器程序设计、中文解决方案章节,后者是数据库连接池文件,详细分析请看后面的Struts数据库应用程序设计章节。 web目录下包含了JSP、Html等web文件和Web文件用到的图片文件。新建时这个目录是空的。 build.xml文件是编译是所需的配置文件,由于JSPStudio采用的是ANT编译器,所以这个文件是JSPStudio项目中必不可少的,它是ANT标准的配置文件,所有的项目目录结构也符合ANT编译器的要求,可见JSPStudio项目与ANT具有非常好的兼容性,这也是JSPStudio的优点之一。 hello.prj文件是项目文件,XML结构,内容如下: Simple struts
emptyprj /Jave Web 项目/空的Struts普通模板 F:/JavaWebStudio/JavaWebStudioWorkDir/Simple 标签内是项目名称; 标签内是项目的类型,这个标签的内容最好不要改变;
首先是把本页定义为支持中文显示,中文编码采用GB2312格式,程序语言为Java:
接着定义支持四种Struts标签bean、html、logic和template,在该文件中没用到的标签可以去掉相应的定义,如果在文件中还需要用到自定义标签,也需要在这里加入相应的定义:
就不用说了。
4.3.2 输出JSP页面文件 输出JSP页面文件名是helloOut.jsp,主要实现输入文件提交的文本框的值,文件代码如下:
输出文件与前面输入文件唯一不同的是把
标签实现Bean属性值的输出,其中name保存Bean名,这里是“helloForm”,从后面的配置文件可以看出,它对应的类是helloForm类;property保存属性名,这里是“mybeanvariable1”,与输入文件的文本框取的属性名一至。
4.3.3 ActionForm Bean文件 Hello程序的ActionForm Bean文件实现只包含一个变量的Bean,文件名是helloForm.java,文件代码如下: package emptyprj; import javax.servlet.http.HttpServletRequest; import org.apache.struts.action.ActionError; import org.apache.struts.action.ActionErrors; import org.apache.struts.action.ActionForm; import org.apache.struts.action.ActionMapping; public final class HelloWordForm extends ActionForm { private String mybeanvariable1; public String getMybeanvariable1() { return (this.mybeanvariable1); } public void setMybeanvariable1(String mybeanvariable1) { this.mybeanvariable1=mybeanvariable1; } } 首先是定义package名: package emptyprj; 这是选用了JSPStudio默认的package名emptyprj,需注意的是package名要与目录名对应。接着引入了ActionForm Bean设计中常用的五个类HttpServletRequest、ActionError、ActionErrors、ActionForm和ActionMapping,这是JSPStudio自动加入的,实际上helloForm类只用于ActionForm类,其它部分可以删除,但这里保留它以方便以后扩展程序时用。 import javax.servlet.http.HttpServletRequest; import org.apache.struts.action.ActionError; import org.apache.struts.action.ActionErrors; import org.apache.struts.action.ActionForm; import org.apache.struts.action.ActionMapping; 接下来就是定义了helloForm、一个参数mybeanvariable1和它对应的get()、set()函数,这与普通Bean定义的方法一模一样。
4.3.4 Action文件 Hello程序的Action文件实现对输入文件提交的表单的处理,文件名是helloAction.java,文件代码如下: package emptyprj; import java.lang.reflect.InvocationTargetException; import java.util.Locale; import javax.servlet.ServletException; import javax.servlet.http.HttpSession; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import org.apache.commons.beanutils.PropertyUtils; import org.apache.commons.logging.Log; import org.apache.commons.logging.LogFactory; import org.apache.struts.action.Action; import org.apache.struts.action.ActionError; import org.apache.struts.action.ActionErrors; import org.apache.struts.action.ActionForm; import org.apache.struts.action.ActionForward; import org.apache.struts.action.ActionMapping; import org.apache.struts.action.ActionServlet; import org.apache.struts.util.ModuleException; import org.apache.struts.util.MessageResources;
public final class HelloWordAction extends Action { // 变量定义: private Log log = LogFactory.getLog("org.apache.struts.webapp.Example"); //函数定义: public ActionForward execute(ActionMapping mapping, ActionForm form, HttpServletRequest request, HttpServletResponse response) throws Exception { // Extract attributes and parameters we will need Locale locale = getLocale(request); MessageResources messages = getResources(request); HttpSession session = request.getSession(); HelloWordForm myform = (HelloWordForm) form; String variable1= myform.getMybeanvariable1(); try { if(variable1.trim().equals("")) { return new ActionForward(mapping.getInput()); } //其它代码 return (mapping.findForward("success")); } catch (Exception e) { //log.error("出错", e); //log.trace("出错"); throw new RuntimeException(e.getMessage()); } } } 首先定义处理函数execute(),可以理解为当Hello输入文件表单提交到服务器的ActionServlet,由ActionServlet调用Action的execute()函数实现商业逻辑处理,处理完成后把结果转发到输出文件中。execute()函数定义一个helloForm实例“myform”,并从提交的输入ActionForm对象实例form中读取数据,把mybeanvariable1变量的值赋给新的字符串变量variable1: helloForm myform = (helloForm) form; String variable1= myform.getMybeanvariable1(); 接下来是出错处理,try语句用于组合一个引起异常的代码块,它使我们告诉Java要注意有可能出现异常的代码段;catch:一旦掷出一个异常,需要捕获住这个异常,catch语句使程序员定义一个捕获;finally:在try/catch块结尾,程序可能需要确保一个代码块不管是否掷出了异常,总是被执行,例如不管发生什么,我们可能都需要确保关闭特定的文件; Exceptlon:一种用于存放在代码中发现的关于一个"exception"或"error"的信息的类;throws:当某些事需要关注时,我们"掷出"一个异常。这个异常被我们创建的一段处理异常的特殊代码"抓住"。涣句话说,通过掷出一个异常,我们告诉代码:出错啦,需要调用一些特殊的逻辑去处理问题。下面完它的完整结束: try { //正常代码 } catch (Exception e) { //出错处理代码 throw new RuntimeException(e.getMessage()); } finally { //最后都必需进行的处理代码 }
在try块中我们进行的变量variable1是否为空的判断,如果为空就转发到输入页,否则转发到定义为success的输出页: if(variable1.trim().equals("")) { return new ActionForward(mapping.getInput()); } //其它代码 return (mapping.findForward("success")); mapping.getInput()函数用于获取输入页的URL值,这个值与配置文件struts-config.xml中 项的input属性值相对应。
4.3.5 Struts程序配置
"-//Apache Software Foundation//DTD Struts Configuration 1.0//EN" "http://jakarta.apache.org/struts/dtds/struts-config_1_0.dtd">
type="emptyprj.HelloWordForm" />
type="emptyprj.HelloWordAction" scope="session" input="/HelloWord.jsp"> |