手把手教你在Eclipse中配置开发Struts

作者:baggio785

来源:http://blog.csdn.net/baggio785

原文地址:http://blog.csdn.net/baggio785/archive/2006/03/10/620535.aspx(转载请注明出处)

日期：2006-3-9

关键词：Eclipse，MyEclipse，Struts，Java

前言

本文根据实例详细介绍了如果在Eclipse中配置并开发Struts。此前在网上也看到过不少此类文章，而且还是有不少网友问此类问题。所以想根据自己的实际经验，并结合例子写一篇详细的文章，一个是方便大家，再一个也是检验一下自己的知识。

本文是偶的一些拙见，有不正确的地方请大家多多评论指正。

　

开发环境

JDK1_4_03，点击下载
tomcat5.0.28，点击下载
Eclipse3.1.2，点击下载；下载中文包,中文包是3.1.1，但是也适用3.1.2
MyEcilpse4.1，点击下载MyEcilpse4.1及破解补丁
TomcatPlugin插件，点击下载TomcatPlugin插件
更多Eclipse插件下载，点击进入

　

需求

本文所要结合的Struts应用实例为用户登录（logon），用户登录（logon）的需求为：

1  接收用户名和密码，跳转到成功页面，并提示“<username>欢迎您登录！”。
2  如果用户名为空就提交表单，则提示“请输入用户名！”。
3  如果密码为空就提交表单，则提示“请输入密码！”。
4  如果输入非法用户名，则提示“请输入正确的用户名！”。
5  通过模型组件，保存登录信息。

登录应用实例的框架介绍

用户登录(logon)应用由以下模块组成：
1  模型（M）：模型为一个JAVABEAN组件－SaveLogon，包含username（用户名）和userpassword（密码）两个属性，提供读取和设置属性的方法get/set，以及保存登录信息的方法saveToDb()。saveToDb的任务是把登录信息保存到持久化存储系统（例如数据库）。
2  视图（V）：视图包括两个JSP文件，以及一个ActionForm Bean－logonForm。JSP文件分别为：logon.jsp、success.jsp。logon.jsp负责接受用户输入的用户名和密码以及显示出错信息，success.jsp负责显示登录成功信息。
3  控制器（C）：控制器为Action类logonAction。对数据进行业务逻辑验证、调用模型组件保存登录信息、选择视图组件返回给用户。

　

Struts的工作机制

用户在视图组件（logon.jsp）中输入用户名和密码并提交HTML表单，Struts框架会先读取WEB.XML中关于servlet的配置，然后自动将表单数据封装到ActionForm Bean中，在本例中是logonForm。logonForm会对提交的数据进行数据合法性验证（例如最短长度、是否包含非法字符等）。如果ActionForm Bean验证未通过，则logonForm返回ActionErrors对象，Struts框架会把ActionErrors对象保存在request范围内，并把请求转发到视图组件，并在视图组件中通过<html:errors/>标签，展示request范围内的ActionErrors对象所包含的错误信息；如果通过ActionForm Bean验证，则logonForm返回的ActionErrors对象为NULL，Struts框架将表单数据提交到控制器组件logonAction，控制器对表单数据进行业务逻辑验证，如果logonAction验证未通过，则创建包含错误信息的ActionMessages对象，并通过saveErrors方法把ActionMessages对象保存到request范围内，并把请求转发到视图组件，并在视图组件中通过<html:errors/>标签，展示request范围内的ActionErrors对象所包含的错误信息；如果logonAction验证通过，则Struts框架访问模型组件，然后Struts框架会返回ActionFoward对象，并根据Struts-config.xml文件的配置情况，决定将ActionFoward对象包含的转发信息传递到那一个视图组件。

　

部署Struts框架

Struts的工作机制大家都有了一定的了解了，现在介绍如何在Eclipse中部署Struts框架。

本文的环境前文已经提到，Eclipse以及其插件MyEclipse和TomcatPlugin的安装本文不介绍，请参考其他文章。关于Eclipse的相关文章请看：http://blog.csdn.net/baggio785/category/148174.aspx。

1    新建一个项目

1）  选择Java >> Tomcat Project，下一步，如图一

（图一）

2）填写项目名称，如果不采用项目所在目录的缺省值，请修改，点击完成。如图二

（图二）

2    创建Struts框架

1）    右键选择项目 >> 新建 >> 其他 >> MyEclipse >> Web-Struts >> Struts 1.2 >> Struts 1.2 Form,Action & JSP。如图三。如果这一步出现错误，本文不做描述，请参考我的另一边文章－MyEclipse中创建Struts出现错误的解决办法。

