主题：Struts 2 自学之路: 3.2 名称空间(namespace)详解

来源：互联网发布：进销存软件excel表格编辑：程序博客网时间：2024/05/18 01:12

内容简介:
这篇文章将会通过实例详细介绍 struts.xml 文件中 package 元素下 namespace 属性的作用

说在前面的话:
namespace的作用是控制相应package下的action的url地址,url地址在web编程中是基础中的基础
我们的程序不同的功能实际上就是对相应url地址的访问来触发的,这个要牢牢掌握,有点象java的classpath

需要注意的事项:
我修改了tomcat端口,所以你们看到的http://127.0.0.1:8888/里的8888,要以你自己的tomcat端口为准
修改了xml文件一定要重新启动tomcat或者重新热部署

第一部分
首先我还是废话一下这个基础,这些你都很清楚可以跳过前面这部分
先来看一下一些相对路径的不同写法在tomcat里的运行情况,这里我们使用表单的action来介绍

打开我们上次的工程,在WebRoot文件夹下新建一个目录namespace,然后在里面新建一个Jsp文件testurl.jsp,这里下载
其代码如下

Java代码  
<%@ page language="java" import="java.util.*" pageEncoding="GB18030"%>  
<%@taglib prefix="s" uri="/struts-tags"%>  
<!-- 使用struts标签必需在这里倒入 -->  
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">  
<html>  
    <head>  
        <title>testurl</title>  
    </head>  
    <body>  
        由于struts标签的action和html表单的action在处理上有某些不同<br>  
        struts标签的action把以"/"开头的路径优化过,提交下面的表单<br>        
        由于没有test.jsp,肯定全部是404错误,没关系,我们只需要查看其url地址,这足够让我们理解其具体行为了  
        <br>  
        <br>  
        <table border="1">  
            <tr>  
                <th>  
                    使用html表单访问test.jsp  
                </th>  
                <th>  
                    使用struts表单标签访问test.jsp  
                </th>  
            </tr>  
            <tr>  
                <td>  
                    action="test.jsp"  
                    <form action="test.jsp" method="post">  
                        <input type="submit" value="html表单访问test.jsp" />  
                    </form>  
                </td>  
                <td>  
                    action="test.jsp"  
                    <s:form action="test.jsp">  
                        <s:submit value="struts表单标签访问test.jsp" />  
                    </s:form>  
                </td>  
            <tr>  
            <tr>  
                <td>  
                    action="/test.jsp"  
                    <form action="/test.jsp" method="post">  
                        <input type="submit" value="html表单访问test.jsp" />  
                    </form>  
                </td>  
                <td>  
                    action="/test.jsp"  
                    <s:form action="/test.jsp">  
                        <s:submit value="struts表单标签访问test.jsp" />  
                    </s:form>  
                </td>  
            <tr>  
            <tr>  
                <td>  
                    action="./test.jsp"  
                    <form action="./test.jsp" method="post">  
                        <input type="submit" value="html表单访问test.jsp" />  
                    </form>  
                </td>  
                <td>  
                    action="./test.jsp"  
                    <s:form action="./test.jsp">  
                        <s:submit value="struts表单标签访问test.jsp" />  
                    </s:form>  
                </td>  
            <tr>  
            <tr>  
                <td>  
                    action="../test.jsp"  
                    <form action="../test.jsp" method="post">  
                        <input type="submit" value="html表单访问test.jsp" />  
                    </form>  
                </td>  
                <td>  
                    action="../test.jsp"  
                    <s:form action="../test.jsp">  
                        <s:submit value="struts表单标签访问test.jsp" />  
                    </s:form>  
                </td>  
            <tr>  
            <tr>  
                <td>  
                    action="/Struts2Study/namespace/test.jsp"  
                    <form action="/Struts2Study/namespace/test.jsp" method="post">  
                        <input type="submit" value="html表单访问test.jsp" />  
                    </form>  
                </td>  
                <td>  
                    action="/namespace/test.jsp"  
                    <s:form action="/namespace/test.jsp">  
                        <s:submit value="struts表单标签访问test.jsp" />  
                    </s:form>  
                </td>  
            <tr>  
        </table>  
    </body>  
</html>  

