spring mvc

用来开发基于 web 的应用程序

1. 流行的 mvc 框架

struts 1.x
webwork
struts 2.x (webwork+struts 1.x) ssh 经常暴露安全问题
springmvc 更容易上手，相对更安全

2. mvc 思想

model 模型 - 数据 domain
view 视图 - 数据的展现方式 jsp, jstl, el
controller 控制器 - 结合模型和视图，控制请求流程 servlet, controller

servlet 如果作为控制器
缺点1：请求参数处理麻烦 String 值 = request.getParameter(“参数名”)
缺点2：当业务比较多时，servlet 类的数量膨胀不好管理
controller 优点
优点：利用spring 各种思想，ioc, di, aop, 可扩展性高

3. spring mvc 使用步骤

添加jar依赖

<!-- spring mvc 依赖 -->
<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-webmvc</artifactId>
    <version>4.3.21.RELEASE</version>
</dependency>

<!-- servlet, jsp, 标签库 -->
<dependency>
    <groupId>javax.servlet</groupId>
    <artifactId>javax.servlet-api</artifactId>
    <version>3.1.0</version>
    <scope>provided</scope>
</dependency>

<dependency>
    <groupId>javax.servlet.jsp</groupId>
    <artifactId>javax.servlet.jsp-api</artifactId>
    <version>2.2.1</version>
    <scope>provided</scope>
</dependency>

<dependency>
    <groupId>jstl</groupId>
    <artifactId>jstl</artifactId>
    <version>1.2</version>
</dependency>

添加 spring 配置文件

<!-- 启用了 与 springmvc 相关的注解 @RestController @RequestMapping @ResponseBody @ExceptionHandler ... -->
    <mvc:annotation-driven />

添加控制器

spring 提供的前控制器(实际是一个servlet)，作为一个统一入口，由它来分发请求，进入真正的控制器
需要使用 web.xml 文件配置它的路径

<!-- 配置前控制器 (servlet) -->
<servlet>
    <servlet-name>aa</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <!-- 指明 spring 配置文件的位置, 根据它创建 spring容器 -->
    <init-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>classpath:springmvc.xml</param-value>
    </init-param>
    <!-- tomcat 启动时, 就创建和初始化 servlet, 同时创建 spring 容器 -->
    <load-on-startup>1</load-on-startup>
</servlet>

<servlet-mapping>
    <servlet-name>aa</servlet-name>
    <!-- / 用来匹配所有的路径 -->
    <url-pattern>/</url-pattern>
</servlet-mapping>

自己提供的控制器

@Controller
public class 控制器类 {

    @RequestMapping("请求路径") // 请求路径要唯一
    public String 方法1() {

    }

    ...

    @RequestMapping("请求路径")
    public String 方法n() {
        
    }

}

配置视图
控制器方法的返回值是一个视图名，此视图名经过视图解析器解析为一个完整路径，利用请求转发跳转至该jsp

<mvc:view-resolvers>
    <!-- 前缀 + 视图名 + 后缀 == 完整路径, 再利用请求转发跳转至 jsp -->
    <mvc:jsp prefix="/" suffix=".jsp" />
</mvc:view-resolvers>

处理请求参数
http://localhost:8080/c1?name=zhangsan&age=18&birthday=1995-9-6

方法1：只要把方法的参数名称和请求的参数名称对象，springmvc 会将请求参数的值赋值给方法参数，并完成类型转换
日期类型需要特殊处理，请求参数类型转换出错，会出现400错误, 日期可以使用 @DateTimeFormat(pattern=“日期格式”)

方法2：当请求参数较多时，可以把请求参数映射到java对象的属性上

class User{
    private String name;
    private Integer age;
    private Date birthday;
}

方法3：把参数信息包含在路径当中
删除用户

/deleteUser?id=1
/deleteUser?id=2
…

/deleteUser/1 删除1号用户
/deleteUser/2 删除2号用户
…

