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

内容简介:
这篇文章将会通过实例详细介绍 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, 这里下载
其代码如下

<%@ 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
<%@ 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部分
<!-- 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
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文件中加入以下内容
<!-- 倒入其它配置文件 -->
<include file="yufei/namespace/namespace.xml"/>


namespace.xml的代码如下,这些前篇文章都讲过了,这里不再说了
<?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"(这个值代表的其实是路径)
<?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的,这是我自己的理解,没有任何资料参考,如有什么不妥之处请邮件告知([email protected])

以今天这个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="/"来看效果)

<!-- 去掉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再添加一个表单,提交给一个更容易看明白的地址

	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如下
<?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,然后来提交我们刚才加入在最后的表单,现在我们是不是看到一堆烦人的鸟文了啊^_^



项目文件在附件中

你可能感兴趣的:(apache,tomcat,jsp,xml,struts)