一、基于注解的springMVC应用【掌握】
spring2.5版本增加了可基于注解的控制器,也就是说控制器不用实现Controller接口,通过注解类型来描述,下面演示一个基于注解的控制器SpringMVC的WEB应用
由于使用了注解类型,因此不需要再在配置文件中使用XML描述bean,Spring使用扫描机制查找应用程序中所有基于注解的控制器类<context.component-scan basepackage="com.acoffee.maven.controller">
制定需要spring扫描com.acoffee.maven.controller
包及其子包下面的所有java文件。
此处还配置了一个annotation类型的处理映射器RequestMappingHandlerMapping
,它根据请求查找映射;同时配置了annotation类型的处理器适配器RequestMappingHandlerAdapter
,,来完成对HelloController类的@RequestMapping
注解方法的调用;最后配置了视图解析器InternalResourceViewResolver
来解析视图,将view呈现给用户
springmvc使用< mvc:annotation-driven >自动加载RequestMappingHanderMapping和RequestMappingHandlerAdapter ,可用在springmvc.xml配置文件中使用< mvc:annotation-driven >替代注解处理器和适配器的配置。
web.xml文件
<?xml version="1.0" encoding="UTF-8"?>
<web-app id="WebApp_9" version="3.0" xmlns="http://java.sun.com/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_3_0.xsd">
<!--解决后端返回页面中文乱码问题-->
<filter>
<filter-name>encodingFilter</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>encodingFilter</filter-name>
<servlet-name>springmvc</servlet-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
<!--
/:只匹配所有的请求,不会去匹配jsp页面
/*:匹配所有的请求,包括jsp页面,如果使用/* 这里就会出问题,所有的jsp请求最交给DispatchServlet处理,如果我们在视图解析器配置后缀为.jsp,然后就会出现Hello.jsp.jsp.....无限嵌套报错404
-->
<servlet>
<servlet-name>springmvc</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>springmvc</servlet-name>
<url-pattern>/</url-pattern>
</servlet-mapping>
</web-app>
为什么我们这里配置DispatchServlet为 /
而不是 /*
其中 /
和 /*
的区别:
< url-pattern> / </url-pattern >
不会匹配到*.jsp
,即:*.jsp
不会进入spring的 DispatcherServlet
类 。
< url-pattern > /* </ url-pattern >
会匹配*.jsp
,会出现返回jsp视图时再次进入spring的DispatcherServlet
类,导致找不到对应的controller
所以报404错。
总之,关于web.xml的url映射的小知识:
<url-pattern>/</url-pattern>
会匹配到/login
这样的路径型url
,不会匹配到模式为*.jsp
这样的后缀型url。
<url-pattern>/*</url-pattern>
会匹配所有url:路径型的和后缀型的url(包括/login
,*.jsp
,*.js
和*.html
等)。
springmvc-servlet.xml文件
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:context="http://www.springframework.org/schema/context"
xmlns:mvc="http://www.springframework.org/schema/mvc"
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/context http://www.springframework.org/schema/context/spring-context.xsd
http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc.xsd">
<!-- 自动扫描包,让指定包下的注解生效,由IOC容器统一管理 -->
<context:component-scan base-package="com.acoffee.maven.controller"></context:component-scan>
<!--基于注解的处理器映射器-->
<!--<bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping"></bean>-->
<!--基于注解的处理器适配器-->
<!--<bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter"></bean>-->
<!--支持mvc注解驱动
在spring中一般采用@RequestMapping注解来完成映射关系
要想使@RequestMapping注解生效
必须向上下文中注册DefaultAnnotationHandlerMapping
和一个AnnotationMethodHandlerAdapter实例
这两个实例分别在类级别和方法级别处理。
而annotation-driven配置帮助我们自动完成上述两个实例的注入。-->
<!--使用如下配置替代上面的RequestMappingHanlderMapping和RequestMappingHanlderAdapter-->
<mvc:annotation-driven></mvc:annotation-driven>
<!--我们一般也会再配置文件中配置视图解析器:如果我们这里配置了下面写welcome就可以了-->
<!-- 视图解析器 -->
<!-- <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"
id="internalResourceViewResolver">-->
<!-- 前缀 -->
<!--<property name="prefix" value="/WEB-INF/jsp/" />-->
<!-- 后缀 -->
<!--<property name="suffix" value=".jsp" />
</bean>-->
</beans>
在视图解析器中我们把所有的视图都存放在/WEB-INF/目录下,这样可以保证视图安全,因为这个目录下的文件,客户端不能直接访问。
controller组件
@Controller
@RequestMapping(value="/hello")
public class HelloController {
@RequestMapping("/hello")
public ModelAndView hi(){
ModelAndView modelAndView = new ModelAndView();
System.out.println("========基于注解的springmvc中的hi方法========");
modelAndView.setViewName("/welcome.jsp");
return modelAndView;
}
@RequestMapping("/thanks")
public ModelAndView thanks(){
ModelAndView modelAndView = new ModelAndView();
System.out.println("========基于注解的springmvc中的thank方法========");
modelAndView.setViewName("/welcome.jsp");
return modelAndView;
}
}
执行结果:
@RequestMapping:注解
主要的功能:请求映射的,给前台设置请求到控制器中的路径或方法
位置:可以放在类,也可以放在方法上.
说明:一个Controller可以编写多个方法,每个方法就是一个功能,如果在类上声明实际上的作用就相当于模块的功能
如果放在方法上实际上就是这个方法对外提供的路径,最终对外提供的路径是:类上@RequestMapping注解的声明的value值+对应方法上@RequestMapping的声明的value值
@RequestMapping常用的属性如下
- value:编写请求路径地址
- path:path与value作用一样,一般都是用value,基本上没有人使用path
- method:表示HTTP协议请求方法,常用的方法如下:
方法 |
---|
RequestMethod.GET |
RequestMethod.POST |
RequestMethod.DELETE |
新增注解
Spring4.3之后,新增了@GetMapping,@PostMapping,@PutMapping,@DeleteMapping ,@PathMapping注解,
这几个注解可以指定的属性和@RequestMapping注解类似.
区别如下:
注解 | 作用 |
---|---|
@GetMapping | 只支持GET方式的请求 |
@PostMapping | 只支持POST方式的请求 |
@PutMapping | PUT请求 |
@DeleteMapping | DELETE请求 |
@PatchMapping | PATCH请求 |
注意:如果在@RequestMapping只有一个属性,value,那么value可以省略不写
< load-onstartup>属性
如果< load-onstartup>元素的值为1,则在应用程序启动时会立即加载该Servlet ;
如果< load-on-startup>元素不存在,则应用程序会在第一个Servlet请求时加载DispatcherServlet.
二、更改springmvc配置文件的名称或路径
默认情况下,springmvc得配置文件的名称和路径都是有规定的,不能随意乱取名称和存放,规定如下:
必须在WEB-INF 文件夹下,名字必须是xx-servlet.xml,这个xx就是我们在web.xml中取的名字
实际上学习maven,为了更好构建项目,建议大家将配置文件都放在resources之下
DispatcherServlet默认自动加载WEB-NF/< servlet-name>-servlet.xml的Spirng配置文件,启动WEB层spring容嚣可以为DlspatcherServlet配置名称为contextConfigLocation的初始化参数指定配置文件的名称和位置,具体如下所示:
<init-param>
<param-name>contextConfigLocation</param-name>
<param-value>classpath:springmvc-config.xml</param-value>
</init-param>
三、请求处理参数
① 控制器方法入参
控制器就是我们的controller
,请求的URL参数绑定到controller
的方法形参中。接下来我们会说到 字符串、数组、集合、对象参数的处理。
重点: 要记住的是String字符串类型和我们的对象类型传参,因为用的最多,问题也是最多。在Springboot中同样适用。
参数注解:
@RequstParam
这个注解是用来处理 form表单类型的请求数据。这个注解中有个 required 这个属性是true的话表示不能为空,false是可以为空的@RequestParam(value = "name",required = false)
@RequestBody
(前后端分离,我们常用这个注解)这个注解是用来处理json数据,或者异步提交(ajax)的JSON数据。
String字符串类型
index.jsp
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>Title</title>
</head>
<body>
<h2>String类型传参</h2>
<form action="/acoffee/StringView" method="post">
<input type="text" name="name">
<input type="password" name="password">
<button>提交</button>
</form>
</body>
</html>
StringView.jsp
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>Title</title>
</head>
<body>
${username}<br>
${password}
</body>
</html>
controller组件
@Controller
@RequestMapping("/acoffee")
public class StringController {
@RequestMapping("/StringView")
public ModelAndView andView(@RequestParam(value = "name",required = false) String username, String password){
ModelAndView modelAndView = new ModelAndView();
modelAndView.addObject("username","传入用户名的是:"+username);
modelAndView.addObject("password","传入密码的是:"+password);
modelAndView.setViewName("stringView");
return modelAndView;
}
}
执行结果:
List集合
index.jsp
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>Title</title>
</head>
<body>
<h2>List类型传参</h2>
<form action="/acoffee/ListView" method="post">
<input type="checkbox" name="ids" value="0">frank
<input type="checkbox" name="ids" value="1">tom
<input type="checkbox" name="ids" value="2">jerry <br>
<button>提交</button>
</form>
</body>
</html>
ListView.jsp
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>Title</title>
</head>
<body>
${ids}
</body>
</html>
controller组件
@Controller
@RequestMapping("/acoffee")
public class StringController {
@RequestMapping("/ListView")
public ModelAndView andView1(@RequestParam List<Integer> ids){
ModelAndView modelAndView = new ModelAndView();
modelAndView.addObject("ids","传入参数的是:"+ids);
modelAndView.setViewName("listView");
return modelAndView;
}
}
执行结果:
Map集合
index.jsp
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>Title</title>
</head>
<body>
<h2>Map类型传参</h2>
<form action="/acoffee/MapView" method="post">
用户名:<input type="text" name="username"> <br>
年龄:<input type="number" name="age"> <br>
<input type="radio" name="sex" value="1">男
<input type="radio" name="sex" value="2">女
<br>
<button>提交</button>
</form>
</body>
</html>
MapView.jsp
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>Title</title>
</head>
<body>
${map}
</body>
</html>
controller组件
@Controller
@RequestMapping("/acoffee")
public class UserController {
@RequestMapping("/MapView")
public ModelAndView andView2(@RequestParam Map map){
ModelAndView modelAndView = new ModelAndView();
modelAndView.addObject("map","传入的参数是:"+map);
modelAndView.setViewName("mapView");
return modelAndView;
}
}
}
执行结果:
单个实体类
实体类
@Data
@AllArgsConstructor
@NoArgsConstructor
public class User {
private String name;
private int age;
private String telphone;
private String sex;
}
index.jsp
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>Title</title>
</head>
<body>
<h2>Map类型传参</h2>
<form action="/acoffee/ObjectView" method="post">
用户名:<input type="text" name="name"> <br>
年龄:<input type="number" name="age"> <br>
电话:<input type="text" name="telphone"><br>
<input type="radio" name="sex" value="1">男
<input type="radio" name="sex" value="2">女
<br>
<button>提交</button>
</form>
</body>
</html>
objectView.jsp
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>Title</title>
</head>
<body>
${user}
</body>
</html>
controller组件
@Controller
@RequestMapping("/acoffee")
public class UserController {
@RequestMapping("/ObjectView")
public ModelAndView andView3(User user){
ModelAndView modelAndView = new ModelAndView();
modelAndView.addObject("user","传入的参数是:"+user);
modelAndView.setViewName("objectView");
return modelAndView;
}
}
}
执行结果:
实体类一对多
实体类
@Data
@NoArgsConstructor
@AllArgsConstructor
public class ClassRoom {
String className;
List<User> studentList;
}
@Data
@AllArgsConstructor
@NoArgsConstructor
public class User {
private String name;
private int age;
private String telphone;
private String sex;
}
index.jsp
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>Title</title>
</head>
<body>
<h2>Map类型传参</h2>
<form action="/acoffee/ObjectView" method="post">
用户名:<input type="text" name="name"> <br>
年龄:<input type="number" name="age"> <br>
电话:<input type="text" name="telphone"><br>
<input type="radio" name="sex" value="1">男
<input type="radio" name="sex" value="2">女
<br>
<button>提交</button>
</form>
</body>
</html>
objectView.jsp
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>Title</title>
</head>
<body>
${classRoom}
</body>
</html>
controller组件
@Controller
@RequestMapping("/acoffee")
public class UserController {
@RequestMapping("/ObjectView")
public ModelAndView andView3(User user){
ModelAndView modelAndView = new ModelAndView();
modelAndView.addObject("user","传入的参数是:"+user);
modelAndView.setViewName("objectView");
return modelAndView;
}
}
}
执行结果:
四、处理静态资源
我们的web.xml配置有一个坑,DispatchServlet的配置,拦截了所有的 / 的这种请求,都要
经过mvc的过滤。然后会经过mvc的流程,解析URI,就会出现访问不到后台的静态资源。
图片放在非WEB-INF目录下
第一种方案:
在标注配置下,也就是我们配置了DispatchServlet的情况下,直接通过浏览器访问,无法
访问。原因是被DispatchServlet给拦截住了
如果想要解决这个问题,就需要考虑,让图片资源, 不直接通过 DispatchServlet来进行访
问,采用通过tomcat的defaultservlet来进行过滤,让静态资源走tomcat的servlet。
如何让请求,先去我们tomcat的defaultservlet来进行访问,而不是通过springmvc的
DispatchServlet来进行拦截,我们可以修改我们的项目中的web.xml:
<!--将会过滤所有后缀是png的静态资源 -->
<servlet-mapping>
<servlet-name>default</servlet-name>
<url-pattern>*.png</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>default</servlet-name>
<url-pattern>*.css</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>default</servlet-name>
<url-pattern>*.gif</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>default</servlet-name>
<url-pattern>*.mp4</url-pattern>
</servlet-mapping>
default是tomcat默认的servlet。
我们其实还有其他的各种服务器:
第二种方案:
在applicationContext.xml中加一句话:
<mvc:default-servlet-handler/>
在xml中添加这句话的时候,可以解决非WEB-INF下的静态资源的访问,但是,此时
如果没有 <mvc:annotation-driven/>
,则会出现,controller接口无法访问!反之,如
果有他们2个,则都能访问成功。
SpringMVC的上下文中定义了一个类DefaultServletHttpRequestHandler
,对进入
DispatchServlet的URL进行筛查,静态资源交给web服务器默认的Servlet来出来,非静
态资源交给DispatchServlet来处理。