为了账号安全,请及时绑定邮箱和手机立即绑定
首页 手记 SpringMVC从入门到精通之第五章

SpringMVC从入门到精通之第五章

2016.01.27 21:36 7457浏览

上一章节主要讲了@Controller和@RequestMapping注解。
这一章想讲解另一个比较重要的注解(@PathVariable),因为这个注解支持现在当下较为流行的Restful风格的URL。
先说说这个注解的作用,支持将url中的占\位符参数绑定到目标方法的参数上, 该功能也是springmvc实现Restful风格url的重要措施。
既然说道了restful风格的url就不得不说一说什么是restful风格的URL?解决方式-->百度
在讲解用springmvc来实现restful请求之前先看看rest请求样子,restful风格的url的请求是不会有.do,action等结尾的请求(这就是”逼格“用的好能够提高网站性能,用的不好我就呵呵了,,其实你观看本文章的时候注意地址栏的这个链接就是restful风格的,这个足以说明rest使用的流行程度)。
它的风格应该类似这样:

/user:新增(POST请求)、
/user/1:修改(PUT请求)、
/user/1:删除(DELETE请求)、
/user/1:获取(GET请求)

我们熟悉的请求应该是POST和GET请求,这两个请求也是最常用的而实际上HTTP1.1请求还有PUT、DELETE等8种来表名请求的动作。
说了一堆,肯定有小伙伴等不及了,怎么还不说实现方式?
下面我们就来一步一步来用springmvc实现restful风格的请求。
还记得第二章中配置的web.xml么?
现在要实现restful风格的请求,当然离不开前端控制器要拦截的请求了。下面看配置

<!-- 配置前端控制器 -->
    <servlet>
        <servlet-name>springmvc-1</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>classpath:mvc-dispatcher-servlet.xml</param-value>
        </init-param>
        <!-- 表示随WEB服务器启动 -->
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>springmvc</servlet-name>
        <!-- 备注:可以拦截三种请求
         第一种:拦截固定后缀的url,比如设置为 *.do、*.action, 例如:/user/add.action此方法最简单,不会导致静态资源(jpg,js,css)被拦截. 
         第二种:拦截所有,设置为/,例如:/user/add /user/add.action此方法可以实现REST风格的url,很多互联网类型的应用使用这种方式.但是此方法会导致静态文件(jpg,js,css)被拦截后不能正常显示.需要特殊处理.
            1>.为什么会有静态资源问题
                优雅的REST 风格的资源URL 不希望带.html或.do等后缀
                若将DispatcherServlet请求映射配置为(第二种方式),则springmvc将捕获WEB容器所有请求,包括静态资源的请求,springmvc会将他们当成一个普通请求处理
                因为找不到对应处理器将导致错误。
            2>. 解决方案:
                可以在springmvc的配置文件中配置<mvc:default-servlet-handler/>的方式解决静态资源的问题。
                    1.>.<mvc:default-servlet-handler/>将在springmvc上下文中定义一个DefaultServletHttpRequestHandler,它会对进入DispatcherServlet的请求进行筛查,如果发现是没有经过映射的请求,就将该请求交由WEN应用服务器默认的Servlet处理,如果不是静态资源的请求,才由DispatcherServlet处理。
                    2.>.一般WEB应用服务器默认的Servlet的名称都是default,若所使用的WEB服务器的默认Servlet名称不是default,则需要通过default-servlet-name属性显示指定
             第三种:拦截所有,设置为/*,此设置方法错误,因为请求到Action,当action转到jsp时再次被拦截,提示不能根据jsp路径mapping成功. 
         -->
        <url-pattern>/</url-pattern>

注意一下配置里面的注释。
下面我们来看下实现get和post请求因为这两个请求比较常见!对熟人下手,速度较快
上面说道@PathVariable这个注解能够将url中的占_位符参数绑定到目标方法的参数上。
我们先看下实现页面:

<a href="${pageContext.request.contextPath}/springmvc/testRestfulGet/1">@PathVariable注解知识点:支持Restful风格的GET请求</a>
        <form action="${pageContext.request.contextPath}/springmvc/testRestfulPost" method="post">
        用户:<input type="text" name="username"/>
                密码:<input type="password" name="password"/><br>
        <input type="sumit" value="@PathVariable注解知识点:支持Restful风格的POST请求"/>
    </form>

后台处理器代码:

    /**
     * 
     * @Title: testRestfulGet
     * @Description: TODO (测试Restful风格的URL:GET请求)
     * @Author: Hanson                
     * @Create Date: 2016年1月27日 下午8:48:39
     * @History: 2016年1月27日 下午8:48:39 Hanson Created.
     *
     * @param id
     * @return
     *
     */
    @RequestMapping(value = "/testRestfulGet/{id}", method = { RequestMethod.GET })
    public String testRestfulGet(@PathVariable("id") Integer id) {
    System.out.println("The value which the restful style url is GET :"+ id);
        return "success";
    }

    /**
     * 
     * @Title: testRestfulPost
     * @Description: TODO (测试Restful风格的URL:POST请求)
     * @Author: Hanson                
     * @Create Date: 2016年1月27日 下午8:48:53
     * @History: 2016年1月27日 下午8:48:53 Hanson Created.
     *
     * @return
     *
     */
    @RequestMapping(value = "/testRestfulPost", method = { RequestMethod.POST })
    public String testRestfulPost() {
        System.out.println("The value which the restful style url is POST ");
        return "success";
    }

