SpringMVC框架入门
<!-- springmvc 依赖 -->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
<version>5.2.6.RELEASE</version>
</dependency>
</dependencies>
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"
xmlns:context="http://www.springframework.org/schema/context"
xmlns:mvc="http://www.springframework.org/schema/mvc"
xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/context https://www.springframework.org/schema/context/spring-context.xsd http://www.springframework.org/schema/mvc https://www.springframework.org/schema/mvc/spring-mvc.xsd">
<!-- 注解扫描 -->
<context:component-scan base-package="com.zzxx.web"/>
<!-- 同时注册处理器适配器和处理器映射器 -->
<mvc:annotation-driven/>
<!-- <bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping"/>-->
<!-- <bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter"/>-->
<!-- 配置视图解析器 -->
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<!-- 视图后缀 -->
<property name="suffix" value=".jsp"/>
<!-- 视图前缀 -->
<property name="prefix" value="/WEB-INF/pages/"/>
</bean>
</beans>
web.xml
<!DOCTYPE web-app PUBLIC
"-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
"http://java.sun.com/dtd/web-app_2_3.dtd" >
<web-app>
<display-name>Archetype Created Web Application</display-name>
<!-- 配置前端控制器 -->
<servlet>
<servlet-name>DispatcherServlet</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<!-- 配置初始化参数: 指定springmvc配置文件路径 -->
<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>
<!-- /* 拦截所有,包括静态资源 .PNG .CSS .JS .JSP ...
/ 拦截所有,不包括 .JSP 一般常用于互联网应用
*.do 一般在xx管理系统使用
-->
<url-pattern>/</url-pattern>
</servlet-mapping>
</web-app>
.jsp
<%@ page pageEncoding="UTF-8" isELIgnored="false" %>
<html>
<body>
<h2>Hello World!</h2>
<a href="${pageContext.request.contextPath}/spring/hello?username=zhangsan">发送请求</a><br>
<a href="${pageContext.request.contextPath}/spring/hehe?username=zhangsan">发送请求</a>
</body>
</html>
HelloController.java
@Controller
// 这个类中所有的处理器方法, 都会在路径上加统一的上级目录
@RequestMapping("/spring")
public class HelloController {
// <servlet-name>
// params = "username" : 表示请求中必须包含username参数
@RequestMapping(value={"/hello", "/hehe"}, method = {RequestMethod.POST, RequestMethod.GET}
, params = {"username=lisi", "age<100"},
headers = "user-agent")
public String hello() {
System.out.println("hello 控制器方法执行了!");
return "success";
}
@RequestMapping("/hi")
public String hi() {
System.out.println("hi 控制器方法执行了!");
return "success";
}
}
WEB-INF/pages/success.jsp
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>执行成功</title>
</head>
<body>
执行成功!
</body>
</html>
SpringMVC执行流程
SpringMVC请求参数绑定
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>参数接收测试</title>
</head>
<body>
<!-- 发送请求, 参数为简单类型 id=1&username=zhangsan -->
<a href="params/simple?id=1&username=zhangsan">接收简单类型的参数</a><br>
<!-- 发送请求, 参数为对象类型[参数可以封装为一个完整的对象] -->
<form action="params/bean" method="post">
账号id: <input type="text" name="id"/> <br>
账号姓名: <input type="text" name="name"/> <br>
账号金额: <input type="text" name="money"/> <br>
<%-- 想要将以下两个参数值 封装到上面 account对象中的user属性里 --%>
用户id: <input type="text" name="user.id"/> <br>
用户姓名: <input type="text" name="user.username"/> <br>
<input type="submit" value="提交">
</form>
<form action="params/array" method="post">
<input type="checkbox" name="ids" value="1"/>
<input type="checkbox" name="ids" value="2"/>
<input type="checkbox" name="ids" value="3"/>
<input type="checkbox" name="ids" value="4"/>
<input type="checkbox" name="ids" value="5"/><br>
<input type="submit" value="提交">
</form>
<form action="params/list" method="post">
<input type="checkbox" name="ids" value="1"/>
<input type="checkbox" name="ids" value="2"/>
<input type="checkbox" name="ids" value="3"/>
<input type="checkbox" name="ids" value="4"/>
<input type="checkbox" name="ids" value="5"/><br>
<input type="submit" value="提交">
</form>
<form action="params/userList" method="post">
用户1id: <input type="text" name="userList[0].id"/> <br>
用户1姓名: <input type="text" name="userList[0].username"/> <br>
用户2id: <input type="text" name="userList[1].id"/> <br>
用户2姓名: <input type="text" name="userList[1].username"/> <br>
用户3id: <input type="text" name="userList[2].id"/> <br>
用户3姓名: <input type="text" name="userList[2].username"/> <br>
<input type="submit" value="提交">
</form>
<form action="params/userMap" method="post">
one用户 id: <input type="text" name="userMap['one'].id"/> <br>
one用户 姓名: <input type="text" name="userMap['one'].username"/> <br>
two用户id: <input type="text" name="userMap['two'].id"/> <br>
two用户姓名: <input type="text" name="userMap['two'].username"/> <br>
<input type="submit" value="提交">
</form>
<form action="params/date">
生日: <input type="date" name="birthday"><br>
<input type="submit" value="提交">
</form>
<!-- 发送请求, 参数为简单类型 id=1&username=zhangsan -->
<a href="params/simple1?id=1">接收简单类型的参数</a><br>
</body>
</html>
web/ParamsController.java
@Controller
@RequestMapping("/params")
public class ParamsController {
@RequestMapping("/simple")
// id=1&username=zhangsan
// 将请求参数的key, 作为控制器的方法参数 即可
public String getSimpleParam(int id, String username) {
System.out.println("接收简单参数的控制器方法执行...");
System.out.println(id + ", " +username);
return "success";
}
@RequestMapping("/simple1")
// id=1
public String getSimpleParam1(@RequestParam(name = "id", required = false, defaultValue = "0") int userId) {
System.out.println("接收简单参数的控制器方法执行...");
System.out.println(userId);
return "success";
}
@RequestMapping("/bean")
// 表单: id=1&name=zhangsan&money=2000.0
// 将要封装的对象作为 控制器的方法参数
// 注意: 参数名key 和对象的属性名要一致
public String getBeanParam(Account account) {
System.out.println("接收对象类型的参数的控制器方法执行...");
System.out.println(account);
return "success";
}
@RequestMapping("/array")
// 数组/集合 int[] ids List<Integer> ids;
// ids=1&ids=2&ids=3&ids=4
// request.getParameterValues(ids);
public String getArrayParam(int[] ids) {
System.out.println(Arrays.toString(ids));
return "success";
}
@RequestMapping("/list")
// 集合 List<Integer> ids;
// ids=1&ids=2&ids=3&ids=4
// request.getParameterValues(ids);
public String getListParam(QueryVo qv) {
System.out.println(qv.getIds());
return "success";
}
@RequestMapping("/userList")
// 集合 List<User> userList
// key
public String getUserListParam(QueryVo qv) {
System.out.println(qv.getUserList());
return "success";
}
@RequestMapping("/userMap")
// {one=User1, two=User2}
public String getUserMapParam(QueryVo qv) {
System.out.println(qv.getUserMap());
return "success";
}
@RequestMapping("/date")
// birthday=2020-10-07
// String -> Date Converter
public String getDateParam(Date birthday) {
System.out.println(birthday);
return "success";
}
@RequestMapping("/servletAPI")
// 想要使用 HttpServletRequest对象 和 HttpServletResponse对象 HttpSession对象
// 需要导入依赖 javax.servlet-api
public String servletAPI(HttpServletRequest request, HttpServletResponse response, HttpSession session) {
System.out.println(request);
System.out.println(response);
System.out.println(session);
return "success";
}
}
// 包装类
public class QueryVo {
private List<Integer> ids;
private List<User> userList;
private Map<String, User> userMap;
public Map<String, User> getUserMap() {
return userMap;
}
public void setUserMap(Map<String, User> userMap) {
this.userMap = userMap;
}
public List<User> getUserList() {
return userList;
}
public void setUserList(List<User> userList) {
this.userList = userList;
}
public List<Integer> getIds() {
return ids;
}
public void setIds(List<Integer> ids) {
this.ids = ids;
}
}
// 转换器
public class StringDateConverter implements Converter<String, Date> {
@Override
public Date convert(String source) {
SimpleDateFormat sf = new SimpleDateFormat("yyyy-MM-dd");
try {
return sf.parse(source);
} catch (ParseException e) {
e.printStackTrace();
}
return null;
}
}
springmvc.xml
<!-- 设置处理器映射器/处理器适配器, 指定转换器服务 -->
<mvc:annotation-driven conversion-service="cs2"/>
<!-- 注册 转换器服务工厂 -->
<bean id="cs2" class="org.springframework.context.support.ConversionServiceFactoryBean">
<!-- 注入自定义转换器对象 -->
<property name="converters">
<set>
<bean class="com.zzxx.converter.StringDateConverter"/>
</set>
</property>
</bean>
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>
Restful编程风格
设置使用HTTP的请求方式进行方法的区分
.jsp
<%@page pageEncoding="UTF-8" %>
<html>
<body>
<form action="user" method="post">
id: <input type="text" name="id" /><br>
<input type="hidden" name="_method" value="PUT"/>
<input type="submit" value="提交"/>
</form>
</body>
</html>
web.xml
<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>
UserController.java
@Controller
@RequestMapping("/user")
public class UserController {
@RequestMapping(method = RequestMethod.POST)
public String add(int id) {
System.out.println("post提交方式 add 方法被执行");
System.out.println(id);
return "success";
}
@RequestMapping(method = RequestMethod.PUT)
public String update(int id) {
System.out.println("put提交方式 update 方法被执行");
System.out.println(id);
return "success";
}
@RequestMapping(method = RequestMethod.GET)
public String findAll() {
return "success";
}
@RequestMapping(path = "/{id}",method = RequestMethod.GET)
// /user/10 ?id=10
public String findById(@PathVariable("id") int id) {
System.out.println("findById 方法执行!");
System.out.println(id);
return "success";
}
@RequestMapping(method = RequestMethod.DELETE)
public String delete() {
System.out.println("delete提交方式 delete 方法被执行");
return "success";
}
}
响应数据和结果
返回JSON依赖
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-databind</artifactId>
<version>2.9.8</version>
</dependency>
springmvc.xml
<!-- 放行 js -->
<mvc:resources mapping="/js/**" location="/js/"/>
<mvc:resources mapping="/css/**" location="/css/"/>
<mvc:resources mapping="/images/**" location="/images/"/>
.jsp
<%@page pageEncoding="UTF-8" %>
<html>
<head>
<script src="js/jquery-1.11.0.min.js"></script>
<script>
$(function() {
$("#btn1").click(function() {
$.ajax({
url: "user/testJson",
data: {id: 1, username:"张三"},
success: function(user) {
alert(user.id);
alert(user.username);
},
dataType: "json",
type: "get",
async: true
});
});
});
</script>
</head>
<body>
<h2>Hello World!</h2>
<button id="btn1" >发送ajax请求</button>
</body>
</html>
/WEN-INF/pages/success.jsp
<%@ page contentType="text/html;charset=UTF-8" language="java" isELIgnored="false" %>
<html>
<head>
<title>成功</title>
</head>
<body>
执行成功!
${msg}
${username}
</body>
</html>
UserController
@Controller
@RequestMapping("/user")
public class UserController {
// 1.String 类型返回值
@RequestMapping("/testString")
public String testStringReturn(Model model, ModelMap modelMap) {
System.out.println("testStringReturn 执行了!");
// 通常在请求转发之前, 会传递数据, 需要用到request域
model.addAttribute("msg", "hello");
modelMap.addAttribute("username", "zhangsan");
// 等同于 请求转发, 会使用视图解析器来解析视图路径
return "success";
}
// 2.String 类型返回值
@RequestMapping("/testStringRedirect")
public String testStringRedirect() {
System.out.println("testStringRedirect 执行了!");
// 重定向, 使用关键字 redirect, 不会进入视图解析器添加前缀和后缀
// response.sendRedirect(request.getContextPaht() + "/error.jsp")
return "redirect:/error.jsp";
}
// 3.String 类型返回值
@RequestMapping("/testStringForward")
public String testStringForward() {
System.out.println("testStringForward 执行了!");
// 转发, 使用关键字 forward, 不会进入视图解析器添加前缀和后缀
return "forward:/WEB-INF/pages/success.jsp";
}
// 4.void 没有返回值
@RequestMapping("/testVoid")
public void testVoid(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
System.out.println("testVoid 执行了!");
// 使用request response 来页面跳转
// 转发
// request.getRequestDispatcher("/WEB-INF/pages/success.jsp").forward(request, response);
// 重定向
// response.sendRedirect(request.getContextPath() + "/error.jsp");
// 直接使用response来写出页面
response.setContentType("text/html;charset=utf-8");
response.getWriter().write("你好!");
}
// 5.ModelAndView 返回值
@RequestMapping("/testModelAndView")
public ModelAndView testModelAndView() {
System.out.println("testModelAndView 执行了!");
ModelAndView mav = new ModelAndView();
// 1.给mav 添加数据模型, 等同于model.addAttribute()
mav.addObject("msg", "modelAndView");
// 2.设置转发视图页面路径 -- 会经过视图解析器的处理
mav.setViewName("success");
return mav;
}
// 6.返回json
@RequestMapping("/testJson")
@ResponseBody // 将返回值转换成json格式字符串写出
public User testJson(User user) {
System.out.println("testJson 执行了!");
user.setId(10);
// 将user对象转换成json写出给客户端
// jackson jsonlib fastjson gson
return user;
}
}
传统方式和跨服务器方式实现文件上传
<!-- 传统 -->
<dependency>
<groupId>commons-fileupload</groupId>
<artifactId>commons-fileupload</artifactId>
<version>1.4</version>
</dependency>
<!-- 跨服务器 -->
<dependency>
<groupId>com.sun.jersey</groupId>
<artifactId>jersey-client</artifactId>
<version>1.19</version>
</dependency>
springmvc.xml
<!-- 配置文解析器, id固定 multipartResolver -->
<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
<!-- 设置上传文件的最大上限 -->
<property name="maxUploadSize" value="5242880"/>
</bean>
.jsp
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<body>
<h2>Hello World!</h2>
<FORM action="fileupload3" method="post" enctype="multipart/form-data" >
用户名:<input type="text" name="username"/><br>
选择文件: <input type="file" name="upload"/><br>
<input type="submit" value="提交"/>
</FORM>
</body>
</html>
FileUploadController.java
@Controller
public class FileUploadController {
@RequestMapping("/fileupload")
public String fileUpload(HttpServletRequest request) throws FileUploadException, IOException {
// 1.获得磁盘文件项工厂
DiskFileItemFactory factory = new DiskFileItemFactory();
// 2.获得文件上传的核心类对象
ServletFileUpload upload = new ServletFileUpload(factory);
// 3.解析请求, 获得表单项
List<FileItem> list = upload.parseRequest(request);
// 4.判断表单项是否是文件
for (FileItem item : list) {
if (item.isFormField()) {
// 普通表单项, 获得参数操作即可
} else {
// 5.文件项, 上传文件
// a.获得要上传的文件名
String filename = item.getName();
// a.1 文件名的处理
String uuid = UUID.randomUUID().toString();
uuid = uuid.replace("-", "");
filename = uuid + "_" + filename;
// b.定义上传文件的服务器目标目录
String path = request.getServletContext().getRealPath("/uploads");
// c.上传
InputStream in = item.getInputStream();
OutputStream out = new FileOutputStream(path + "/" + filename);
int len = 0;
byte[] buffer = new byte[1024];
while ((len = in.read(buffer)) > 0) {
out.write(buffer, 0, len);
}
in.close();
out.close();
}
}
return "success";
}
@RequestMapping("/fileupload2")
public String fileUpload2(MultipartFile upload, HttpServletRequest request) throws FileUploadException, IOException {
System.out.println("fileUpload2 的文件上传");
// 5.文件项, 上传文件
// a.获得要上传的文件名
String filename = upload.getOriginalFilename();
// a.1 文件名的处理
String uuid = UUID.randomUUID().toString();
uuid = uuid.replace("-", "");
filename = uuid + "_" + filename;
// b.定义上传文件的服务器目标目录
String path = request.getServletContext().getRealPath("/uploads/");
// c.文件复制
upload.transferTo(new File(path, filename));
return "success";
}
/**
* 跨服务器上传文件
* 异常: 403代码, 文件服务器没有写入权限(readonly[false])
* 400代码, URI/URL不支持中文 URIEncoder
* @param upload
* @return
*/
@RequestMapping("/fileupload3")
public String fileUpload3(MultipartFile upload) throws FileUploadException, IOException {
String file_server = "http://localhost:9090/springmvc02_fileserver_war/uploads/";
System.out.println("fileUpload3 的文件上传");
// 5.文件项, 上传文件
// a.获得要上传的文件名
String filename = upload.getOriginalFilename();
// a.1 文件名的处理
String uuid = UUID.randomUUID().toString();
uuid = uuid.replace("-", "");
filename = uuid + "_" + filename;
// filename如果是中文, 要处理过, 编码一下
filename = URLEncoder.encode(filename, "UTF-8");
// b.创建一个跨服务的Client对象
Client client = Client.create();
// c.获得上传文件的资源对象
WebResource resource = client.resource(file_server + filename);
// d.文件上传
resource.put(upload.getBytes());
return "success";
}
}
异常处理
springmvc.xml
<bean class="com.zzxx.utils.MyExceptionHandler"/>
MyExceptionHandler.java
public class MyExceptionHandler implements HandlerExceptionResolver {
/**
*
* @param request
* @param response
* @param handler 抛出异常的处理器对象
* @param ex 抛出的异常(所有的)
* @return
*/
@Override
public ModelAndView resolveException(
HttpServletRequest request,
HttpServletResponse response,
Object handler, Exception ex) {
System.out.println(handler);
// 只想处理 CustomerException
if (ex instanceof CustomerException) {
ModelAndView mav = new ModelAndView();
mav.addObject("msg", ex.getMessage());
mav.setViewName("error");
return mav;
}
return null;
}
}
UserController.java
@Controller
public class UserController {
@RequestMapping("/testException")
public String testException(Integer id) throws CustomerException {
if (id < 10) {
throw new CustomerException("该商品已下架!");
} else if (id < 20) {
throw new NullPointerException("这是代码出错了!");
}
return "success";
}
}
拦截器
springmvc.xml
<!-- 注册拦截器 -->
<mvc:interceptors>
<mvc:interceptor>
<!-- 要拦截的路径
/* 拦截根目录下所有的路径资源
/** 拦截根目录以及所有子目录中的路径资源
-->
<mvc:mapping path="/**"/>
<!-- 不进行拦截的路径 -->
<mvc:exclude-mapping path="/user/login"/>
<bean class="com.zzxx.web.interceptor.LoginInterceptor"/>
</mvc:interceptor>
</mvc:interceptors>
com.zzxx.web.LoginInterceptor
// 自定义拦截器
public class LoginInterceptor implements HandlerInterceptor {
@Override
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
// 判断用户是否登录
HttpSession session = request.getSession();
Object user = session.getAttribute("user");
if (user == null) {
// 如果没有登录, 不放行, 跳转到登录页面
response.sendRedirect(request.getContextPath() + "/login.jsp");
return false;
}
// 如果登录了, 就放行
return true;
}
}