SpringMVC学习笔记

最新推荐文章于 2025-06-01 19:00:00 发布

hhf的博客

最新推荐文章于 2025-06-01 19:00:00 发布

阅读量112

点赞数

分类专栏：学习笔记文章标签： spring java

本文链接：https://blog.youkuaiyun.com/weixin_46818541/article/details/117961401

版权

学习笔记专栏收录该内容

19 篇文章

订阅专栏

一 SpringMVC简介

概述

SpringMVC是一种基于Java的实现MVC设计模型的请求驱动类型的轻量级Web框架，支持RESFul编程风格的请求

开发步骤

导入SpringMVC包
配置SpringMVC核心控制器DispatcherServlet
编写Controller
将Controller以及内部业务方法使用注解配置到Spring容器
配置SpringMVC核心文件spring-mvc.xml（配置组件扫描）
客户端发起请求测试

<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-webmvc</artifactId>
    <version>5.0.3.RELEASE</version>
</dependency>

	<!--配置SpringMVC前端控制器-->
    <servlet>
        <servlet-name>DispatcherServlet</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <!--配置初始化参数，加载spring-mvc.xml-->
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>classpath:spring-mvc.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>

@Controller
public class UserController {
    @RequestMapping("/save")
    public String save() {
        System.out.println("controller save");
        return "a.jsp";
    }
}

spring-mvc.xml

<!--Controller组件扫描-->
<context:component-scan base-package="com.springmvc01.controller"></context:component-scan>

流程图

在这里插入图片描述

二 SpringMVC组件解析

执行流程

在这里插入图片描述

注解解析

@RequestMapping

用于建立请求URL和处理请求方法之间的对应关系

位置

类之前（如果不写相当于应用根目录）
方法之前

属性

value：指定请求URL
method：指定请求方式
params：指定限制请求参数的条件，支持简单表达式

@Controller
@RequestMapping("/user")
public class UserController {

    //指定请求路径为/user/quick，请求方式为post，请求参数要有username
    @RequestMapping(value="/quick",method= RequestMethod.POST,params = {"username"})
    public String save() {
        System.out.println("controller save");
        return "/a.jsp";
    }
}

组件扫描

<!--Controller组件扫描-->
<context:component-scan base-package="com.springmvc01.controller"></context:component-scan>

<!--Controller组件扫描也可以这样写-->
<context:component-scan base-package="com.springmvc01">
    <context:include-filter type="annotation" expression="org.springframework.stereotype.Controller"/>
</context:component-scan>

xml配置解析

视图解析器配置

controller中

return "forward:/a.jsp";//转发
return "redirect:/a.jsp";//重定向

spring-mvc.xml

<!--配置内部资源视图解析器-->
<bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
    <!--配置前缀、后缀-->
    <property name="prefix" value="/jsp/"></property>
    <property name="suffix" value=".jsp"></property>
</bean>

三 SpringMVC数据响应

页面跳转

返回字符串

见前面的视图解析器配置

通过ModelAndView对象返回

@RequestMapping(value="/quick2")
public ModelAndView save2() {
    /*
    Model：模型，封装数据
    View：视图，展示数据
     */
    ModelAndView modelAndView=new ModelAndView();
    //设置模型数据
    modelAndView.addObject("username","hhf");
    //设置视图名称
    modelAndView.setViewName("a");
    return modelAndView;
}
//下面是其它两种用法
@RequestMapping(value="/quick3")
public ModelAndView save3(ModelAndView modelAndView) {
    //设置模型数据
    modelAndView.addObject("username","hhf");
    //设置视图名称
    modelAndView.setViewName("a");
    return modelAndView;
}

@RequestMapping(value="/quick4")
public String save4(Model model) {
    model.addAttribute("username","hhf");
    return "a";
}

返回数据

返回字符串

注入response对象

@RequestMapping(value="/quick6")
public void save6(HttpServletResponse response) throws IOException {
    response.getWriter().print("hello");
}

@ResponseBody修饰方法

@RequestMapping(value="/quick7")
@ResponseBody
public String save7() {
    return "hello";
}