运行上面的例子可以看到结果,从运行结果可以看出,struts的form标签的action是经过优化的
当html的form表单的action="/url"(以/开头的url地址)时,其会从http://127.0.0.1:8080这个根开始附加,我们要访问具体信息必需要加上
项目的上下文(context),就是tomcat安装目录下wepapps/context(具体是你工程名字)这个文件夹名字,象这样
<form action="/Struts2Study/namespace/test.jsp" method="post">
而struts的form标签的action="/url"(以/开头的url地址)时,struts2帮我们作了优化,他会自动为我们在htpp://127.0.0.1:8080/后面加上
项目的上下文,再附加action后的url,而这也是我们开发时想要的本意,象这样<s:form action="/namespace/test.jsp">
其余的都是一样的
action="url" 和 action="./url" 都表示当前路径
action="../" 表示上级路径

上面的表单实际上是被当作超链接来使用的(没有表单参数,只是跳转),超链接的实际访问效果和表单是一样的 action="test.jsp" 和
<a href="test.jsp"> 都是访问test.jsp,只是表单允许用户输入数据,而超链接办不到

第二部分
接下来就该进入正题了,先把工程以前在根目录的index.jsp,error.jsp和welcome.jsp复制到namespace文件夹里,然后修改其代码
再新建两个jsp文件,分别为 error1.jsp,welcome1.jsp,这两个同error.jsp和welcome.jsp一样,只要确认文本就ok
index.jsp

Java代码  
<%@ page language="java" import="java.util.*" pageEncoding="GB18030"%>  
<%@taglib prefix="s" uri="/struts-tags"%>  
<!-- 要使用struts的标签就要先倒入 -->  
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">  
<html>  
  <head>      
    <title>第一个Struts程序</title>  
  </head>    
  <body>  
    <center>  
    action="NameSpace.action"  
    <form action="NameSpace.action" method="post">  
        <table align="center">  
        <caption><h3>用户登录</h3></caption>  
            <tr>  
                <td>用户名:<input type="text" name="username"/></td>  
            </tr>  
            <tr>  
                <td>密  码:<input type="text" name="password"/></td>  
            </tr>  
            <tr align="center">  
                <td colspan="2"><input type="submit" value="登录"/>  
                <input type="reset" value="重填"/></td>  
            </tr>  
        </table>  
    </form>  
    action="/Struts2Study/namespace/NameSpace.action"  
    <form action="/Struts2Study/namespace/NameSpace.action" method="post">  
        <table align="center">  
        <caption><h3>用户登录</h3></caption>  
            <tr>  
                <td>用户名:<input type="text" name="username"/></td>  
            </tr>  
            <tr>  
                <td>密  码:<input type="text" name="password"/></td>  
            </tr>  
            <tr align="center">  
                <td colspan="2"><input type="submit" value="登录"/>  
                <input type="reset" value="重填"/></td>  
            </tr>  
        </table>  
    </form>  
    action="/Struts2Study/NameSpace.action"  
    <form action="/Struts2Study/NameSpace.action" method="post">  
        <table align="center">  
        <caption><h3>用户登录</h3></caption>  
            <tr>  
                <td>用户名:<input type="text" name="username"/></td>  
            </tr>  
            <tr>  
                <td>密  码:<input type="text" name="password"/></td>  
            </tr>  
            <tr align="center">  
                <td colspan="2"><input type="submit" value="登录"/>  
                <input type="reset" value="重填"/></td>  
            </tr>  
        </table>  
    </form>  
    <br>  
    <h5>以下是使用struts的form标签</h5>  
    <br>  
    action="NameSpace"  
    <s:form action="NameSpace">  
        <s:textfield name="username" label="用户名"/>  
        <s:textfield name="password" label="密  码"/>  
        <s:submit value="登录"/>  
    </s:form>  
    action="/namespace/NameSpace.action"  
    <s:form action="/namespace/NameSpace.action">  
        <s:textfield name="username" label="用户名"/>  
        <s:textfield name="password" label="密  码"/>  
        <s:submit value="登录"/>  
    </s:form>  
    action="/NameSpace.action"  
    <s:form action="/NameSpace.action">  
        <s:textfield name="username" label="用户名"/>  
        <s:textfield name="password" label="密  码"/>  
        <s:submit value="登录"/>  
    </s:form>  
    </center>  
  </body>  
</html>  

下面来确认error.jsp,welcome.jsp,error1.jsp及welcome1.jsp的body部分

Java代码  
<!-- error.jsp -->  
<body>  
    你是谁啊,我根本不认识你,再不离开我放狗了  
    namespace/error.jsp  
</body>  
  
<!-- error1.jsp -->  
<body>  
    who are you? i don't know you,i'll call my dog if you won't go<br>  
    namespace/error1.jsp      