（图三）

2）    配置Struts ActionForm  

因为本文的Struts应用实例为用户登录，所以Use case选用logon。Superclass选择如图所示，其他默认。如图四

（图四）

接下来填写Optional Details，输入Form表单项，本例为用户名（username）和密码（userpassword）。点击Add，输入请参考图五、图六。

（图五）

（图六）

输后完毕，Optional Details的Form Properties中会显示。如图七

（图七）

Methods选项卡的设置我们采用默认设置，不去修改。

点击JSP选项卡，将“Create JSP form”选项的勾选中，采用默认设置“/form/logon.jsp”。如图八

（图八）

3）    配置Struts Action

以上步骤完成了对Form的配置，下面配置Action。

在图八中点击下一步，采用默认即可。如图九

（图九）

Parameter和Methods选项也采用默认。

点击Forwards选项卡，点击Add，配置成功页面信息。本文选取根目录的success.jsp作为成功页面，Name为logon_sc。如图十

（图十）

输后完毕，Optional Details的Forwards中会显示。如图十一

（图十一）

点击完成。

Struts已经配置完毕。看看Eclipse中，项目中多了一些东东，例如struts相关的jar，以及struts-config.xml和tld文件。struts-config.xml的代码如下：

代码清单一（struts-config.xml）

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE struts-config PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 1.2//EN" "http://struts.apache.org/dtds/struts-config_1_2.dtd">

<struts-config>

<data-sources />

<form-beans >

<!--这里是ActionForm的配置信息，ActionForm Bean的name为logonForm，对应的类为com.mystruts.struts.form.LogonForm-->

<form-bean name="logonForm" type="com.mystruts.struts.form.LogonForm" />

</form-beans>

<global-exceptions />

<global-forwards />

<action-mappings >

<!--这里是Action组件的配置信息，描述了从特定的请求路径到响应的Action的映射-->

<!--attribute设置Action关联的ActionForm在request或者session范围内的key.就是在request或者session共享内的名称-->

<!--input指定包含表单的URL,当表单验证失败的时候发送的URL-->

<!--name指定和该Action关联的Form名字.该名字必须是在form-bean中定义过的,可写可不写-->

<!--path指定请求访问Action的路径，必须以/开头-->

<!--scope指定Form的存在范围，例如request-->

<!--type指定Action组件对应的类-->

<action

attribute="logonForm"

input="/form/logon.jsp"

name="logonForm"

path="/logon"

scope="request"

type="com.mystruts.struts.action.LogonAction">

<!--这里是forward，即局部转发配置信息，登录成功后转向/success.jsp，name为logon_sc-->

<forward

name="logon_sc"

path="/success.jsp"

/>

</action>

</action-mappings>

<!--这里是消息资源文件的配置信息，用来配置Resource Bundle.用于存放本地文本消息文件。parameter指定文件名，不包含后缀名。-->

<message-resources parameter="com.mystruts.struts.ApplicationResources" />

</struts-config>

 

 

作者:baggio785

来源:http://blog.csdn.net/baggio785

原文地址:http://blog.csdn.net/baggio785/archive/2006/03/10/620579.aspx(转载请注明出处)

日期：2006-3-9

关键词：Eclipse，MyEclipse，Struts，Java

创建消息资源文件

视图组件将使用标签来输出文本内容，这些内容来自于Resource Bundle。Resource Bundle对应消息资源文件。

代码清单二（ApplicationResources.properties）

# 这里是注释
logon.page.title = &#x6211;&#x7684;&#x7B2C;&#x4E00;&#x4E2A;Struts

logon.username.error = &#x8BF7;&#x8F93;&#x5165;&#x7528;&#x6237;&#x540D;&#xFF01;

logon.userpassword.error = &#x8BF7;&#x8F93;&#x5165;&#x5BC6;&#x7801;&#xFF01;

logon.badusername.error = &#x7528;&#x6237;&#x540D;&#x4E0D;&#x80FD;&#x4E3A;admin&#xFF01;

logon.baduserpassword.error = &#x5BC6;&#x7801;&#x4E0D;&#x80FD;&#x4E3A;123456&#xFF01;

logon.success = &#x6B22;&#x8FCE;&#x60A8;&#x767B;&#x5F55;&#xFF01;

为了实现国际化，消息资源文件中的汉字采用的是UTF-8编码。查看如何实现汉字转化为UTF-8。

　

创建JSP文件

logon.jsp（所在路径为/form/）接收用户输入的用户名和密码，并显示表单验证失败的错误信息。success.jsp显示登录成功的信息。

JSP文件全部使用客户化标签，无JAVA代码，输入的文本内容完全由标签提供。