返回json字符串（使用fastjson）

@RequestMapping(value="/quick8")
@ResponseBody
public String save8() {
    User user=new User();
    user.setName("hhf");
    JSONObject jsonObject=new JSONObject();
    jsonObject.put("data",user);
    return JSONObject.toJSONString(jsonObject);
}

返回对象或集合

@RequestMapping(value="/quick9")
@ResponseBody
public User save9() {
    User user=new User();
    user.setName("hhf");
    return user;
}

spring-mvc.xml

<!--配置处理器映射器-->
<bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter">
    <property name="messageConverters">
        <list>
            <bean class="org.springframework.http.converter.json.MappingJackson2HttpMessageConverter"></bean>
        </list>
    </property>
</bean>

pom.xml导入jackson依赖

<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>
<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-annotations</artifactId>
    <version>2.9.0</version>
</dependency>

优化

用mvc注解驱动代替配置处理器映射器，自动加载处理映射器和处理适配器，默认底层会集成jackson进行对象或集合的json字符串转换，在spring-mvc.xml加入

<!--mvc注解驱动-->
<mvc:annotation-driven/>

四 SpringMVC请求

请求参数类型

基本类型

Controller中业务方法的参数名与请求参数名一致

@RequestMapping(value="/quick10")
@ResponseBody
public void save10(String name) {
    System.out.println("name="+name);
}

pojo类型

Controller中业务方法的pojo参数的属性名与请求参数名一致

@RequestMapping(value="/quick11")
@ResponseBody
public void save11(User user) {
    System.out.println(user);
}

public class User {
    private String name;

    @Override
    public String toString() {
        return "User{" +
                "name='" + name + '\'' +
                '}';
    }

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

    public String getName() {
        return name;
    }
}

数组类型

Controller中业务方法的数组参数名与请求参数名一致

@RequestMapping(value="/quick12")
@ResponseBody
public void save12(String[] names) {
    System.out.println(Arrays.asList(names));
}

集合类型

1 将集合参数包装到一个pojo中

public class VO {
    private List<User> userList;

    @Override
    public String toString() {
        return "VO{" +
                "userList=" + userList +
                '}';
    }

    public void setUserList(List<User> userList) {
        this.userList = userList;
    }

    public List<User> getUserList() {
        return userList;
    }
}

@RequestMapping(value="/quick13")
@ResponseBody
public void save13(VO vo) {
    System.out.println(vo);
}

前端jsp

<form action="${pageContext.request.contextPath}/user/quick13" method="post">
    <input type="text" name="userList[0].name">
    <input type="text" name="userList[1].name">
    <input type="submit" value="提交">
</form>

2 用ajax提交，指定contentType为json形式时，可以用@RequestBody修饰方法参数，不需要用pojo包装

@RequestMapping(value="/quick14")
@ResponseBody
public void save14(@RequestBody List<User> userList) {
    System.out.println(userList);
}

<script>
    var userList=new Array();
    userList.push({name:"hhf"});
    userList.push({name:"abc"});
    $.ajax({
        type:"post",
        url:"${pageContext.request.contextPath}/user/quick14",
        data:JSON.stringify(userList),
        contentType:"application/json;charset=utf-8"
    });
</script>

静态资源访问

spring-mvc.xml，以下两种写法二选一

<!--开放资源的访问权限，mapping表示虚拟路径，location表示资源实际目录-->
<mvc:resources mapping="/js/**" location="/js/"/>

<!--如果DispatcherServlet找不到资源，就交给tomcat查找静态资源-->
<mvc:default-servlet-handler/>

请求数据乱码

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>
</filter>
<filter-mapping>
    <filter-name>CharacterEncodingFilter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

参数绑定

请求参数名与Controller业务方法参数名不一致，使用@RequestParam绑定参数

value：请求参数名

required：指定是否必须包括请求参数，默认true

defaultValue：没有指定请求参数时的默认值

