SpringMVC(二) --------- SpringMVC 注解式开发

在森林中麋了鹿

于 2022-02-21 21:44:41 发布

阅读量2.5k

点赞数

分类专栏： SpringMVC 文章标签： java intellij-idea spring

本文链接：https://blog.csdn.net/m0_51111980/article/details/123034335

版权

SpringMVC 专栏收录该内容

6 篇文章 1 订阅

订阅专栏

一、@RequestMapping 定义请求规则

指定模块名称

通过@RequestMapping 注解可以定义处理器对于请求的映射规则。该注解可以注解在方法上，也可以注解在类上，但意义是不同的。value 属性值常以" / "开始。

@RequestMapping 的 value 属性用于定义所匹配请求的 URI。但对于注解在方法上与类上，其 value 属性所指定的 URI，意义是不同的。

一个 @Controller 所注解的类中，可以定义多个处理器方法。当然，不同的处理器方法所匹配的 URI 是不同的。这些不同的 URI 被指定在注解于方法之上的 @RequestMapping 的 value 属性中。但若这些请求具有相同的 URI 部分，则这些相同的 URI，可以被抽取到注解在类之上的 @RequestMapping 的 value 属性中。此时的这个 URI 表示模块的名称。URI 的请求是相对于 Web 的根目录。

换个角度说，要访问处理器的指定方法，必须要在方法指定 URI 之前加上处理器类前定义的模块名称。

定义处理器类 MyController

java注解@RequestMapping可用于类或方法上。用于类上，表示类中的所有响应请求的方法都是以该地址作为父路径。

在这里插入图片描述
添加视图页面

在/WEB-INF/view 目录下添加 some.jsp 与 other.jsp 页面

结构：
在这里插入图片描述
简单定义 other.jsp 界面

简单定义 some.jsp 界面

对请求提交方式的定义

对于@RequestMapping，其有一个属性 method，用于对被注解方法所处理请求的提交方式进行限制，即只有满足该 method 属性指定的提交方式的请求，才会执行该被注解方法。Method 属性的取值为 RequestMethod 枚举常量。常用的为 RequestMethod.GET 与 RequestMethod.POST，分别表示提交方式的匹配规则为 GET 与 POST 提交。

在这里插入图片描述
以上处理器方法只能处理 POST 方式提交的请求。客户端浏览器常用的请求方式，及其提交方式有以下几种：

请求方式	提交方式
表单请求	默认GET，可以指定POST
AJAX 请求	默认GET，可以指定 POST
地址栏请求	GET请求
超链接请求	GET请求
src资源路径请求	GET请求

也就是说，只要指定了处理器方法匹配的请求提交方式为 POST，则相当于指定了请求发送的方式：要么使用表单请求，要么使用 AJAX 请求。其它请求方式被禁用。当然，若不指定 method 属性，则无论是 GET 还是 POST 提交方式，均可匹配，即对于请求的提交方式无要求。

修改处理器类 MyController
在这里插入图片描述

定义 index 界面
在这里插入图片描述

二、处理器方法的参数

处理器方法可以包含以下四类参数，这些参数会在系统调用时由系统自动赋值，即程序员可在方法内直接使用。

➢ HttpServletRequest
➢ HttpServletResponse
➢ HttpSession
➢ 请求中所携带的请求参数

逐个参数接收

只要保证请求参数名与该请求处理方法的参数名相同即可。

修改 index 页面

在这里插入图片描述
修改处理器类 MyController

添加 show 界面

在这里插入图片描述

请求参数中文乱码问题

对于前面所接收的请求参数，若含有中文，则会出现中文乱码问题。Spring 对于请求参数中的中文乱码问题，给出了专门的字符集过滤器：spring-web-5.2.5.RELEASE.jar 的 org.springframework.web.filter 包下的 CharacterEncodingFilter 类。

在这里插入图片描述

解决方案
在 web.xml 中注册字符集过滤器，即可解决 Spring 的请求参数的中文乱码问题。不过，最好将该过滤器注册在其它过滤器之前。因为过滤器的执行是按照其注册顺序进行的。直接在项目 receiveParameters-property 上进行修改。

<!-- 注册字符集过滤器: 解决 post 请求 -->
<filter>
    <filter-name>characterEncodingFilter</filter-name>
    <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
    <!-- 指定字符集    -->
    <init-param>
        <param-name>encoding</param-name>
        <param-value>utf-8</param-value>
    </init-param>
    <!-- 强制 request 使用字符集encoding        -->
    <init-param>
        <param-name>forceRequestEncoding</param-name>
        <param-value>true</param-value>
    </init-param>
    <!-- 强制response使用字符集encoding   -->
    <init-param>
        <param-name>forceResponseEncoding</param-name>
        <param-value>true</param-value>
    </init-param>
