主要内容:
-
RequestMapping
特性 -
Controller
方法返回值 - 参数绑定
一、需求分析
这里我们还是使用上次整合的工程。
操作流程:
- (1)进入商品查询列表页面
- (2)点击修改,进入商品修改页面,页面中显示了要修改的商品信息(从数据库中查询),要修改的商品从数据查询,根据商品
id
(主键)查询商品信息 - (3)在商品修改页面,修改商品信息,修改后,点击提交。
二、开发 mapper
根据上面的需求我们可以知道,mapper
中此处需要完成两个功能:
- 根据
id
查询商品信息,返回给页面显示 - 更新
items
表的数据,更新数据库
但是这里的两个功能需求是相对简单的,在逆向工程中已经帮我们生成好了相关代码,我们只需要直接使用即可,不需要再次开发。
三、开发 service
根据持久层mapper
的相关业务需求,这里我们就可以知道业务层的功能需求
- 根据
id
查询商品信息 - 修改商品信息
3.1 接口
ItemsServiceI.java
//根据id查询商品信息
public ItemsCustom findItemsById(Integer id) throws Exception;
//修改商品信息,这里id本来已经在itemsCustom存在,但是为了更好的开发,还是将id提取出来
//作为一个参数,表明此id必须传入
public void updateItems(Integer id, ItemsCustom itemsCustom) throws Exception;
3.2 实现
ItemsServiceImpl.java
package cn.itcast.ssm.service.impl;
import java.util.List;
import org.springframework.beans.BeanUtils;
import org.springframework.beans.factory.annotation.Autowired;
import cn.itcast.ssm.mapper.ItemsMapper;
import cn.itcast.ssm.mapper.ItemsMapperCustom;
import cn.itcast.ssm.pojo.Items;
import cn.itcast.ssm.pojo.ItemsCustom;
import cn.itcast.ssm.pojo.ItemsQueryVo;
import cn.itcast.ssm.service.ItemsServiceI;
public class ItemsServiceImpl implements ItemsServiceI{
@Autowired
private ItemsMapperCustom itemsMapperCustom;
@Autowired
private ItemsMapper itemsMapper;
@Override
public List<ItemsCustom> findItemsList(ItemsQueryVo itemsQueryVo)
throws Exception {
//通过ItemsMapperCustom查询数据库,通过spring注入
return itemsMapperCustom.findItemsList(itemsQueryVo);
}
@Override
public ItemsCustom findItemsById(Integer id) throws Exception {
Items items = itemsMapper.selectByPrimaryKey(id);
//查询出来的数据可能需要进行一些业务处理,最后要返回ItemsCustom
ItemsCustom itemsCustom = new ItemsCustom();
//将Items内容拷贝到ItemsCustom
BeanUtils.copyProperties(items, itemsCustom);
return itemsCustom;
}
@Override
public void updateItems(Integer id, ItemsCustom itemsCustom) throws Exception {
//添加一些业务校验,通常在service接口对关键的参数进行校验
//校验id是否为空等等,如果为空则抛出异常
//更新商品信息,使用updateByPrimaryKeyWithBLOBs可以根据id更新表中所有字段,
//包括大文本字段,这里因为表中有个字段属性为text,所以使用此方法
//要求必须传入id,即使类中已经存在
itemsCustom.setId(id);
itemsMapper.updateByPrimaryKeyWithBLOBs(itemsCustom);
}
}
说明:这里我们的方法还不是很完善,比如这里就没有给出查询条件,在后面一步步完善。
四、开发Controller
ItemsController.java
package cn.itcast.ssm.controller;
import java.util.List;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.servlet.ModelAndView;
import cn.itcast.ssm.pojo.ItemsCustom;
import cn.itcast.ssm.service.ItemsServiceI;
//商品Controller
@Controller
public class ItemsController {
@Autowired
private ItemsServiceI itemsService;
//商品查询
@RequestMapping("/queryItems")
public ModelAndView queryItems() throws Exception{
List<ItemsCustom> itemsList = itemsService.findItemsList(null);//这里暂时还没有查询条件
//返回ModelAndView
ModelAndView modelAndView = new ModelAndView();
//相当于request的setAttribute方法,在jsp页面中就可以通过items取数据了
modelAndView.addObject("itemsList",itemsList);
//指定视图
modelAndView.setViewName("items/itemsList");
return modelAndView;
}
//商品信息修改页面展示
@RequestMapping("/editItems")
public ModelAndView editItems() throws Exception{
//调用service根据id查询商品信息
ItemsCustom itemsCustom = itemsService.findItemsById(1);
ModelAndView modelAndView = new ModelAndView();
//将商品信息放入Model
modelAndView.addObject("itemsCustom", itemsCustom);
//返回商品修改页面
modelAndView.setViewName("items/editItems");
return modelAndView;
}
//商品修改提交
@RequestMapping("/editItemsSubmit")
public ModelAndView editItemsSubmit() throws Exception{
//调用service更新商品信息,页面需要将商品信息传到此方法
//............
ModelAndView modelAndView = new ModelAndView();
//先返回一个成功页面
//返回商品修改页面
modelAndView.setViewName("success");
return modelAndView;
}
}
说明:对于商品列表展示页面在整合工程中已经给出,这里我们给出修改页面:
WEB-INF/jsp/items/editItems.jsp
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"
isELIgnored="false"%>
<%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c"%>
<%@ taglib uri="http://java.sun.com/jsp/jstl/fmt" prefix="fmt"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>修改商品信息</title>
</head>
<body>
<form id="itemForm" action="${pageContext.request.contextPath }/editItemsSubmit.action"
method="post">
<input type="hidden" name="id" value="${itemsCustom.id }" /> 修改商品信息:
<table width="100%" border=1>
<tr>
<td>商品名称</td>
<td><input type="text" name="name" value="${itemsCustom.name }" /></td>
</tr>
<tr>
<td>商品价格</td>
<td><input type="text" name="price" value="${itemsCustom.price }" /></td>
</tr>
<tr>
<td>商品简介</td>
<td><textarea rows="3" cols="30" name="detail">${itemsCustom.detail }</textarea></td>
</tr>
<tr>
<td colspan="2" align="center"><input type="submit" value="提交" /></td>
</tr>
</table>
</form>
</body>
</html>
下面我们就可以部署工程,使用地址http://localhost:8080/springmvc-mybatis01/queryItems.action
进行访问,此时点击页面中的修改页面,就会找到editItems.action
,我们可以看到修改页面中回显了我们选择要修改商品的信息。当然这里还有一个成功页面WEB-INF/jsp/items/success.jsp
。
五、RequestMapping特性
5.1 普通 url 地址映射
普通url
地址映射在之前讲过,比如:
@RequestMapping("/queryItems")
5.2 窄化请求映射
所谓窄化请求映射就是当控制器中方法很多,映射很多的时候,我们为了便于管理,一般会将这些url
地址进行分类管理。这里我们对控制器进行改造,窄化请求映射。
这里我们使用:
@RequestMapping("/items")
进行窄化请求映射,于是最终的url
就是跟路径+子路径,比如/items/queryItems.action
。我们在此处改动之后需要对jsp页面进行改进,在itemsList.jsp
中
<td><a href="${pageContext.request.contextPath }/items/editItems.action?id=${item.id}">修改</a></td>
<%-- <td><a href="${pageContext.request.contextPath }/editItems.action?id=${item.id}">修改</a></td> --%>
在editItems.jsp
<form id="itemForm" action="${pageContext.request.contextPath }/items/editItemsSubmit.action" method="post">
<%-- <form id="itemForm" action="${pageContext.request.contextPath }/editItemsSubmit.action" method="post"> --%>
其中被注释掉的是之前的方式。
5.3 限制 http 请求方法
一般常用请求方式有GET
和POST
两种,但是有时候我们需要规定必须使用哪种方式,在ItemsController.java
:
@RequestMapping(value="/editItems", method={RequestMethod.POST, RequestMethod.GET})
public ModelAndView editItems() throws Exception{
这里我们限制请求方式必须是GET
或者POST
,当然如果这里我们限制为POST
,那么默认的GET
提交方式就提交不成功。
六、Controller方法的返回值
6.1 返回 ModelAndView
这个在之前我们已经讲过,这里不再说明。
6.2 返回 String
- 1.返回
String
如果Controller
方法返回的是String
,表示返回逻辑视图名。而真正视图(jsp
)=前缀+逻辑视图名+后缀
@RequestMapping(value="/editItems", method={RequestMethod.POST, RequestMethod.GET})
public String editItems(Model model) throws Exception{
//调用service根据id查询商品信息
ItemsCustom itemsCustom = itemsService.findItemsById(1);
//通过形参中的model将model数据传递到页面
//相当于modelAndView.addObject("itemsCustom", itemsCustom);
model.addAttribute("itemsCustom", itemsCustom);
return "items/editItems";
}
说明:可以看到我们首先将数据存入到Model
中,然后返回逻辑视图地址。而真正的视图(jsp
)还需要加上前缀和后缀。
- 2.
redirect
重定向
需求:商品修改成功之后重定向到商品查询列表。修改提交的request
数据无法传递到重定向的地址。因为重定向后重新进行request
,也就是重定向不能共享request
。
@RequestMapping("/editItemsSubmit")
public String editItemsSubmit() throws Exception{
//调用service更新商品信息,页面需要将商品信息传到此方法
//............
//ModelAndView modelAndView = new ModelAndView();
//先返回一个成功页面
//返回商品修改页面
//modelAndView.setViewName("success");
//重定向
return "redirect:queryItems.action";//根路径不需要加
//return "success";
}
说明:一定注意在Controller
方法中重定向时不需要加根路径。
- 3.
forward
请求转发
@RequestMapping("/editItemsSubmit")
public String editItemsSubmit() throws Exception{
return "forward:queryItems.action";
}
说明:通过此种方式进行页面转发,url
地址栏不变,request
可以共享。当然我们说request
可以共享,那么我们可以给方法传递一个参数HttpServletRequest
:
@RequestMapping("/editItemsSubmit")
public String editItemsSubmit(HttpServletRequest request) throws Exception{
return "forward:queryItems.action";
}
于是我们在其跳转的方法中可以接收request
:
//商品查询
@RequestMapping("/queryItems")
public ModelAndView queryItems(HttpServletRequest request) throws Exception{
//测试request共享
System.out.println(request.getParameter("id"));
......
}
这样就实现了request
的共享。我们可以在此方法中进行测试。
6.3 返回 void
在Controller
方法行参上可以定义request
和response
,使用request
或者response
指定响应结果:
- 1)、使用
request
转向页面,如下:
request.getRequestDispatcher("").forward(request, response);
- 2)、也可以通过
response
页面重定向
response.sendRedirect("url");
- 3)、也可以通过
response
指定相应结果,例如响应json
数据如下:
response.setCharacterEncoding("utf-8");
response.setContentType("application/json;charset=utf-8");
response.getWriter().write("json串");
七、参数绑定(工程springmvc-mybatis02
)
7.1 参数绑定过程
从客户端请求
key/value
数据,经过参数绑定,将key/value
数据绑定到Controller
方法的形参上,接收页面提交的数据是通过方法的形参,而不是在Controller
类定义成员变量。处理器适配器调用
springmvc
提供参数绑定组件将key/value
数据转成Controller
方法的形参。参数绑定组件:在
springmvc
早起版本使用PropertyEditor
(只能将字符串转成java
对象),后期使用converter
(进行任意参数类型的转换)。springmvc
提供 了很多converter
(转换器)。在特殊情况下需要自定义converter
(比如对日期数据的绑定需要自定义)。然后调用Controller
。
7.2 参数绑定默认支持的类型
直接在Controller
方法的形参上定义下面类型的对象,就可以使用这些对象。在参数绑定过程中,如果遇到下边的类型直接进行绑定(自动进行的)。
1)、
HttpServletRequest
通过request
对象获取请求信息2)
HttpServletResponse
通过response
处理响应信息3)
HttpSession
通过session
对象得到session
中存放的对象。4)
Model/ModelMap
Model
是一个接口,ModelMap
是接口实现。在Controller
方法形参中我们可以定义成前者或者后者都行。作用:将模型数据填充到request
域。
7.3 绑定简单类型
public String editItems(Model model, @RequestParam(value="id", required=true, defaultValue="") Integer items_id)
说明:这里我们绑定了一个简单类型(Integer
),如果这个参数名称为id
,也就是和request
传入参数名称一致,那么我们不需要使用注解。但是这里我们参数名称是items_id
,也就是不一致,那么我们需要使用上面的注解进行绑定。@RequestParam
中value
指定request
传入参数名称和形参绑定,required=true
指定此参数是否必须被传入,defaultValue=""
设置默认值。可以绑定的简单类型还有String、float、double、boolean
。
7.4 绑定 pojo 对象
@RequestMapping("/editItemsSubmit")
public String editItemsSubmit(HttpServletRequest request, Integer id, ItemsCustom itemsCustom) throws Exception{
itemsService.updateItems(id, itemsCustom);
return "forward:queryItems.action";
}
说明:这里我们绑定pojo
类有个前提,就是页面中input
的名称和Controller
的pojo
形参中的属性名称一致,可以自动将页面中的数据绑定到pojo
中
- 问题一:乱码问题
- POST乱码
在web.xml
中添加post
乱码过滤器:
- POST乱码
<!-- 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>
- GET乱码
对于get
请求中文参数中出现乱码解决方法有两个:
1.修改tomcat
配置文件(server.xml
)添加编码与工程一致,如下:
2.另一种方法对参数进行重新编码:
String username = new String(request.getParameter("username").getBytes("iso8859-1"),"utf-8");
- 问题二:日期类型的绑定问题
我们将editItems.jsp
中这段代码的注释去掉:
<tr>
<td>商品生产日期</td>
<td><input type="text" name="createtime" value="<fmt:formatDate value="${itemsCustom.createtime}" pattern="yyyy-MM-dd HH:mm:ss"/>"/></td>
</tr>
然后我们再次访问时发生错误,这里的问题是日期类型不能自动绑定,需要我们手动编写转换器之后绑定。对于Controller
形参中pojo
对象,如果属性中有日期类型,需要自定义参数绑定。将请求的日期数据串转换成日期类型,要转换的日期类型和pojo
中日期属性的类型保持一致。需要像处理器适配器中注入自定义的参数绑定组件。在springmvc.xml
中:
<mvc:annotation-driven conversion-service="conversionService"></mvc:annotation-driven>
<!-- 自定义参数绑定 -->
<bean id="conversionService" class="org.springframework.format.support.FormattingConversionServiceFactoryBean">
<!-- 转换器 -->
<property name="converters">
<list>
<!-- 日期类型的转换 -->
<bean class="cn.itcast.ssm.controller.convert.CustomDateConverter"></bean>
<!-- 其他类型的转换 -->
</list>
</property>
</bean>
说明:我们使用conversion-service
属性给适配器中添加自定义转换器。
自定义转换器CustomDateConverter.java
package cn.itcast.ssm.controller.convert;
import java.text.ParseException;
import java.text.SimpleDateFormat;
import java.util.Date;
import org.springframework.core.convert.converter.Converter;
public class CustomDateConverter implements Converter<String, Date>{
@Override
public Date convert(String source) {
//实现将日期字符串转换成日期类型(格式是yyyy-MM-dd HH:mm:ss)
SimpleDateFormat format = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
try {
//如果转换成功
return format.parse(source);
} catch (ParseException e) {
e.printStackTrace();
}
//如果绑定失败
return null;
}
}
说明:注意自定义转换器需要实现Converter
接口。其中String
是我们需要转换的类型,Date
是我们最终需要的类型。
- 最后:上面我们是将适配器和映射器配置在一起,可能不太容易理解,如果单独配置,那么我们的转换器配置应该如下:
<!--注解适配器 -->
<bean
class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter">
<property name="webBindingInitializer" ref="customBinder"></property>
</bean>
<!-- 自定义webBinder -->
<bean id="customBinder"
class="org.springframework.web.bind.support.ConfigurableWebBindingInitializer">
<property name="conversionService" ref="conversionService" />
</bean>
<!-- conversionService -->
<bean id="conversionService"
class="org.springframework.format.support.FormattingConversionServiceFactoryBean">
<!-- 转换器 -->
<property name="converters">
<list>
<bean class="cn.itcast.ssm.controller.converter.CustomDateConverter"/>
</list>
</property>
</bean>
当然这种方式较为繁琐,这里只是了解。
八、springmvc 和 struts2的区别
1、
springmvc
基于方法开发的,struts2
基于类开发的。springmvc
映射时将url
和Controller
方法进行映射。映射成功之后springmvc
会生成一个handler
对象,对象中只包括了一个method
,方法执行结束,形参数据就销毁了。springmvc
的Controller
开发类似service
开发。2、
springmvc
可以进行单例开发,并且也建议单例开发。Struts2
通过类的成员变量接收的参数,所以无法使用单例,只能使用多例。3、
struts2
速度慢在于使用struts2
标签。建议,如果使用struts2
,直接使用jstl
,不要使用struts2
的标签。
最后:我们看到这里我们使用这样一个例子将springmvc
开发中所需要用到的一些基本内容说明了,对于其他功能开发基本就类似了。