@RequestMapping(value="/quick15")
@ResponseBody
public void save15(@RequestParam(value="username",required = false,defaultValue = "hhf") String name) {
    System.out.println(name);
}

获得Restful风格参数

Restful是一种软件架构风格，请求使用“url+请求方式”

请求方式

get：获取资源
post：新建资源
put：更新资源
delete：删除资源

使用占位符进行参数绑定，使用@PathVariable进行占位符的匹配获取工作

@RequestMapping(value="/quick16/{username}")
@ResponseBody
public void save16(@PathVariable(value="username",required = true) String name) {
    System.out.println(name);
}

自定义类型转换器

开发步骤

定义转换器类实现Converter接口，泛型1转换为泛型2
在配置文件声明转换器
在<annotation-driven>引用转换器

下面以字符串转为日期对象为例

public class DateConverter implements Converter<String, Date> {
    @Override
    public Date convert(String source) {
        //将日期字符串转换成日期对象
        SimpleDateFormat format=new SimpleDateFormat("yyyy-MM-dd");
        Date date=null;
        try {
            date=format.parse(source);
        } catch (ParseException e) {
            e.printStackTrace();
        }
        return date;
    }
}

spring-mvc.xml

<!--声明转换器-->
<bean id="conversionService" class="org.springframework.context.support.ConversionServiceFactoryBean">
    <property name="converters">
        <list>
            <bean class="com.springmvc01.converter.DateConverter"></bean>
        </list>
    </property>
</bean>

<!--引用转换器-->
<mvc:annotation-driven conversion-service="conversionService"/>

获得servlet相关api

用原始servlet api对象作为控制器方法的参数注入，常用对象有

HttpServletRequest
HttpServletResponse
HttpSession

@RequestMapping(value="/quick18")
@ResponseBody
public void save18(HttpServletRequest request, HttpServletResponse response, HttpSession session) {
    System.out.println(request);
    System.out.println(response);
    System.out.println(session);
}

获得请求头

@RequestHeader

value：请求头名称
required：是否必须携带请求头

@RequestMapping(value="/quick19")
@ResponseBody
public void save19(@RequestHeader(value="User-Agent",required = false) String user_agent) {
    System.out.println(user_agent);
}

@CookieValue

value：指定cookie名称
required：是否必须携带cookie

@RequestMapping(value="/quick20")
@ResponseBody
public void save20(@CookieValue(value="JSESSIONID",required = false) String jsessionid) {
    System.out.println(jsessionid);
}

文件上传

单文件上传

导入fileupload和io坐标
配置文件上传解析器
编写文件上传代码

<dependency>
    <groupId>commons-fileupload</groupId>
    <artifactId>commons-fileupload</artifactId>
    <version>1.2.1</version>
</dependency>
<dependency>
    <groupId>commons-io</groupId>
    <artifactId>commons-io</artifactId>
    <version>2.4</version>
</dependency>

spring-mvc.xml

<!--配置文件上传解析器-->
<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
<!--上传文件编码类型-->
    <property name="defaultEncoding" value="utf-8"></property>
<!--上传文件总大小-->
    <property name="maxUploadSize" value="500000"></property>
</bean>

<form action="${pageContext.request.contextPath}/user/quick21" method="post" enctype="multipart/form-data">
    <input type="text" name="username">
    <input type="file" name="uploadFile">
    <input type="submit" value="提交">
</form>

注意上传文件input标签的name要与控制器方法MultipartFile的参数名相同

@RequestMapping(value="/quick21")
@ResponseBody
public void save21(String username, MultipartFile uploadFile) throws IOException {
    //获得文件名称
    String fileName=uploadFile.getOriginalFilename();
    System.out.println(fileName);
    System.out.println(username);
    //保存文件
    uploadFile.transferTo(new File("D:\\"+fileName));
}

多文件上传

<form action="${pageContext.request.contextPath}/user/quick22" method="post" enctype="multipart/form-data">
    <input type="text" name="username">
    <input type="file" name="uploadFile">
    <input type="file" name="uploadFile">
    <input type="submit" value="提交">
</form>

