MyEclipse Struts_1.x 快速入门中文版PDF

MyEclipseStruts1.x教程翻译:刘长炯[e-mail]:日期:2007-11-16声明:中文文字版权归刘长炯所有,原文及相关的图片等资源的版权归原作者GenuitecL.L.C公司所有.目录1.前言2.简介3.系统需求4.设置新项目和目录结构5.开始Struts项目1.Struts项目的组成部分2.构造我们的应用6.运行示例代码7.小结8.用户反馈1.前言这个文档基于MyEclipse6.0GA编写.所有的截屏基于Eclipse,MyEclipseEnterpriseWorkbench,和WindowsXP的默认设置.如果你在读取这份文档时遇到困难,请查看用户反馈部分了解如何向MyEclipse文档团队提供反馈.2.简介在这个教程中我们将使用MyEclipseEnterpriseWorkbench来开发和测试一个简单的Struts示例程序.您可以不需要事先了解Struts或者MyEclipse的相关知识.这个教程,因为框架之间的相似和特性覆盖,将会和JSF教程很类似.我们将会按照同样的项目目标和大纲,这样当你熟悉MyEclipse中的Struts工具后可以对JSF和Struts进行比较.3.系统需求下面是这个指南所使用的软件的列表:•JavaSE5(Sun或者IBM)••MyEclipse6.0GA(All-In-One安装程序)••Tomcat5.0.x(首选5.0.28,或者其它符合标准的Servlet/EJB容器)••ForthisdemotheUserNameismyeclipseandthePasswordismyeclipseaswell.注意:在安装过JDK并且重启你的计算机后,请确保首先安装Eclipse然后是MyEclipse,昀后安装Tomcat.安装MyEclipse的操作说明,请阅读安装教程.所有这些软件安装完毕后,你需要在MyEclipse中设置Tomcat5连接器,详细过程请参考ApplicationServer教程,这样你才能发布和执行示例程序.4.设置新项目和目录结构为了组织我们的开发过程,我们需要在MyEclipse中创建一个新的Web模块项目并向它添加Struts功能(StrutsCapabilities)模块.你可以通过向导来创建一个web项目,请通过选择菜单项FileNewOtherMyEclipseJavaEnterpriseProjectsWebProject来打开,如下图1所示.图1-WebProject向导对话框现在输入新项目信息,如图2所示:图2-WebProject设置一旦Web项目创建了,我们需要给它添加Struts功能.这个操作可以通过PackageExplorer视图的项目根节点上右键点击,选择弹出菜单中的MyEclipseAddStrutsCapabilities,如图3所示.图3-向Web项目添加Struts功能Struts对话框的默认值对这个教程来说不需要修改就可以使用.不过,你也可以通过修改Basepackagefornewclasses为你希望存放的位置.这里我们都保持默认值,如图4所示.图4-配置Struts功能这个向导结束后,项目的目录结构将会如下图5所示图5-配置后的项目布局现在项目已经创建,我们可以开始修改并创建我们自己的应用相关的代码了,如下一部分所示.5.开始Struts项目在这一部分我们将集中精力来创建示例应用,我们的例子来模拟昀简单的网站登录屏幕.因此,我们只需要2个JSP页面,一个用来提示用户登录,另一个显示登录成功.这两个页面分别被命名为userLogin.jsp和userLoginSuccess.jsp.为了简化,如果登录过程中验证失败,我们将会将用户重定向回userLogin.jsp页面并显示出错信息.开始一个Struts项目的时候,如果能够实现列出应用程序的工作流程,这对整个开发团队来如何更好的组织各个部分都是很有用的.昀简单的显示流程的办法是使用Struts编辑器的设计模式来创建.Struts编辑器提供了一系列的组件拖放工具面板,使你可以在设计的时候快速的建立页面来构造原型.我们的示例登录程序流程如下面的图6所示.注意:截图中所显示的应用程序流程使用Struts设计器制作.我们将在下一部分来详细介绍如何打开和使用它.图6-示例应用程序流程从设计布局这里,我们可以看到应用从显示页面userLogin.jsp开始.登录页面将会调用userLoginaction来执行登录操作.如果登录时验证失败或者其它问题,用户登录action将会将用户引导到userLogin.jsp页面.当然,如果登录成功,程序将会前进到userLoginSuccess.jsp页面.5.1Struts项目的组成部分典型的Struts项目将会由下列几种元素组成:•JSPs•Actions•ActionForwards*•ActionForms**•Struts部署描述符:struts-config.xml*ActionForwards是struts-config.xml文件中定义的forward条目,定义了当Action执行完毕后所进入的路径.我们将不会设计如何自己来实现ActionForward类,尽管这样是可以的,工具也支持高级用户来这样做.**ActionForms可以用DynaForms来代替,这样用户可以不用创建具体的ActionForm来包装页面表单值.在MyEclipse中创建这些元素中的任一种(除了文件struts-config.xml)可以通过3种不同的方式来完成:方式#1:使用菜单FileNewOther...J2EEStruts1.1(或者1.2,1.3)然后选择Struts向导,如图7所示:图7-所有可用的Struts向导向导很直接,将会提示你输入给定的Struts组件支持的所有属性值.一些向导比其它的更复杂.例如图8中显示的StrutsAction向导,全面的包含了所有StrutsAction所支持的功能:图8-新建StrutsAction向导方式#2:使用自定义的大纲视图,这个视图可以在Struts编辑器的源代码面板打开时看到.从大纲视图上,你可以在任何一个根级别的节点上右键点击,然后来激活向导来创建对应类型的元素,或者来使用向导编辑存在的元素.图9显示了如何使用这些上下文敏感的向导之一.图9-在大纲视图中启动Struts向导你应该注意到截屏里面的一些操作实际上是一系列逻辑上相关的向导的组合,可以让你来创建一个完整的流程.这些向导被无缝集合在一起来重用一些共用的值然后昀小化需要人工重新输入的内容.方式#3:如图10所示的StrutsEditor的设计面板,也是一个非常方便的创建各种Struts元素的地方.设计器可以通过打开文件struts-config.xml来访问.在编辑器的下方你可以点击Design面板来打开设计器.图10-打开Struts设计器切换到设计器之后的样子如下面的图11所示:图11-Struts设计器一览现在我们已经完整介绍了如何创建Struts项目的不同组件,接着在下一部分中我们将会创建登录示例应用程序的不同的部分.5.2构造我们的应用首先通过创建JSP页面来开始建造我们的示例应用程序.因为我们的程序只是模拟网站的登录,所以我们只需要两个JSP页面:userLogin.jspanduserLoginSuccess.jsp.像多数Struts应用程序一样,如果登录时出现了问题,我们将会把用户送回到页面userLogin.jsp然后显示一个错误(这是为什么我们不需要来写loginUserFailure.jsp页面).我们先来创建userLoginSuccess.jsp页面.虽然这样看起来好像我们首先创建的是流程昀后的那个页面,但是这样做是因为我们可以使用新建Form,Action和JSP向导来同时创建第一个页面和相关的Action和ActionForm.在设计视图下,先点击组件工具栏上的JSP工具,然后再点击画布,这样来创建页面userLoginSuccess.jsp.参考下面的图12:图12-使用设计器创建JSP在点击画布后,将会显示如图13所示的熟悉的新建JSP对话框.注意:请确保选择StandardJSPusingStruts1.1模版图13-配置JSP向导点击Finish后,如图14所示,将会显示新建好的页面的设计器.注意:添加了新的JSP后,MyEclipse将会在JSP编辑器中打开那个新JSP页面,下面的截屏显示了返回到设计器后程序看起来的样子,不要在创建了JSP页面后感到困惑(注:困惑设计器消失了).图14-显示了我们的JSP页面的Struts设计器剩下要做事情就是输出一个消息来通知用户登录已经成功了,这样就完成了页面.这个页面的完整的源代码清单如图Figure14a所示.注意:为了是这个教程更容易的来理解(以及让代码段更简短),下面的JSP页面和第一次打开页面时所看到的内容是不一样的,你可以把这里的代码赋值过去或者修改新建JSP页面后所生成的页面里面的默认JSP模版代码.userLoginSuccess.jsp%@pagelanguage=java%%@tagliburi==bean%%@tagliburi==html%%@tagliburi==logic%%@tagliburi==tiles%%@tagliburi==template%%@tagliburi==nested%!DOCTYPEHTMLPUBLIC-//W3C//DTDHTML4.01Transitional//ENhtml:htmllocale=trueheadtitleMyStruts'userLoginSuccess.jsp'endingpage/title/headbodyHellobean:writename=userNamescope=request/,yousuccessfullyloggedin!/body/html:html图14a-userLoginSuccess.jsp源代码清单注意这个页面很简单.这里做过的唯一重要的事情就是body标签里面的内容,打印位于应用的request范围内的userName变量的值.所以,在我们后面要创建的action中,我们需要在request里面设置一个名为userName的属性.现在我们依然需要创建userLogin.jsp页面,对应的ActionForm和Action.听起来好像有很多工作要做,但是MyEclipse可以通过串在一起的NewForm,NewForm,Action和JSP向导来完成.创建userLogin.js