代码清单三（logon.jsp）

<%@ page contentType="text/html;charset=UTF-8" language="java"%>
<%@ taglib uri="/WEB-INF/struts-bean.tld" prefix="bean"%>

<%@ taglib uri="/WEB-INF/struts-html.tld" prefix="html"%>

<%@ taglib uri="/WEB-INF/struts-logic.tld" prefix="logic"%>

　

<html>

<head>

<!--title使用客户化标签，文本内容对应的是消息资源文件中logon.page.title的值-->

<title><bean:message key="logon.page.title"/></title>

</head>

<body>

<html:form action="/logon" method="POST">

&#x7528;&#x6237;&#x540D;&#xFF1A;<html:text property="username"/><html:errors property="username"/><br/>

&#x5BC6;&#x3000;&#x7801;&#xFF1A;<html:password property="userpassword"/><html:errors property="userpassword"/><br/>

<html:submit value="&#x767B;&#x5F55;"/><html:reset value="&#x53D6;&#x6D88;"/>

</html:form>

</body>

</html>　

代码清单四（success.jsp）

<%@ page language="java" pageEncoding="UTF-8"%>
<%@ taglib uri="/WEB-INF/struts-bean.tld" prefix="bean"%>

<%@ taglib uri="/WEB-INF/struts-html.tld" prefix="html"%>

<%@ taglib uri="/WEB-INF/struts-logic.tld" prefix="logic"%>

<html:html lang="true">

<head>

<html:base />

<title>success.jsp</title>

</head>

　

<body>

<logic:present name="savelogon" scope="request">

<bean:write name="savelogon" property="username"/>

<bean:message key="logon.success"/>

</logic:present>

</body>

</html:html>

　

创建ActionForm Bean组件logonFrom

用户提交HTML表单后，Struts框架会自动把表单数据封装到ActionForm Bean（本例是logonForm）中。ActionForm Bean的属性必须与HTML表单的字段一一对应。ActionForm Bean会对表单数据进行验证，并提供将HTML表单的字段值重置为默认值的方法（等同于HTML中Form表单的Reset）。

代码清单五（logonFrom.java）

package com.mystruts.struts.form;

import javax.servlet.http.HttpServletRequest;

import org.apache.struts.action.ActionErrors;
import org.apache.struts.action.ActionForm;
import org.apache.struts.action.ActionMapping;
import org.apache.struts.action.ActionMessage;

/**
* MyEclipse Struts
* Creation date: 02-27-2006
*
* XDoclet definition:
* @struts.form name="logonForm"
*/
public class LogonForm extends ActionForm {

// --------------------------------------------------------- Instance Variables

/** userpassword property */
private String userpassword;

/** username property */
private String username;

// --------------------------------------------------------- Methods

/**
* Method validate
* @param mapping
* @param request
* @return ActionErrors
*/
//用于表单验证的validate方法
public ActionErrors validate(
ActionMapping mapping,
HttpServletRequest request) {

//声明一个ActionErrors对象
ActionErrors errors = new ActionErrors();

//如果用户名验证失败，将ActionMessage对象保存到ActionErrors对象errors中。logon.username.error对应消息资源文件中的logon.username.error的值。
if(username==null || username.length()<3){
errors.add("username", new ActionMessage("logon.username.error"));
}

//如果密码验证失败，将ActionMessage对象保存到ActionErrors对象errors中。logon.userpassword.error对应消息资源文件中的logon.userpassword.error的值。
if(userpassword==null || userpassword.length()<3){
errors.add("userpassword", new ActionMessage("logon.userpassword.error"));
}
// TODO Auto-generated method stub

//返回ActionErrors对象errors，Struts框架会把errors保存在request范围内，并将请求转发到视图组件logon.jsp中，通过<html:errors/>来显示错误信息
return errors;
}

/**
* Method reset
* @param mapping
* @param request
*/
public void reset(ActionMapping mapping, HttpServletRequest request) {

// TODO Auto-generated method stub
this.username = null;
this.userpassword = null;
}

/**
* Returns the userpassword.
* @return String
*/
public String getUserpassword() {
return userpassword;
}

/**
* Set the userpassword.
* @param userpassword The userpassword to set
*/
public void setUserpassword(String userpassword) {
this.userpassword = userpassword;
}

/**
* Returns the username.
* @return String
*/
public String getUsername() {
return username;
}

/**
* Set the username.
* @param username The username to set
*/
public void setUsername(String username) {
this.username = username;
}

}

　

创建控制器Action组件logonAction

logonAction对表单数据进行业务逻辑验证。

