springMVC --- 入门

1  MVC介绍

    * 在 JavaEE 开发中，几乎全都是基于 B/S 架构的开发。那么在 B/S 架构中，系统标准的三层架构包括：表现层、业务层、持久层。三层架构在我们的实际开发中使用的非常多，所以我们课程中的案例也都是基于三层架构设计的。
三层架构中，每一层各司其职，接下来我们就说说每层都负责哪些方面：
    * 表现层：
        也就是我们常说的web层。它负责接收客户端请求，向客户端响应结果，通常客户端使用http协议请求web 层，web 需要接收 http 请求，完成 http 响应。表现层包括展示层和控制层：控制层负责接收请求，展示层负责结果的展示。表现层依赖业务层，接到客户端请求一般会调用业务层进行业务处理，并将处理结果响应给客户端。表现层的设计一般都使用 MVC 模型。（MVC 是表现层的设计模型，和其他层没有关系）
    * 业务层：
        也就是我们常说的 service 层。它负责业务逻辑处理，和我们开发项目的需求息息相关。web 层依赖业务层，但是业务层不依赖 web 层。业务层在业务处理时可能会依赖持久层，如果要对数据持久化需要保证事务一致性。（也就是我们说的，事务应该放到业务层来控制)。

    * 持久层：
        也就是我们是常说的 dao 层。负责数据持久化，包括数据层即数据库和数据访问层，数据库是对数据进行持久化的载体，数据访问层是业务层和持久层交互的接口，业务层需要通过数据访问层将数据持久化到数据库中。通俗的讲，持久层就是和数据库交互，对数据库表进行曾删改查的。

2  springMVC 

    * SpringMVC 是一种基于 Java 的实现 MVC 设计模型的请求驱动类型的轻量级 Web 框架，属于 Spring FrameWork 的后续，已经融合在 Spring Web Flow 里面。Spring 框架提供了构建 Web 应用程序的全功能 MVC 模块。使用 Spring 可插入的 MVC 架构，从而在使用 Spring 进行 WEB 开发时，可以选择使用 Spring的 Spring MVC 框架或集成其他 MVC 开发框架，如 Struts1(现在一般不用)，Struts2 等。SpringMVC 已经成为目前最主流的 MVC 框架之一，并且随着 Spring3.0 的发布，成为最优秀的 MVC 框架。它通过一套注解，让一个简单的 Java 类成为处理请求的控制器，而无须实现任何接口。同时它还支持RESTful 编程风格的请求。

3  简单入门

    * 配置核心控制器配置文件

<servlet>
    <servlet-name>SpringMVCDispatcherServlet</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 的对象的创建时间点：应用加载时创建。取值只能是非 0 正整数，表示启动顺序 -->
    <load-on-startup>1</load-on-startup>
</servlet>

<servlet-mapping>
    <servlet-name>SpringMVCDispatcherServlet</servlet-name>
    <url-pattern>/</url-pattern>
</servlet-mapping>

    * 配置springmvc.xml

<!-- 配置创建 spring 容器要扫描的包 -->
 <context:component-scan base-package="com.springDemo"></context:component-scan>
 
 <!-- 配置视图解析器 -->
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
     <property name="prefix" value="/WEB-INF/pages/"></property>
     <property name="suffix" value=".jsp"></property>
</bean>

    * 注解类编写测试

@Controller("helloController")
public class HelloController {

    @RequestMapping("/test")
    public String sayHello() {
        System.out.println("hello world.....");
        return "success";
    }
}

  4 过程剖析

    ** 注(图取自GavlinLi2588)

    * 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。一般情况下需要通过页面标签或页面模版技术将模型数据通过页面展示给用户，需要由程序员根据业务需求开
发具体的页面。

  5 注解说明

    * RequestMapping

        ** 用于建立请求 URL 和处理请求方法之间的对应关系。

        ** 类上：请求 URL 的第一级访问目录。此处不写的话，就相当于应用的根目录。写的话需要以/开头。它出现的目的是为了使我们的 URL 可以按照模块化管理:例如：账户模块：/account/add  /account/update 订单模块：/order/add /order/update 使我们的 URL 更加精细。 

        ** 属性：value：用于指定请求的 URL。它和 path 属性的作用是一样的。method：用于指定请求的方式。params：用于指定限制请求参数的条件。它支持简单的表达式。要求请求参数的 key 和 value 必须和配置的一模一样。headers：用于指定限制请求消息头的条件。(注  以上四个属性只要出现 2 个或以上时，他们的关系是与的关系。)

// jsp代码
<a href="account/findAccount">查询账户</a>


// 后端代码
@Controller("accountController")
@RequestMapping("/account")
public class AccountController {
    
    @RequestMapping("/findAccount")
    public String findAccount() {...}
}

    * RequestParam

     ** 把请求中指定名称的参数给控制器中的形参赋值。

     ** value：请求参数中的名称。 required：请求参数中是否必须提供此参数。默认值：true。表示必须提供，如果不提供将报错。 

// jsp 中的代码：
<!-- requestParams 注解的使用 -->
<a href="springmvc/useRequestParam?name=test">requestParam 注解</a>

