一、Spring MVC基本概念
1-1 Spring MVC的优势
1、清晰的角色划分:
前端控制器(DispatcherServlet)
请求到处理器映射(HandlerMapping)
处理器适配器(HandlerAdapter)
视图解析器(ViewResolver)
处理器或页面控制器(Controller)
验证器( Validator)
命令对象(Command 请求参数绑定到的对象就叫命令对象)
表单对象(Form Object 提供给表单展示和提交到的对象就叫表单对象)。
2、分工明确,而且扩展点相当灵活,可以很容易扩展,虽然几乎不需要。
3、由于命令对象就是一个 POJO,无需继承框架特定 API,可以使用命令对象直接作为业务对象。
4、和 Spring 其他框架无缝集成,是其它 Web 框架所不具备的。
5、可适配,通过 HandlerAdapter 可以支持任意的类作为处理器。
6、可定制性,HandlerMapping、ViewResolver 等能够非常简单的定制。
7、功能强大的数据验证、格式化、绑定机制。
8、利用 Spring 提供的 Mock 对象能够非常简单的进行 Web 层单元测试。
9、本地化、主题的解析的支持,使我们更容易进行国际化和主题的切换。
10、强大的 JSP 标签库,使 JSP 编写更容易。
1-2 SpringMVC 和 Struts2 的优略分析
共同点:
它们都是表现层框架,都是基于 MVC 模型编写的。
它们的底层都离不开原始 ServletAPI。
它们处理请求的机制都是一个核心控制器。
区别:
Spring MVC 的入口是 Servlet, 而 Struts2 是 Filter
Spring MVC 是基于方法设计的,而 Struts2 是基于类,Struts2 每次执行都会创建一个动作类。所
以 Spring MVC 会稍微比 Struts2 快些。
Spring MVC 使用更加简洁,同时还支持 JSR303, 处理 ajax 的请求更方便
(JSR303 是一套 JavaBean 参数校验的标准,它定义了很多常用的校验注解,我们可以直接将这些注
解加在我们 JavaBean 的属性上面,就可以在需要校验的时候进行校验了。)
Struts2 的 OGNL 表达式使页面的开发效率相比 Spring MVC 更高些,但执行效率并没有比 JSTL 提
升,尤其是 struts2 的表单标签,远没有 html 执行效率高。
二、Spring MVC入门
2-1 使用纯xml的方式
-
引入依赖
<dependencies> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-webmvc</artifactId> <version>5.2.5.RELEASE</version> </dependency> <dependency> <groupId>javax.servlet</groupId> <artifactId>servlet-api</artifactId> <version>2.5</version> <scope>provided</scope> </dependency> <dependency> <groupId>javax.servlet.jsp</groupId> <artifactId>jsp-api</artifactId> <version>2.0</version> <scope>provided</scope> </dependency> </dependencies>
-
编写web.xml
<?xml version="1.0" encoding="UTF-8"?> <web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd" version="4.0"> <servlet> <servlet-name>dispatcherServlet</servlet-name> <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class> <init-param> <param-name>contextConfigLocation</param-name> <param-value>classpath:springmvc.xml</param-value> </init-param> <!-- 启动级别:配置servlet启动时加载对象 --> <load-on-startup>1</load-on-startup> </servlet> <servlet-mapping> <servlet-name>dispatcherServlet</servlet-name> <!-- / : 只匹配所有请求,不会匹配jsp页面 /*: 匹配所有请求,包含jsp页面 --> <url-pattern>/</url-pattern> </servlet-mapping> </web-app>
-
编写springmvc.xml
<?xml version="1.0" encoding="UTF-8"?> <beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation=" http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd"> <!--处理器映射器--> <bean class="org.springframework.web.servlet.handler.BeanNameUrlHandlerMapping"/> <!--处理器适配器--> <bean class="org.springframework.web.servlet.mvc.SimpleControllerHandlerAdapter"/> <!--视图解析器--> <bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver"> <property name="prefix" value="/WEB-INF/pages/"/> <property name="suffix" value=".jsp"/> </bean> <bean name="/hello" class="com.qgc.controller.HelloController"/> </beans>
-
编写Controller
public class HelloController implements Controller { @Override public ModelAndView handleRequest(HttpServletRequest httpServletRequest,HttpServletResponse httpServletResponse) throws Exception { ModelAndView modelAndView = new ModelAndView(); modelAndView.addObject("value","Hello SpringMVC"); modelAndView.setViewName("hello"); return modelAndView; } }
-
hello.jsp
<%@ page contentType="text/html;charset=UTF-8" language="java" %> <html> <head> <title>Title</title> </head> <body> ${value} </body> </html>
执行流程
2-2 使用注解开发
-
引入依赖
<dependencies> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-webmvc</artifactId> <version>5.2.5.RELEASE</version> </dependency> <dependency> <groupId>javax.servlet</groupId> <artifactId>servlet-api</artifactId> <version>2.5</version> <scope>provided</scope> </dependency> <dependency> <groupId>javax.servlet.jsp</groupId> <artifactId>jsp-api</artifactId> <version>2.0</version> <scope>provided</scope> </dependency> </dependencies>
-
编写web.xml
<?xml version="1.0" encoding="UTF-8"?> <web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd" version="4.0"> <servlet> <servlet-name>dispatcherServlet</servlet-name> <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class> <init-param> <param-name>contextConfigLocation</param-name> <param-value>classpath:springmvc.xml</param-value> </init-param> <!-- 启动级别:配置servlet启动时加载对象 --> <load-on-startup>1</load-on-startup> </servlet> <servlet-mapping> <servlet-name>dispatcherServlet</servlet-name> <url-pattern>/</url-pattern> </servlet-mapping> </web-app>
-
编写springmvc.xml配置文件
<?xml version="1.0" encoding="UTF-8"?> <beans xmlns="http://www.springframework.org/schema/beans" xmlns:mvc="http://www.springframework.org/schema/mvc" xmlns:context="http://www.springframework.org/schema/context" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation=" http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd"> <!--配置要扫描的包--> <context:component-scan base-package="com.qgc.controller"/> <bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver"> <property name="prefix" value="/WEB-INF/pages/"/> <property name="suffix" value=".jsp"/> </bean> <!--开启注解支持--> <mvc:annotation-driven /> <!--过滤静态资源--> <mvc:default-servlet-handler/> <!-- 手动过滤静态资源 --> <mvc:resources location="/css/" mapping="/css/**"/> <!-- 样式 --> <mvc:resources location="/images/" mapping="/images/**"/> <!-- 图片 --> <mvc:resources location="/js/" mapping="/js/**"/> <!-- javascript --> </beans>
注意:
在 SpringMVC 的各个组件中,处理器映射器、处理器适配器、视图解析器称为 SpringMVC 的三大组件。
使 用<mvc:annotation-driven>
自动加载 RequestMappingHandlerMapping (处理映射器) 和
RequestMappingHandlerAdapter ( 处 理 适 配 器 ) , 可 用 在 SpringMVC.xml 配 置 文 件 中 使 用<mvc:annotation-driven>
替代注解处理器和适配器的配置 -
编写controller文件
@Controller public class HelloController2 { @RequestMapping("/hello") public String test(Model model){ model.addAttribute("value","Hello SpringMVC2"); return "hello"; } }
2-3 404问题
-
首先确认导入了Spring-mvc的包,否则会导致404
-
确定打包的时候将jar包导出了
2-4 mvc中所用的组件
- DispatcherServlet:前端控制器
用户请求到达前端控制器,它就相当于 mvc 模式中的 c,dispatcherServlet 是整个流程控制的中心,由
它调用其它组件处理用户的请求,dispatcherServlet 的存在降低了组件之间的耦合性。
- HandlerMapping:处理器映射器
HandlerMapping 负责根据用户请求找到 Handler 即处理器,SpringMVC 提供了不同的映射器实现不同的
映射方式,例如:配置文件方式,实现接口方式,注解方式等。
- Handler:处理器
它就是我们开发中要编写的具体业务控制器。由 DispatcherServlet 把用户请求转发到 Handler。由
Handler 对具体的用户请求进行处理。
- HandlAdapter:处理器适配器
通过 HandlerAdapter 对处理器进行执行,这是适配器模式的应用,通过扩展适配器可以对更多类型的处理
器进行执行
- View Resolver:视图解析器
View Resolver 负责将处理结果生成 View 视图,View Resolver 首先根据逻辑视图名解析成物理视图名
即具体的页面地址,再生成 View 视图对象,最后对 View 进行渲染将处理结果通过页面展示给用户。
- View:视图
SpringMVC 框架提供了很多的 View 视图类型的支持,包括:jstlView、freemarkerView、pdfView
等。我们最常用的视图就是 jsp。
一般情况下需要通过页面标签或页面模版技术将模型数据通过页面展示给用户,需要由程序员根据业务需求开发具体的页面。
三、请求参数
3-1 基本类型参数
直接在controller类上加上参数即可,要求此参数与前端传过来的参数名称一致
@RequestMapping(path = "/hello")
public String getParam(String username){
System.out.println("用户名"+username);
return "success";
}
3-2 POJO 类型参数
直接写上实体类即可
@RequestMapping(path = "/form")
public String getParams(Account account){
System.out.println(account);
return "success";
}
3-3 解决POST提交乱码问题
在web.xml中加入以下代码即可
<!--配置解决乱码的过滤器-->
<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>
3-4 自定义类型转换器
- 写一个自定义类型转换器实现Converter接口
public class StringToDate implements Converter<String, Date> {
/**
* 自定义类型转换器
*
* @param source 传入的参数
* @return
*/
@Override
public Date convert(String source) {
if (source == null) {
throw new RuntimeException("参数不能为空");
}
try {
DateFormat df = new SimpleDateFormat("yyyy-MM-dd"); // 解析字符串
Date date = df.parse(source);
return date;
} catch (Exception e) {
throw new RuntimeException("类型转换错误");
}
}
}
- 注册自定义类型转换器,在springmvc.xml配置文件中编写配置
<!--配置自定义转换器-->
<bean id="conversionService" class="org.springframework.context.support.ConversionServiceFactoryBean">
<property name="converters">
<set>
<bean class="cn.itcast.utils.StringToDateConverter"/>
</set>
</property>
</bean>
<!--Spring开启注解-->
<mvc:annotation-driven conversion-service="conversionService"></mvc:annotation-driven>
3-5 获取Servlet原生api
直接在方法的参数上写想要获取的api即可
@RequestMapping("/testServletAPI")
public String testServletAPI(HttpServletRequest request,HttpServletResponse response,HttpSession session) {
System.out.println(request);
System.out.println(response);
System.out.println(session);
}
四、RestFul风格
4-1 RestFul简介
-
概念
Restful就是一个资源定位及资源操作的风格。不是标准也不是协议,只是一种风格。基于这个风
格设计的软件可以更简洁,更有层次,更易于实现缓存等机制。 -
传统方式操作资源
通过不同的参数实现不同的效果!方法单一,post 和 get
http://127.0.0.1/item/queryltem.action?id=1查询,GET
http://127.0.0.1/item/saveltem.action新增,POST
http://127.0.0.1/item/updateltem.action更新, POST
http://127.0.0.1/item/deleteltem.action?id=1删除, GET或POST
-
使用RESTful操作资源
可以通过不同的请求方式来实现不同的效果!如下:请求地址一样,但是功能可以不同
http://127.0.0.1/item/1查询,GET
http://127.0.0.1/item新增,POST
http://127.0.0.1/item更新,PUT
http://127.0.0.1/item/1删除,DELETE
4-2 实现
-
在参数前加上@PathVariable注解
@RequestMapping("/hello/{a}/{b}") public String test(@PathVariable int a,@PathVariable int b, Model model){ model.addAttribute("value"," 值为: " + (a + b)); return "hello"; }
五、常用注解
5-1 RequestParam
作用:
把请求中指定名称的参数给控制器中的形参赋值。
属性:
value:请求参数中的名称。
required:请求参数中是否必须提供此参数。默认值:true。表示必须提供,如果不提供将报错。
例:
//将前端的name值传给username
@RequestMapping("/useRequestParam")
public String useRequestParam(@RequestParam("name") String username)
5-2 RequestBody
作用:
用于获取请求体内容。直接使用得到是 key=value&key=value…结构的数据。get 请求方式不适用。
属性:
required:是否必须有请求体。默认值是:true。当取值为 true 时,get 请求方式会报错。如果取值为 false,get 请求得到是 null。
例:
@RequestMapping("/useRequestBody")
public String useRequestBody(@RequestBody(required=false) String body){}
5-3 PathVaribale
作用:
用于绑定 url 中的占位符。例如:请求 url 中 /delete/{id},这个{id}就是 url 占位符。url 支持占位符是 spring3.0 之后加入的。是 springmvc 支持 rest 风格 URL 的一个重要标志。
属性:
value:用于指定 url 中占位符名称。
required:是否必须提供占位符。
例:
@RequestMapping("/usePathVariable/{id}")
public String usePathVariable(@PathVariable("id") Integer id){}
5-4 ModelAttribute
作用:
该注解是 SpringMVC4.3 版本以后新加入的。它可以用于修饰方法和参数。
出现在方法上,表示当前方法会在控制器的方法执行之前,先执行。它可以修饰没有返回值的方法,也可以修饰有具体返回值的方法。
出现在参数上,获取指定的数据给参数赋值。
属性:
value:用于获取数据的 key。key 可以是 POJO 的属性名称,也可以是 map 结构的 key。
应用场景:
当表单提交数据不是完整的实体类数据时,保证没有提交数据的字段使用数据库对象原来的数据。
例如:
我们在编辑一个用户时,用户有一个创建信息字段,该字段的值是不允许被修改的。在提交表单数
据是肯定没有此字段的内容,一旦更新会把该字段内容置为 null,此时就可以使用此注解解决问题。
- 方式一:在方法名上加ModelAttribute
下面代码会先执行modelAttribute,获取用户的uname,模拟在数据库中查询user,返回给saveUser方法。
saveUser方法拿到modelAttribute返回的user 然后在这个基础上封装用户传过来的数据注意:无论前端请求该Controller下的哪个方法,被 @ModelAttribute表示的方法会先执行,相当于init
@RequestMapping(path = "/test2")
public String saveUser(User user){
System.out.println(user);
return "success";
}
@ModelAttribute
public User modelAttribute(String uname){
User user = new User();
user.setAge(99);
user.setBirthday(new Date());
user.setUname(uname);
return user;
}
- 方式二:不适用返回值
@RequestMapping(path = "/test3")
public String saveUser1(@ModelAttribute User user){
System.out.println(user);
return "success";
}
@ModelAttribute
public void modelAttribute(String uname, Map<String,User> map){
User user = new User();
user.setAge(99);
user.setBirthday(new Date());
user.setUname(uname);
map.put("abc",user);
}
六、响应数据和结果视图
6-1 返回值分类
- 字符串
@RequestMapping("/testReturnString")
public String testReturnString() {
System.out.println("AccountController 的 testReturnString 方法执行了。。。。");
return "success";
}
- void
可以使用response进行跳转,也可以直接输出 - ModelAndView
@RequestMapping("/testReturnModelAndView")
public ModelAndView testReturnModelAndView() {
ModelAndView mv = new ModelAndView();
mv.addObject("username", "张三");
mv.setViewName("success");
return mv;
}
Model 只适合用于存储数据
ModelMap 继承了LinkedMap,有了LinkedMap的方法和特性
ModelAndView 可以存储数据的同时,返回逻辑视图,进行跳转
6-2 转发和重定向
- forward 转发
直接写在return语句中即可
return "forward:/WEB-INF/pages/success.jsp";
- Redirect 重定向
return "redirect:testReturnModelAndView";
6-3 ResponseBody 响应 json 数据
方式一:使用Jackson
- 导入jar包
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-databind</artifactId>
<version>2.10.0</version>
</dependency>
- 使用@RequestBody注解把json的字符串转换成JavaBean的对象,使用@ResponseBody注解把JavaBean对象转换成json字符串,直接响应
要求方法需要返回JavaBean的对象
@Controller
public class UserController {
@RequestMapping("/a")
@ResponseBody
public String test01() throws JsonProcessingException {
ObjectMapper objectMapper = new ObjectMapper(); //Jackson中的类
User user = new User();
user.setName("哈哈");
user.setSex("嘿嘿");
return objectMapper.writeValueAsString(user);
}
}
-
解决JSON中出现中文乱码情况
在springmvc.xml中加入如下代码:
<!--Jackson乱码解决--> <bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter"> <property name="messageConverters"> <list> <bean class="org.springframework.http.converter.StringHttpMessageConverter"> <property name="supportedMediaTypes"> <list> <value>text/html;charset=UTF-8</value> </list> </property> </bean> </list> </property> </bean>
-
抽取为工具类
/** jackson 工具类,格式化JSON对象 * @Classname JsonUtil * @Description TODO * @Date 2020-04-16 23:41 * @Author by Administrator */ public class JsonUtil { public static String getJSONString(Object object){ return getJSONString(object,"yyyy-MM-dd HH:mm:ss"); } /** * @param object 要格式化的对象 * @param dateFormat 日期格式字符串 如:yyyy-MM-dd HH:mm:ss * @return 返回JSON字符串 */ public static String getJSONString(Object object,String dateFormat) { ObjectMapper mapper = new ObjectMapper(); //不使用时间戳方式 mapper.configure(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS,false); //自定义日期格式 SimpleDateFormat simpleDateFormat = new SimpleDateFormat(dateFormat); mapper.setDateFormat(simpleDateFormat); try { return mapper.writeValueAsString(object); } catch (JsonProcessingException e) { e.printStackTrace(); } return null; } }
方式二:FastJson
-
导入依赖
<dependency> <groupId>com.alibaba</groupId> <artifactId>fastjson</artifactId> <version>1.2.60</version> </dependency>
-
使用
@Controller public class UserController { @RequestMapping("/a") @ResponseBody public String test01() throws JsonProcessingException { Date date = new Date(); //格式化日期 JSON.DEFFAULT_DATE_FORMAT = "yyyy-MM-dd"; return JSON.toJSONString(date, SerializerFeature.WriteDateUseDateFormat); } }
七、文件上传
-
配置文件解析器对象
<!-- 配置文件解析器对象,要求id名称必须是multipartResolver --> <bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver"> <property name="maxUploadSize" value="10485760"/> </bean>
-
编写controller类
/*** SpringMVC方式的文件上传 ** @param request * @return * @throws Exception */ @RequestMapping(value = "/fileupload2") public String fileupload2(HttpServletRequest request, MultipartFile upload) throws Exception { System.out.println("SpringMVC方式的文件上传..."); // 先获取到要上传的文件目录 String path = request.getSession().getServletContext().getRealPath("/uploads"); // 创建File对象,一会向该路径下上传文件 File file = new File(path); // 判断路径是否存在,如果不存在,创建该路径 if (!file.exists()) { file.mkdirs(); } // 获取到上传文件的名称 String filename = upload.getOriginalFilename(); String uuid = UUID.randomUUID().toString().replaceAll("-", "").toUpperCase(); // 把文件的名称唯一化 filename = uuid + "_" + filename; // 上传文件 upload.transferTo(new File(file, filename)); return "success"; }
-