</filter>
<filter-mapping>
    <filter-name>characterEncodingFilter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

矫正请求参数名 @RequestParam

所谓校正请求参数名，是指若请求 URL 所携带的参数名称与处理方法中指定的参数名不相同时，则需在处理方法参数前，添加一个注解 @RequestParam(“请求参数名”)，指定请求 URL 所携带参数的名称。该注解是对处理器方法参数进行修饰的。value 属性指定请求参数的名称。

@RequestParam 属性

value, 请求中参数名
required, boolean, 默认是true
true: 表示请求中必须有参数
false: 可以没有此参数

修改 index 界面

将表单中的参数名称修改的与原来不一样

在这里插入图片描述

修改处理器类 MyController

在这里插入图片描述

required 属性

在这里插入图片描述

对象参数接收

将处理器方法的参数定义为一个对象，只要保证请求参数名与这个对象的属性同名即可。

定义学生类Student

public class Student {
    private String name;
    private int age;

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public int getAge() {
        return age;
    }

    public void setAge(int age) {
        this.age = age;
    }
}

修改处理器类 MyController

在这里插入图片描述
修改 show 页面

在这里插入图片描述
测试结果

三、处理器方法的返回值

使用@Controller 注解的处理器的处理器方法，其返回值常用的有四种类型：

➢ 第一种：ModelAndView
➢ 第二种：String
➢ 第三种：无返回值 void
➢ 第四种：返回自定义类型对象

根据不同的情况，使用不同的返回值。

返回 ModelAndView

若处理器方法处理完后，需要跳转到其它资源，且又要在跳转的资源间传递数据，此时处理器方法返回 ModelAndView 比较好。当然，若要返回 ModelAndView，则处理器方法中需要定义 ModelAndView 对象。

在使用时，若该处理器方法只是进行跳转而不传递数据，或只是传递数据而并不向任何资源跳转（如对页面的 Ajax 异步响应），此时若返回 ModelAndView，则将总是有一部分多余：要么 Model 多余，要么 View 多余。即此时返回 ModelAndView 将不合适。

返回 String

处理器方法返回的字符串可以指定逻辑视图名，通过视图解析器解析可以将其转换为物理视图地址

返回内部资源逻辑视图名
若要跳转的资源为内部资源，则视图解析器可以使用 InternalResourceViewResolver 内部资源视图解析器。此时处理器方法返回的字符串就是要跳转页面的文件名去掉文件扩展名后的部分。这个字符串与视图解析器中的 prefix、suffix 相结合，即可形成要访问的 URI。

在这里插入图片描述
当然，也可以直接返回资源的物理视图名。不过，此时就不需要再在视图解析器中再配置前辍与后辍了。

在这里插入图片描述

返回 void

对于处理器方法返回 void 的应用场景：AJAX 响应。若处理器对请求处理后，无需跳转到其它任何资源，此时可以让处理器方法返回 void，例如，对于 AJAX 的异步请求的响应。

maven 加入 jackson 依赖

由于本项目中服务端向浏览器传回的是 JSON 数据，需要使用一个工具类将字符串包装为 JSON 格式，所以需要导入 JSON 的依赖。

<dependency>
	<groupId>com.fasterxml.jackson.core</groupId>
	<artifactId>jackson-core</artifactId>
	<version>2.9.0</version>
</dependency>
<dependency>
	<groupId>com.fasterxml.jackson.core</groupId>
	<artifactId>jackson-databind</artifactId>
	<version>2.9.0</version>
</dependency>

引入 jQuery 库

由于本项目要使用 jQuery 的 ajax()方法提交 AJAX 请求，所以项目中需要引入 jQuery 的库。在 WebRoot 下新建一个 Folder（文件夹），命名为 js，并将 jquery-3.1.1.js 文件放入其中。

在这里插入图片描述
当然，该 jQuery 库文件，需要在使用 ajax() 方法的 index 页面中引入

<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<script type="text/javascript" src="js/jquery-3.1.1.min.js"></script>

定义 index 界面

index 页面由两部分内容构成：一个是<button/>，用于提交 AJAX 请求；一个是<script/>，用于处理 AJAX 请求。

<script>
    $(function (){
            $("button").click(function (){
                $.ajax({
                    url:"/MyWeb/test/MyAjax.do",
                    data:{
                        name:"zs",
                        age:"24"
                    },
                    type:"post",
                    dataType:"json",
                    success:function (resp){
                        alert("resp: " + resp.name + " " + resp.age);
                    }

                });
            });
        });