</body>  
  
<!-- welcome.jsp -->  
<body>  
    你好啊亲爱滴,我等你很久了<br>  
    namespace/welcome.jsp  
</body>  
  
<!-- welcome1.jsp -->  
<body>  
    hi,darlin,i wait for you for a long time<br>  
    namespace/welcome1.jsp      
</body>  

接下来在新建包yufei.namespace,然后从hello把HelloAction.java复制过去,不用修改代码
HelloAction.java

Java代码  
package yufei.namespace;  
  
public class HelloAction  
    {  
    private String username;  
    private String password;  
    public String getPassword()  
        {  
        return password;  
        }  
    public void setPassword(String password)  
        {  
        this.password = password;  
        }  
    public String getUsername()  
        {  
        return username;  
        }  
    public void setUsername(String username)  
        {  
        this.username = username;  
        }  
    public String execute()  
        {  
        String strReturn = "error";  
        if (username.equals("yufei"))  
            strReturn = "success";  
        return strReturn;  
        }  
    }  

接着我们在yufei.namespace包中新建一个xml文件namespace.xml,并且在struts.xml文件中加入以下内容

Java代码  
<!-- 倒入其它配置文件 -->  
<include file="yufei/namespace/namespace.xml"/>  

namespace.xml的代码如下,这些前篇文章都讲过了,这里不再说了

Java代码  
<?xml version="1.0" encoding="GBK"?>  
<!DOCTYPE struts PUBLIC   
    "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"  
    "http://struts.apache.org/dtds/struts-2.0.dtd">  
<struts>  
    <package name="yufei.namespace" extends="struts-default">  
        <action name="NameSpace" class="yufei.namespace.HelloAction">  
            <result name="success">/namespace/welcome.jsp</result>  
            <result name="error">/namespace/error.jsp</result>  
        </action>  
    </package>  
</struts>  

接下来我们启动tomcat来测试程序,jsp里的表单action多的就不说了,在第一部分已经废话了很多,这里有个小知识
就是使用struts的form标签时,如果是当前路径,可以不带.action,即不是以/或./或../这类开头的,可以看index.jsp代码
不过我建议还是每个地方都写上,这样看上去更统一,这点知道就行了,在地址拦输入http://127.0.0.1:8888/Struts2Study/namespace/index.jsp
每个表单分别提交一次,我们观察url地址,会发现有两种地址,分别是
http://127.0.0.1:8888/Struts2Study/namespace/NameSpace.action
http://127.0.0.1:8888/Struts2Study/NameSpace.action
而且都能正常到执行,这里先不忙解释,我们对namespace.xml做一些小手脚来继续观察,给package元素加上namespace属性
设置其值为namespace="namespace"(这个值代表的其实是路径)

Java代码  
<?xml version="1.0" encoding="GBK"?>  
<!DOCTYPE struts PUBLIC   
    "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"  
    "http://struts.apache.org/dtds/struts-2.0.dtd">  
<struts>  
    <!-- 新加上namespace -->  
    <package name="yufei.namespace" extends="struts-default" namespace="/namespace">  
        <action name="NameSpace" class="yufei.namespace.HelloAction">  
            <result name="success">/namespace/welcome.jsp</result>  
            <result name="error">/namespace/error.jsp</result>  
        </action>  
    </package>  
</struts>  

