Struts2 —— 基础与实践

忘是亡心i 2022-06-16 04:49 153阅读 0赞

**一、基础使用**

使用struts2.5.10

**1、配置Struts2 与 简单使用**

（1）、导包。通过实践，Struts 2.5.10必须导入的包如下：（其实在某个名为min-struts.xml 中所列的就是必须的jar包）

![Center][]

注：其中log4j-api-\*\*.jar 不同于普通的log4j -\*\*.jar，所以只能导入struts 中的该日志包，但common-logging-\*\*.jar应该是相同的。

（2）、配置web.xml。两种方式使用struts。

<servlet>
    		<servlet-name>strutsServlet</servlet-name>
    		<servlet-class>org.apache.struts2.dispatcher.servlet.StrutsServlet</servlet-class>
    	</servlet>
    	<servlet-mapping>
    		<servlet-name>strutsServlet</servlet-name>
    		<url-pattern>/*</url-pattern>
    	</servlet-mapping>
    	
    	<filter>
    		<filter-name>struts</filter-name>
    	    <filter-class>org.apache.struts2.dispatcher.filter.StrutsPrepareAndExecuteFilter</filter-class>
    	</filter>
    	<filter-mapping>
    	    <filter-name>struts</filter-name>
    	    <url-pattern>/*</url-pattern>
    	</filter-mapping>

（3）、在java源文件目录src 目录配置struts.xml （不能在其它目录或src 的子目录！）

<?xml version="1.0" encoding="UTF-8"?>
    
    <!DOCTYPE struts PUBLIC    
                "-//Apache Software Foundation//DTD Struts Configuration 2.5//EN"    
        "http://struts.apache.org/dtds/struts-2.5.dtd">  
    <struts>
    	<package name="myPackage" extends="struts-default" >
    		<action name="first">
    			<result>/loginOn.jsp</result>
    		</action>
    	</package>
    </struts>

注：action 的name属性值最后作为访问的url，访问基础格式：first.action。映射到loginOn.jsp

4、编写页面，通过struts2 实现简单跳转

index.jsp中：

<a href="first.action">first.action请求struts2</a>

说明：访问struts2的name 为first 的action。也即访问到映射的loginOn.jsp页面。

**2、新手常见问题**

常遇到错误：**There is no Action mapped for namespace /** and action name

常见原因：

（1）、struts.xml文件名错误。一定要注意拼写问题（自己就一直认为是Structs ...）；

（2）、struts.xml文件放置路径错误。一定要将此文件放置在src目录下。编译成功后，要确认是否编译到classes目录中；

（3）、struts.xml文件内容错误。尤其是 声明部分，正确配置参考：

<!DOCTYPE struts PUBLIC    
        "-//Apache Software Foundation//DTD Struts Configuration 2.5//EN"    
        "http://struts.apache.org/dtds/struts-2.5.dtd">

说明：其中的版本号保留2位，所以不同版本的struts，在此基础上改版本号即可。

参考：

（1）、[There is no Action for namespace / and..问题总结][There is no Action for namespace _ and..]  
（2）、[DOCTYPE 声明标准][DOCTYPE]

DOCTYPE 标准格式：

<!DOCTYPE rootElementName PUBLIC "PublicIdentifier" "URIreference">

其中publicIdentifier 格式如下，URIreference 为标签定义文件位置。

DTD名称格式为"注册//组织//类型 标签//语言"

**二、Struts 2 的Action 对象**

struts1 中，所有控制器都继承 org.apache.struts.action.Action 类。

struts2 中，有所改变：存在于core jar文件的com.opensymphony.xwork2包中。下面的记录都是关于struts2 的。

![Center 1][]

**1、Action 接口**

该接口定义了5个常量与execute 方法。常量分别为：SUCCESS、NONE、INPUT、LOGIN、ERROE，常量表示请求结果，并作为返回哪个页面的一个判断条件。

execute 方法便是返回这几个值中的某个，表明当前action 请求状态。

各常量值含义：

SUCCESS:
    The action execution was successful. Show result view to the end user.成功并返回一个页面
    NONE:
    The action execution was successful but do not show a view. This is useful for actions that are handling the view in another fashion like redirect.成功但不返回页面。
    INPUT:
    This result is also used if the given input params are invalid, meaning the user should try providing input again.与输入有关的请求失败，如输入不合法、输入不全等。
    LOGIN:
    The action could not execute, since the user most was not logged in. The login view should be shown.用户未登陆，无法执行action
    ERROR:
    The action execution was a failure.Show an error view, possibly asking the user to retry entering data.执行action 失败，展示失败页面

**2、应用动态Action **

所谓动态action，就是一个Action 对象（表示某类业务）中有中几个方法，每次决定请求哪个具体方法。

（1）、简单实践：PlainAction.java

package com.milan.actions;
    
    import com.opensymphony.xwork2.ActionSupport;
    
    public class PlainAction extends ActionSupport{
    	private static final long serialVersionUID = 1L;
    	public String actionA(){
    		return "actionA";
    	}
    	public String actionB(){
    		return "actionB";
    	}
    }

（2）、struts.xml 中配置该Action对象：（部分代码）

<struts>
    	<package name="myPackage" extends="struts-default" >
    		<action name="first">
    			<result>/loginOn.jsp</result>
    		</action>
    		<action name="plainAction" class="com.milan.actions.PlainAction">
    			<result name="actionA" type="">/showA.jsp</result>
    			<result name="actionB" type="">/showB.jsp</result>
    		</action>
    	</package>
    </struts>

说明：两个关键属性，result 元素的name属性值取该action 的某个方法的返回值，通常设置与对应方法名相同。type 用于设置返回类型，如转发还是重定向，具体取值暂不讨论。

（3）、页面中请求

<a href="first.action">first.action请求struts2</a>
    <a href="plainAction!actionA">请求actionA并到达showA.jsp页面</a>
    <a href="plainAction!actionB">请求plainAction的actionB方法并到达showB.jsp页面</a>

注：请求一个方法的action：actionName.action，动态请求action：actionName!方法名。

**三、关于Struts 2 中的配置**

使用Struts 2 时需配置相关文件，以使各程序模块之间可以通信。

**1、Struts 2 的配置文件类型**

（1）、struts-default.xml：位于core jar包中（该包中还存放了许多dtd文件）；是struts2 提供的配置文件。

（2）、struts-plugin.xml：位于struts2 提供的各插件的包中。

（3）、struts.xml：Web 应用默认的struts 2 配置文件，需自己编写。

（4）、struts.properties：struts 2 中属性配置文件，需自己编写。

（5）、web.xml：即该应用的web.xml ，在里面配置Struts 2 的StrutsServlet 或 StrutsPrepareAndExecuteFilter 。

**2、配置Struts 2 的package**

实例：

<package name="parentPackage" extends="struts-default" 
    		namespace="resource">	
    	</package>
    	<package name="myPackage" extends="parentPackage" namespace="/jsp">
    		<action name="first">
    			<result>/loginOn.jsp</result>
    		</action>
    	</package>

说明：package 中name属性就是个标识符，用于继承的，不与文件夹对应。namespace 与文件夹对应，所以注意是否要加"/"。

此时访问该action路径应该为：

<a href="resource/jsp/first.action">路径加first.action请求struts2</a>

对应的目录应该为：

![Center 2][]

说明：继承包后，路径叠加。无论直接继承于哪个包，都要直接或间接继承于struts-default 包，该包在struts-default.xml中定义，用于配置struts2 相关信息。

**3、配置struts 2 中action**

略。

**四、MVC 理解**

JSP /Servlet ：

Servlet 可充当控制器；

SpringMVC ：

控制器为实现Controller 接口的类，web.xml中配置 DispatcherServlet 的servlet 对象转向对应的<自定义的该servlet名>-servlet.xml（见下面 **说明一**），再在该xml中定义url 映射bean （如org.springframework.web.servlet.handler.SimpleUrlHandlerMapping类，见**说明二**）与视图解析bean（如org.springframework.web.servlet.view.InternalResourceViewResolver），以及被管理的控制器bean（也即继承Controller 的类，见 **说明二**）。

Struts /Structs2 ：

控制器为实现Action 接口的子类，通过web.xml中配置StrutsServlet 的servlet 对象或 org.apache.struts2.dispatcher.filter.StrutsPrepareAndExecuteFilter 的过滤器对象转向struts.xml。

不管哪种MVC 实现，其思想差不多都是，在特定的控制器（Action）中处理业务，同时可与对应的页面相关联，处理业务后，返回数据或页面。

**说明一：**

配置方式：

1、默认为WEB-INF下的"servletName-servlet.xml"，假设该servlet取名为dispatcherServlet，则对应配置文件应为dispatcherServle-servlet.xml，且在WEB-INF目录下。

2、使用初始化参数指定xml配置文件位置：

<servlet>
    	<servlet-name>dispatcherServlet</servlet-name>
    	<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
            
            <init-param>
                <param-name>contextConfigLocation</param-name>
             <param-value>classpath*:servletNameConfig.xml</param-value>
             
         </init-param>
           <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
    	<servlet-name>dispatcherServlet</servlet-name>
    	<url-pattern>/</url-pattern>
    </servlet-mapping>

多个xml文件使用逗号分隔

**说明二：**

SpringMVC 中，映射关系也可使用注解方式，见另一篇日志：

[Center]: /images/20220616/264703ab838c4beba2d2bc7a7fe6d251.png
[There is no Action for namespace _ and..]: http://www.cnblogs.com/gulvzhe/archive/2011/11/21/2256632.html
[DOCTYPE]: https://msdn.microsoft.com/zh-cn/library/ms256059
[Center 1]: /images/20220616/219dd01a15664aafbeb4c64527d8519a.png
[Center 2]: /images/20220616/58c4e64af49c430088b74aef2659653f.png