// 例如 /deleteUser/1 {id} 的值就是1 /deleteUser/2 {id} 的值就是2
@RequestMapping("/deleteUser/{id}")
// @PathVariable 获取一个路径变量的值{id}, 然后复制给方法参数
public String c4(@PathVariable("id") int aa) {
    System.out.println("值为：" + aa);
    return "hello";
}

处理模型数据
Model接口, 需要调用Model 的相关方法把数据存入模型，页面上再从模型中获取数据并显示

.addAttribute(“名字”, 对象); // 将数据加入 Model

${名字} <c:forEach>

原理：会把模型中数据放入request作用域

=========================================================

1. 汉字乱码

在 web.xml 中添加一个 spring 提供的 CharacterEncodingFilter

<!-- 配置字符编码过滤器 -->
<filter>
    <filter-name>bb</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>bb</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

2. 使用传统 servlet 中的类

HttpServletRequest, HttpServletResponse, HttpSession 他们都可以作为控制器方法的参数，直接使用即可，spring会把他们准备好

3. 异常处理

局部的异常处理器,只针对某个控制器

// 专门定义一个处理异常的方法
// ArrayIndexOutOfBoundsException
@ExceptionHandler(Exception.class) // 异常处理器, 可以指定具体的异常类型
public String error(Exception e) {
    System.out.println("进入了 ExceptionController error " + e.getMessage());
    return "error";
}

全局的异常处理器,针对所有的控制器

@ControllerAdvice
class 全局异常处理器类 {

    @ExceptionHandler(异常类型)
    public String error(异常对象) {
        // 异常处理
        return "视图名";
    }
}

局部的异常处理优先级高于全局的异常处理

4. 文件上传

pom.xml添加依赖

<dependency>
    <groupId>commons-fileupload</groupId>
    <artifactId>commons-fileupload</artifactId>
    <version>1.3.3</version>
</dependency>

springmvc.xml 中对上传文件表单做特殊配置

简单表单
name=zhangsan&age=18

上传文件表单
multipartResovler 上传文件表单的解析器

<!-- 配置上传文件表单解析器, id 是固定的 -->
<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
    
</bean>

编辑表单页面

<!-- multipart/form-data 表示表单数据由多部分，属于复杂的表单格式 -->
<form action="请求地址" method="post" enctype="multipart/form-data">
    <!-- 文件选择框 -->
    <input type="file" name="请求参数名">
</form>

编写控制器

@Controller
public class UploadController {

    @RequestMapping("/upload")
    public String upload(String username,
                         Integer age,
                         MultipartFile image) throws IOException {
        System.out.println("上传文件的原始名称：" + image.getOriginalFilename());
        System.out.println("上传文件的类型：" + image.getContentType());
        System.out.println("获取上传文件大小：" + image.getSize());

        // 生成了临时文件, 当请求结束, 此临时文件会被删除
        // 把临时文件另存为： file
        image.transferTo(new File("d:\\" + image.getOriginalFilename()));
        return "hello";
    }
}

图片预览
通过js完成

<input type="file" name="image" id="image" onchange="preview()">

<img src="" id="preview"/>

function preview() {
    // 获取图片选择框中图片的二进制信息
    var image = document.getElementById("image");
    var file = image.files[0]; // 拿到数组中第一个图片文件

    // 读取文件内容
    var reader = new FileReader();
    // 定义事件
    reader.onload = function() {
        // 获取结果
        document.getElementById("preview").src = this.result;
    };
    // 开始读取
    reader.readAsDataURL(file);
}

对上传文件的控制
从客户端的角度限制

服务器端要对上传文件做检查
图片,修改大小 800x600 -> 640x480 成功
假图片,修改大小 800x600 -> 640x480 报异常

文件大小限制

<!-- 配置上传文件表单解析器, id 是固定的 -->
<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
    <!-- 限制上传文件的总大小,单位是字节-->
    <property name="maxUploadSize" value="2000"></property>
</bean>

springmvc 对静态文件的处理(图片,html,js,css)
springmvc 默认把所有路径都当做了控制器的路径

Spring MVC