代码清单六（logonAction.java）

package com.mystruts.struts.action;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

import org.apache.struts.action.Action;
import org.apache.struts.action.ActionForm;
import org.apache.struts.action.ActionForward;
import org.apache.struts.action.ActionMapping;
import org.apache.struts.action.ActionMessage;
import org.apache.struts.action.ActionMessages;

import com.mystruts.struts.SaveLogon;
import com.mystruts.struts.form.LogonForm;

/**
* MyEclipse Struts
* Creation date: 02-27-2006
*
* XDoclet definition:
* @struts.action path="/logon" name="logonForm" input="/form/logon.jsp" scope="request" validate="true"
* @struts.action-forward name="logon_sc" path="/success.jsp"
*/
public class LogonAction extends Action {

// --------------------------------------------------------- Instance Variables

// --------------------------------------------------------- Methods

/**
* Method execute
* @param mapping
* @param form
* @param request
* @param response
* @return ActionForward
*/
//通过ActionForm Bean的验证后，Struts框架会自动调用execute方法
public ActionForward execute(
ActionMapping mapping,
ActionForm form,
HttpServletRequest request,
HttpServletResponse response) {
// TODO Auto-generated method stub

//获得表单数据中的username
String username = (String)((LogonForm)form).getUsername();

//获得表单数据中的userpassword
String userpassword = (String)((LogonForm)form).getUserpassword();

//定义非法用户名
String badusername = "admin";

//定义非法密码
String baduserpassword = "123456";

//声明一个ActionMessages对象
ActionMessages errors = new ActionMessages();

if(badusername.equals(username)){

//如果用户名验证失败，将ActionMessage对象保存到ActionMessages对象errors中。logon.badusername.error对应消息资源文件中的logon.badusername.error的值。
errors.add("username",new ActionMessage("logon.badusername.error",badusername));

//保存ActionMessages对象errors到request范围。
saveErrors(request,errors);

//返回ActionForward对象，Struts框架会把请求转发到视图组件logon.jsp中，通过<html:errors/>来显示错误信息。
return(new ActionForward(mapping.getInput()));
}

if(userpassword.equals(baduserpassword)){
errors.add("userpassword",new ActionMessage("logon.baduserpassword.error",baduserpassword));
saveErrors(request,errors);
return(new ActionForward(mapping.getInput()));
}

//定义模型组件SaveLogon
SaveLogon sl = new SaveLogon();
sl.setUsername(username);
sl.setUserpassword(userpassword);
sl.saveToDb();

//控制器组件将SavaLogon对象保存到request范围，savalogon对应视图组件success.jsp中<login:present>标签的name以及<bear:write>标签的name
request.setAttribute("savelogon",sl);

//清除request范围内的ActionForm Bean，因为后面的请求已经不需要了
request.removeAttribute(mapping.getAttribute());

//控制器组件将信息转交到视图组件logon.jsp，logon_sc对应struts-config.xml中的forward元素的name
return(mapping.findForward("logon_sc"));
}

}

　

创建模型组件SaveLogon

本模型提供get/set方法，以及saveToDb方法。在例子中并未实现saveToDb方法。

代码清单七（SaveLogon.java）

package com.mystruts.struts;

/**
* @author Administrator
*
*/
public class SaveLogon {

private String username = null;
private String userpassword = null;

public void setUsername(String username){
this.username = username;
}

public String getUsername(){
return this.username;
}

public void setUserpassword(String userpassword){
this.userpassword = userpassword;
}

public String getUserpassword(){
return this.userpassword;
}

public void saveToDb(){

}

}

　

运行

如果用户名和密码为空，运行结果如图十二、图十三、图十四所示。

（图十二）

如果用户名为admin，运行结果如图十三

（图十三）

如果通过验证，运行结果如图十四

（图十四）

　

　

小结

1    为了降低偶合度，应该建立一个存放常量的JAVA文件。例如logonAction.java中的String badusername = "admin"，或者request.setAttribute("savelogon",sl)的第一个参数。

2    要实现Struts的国际化，支持多国语言，编码方式一定要为UTF-8。

3           在配置Action时，见图九，如果选取redirect，则在struts-config.xml中的action元素会多一个属性，redirect="true"。运行的结果是success.jsp中无法获得request范围内的savelogon对象。

 

运行注意事项：

在windows--preferences--myeclipse--application server 里面设置好你使用的应用服务器，并设成enable状态，那么在myclipse的run/stop server里面就会出现相应的选项。右击工程--myeclipse--add remove project deployments 把工程部署到应用服务器上，然后启动服务，打开ie输入地址，就可以运行了。