</script>

 index.jsp<br>
 <button>发起 Ajax 请求</button>

定义 Student 学生类

在这里插入图片描述
修改处理器类 MyController

处理器对于 AJAX 请求中所提交的参数，可以使用逐个接收的方式，也可以以对象的方式整体接收。只要保证 AJAX 请求参数与接收的对象类型属性同名。

以逐个方式接收参数：

// 处理器方法返回值 void , 不能表示数据, 也没有视图
// 可以通过使用HttpServletResponse的输出对象, 把数据输出到浏览器
@RequestMapping
public void doAjax(Integer age, String name, HttpServletResponse response) throws IOException {
   Student student = new Student();
   student.setName(name);
   student.setAge(age);

   // 使用 jackson 工具库, 把 Student 转化为 json
    ObjectMapper mapper = new ObjectMapper();
    String json = mapper.writeValueAsString(student);
    System.out.println("json : " + json);

    // 使用 HttpServletResponse 输出数据到浏览器
    PrintWriter pw = response.getWriter();
    pw.print(json);
    pw.flush();
    pw.close();
}

测试结果

在这里插入图片描述
删除视图页面

由于是服务端直接向浏览器发回数据，所以也就无需视图页面了，所以需要删除 WEB-INF 中的 view 目录及其中的 show 页面。

返回对象 Object

处理器方法也可以返回 Object 对象。这个 Object 可以是 Integer、String、自定义对象、Map、List 等。但返回的对象不是作为逻辑视图出现的，而是作为直接在页面显示的数据出现的。返回对象，需要使用@ResponseBody 注解，将转换后的 JSON 数据放入到响应体中。@ResponseBody的作用其实是将java对象转为json格式的数据。

(1) 环境搭建

声明注解驱动

将 Object 数据转化为 JSON 数据，需要由消息转换器 HttpMessageConverter 完成。而转换器的开启，需要由<mvc:annotation-driven/>来完成。SpringMVC 使用消息转换器实现请求数据和对象，处理器方法返回对象和响应输出之间的自动转换当 Spring 容器进行初始化过程中，在<mvc:annotation-driven/>处创建注解驱动时，默认创建了七个HttpMessageConverter 对象。也就是说，我们注册<mvc:annotation-driven/>，就是为了让容器为我们创建HttpMessageConverter 对象。

注意选以mvc结尾的包

在这里插入图片描述

HttpMessageConverter 接口：HttpMessageConverter<T> 是 Spring3.0 新添加的一个接口，负责将请求信息转换为一个对象（类型为 T），将对象（类型为 T）输出为响应信息。

HttpMessageConverter接口定义的方法：

boolean canRead(class<?> clazz,MediaType mediaType): 指定转换器可以读取的对象类型，即转换器是否可将请求信息转换为clazz 类型的对象, 同时指定支持 MIME 类型(text/html,applaiction/json 等) 
boolean canWrite(class<?> clazz,MediaType mediaType): 指定转换器是否可将 clazz 类型的对象写到响应流中，响应流支持的媒体类型在 MediaType 中定义.
LIst<MediaType> getSupportMediaTypes(): 该转换器支持的媒体类型.
T read(Class<? extends T> clazz,HttpInputMessage inputMessage): 将请求信息流转换为 T 类型的对象.
void write(T t, MediaType contnetType, HttpOutputMessgae outputMessage): 将 T 类型的对象写到响应流中, 同时指定相应的媒体类型为 contentType 加入注解驱动<mvc:annotation-driven/>后适配器类的 messageConverters 属性值

在这里插入图片描述
(2) 返回自定义类型对象

返回自定义类型对象时，不能以对象的形式直接返回给客户端浏览器，而是将对象转换为 JSON 格式的数据发送给浏览器的。由于转换器底层使用了Jackson转换方式将对象转换为JSON数据，所以需要导入Jackson的相关 Jar 包。

定义学生类

用之前定义好的学生类即可

修改处理器MyController

@RequestMapping("/MyAjax.do")
@ResponseBody
public Student doStudentJson() {
    Student student = new Student();
    student.setName("张三");
    student.setAge(18);
    return student;
}

修改 index 页面
在这里插入图片描述
测试结果

(3) 返回 List 集合

修改处理器 MyController

@RequestMapping("/MyAjax.do")
@ResponseBody
public List<Student> doStudentJson() {
   List<Student> students = new ArrayList<>();
   students.add(new Student("张三", 22));
   students.add(new Student("李四", 22));
   return students;
}

修改 index 页面