来看下这个注解的源码:

/**
 * Annotation which indicates that a method parameter should be bound to a URI template
 * variable. Supported for {@link RequestMapping} annotated handler methods in Servlet
 * environments.
 *
 * @author Arjen Poutsma
 * @see RequestMapping
 * @see org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter
 * @see org.springframework.web.servlet.mvc.annotation.AnnotationMethodHandlerAdapter
 * @since 3.0
 */
@Target(ElementType.PARAMETER)
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface PathVariable {

    /** The URI template variable to bind to. */
    String value() default "";

}

上面英文大概意思就是:表明一个方法参数应该被绑定到一个URI模板的占位符中。
这个注解只有一个某人的value属性因此在使用的时候可以省略value="";(不太懂注解原理的童鞋可以去慕课网看看注解相关的教程)。
实现了GET和POST请求,下面就是这片文章的硬菜。
在springmvc中要实现PUT和DELETE 请求需要在web.xml额外配置一个过滤器,这个过滤器的作用就是把POST请求变为PUT和DELETE请求。
先看配置:

<!--org.springframework.web.filter.HiddenHttpMethodFilter:可以把Post请求转变为put和delete请求 -->
    <filter>
        <filter-name>HiddenHttpMethodFilter</filter-name>
        <filter-class>org.springframework.web.filter.HiddenHttpMethodFilter</filter-class>
    </filter>
    <filter-mapping>
        <filter-name>HiddenHttpMethodFilter</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>

这个类的一部分源码:

public class HiddenHttpMethodFilter extends OncePerRequestFilter {

    /** Default method parameter: <code>_method</code> */
    public static final String DEFAULT_METHOD_PARAM = "_method";

    private String methodParam = DEFAULT_METHOD_PARAM;

    /**
     * Set the parameter name to look for HTTP methods.
     * @see #DEFAULT_METHOD_PARAM
     */
    public void setMethodParam(String methodParam) {
        Assert.hasText(methodParam, "'methodParam' must not be empty");
        this.methodParam = methodParam;
    }

这个源码要求在提交POST请求的时候,需要隐藏一个属性名为“_method”,它的值可以是PUT或者DELETE等。
PUT请求和DELETE请求的JSP中实现代码如下:

<form action="${pageContext.request.contextPath}/springmvc/testRestfulDelete/1" method="post">
        <input type="hidden" name="_method" value="DELETE"/>
        用户:<input type="text" name="username"/>
                密码:<input type="password" name="password"/><br>
        <input type="sumit" value="@PathVariable注解知识点:支持Restful风格的DELETE请求"/>
    </form>
    <form action="${pageContext.request.contextPath}/springmvc/testRestfulPut/1" method="post">
        <input type="hidden" name="_method" value="PUT"/>
        用户:<input type="text" name="username"/>
                密码:<input type="password" name="password"/><br>
        <input type="submit" value="@PathVariable注解知识点:支持Restful风格的PUT请求"/>
    </form>

后台实现代码:

    /**
     * 
     * @Title: testRestfulDelete
     * @Description: TODO (测试Restful风格的URL:DELETE请求)
     * @Author: Hanson                
     * @Create Date: 2016年1月27日 下午9:07:20
     * @History: 2016年1月27日 下午9:07:20 Hanson Created.
     *
     * @param id
     * @return
     *
     */
    @RequestMapping(value = "/testRestfulDelete/{id}", method = { RequestMethod.DELETE })
    public String testRestfulDelete(@PathVariable("id") Integer id) {
    System.out.println("The value which the restful style url is DELETE :"+ id);
        return "success";
    }

    /**
     * 
     * @Title: testRestfulPut
     * @Description: TODO (测试Restful风格的URL:PUT请求)
     * @Author: Hanson                
     * @Create Date: 2016年1月27日 下午9:07:29
     * @History: 2016年1月27日 下午9:07:29 Hanson Created.
     *
     * @param id
     * @return
     *
     */
    @RequestMapping(value = "/testRestfulPut/{id}", method = { RequestMethod.PUT })
    public String testRestfulPut(@PathVariable("id") Integer id) {
    System.out.println("The value which the restful style url is PUT :"+ id);
        return "success";
    }

到这里这个注解就算学完了。
那么现在开始总结:看完这片文章应该什么是Rest请求?知道springmvc支持rest风格的请求、要支持这种优雅的请求要怎么配置。

点击查看更多内容
24人点赞

若觉得本文不错,就分享一下吧!

评论

作者其他优质文章

正在加载中
JAVA开发工程师
手记
粉丝
334
获赞与收藏
3452

关注TA,一起探索更多经验知识

同主题相似文章浏览排行榜

风间影月说签约讲师

51篇手记,涉及Java、MySQL、Redis、Spring等方向

进入讨论

Tony Bai 说签约讲师

151篇手记,涉及Go、C、Java、Python等方向

进入讨论
感谢您的支持,我会继续努力的~
扫码打赏,你说多少就多少
赞赏金额会直接到老师账户
支付方式
打开微信扫一扫,即可进行扫码打赏哦
意见反馈 帮助中心 APP下载
官方微信

举报

0/150
提交
取消