@RequestMapping(value="/quick22")
@ResponseBody
public void save22(String username, MultipartFile[] uploadFile) throws IOException {
    for (MultipartFile multipartFile:uploadFile) {
        //获得文件名称
        String fileName=multipartFile.getOriginalFilename();
        //保存文件
        multipartFile.transferTo(new File("D:\\"+fileName));
    }
}

五 SpringMVC拦截器

作用

类似Servlet的过滤器，用于对处理器进行预处理和后处理，是aop思想的具体实现

将拦截器按一定顺序联结成一条链，称为拦截器链。在访问被拦截的方法或字段时，拦截器链中的拦截器会按照定义的顺序被调用

拦截器和过滤器区别

在这里插入图片描述

开发步骤

创建拦截器类实现HandlerInterceptor接口

public class MyInterceptor implements HandlerInterceptor {
    @Override
    //在目标方法执行之前执行
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        System.out.println("prehandle");
        //返回true执行下一个拦截器的preHandle方法
        //返回false代表拦截请求，不执行目标方法
        return true;
    }

    @Override
    //在目标方法执行之后，视图对象返回之前执行
    public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
        System.out.println("posthandle");
    }

    @Override
    //在目标方法执行之后，视图对象返回之后执行
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
        System.out.println("aftercompletion");
    }
}

配置拦截器

<!--配置拦截器-->
<mvc:interceptors>
    <!--先定义的拦截器的preHandle方法先执行，postHandle方法和afterCompletion方法后执行-->
    <mvc:interceptor>
        <!--对哪些资源执行拦截操作,/**表示所有-->
        <mvc:mapping path="/**"/>
        <!--排除拦截哪些资源-->
        <mvc:exclude-mapping path="/user/quick22"/>
        <bean class="com.springmvc01.interceptor.MyInterceptor"></bean>
    </mvc:interceptor>
</mvc:interceptors>

测试拦截器的拦截结果

@RequestMapping(value="/target")
public ModelAndView show(){
    System.out.println("running");
    ModelAndView modelAndView=new ModelAndView();
    modelAndView.addObject("name","hhf");
    modelAndView.setViewName("index");
    return modelAndView;
}

六 SpringMVC异常处理

异常处理思路

dao, service, controller层出现异常都向上层抛出，最后由SpringMVC前端控制器交给异常处理器进行异常处理
在这里插入图片描述

异常处理方式

使用SpringMVC提供的SimpleMappingExceptionResolver

<!--配置简单映射异常处理器-->
<bean class="org.springframework.web.servlet.handler.SimpleMappingExceptionResolver">
    <!--默认异常视图-->
    <property name="defaultErrorView" value="error"></property>
    <property name="exceptionMappings">
        <map>
            <entry key="java.lang.ArithmeticException" value="error1"></entry>
        </map>
    </property>
</bean>

自定义异常处理

创建异常处理器实现HandlerExceptionResolver
配置异常处理器
编写异常页面
测试异常跳转

public class MyExceptionResolver implements HandlerExceptionResolver {
    @Override
    public ModelAndView resolveException(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) {
        ModelAndView modelAndView=new ModelAndView();
        if(ex instanceof ArithmeticException) {
            modelAndView.setViewName("error1");
        }
        else {
            modelAndView.setViewName("error");
        }
        return modelAndView;
    }
}

<!--自定义异常处理器-->
<bean class="com.springmvc01.resolver.MyExceptionResolver"></bean>

SpringMVC学习笔记

文章目录

一 SpringMVC简介

概述

开发步骤

流程图

二 SpringMVC组件解析

执行流程

注解解析

组件扫描

xml配置解析

三 SpringMVC数据响应

页面跳转

返回数据

四 SpringMVC请求

请求参数类型

静态资源访问

请求数据乱码

参数绑定

获得Restful风格参数

自定义类型转换器

获得servlet相关api

获得请求头

文件上传

单文件上传

多文件上传

五 SpringMVC拦截器

作用

拦截器和过滤器区别

开发步骤

六 SpringMVC异常处理

异常处理思路

异常处理方式