<script>
    $(function (){
        $("button").click(function (){
            $.ajax({
                url:"/MyWeb/test/MyAjax.do",
                success:function (resp){
                    $.each(data, function (i, n)) {
                        alert(n.name + "===" + n.age);
                    }
                }

            });
        });
    });

</script>

(4) 返回字符串对象

若要返回非中文字符串，将前面返回数值型数据的返回值直接修改为字符串即可。但若返回的字符串中带有中文字符，则接收方页面将会出现乱码。此时需要使用 @RequestMapping 的 produces 属性指定字符集。

produces，产品，结果，即该属性用于设置输出结果类型。

在这里插入图片描述

四、解读< url-pattern />

配置详解

*.do
在没有特殊要求的情况下，SpringMVC 的中央调度器 DispatcherServlet 的<url-pattern/>常使用后辍匹配方式，如写为*.do 或者 *.action，*.mvc 等。
/
可以写为 /，因为 DispatcherServlet 会将向静态资源的获取请求，例如.css、.js、.jpg、.png等资源的获取请求，当作是一个普通的 Controller 请求。中央调度器会调用处理器映射器为其查找相应的处理器。当然也是找不到的，所以在这种情况下，所有的静态资源获取请求也均会报 404 错误。

静态资源访问

<url-pattern/>的值并不是说写为 / 后，静态资源就无法访问了。经过一些配置后，该问题也是可以解决的。

(1) 使用 <mvc:default-servlet-handler/>

声明了 <mvc:default-servlet-handler /> 后， springmvc 框架会在容器中创建 DefaultServletHttpRequestHandler 处理器对象。它会像一个检查员，对进入 DispatcherServlet 的 URL 进行筛查，如果发现是静态资源的请求，就将该请求转由 Web 应用服务器默认的 Servlet 处理。一般的服务器都有默认的 Servlet。在 Tomcat 中，有一个专门用于处理静态资源访问的 Servlet 名叫 DefaultServlet。其<servlet-name/>为 default。可以处理各种静态资源访问请求。该 Servlet 注册在 Tomcat 服务器的 web.xml 中。在 Tomcat 安装目录 /conf/web.xml。

代码如下

<servlet>
    <servlet-name>default</servlet-name>
    <servlet-class>org.apache.catalina.servlets.DefaultServlet</servlet-class>
    <init-param>
        <param-name>debug</param-name>
        <param-value>0</param-value>
    </init-param>
    <init-param>
        <param-name>listings</param-name>
        <param-value>false</param-value>
    </init-param>
    <load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
    <servlet-name>default</servlet-name>
    <url-pattern>/</url-pattern>
</servlet-mapping>

只需要在 springmvc.xml 中添加<mvc:default-servlet-handler/>标签即可

在这里插入图片描述
<mvc:default-servlet-handler/> 表示使用 DefaultServletHttpRequestHandler 处理器对象。而该处理器调用了 Tomcat 的 DefaultServlet 来处理静态资源的访问请求。当然了，要想使用<mvc: …/>标签，需要引入 mvc 约束。该约束可从 Spring 帮助文档中搜索关键字 spring-mvc.xsd 即可获取docs/spring-framework-reference/htmlsingle/index.html

(2) 使用 <mvc:resources/>

在 Spring3.0 版本后，Spring 定义了专门用于处理静态资源访问请求的处理器 ResourceHttpRequestHandler。并且添加了<mvc:resources/>标签，专门用于解决静态资源无法访问问题。需要在 springmvc 配置文件中添加如下形式的配置：

<mvc:resouces location="" mapping=""/>

location 表示静态资源所在目录。当然，目录不要使用/WEB-INF/及其子目录。

mapping 表示对该资源的请求 (以 /images/ 开始的请求，如 /image/bee.jpg， /images/car.png 等)。注意，后面是两个星号 **

(3)声明注解驱动

解决动态资源和静态资源冲突的问题，在 springmvc 配置文件加入

<mvc:annotation-driven/>

在森林中麋了鹿

关注

0
点赞
踩
0

收藏

觉得还不错? 一键收藏
打赏
0
评论
SpringMVC(二) --------- SpringMVC 注解式开发

目录一、@RequestMapping 定义请求规则指定模块名称对请求提交方式的定义二、处理器方法的参数逐个参数接收请求参数中文乱码问题矫正请求参数名 @RequestParam对象参数接收三、处理器方法的返回值返回 ModelAndView返回 String返回 void一、@RequestMapping 定义请求规则指定模块名称通过@RequestMapping 注解可以定义处理器对于请求的映射规则。该注解可以注解在方法上，也可以注解在类上，但意义是不同的。value 属性值常以" / "开始。
复制链接

扫一扫