// 后端代码
@RequestMapping("/useRequestParam")
public String useRequestParam(@RequestParam("name")String username, @RequestParam(value="age",required=false)Integer age){...}

  * RequestBody

    ** 用于获取请求体内容。直接使用得到是 key=value&key=value...结构的数据。

    ** required：是否必须有请求体。默认值是:true。当取值为 true 时,get 请求方式会报错。如果取值为 false，get 请求得到是 null。

// post 请求 jsp 代码：
<!-- request body 注解 -->
<form action="springmvc/useRequestBody" method="post">

    用户名称：<input type="text" name="username" ><br/>
    用户密码：<input type="password" name="password" ><br/>
    用户年龄：<input type="text" name="age" ><br/>

    <input type="submit" value="保存">
</form>

// 后端代码
@RequestMapping("/useRequestBody")
public String useRequestBody(@RequestBody(required=false) String body){...}

   * PathVaribale

    ** 用于绑定 url 中的占位符。例如：请求 url 中 /delete/{id}，这个{id}就是 url 占位符。

    ** value：用于指定 url 中占位符名称。required：是否必须提供占位符。

// jsp 代码：
<!-- PathVariable 注解 -->
<a href="springmvc/usePathVariable/1">pathVariable 注解</a>

// 后端代码
@RequestMapping("/usePathVariable/{id}")
public String usePathVariable(@PathVariable("id") Integer id){...}

 

6 参数绑定

    * 表单中请求参数都是基于 key=value 的。SpringMVC 绑定请求参数的过程是通过把表单提交请求参数，作为控制器中方法参数进行绑定的。

    * 支持的数据类型：

        1) 基本类型参数：包括基本类型和 String 类型  --- 要求我们的参数名称必须和控制器中方法的形参名称保持一致。(严格区分大小写)

// jsp 代码：
<!-- 基本类型示例 -->
<a href="account/findAccount?accountId=1&accountName=jorgen">查询账户</a>

// 控制器代码：
@RequestMapping("/findAccount")
public String findAccount(Integer accountId,String accountName){...}

        2) POJO 类型参数：包括实体类，以及关联的实体类 --- 要求表单中参数名称和 POJO 类的属性名称保持一致。并且控制器方法的参数类型是 POJO 类型。

// 账户实体类
public class Account implements Serializable {
    private Integer id;
    private String name;
    private Float money;
    private Address address;
    //getters and setters
}
// 地址的实体类
public class Address implements Serializable {
    private String provinceName;
    private String cityName;
    //getters and setters
}

// jsp 代码：
<!-- pojo 类型演示 -->
<form action="account/saveAccount" method="post">
    账户名称：<input type="text" name="name" ><br/>
    账户金额：<input type="text" name="money" ><br/>
    账户省份：<input type="text" name="address.provinceName" ><br/>
    账户城市：<input type="text" name="address.cityName" ><br/>
    <input type="submit" value="保存">
</form>

// 控制器代码：
// 保存账户
@RequestMapping("/saveAccount")
public String saveAccount(Account account) {...}

        3) 数组和集合类型参数：包括 List 结构和 Map 结构的集合（包括数组);

         ** 第一种：要求集合类型的请求参数必须在 POJO 中。在表单中请求参数名称要和 POJO 中集合属性名称相同。给 List 集合中的元素赋值，使用下标。给 Map 集合中的元素赋值，使用键值对。
         ** 第二种：接收的请求参数是 json 格式数据。需要借助一个注解实现。

// 包含数组 map的实体类
public class User implements Serializable {
    private String username;
    private String password;
    private Integer age;
    private List<Account> accounts;
    private Map<String,Account> accountMap;
}

// jsp 代码：
<!-- POJO 类包含集合类型演示 -->
<form action="account/updateAccount" method="post">

    用户名称：<input type="text" name="username" ><br/>
    用户密码：<input type="password" name="password" ><br/>
    用户年龄：<input type="text" name="age" ><br/>

    账户 1 名称：<input type="text" name="accounts[0].name" ><br/>
    账户 1 金额：<input type="text" name="accounts[0].money" ><br/>

    账户 2 名称：<input type="text" name="accounts[1].name" ><br/>
    账户 2 金额：<input type="text" name="accounts[1].money" ><br/>

    账户 3 名称：<input type="text" name="accountMap['one'].name" ><br/>
    账户 3 金额：<input type="text" name="accountMap['one'].money" ><br/>

    账户 4 名称：<input type="text" name="accountMap['two'].name" ><br/>
    账户 4 金额：<input type="text" name="accountMap['two'].money" ><br/>

    <input type="submit" value="保存">
</form>

// 控制器代码：
// 更新账户
@RequestMapping("/updateAccount")
public String updateAccount(User user) {...}

   补充spring中解决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>
		<!-- 启动过滤器 --> 
		<init-param>  
            <param-name>forceEncoding</param-name>  
            <param-value>true</param-value>  
        </init-param>  
	</filter>
	<!-- 过滤所有请求 -->
	<filter-mapping>
		<filter-name>CharacterEncodingFilter</filter-name>
		<url-pattern>/*</url-pattern>
	</filter-mapping>