重新启动tomcat(或重热部署),然后在打开namespace下的index.jsp,现在我们再来提交表单试试
现在出现了异常情况...当我们提交表单到http://127.0.0.1:8888/Struts2Study/NameSpace.action时发生了异常
而我们提交到http://127.0.0.1:8888/Struts2Study/namespace/NameSpace.action却能正常执行
原因就在于这个namespace属性的设置
我们来回顾一下struts2的基本流程,当客户发生请求以后,触发struts2的FilterDispatcher过滤器(默认配置是所有请求都会触发)
如果请求是以.action结尾,FilterDispatcher会去struts.xml里面查找action元素的name属性配置,找到匹配的然后运行其class
属性指定的类
在struts2基本流程里是这样说明的,现在补充一点,匹配的不光是name属性,还有package的namespace属性,现在我这里就来讲一下
struts2是如何去查找匹配action的,这是我自己的理解,没有任何资料参考,如有什么不妥之处请邮件告知(yufei@wapke.cn)
以今天这个index.jsp里 action=NameSpace.action 来举例说明,当我们提交此表单时,会请求以下这个url资源
http://127.0.0.1:8888/Struts2Study/namespace/NameSpace.action
这时filterdispatcher触发,然后其发现请求url是以.action结尾,然后其就去配置文件里面查找,匹配的方式应该是
将http://127.0.0.1:8888/Struts2Study请求资源的根路径去掉,然后再将最后的.action去掉留下中间那部分(这里就是
/namespace/NameSpace),然后将剩下这部分再分为两个部分,即最后一个/以前的部分,和最后一个/以后部分,分解以后就是这样,
/namesapce(最后一个/以前,不包括最后一个/)和NameSpace(最后一个/以后,不包括最后一个/)然后拿分解出来的第一部分去
和package元素里的namespace比对,找到相同的就在这个package元素里找其子action元素的name属性和分解出来的第二部分对比
,相同就执行其class属性对应的类,如果找不到,就会到默认namespace里去找,默认namespace是"",namesapce="" 和 namespace="/" 和 namespace空缺不写是一样的效果,都代表在项目根路径上去匹配action的name,以上面的url举例就是
http://127.0.0.1:8888/Struts2Study/到这里去找NameSpace.action,
如果剩下这部分/以前没有内容,就代表到默认名称空间去找
注意:namespace属性的值等于"/"代表根空间,""代表默认空间,只是默认情况下二者大致相当,指执行结果

为了明白什么是先查找指定名称空间,再查找默认名称空间,我们把namespace.xml的配置文件改动一下
把package元素里的namespace属性去掉(你也可以分别试着让namespace=""或namesapce="/"来看效果)

Java代码  
<!-- 去掉namespace属性 -->  
<package name="yufei.namespace" extends="struts-default">  

这样又回到一开始的配置了,然后我们来执行,会有两种url地址,但是两种地址都能正常运行
http://127.0.0.1:8888/Struts2Study/namespace/NameSpace.action
http://127.0.0.1:8888/Struts2Study/NameSpace.action
第二种情况还比较好理解,这个就是上面说的/以前没有内容,就代表到默认名称空间查找
第一种情况要复杂点,被FilterDispatcher拦截下来后,它先到namespace="/namespace"里面去找
,没有找到,然后又到namespace=""去查找,找到了,所以也执行了

接下来我们再来把配置文件的 namespace改回 namesapce="namespace"
修改配置文件以后http://127.0.0.1:8888/Struts2Study/NameSpace.action会报异常
原因是/以前没有内容,就代表到默认名称空间查找,而配置文件里根本没有配置有默认空间的package,所以肯定找不到
给index.jsp再添加一个表单,提交给一个更容易看明白的地址

Java代码  
action="/namespace1/NameSpace.action"  
    <s:form action="/namespace1/NameSpace.action">  
    <s:textfield name="username" label="用户名"/>  
    <s:textfield name="password" label="密  码"/>  
    <s:submit value="登录"/>  
</s:form>  
<!-- 加入到最后 -->      

这个表单提交到以下地址,报了异常
http://127.0.0.1:8888/Struts2Study/namespace1/NameSpace.action
这个被FilterDispatcher拦截下来后,先到namespace="/namespace1"里面去找,没有找到,然后又到namespace=""去查找
还是没有找到,所以还是报异常

最后我们来做一个同名action的试验来结束名称空间的讲解,看不同名称空间,同名action是某可以使用
修改namespace.xml如下

Java代码  
<?xml version="1.0" encoding="GBK"?>  
<!DOCTYPE struts PUBLIC   
    "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"  
    "http://struts.apache.org/dtds/struts-2.0.dtd">  
<struts>  
    <!-- 新加上namespace -->  
    <package name="yufei.namespace" extends="struts-default" namespace="/namespace">  
        <action name="NameSpace" class="yufei.namespace.HelloAction">  
            <result name="success">/namespace/welcome.jsp</result>  
            <result name="error">/namespace/error.jsp</result>  
        </action>  
    </package>  
    <!-- package name不能出现重复的 -->  
    <package name="yufei.namespace1" extends="struts-default" namespace="/namespace1">  
        <action name="NameSpace" class="yufei.namespace.HelloAction">  
            <!-- 执行的类都是一样的,所以要让其跳转到不同的地方来看效果 -->  
            <result name="success">/namespace/welcome1.jsp</result>  
            <result name="error">/namespace/error1.jsp</result>  
        </action>  
    </package>  
</struts>  

现在我们进入index.jsp,然后来提交我们刚才加入在最后的表单,现在我们是不是看到一堆烦人的鸟文了啊^_^