17

SpringMVC最详细笔记partⅠ

 4 years ago
source link: http://www.cnblogs.com/leyvan/p/SpringMVC_partI.html
Go to the source link to view the article. You can view the picture content, updated content and better typesetting reading experience. If the link is broken, please click the button below to view the snapshot at that time.
neoserver,ios ssh client

一、springMVC-quickStar

  • 解决maven加载项目过慢
archetypeCatalog
internal
  • 导入依赖
<!-- 版本锁定 --> 
<properties> 
    <spring.version>5.0.2.RELEASE</spring.version> 
</properties> 

<dependencies> 
    <dependency> 
        <groupId>org.springframework</groupId> 
        <artifactId>spring-context</artifactId>
        <version>${spring.version}</version> 
    </dependency> 
    
    <dependency> 
        <groupId>org.springframework</groupId> 
        <artifactId>spring-web</artifactId> 
        <version>${spring.version}</version> 
    </dependency> 
    
    <dependency> 
        <groupId>org.springframework</groupId> 
        <artifactId>spring-webmvc</artifactId>
        <version>${spring.version}</version> 
    </dependency> 
    
    <dependency> 
        <groupId>javax.servlet</groupId> 
        <artifactId>servlet-api</artifactId> 
        <version>2.5</version> 
        <scope>provided</scope> 
    </dependency> 
    
    <dependency> 
        <groupId>javax.servlet.jsp</groupId> 
        <artifactId>jsp-api</artifactId> 
        <version>2.0</version>
        <scope>provided</scope> 
    </dependency> 
</dependencies>
  • web.xml配置
<!-- SpringMVC的核心控制器 --> 
<servlet> 
    <servlet-name>dispatcherServlet</servlet-name> 
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class> 
    <!-- 配置Servlet的初始化参数,读取springmvc的配置文件,创建spring容器 --> 
    <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>
    <url-pattern>/</url-pattern> 
</servlet-mapping
  • springMVC的配置文件
<beans xmlns="http://www.springframework.org/schema/beans" 
       xmlns:mvc="http://www.springframework.org/schema/mvc"
       xmlns:context="http://www.springframework.org/schema/context" 
       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/mvc 
                           http://www.springframework.org/schema/mvc/spring-mvc.xsd 
                           http://www.springframework.org/schema/context 
                           http://www.springframework.org/schema/context/spring-context.xsd">
    <!-- 配置spring创建容器时要扫描的包 --> 
    <context:component-scan base-package="club.leyvan"/>
    
    <!-- 配置视图解析器 --> 
    <bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver"> 
        <property name="prefix" value="/WEB-INF/pages/"></property> 
        <property name="suffix" value=".jsp"></property> 
    </bean>
    
    <!-- 配置spring开启注解mvc的支持 -->
    <mvc:annotation-driven></mvc:annotation-driven>
</beans>

在 SpringMVC 的各个组件中,处理器映射器、处理器适配器、视图解析器称为 SpringMVC 的三大组件。 使 用 < mvc:annotation-driven> 自动加载 RequestMappingHandlerMapping (处理映射器) 和 RequestMappingHandlerAdapter ( 处 理 适 配 器 ) , 可 用 在 SpringMVC.xml 配 置 文 件 中 使 用 < mvc:annotation-driven>替代注解处理器和适配器的配置。

  • 创建控制器类
package club.leyvan.controller

//控制器类
@Controller
public class HelloController {

	@RequestMapping(path="/hello")
	public String sayHello(){
    	System.out.println("Hello SpringMvc");
    	return "success";
	}
}

二、@RequestMapping注解

  1. RequestMapping注解的作用是建立请求URL和处理方法之间的对应关系

  2. RequestMapping注解可以作用在方法和类上

    1. 作用在类上:第一级的访问目录

    2. 作用在方法上:第二级的访问目录

    3. 细节:路径可以不编写 / 表示应用的根目录开始

    4. 细节:${ pageContext.request.contextPath }也可以省略不写,但是路径上不能写 /

  3. RequestMapping的属性

    1. path 指定请求路径的url
    2. value value属性和path属性是一样的 源码中声明了:@AliasFor("path")
    3. mthod 指定该方法的请求方式 例:method={RequestMethod.POST}
    4. params 指定限制请求参数的条件 例:params={"username=123"} 请求中必须含有username参数且值必须为123,否则不接受此请求
    5. headers 发送的请求中必须包含的请求头 例:设置一个防爬虫的请求头及值,如果不是用户请求头则不接受访问

三、请求参数绑定

  1. 请求参数的绑定说明

    1. 绑定机制
      1. 表单提交的数据都是k=v格式的 username=haha&password=123
      2. SpringMVC的参数绑定过程是把表单提交的请求参数,作为控制器中方法的参数进行绑定的
      3. 要求:提交表单的name和方法参数的名称是相同的
    2. 支持的数据类型
      1. 基本数据类型和字符串类型
      2. 实体类型(JavaBean)
      3. 集合数据类型(List、map集合等)
  2. 基本数据类型和字符串类型

    1. 提交表单的name和参数的名称是相同的

    2. 区分大小写

    3. 实体类型(JavaBean)

      1. 提交表单的name和JavaBean中的属性名称需要一致
      2. 如果一个JavaBean类中包含其他的引用类型,那么表单的name属性需要编写成:对象.属性 例如:address.name
    4. 给集合属性数据封装

      1. JSP页面编写方式:list[0].属性
    5. 请求参数中文乱码的解决:在web.xml中配置Spring提供的过滤器类

      <!-- 配置过滤器,解决中文乱码的问题 --> 
      <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
  • 不同类型参数绑定的举例:

    /**
     * 1.基本类型和字符串的参数绑定
     * 请求的连接:testParam?username=hehe&password=123
     * 输出结果:username:hehe
     *         password: 123
     */
    
    @RequestMapping("/testParam")
    public String testParam(String username,String password) {
        System.out.println("username:"+username);
        System.out.println("password:"+password);
        return "success";
    }
    
    /**
     * 2.JavaBean的参数绑定
     * account:Account->username:String;password:String;money:Double
     * 请求的连接:通过form提交post请求
     *			<form action="param/saveAccount" metohd="post">
     *				<input type="text" name="username"/>
     * 				<input type="password" name="password"/>
     * 				<input type="text" name="money"/>
     * 				<input type="submit" value="提交"/>
     *			</form>
     */
    
    @RequestMapping("/saveAccount")
    public String saveAccount(Account account) {
        System.out.println(account.toString());
        return "success";
    }
    
    /**
     * 3.JavaBean中含有User类型的参数的参数绑定
     * account:Account->username:String;password:String;money:Double;user:User
     * user:User->uname:String;age:String
     * 请求的连接:通过form提交post请求
     *			<form action="param/saveAccount" metohd="post">
     *				<input type="text" name="username"/>
     * 				<input type="password" name="password"/>
     * 				<input type="text" name="money"/>
     * 				<input type="text" name="user.uname"/>
     * 				<input type="text" name="user.age"/>
     * 				<input type="submit" value="提交"/>
     *			</form>
     */
    
    @RequestMapping("/saveAccount")
    public String saveAccount(Account account) {
        System.out.println(account.toString());
        return "success";
    }
    
    /**
     * 4.集合数组的参数绑定
     * account:Account->username:String;password:String;money:Double;user:User
     *				list:List<User>;map:Map<String,User>
     * 请求的连接:通过form提交post请求
     *			<form action="param/saveAccount" metohd="post">
     *				<input type="text" name="username"/>
     * 				<input type="password" name="password"/>
     * 				<input type="text" name="money"/>
     * 				<input type="text" name="list[0].uname"/>
     * 				<input type="text" name="list[0].age"/>
     * 				<input type="text" name="map['随便'].uname"/>
     * 				<input type="text" name="map['随便']user.age"/>
     * 				<input type="submit" value="提交"/>
     *			</form>
     */

四、自定义类型转换器解决日期格式转换的错误

由于页面提交的数据全都是字符串的形式但SpringMVC内部自动的将字符串类型的数据进行了转换,大多数的类型都帮助转换好了,但还有可能存在问题:

默认转换的日期格式:2020/3/28 但你想要的是2020-3-28这个时候就需要自定义类型转换器

1.定义一个类、实现接口Converter<S,T> S:源类型 T:目标类型

/**
 * 把字符串转换成日期的转换器 
 */ 
public class StringToDateConverter implements Converter<String, Date>{ 
    /**
     * String source 传入进来的字符串
     */ 
    public Date convert(String source) { 
        // 判断 
        if(source == null) { 
            throw new RuntimeException("参数不能为空"); 
        }
        try {
            DateFormat df = new SimpleDateFormat("yyyy-MM-dd"); 
            // 解析字符串 
            Date date = df.parse(source);
            return date; 
        } catch (Exception e) { 
            throw new RuntimeException("类型转换错误"); 
        }
    }
}

2.在springMVC的配置文件中配置自定义类型转换器

<!-- 注册自定义类型转换器 --> 
<bean id="conversionService"class="org.springframework.context.support.ConversionServiceFactoryBean"> 
    <property name="converters"> 
        <set>
            <bean class="cn.itcast.utils.StringToDateConverter"/> 
        </set> 
    </property> 
</bean>

3.让自定义的类型转换器生效

<!-- 开启Spring对MVC注解的支持 --> 
<mvc:annotation-driven conversion-service="conversionService"/>

五、@RequestParam

1.作用:把请求中指定名称的参数给控制器中的形参赋值(当形参于参数名不同时使用)。

2.位置:在方法的参数类型前

3.参数:

  1. value:请求参数中的名称。
  2. required:请求参数中是否必须提供此参数。默认值:true。表示必须提供,如果不提供将报错。

六、@RequestBody

1.作用:用于获取请求体内容。直接使用得到是 key=value&key=value...结构的数据,get 请求方式不适用。 用于异步请求的json数据获取

2.位置:在方法的参数类型前

3.参数:

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

七、@PathVariable和RESTful风格

  • @PathVariable

    1.作用:于@RequestMapping("/test/{id}")联合使用,用于获取RequestMapping中的sid的值;用于绑定 url 中的占位符。例如:请求 url 中 /delete/ {id} ,这个 {id} 就是 url 占位符。 @PathVariable(name="id")

    url:test/10

    2.位置:在方法的参数类型前

    3.参数:

    1. value:用于指定 url 中占位符名称。
    2. required:是否必须提供占位符。
  • 什么是 rest:

    REST(英文:Representational State Transfer,简称 REST)描述了一个架构样式的网络系统,比如 web 应用程序。它首次出现在 2000 年 Roy Fielding 的博士论文中,他是 HTTP 规范的主要编写者之 一。在目前主流的三种 Web 服务交互方案中,REST 相比于 SOAP(Simple Object Access protocol,简单 对象访问协议)以及 XML-RPC 更加简单明了,无论是对 URL 的处理还是对 Payload 的编码,REST 都倾向于用更加简单轻量的方法设计和实现。值得注意的是 REST 并没有一个明确的标准,而更像是一种设计的风格。它本身并没有什么实用性,其核心价值在于如何设计出符合 REST 风格的网络接口。

  • restful 的优点

    它结构清晰、符合标准、易于理解、扩展方便,所以正得到越来越多网站的采用。

  • restful 的特性:

    资源( Resources ):网络上的一个实体,或者说是网络上的一个具体信息。

    ​ 它可以是一段文本、一张图片、一首歌曲、一种服务,总之就是一个具体的存在。可以用一个 URI(统一 资源定位符)指向它,每种资源对应一个特定的 URI 。要 获取这个资源,访问它的 URI 就可以,因此 URI 即为每一个资源的独一无二的识别符。

    表现层( Representation ):把资源具体呈现出来的形式,叫做它的表现层。

    ​ 比如,文本可以用 txt 格式表现,也可以用 HTML 格式、XML 格式、JSON 格式表现,甚至可以采用二进制格式。

    状态转化( State Transfer ):每 发出一个请求,就代表了客户端和服务器的一次交互过程。 HTTP 协议,是一个无状态协议,即所有的状态都保存在服务器端。因此,如果客户端想要操作服务器,必须通过某种手段,让服务器端发生 状态转化 State Transfer )。而这种转化是建立在表现层之上的,所以 就是 表现层状态转化 。具体说,就是 HTTP 协议里面,四个表示操作方式的动词: GETPOSTPUTDELETE 。它们分别对应四种基本操作: GET 用来获取资源, POST 用来新建资源, PUT 用来更新资源, DELETE 用来 删除资源。

  • restful 的示例:

    /account/1 HTTP GET : 得到 id = 1 的 account

    /account/1 HTTP DELETE : 删除 id = 1 的 account

    /account/1 HTTP PUT : 更新 id = 1 的 account

八、@RequestHeader

1.作用:用于获取请求消息头。

2.位置:在方法的参数类型前

3.参数:

  1. value:获取消息头名称
  2. required:是否必须有此消息头

九、@CookieValue

1.作用:用于把指定 cookie 名称的值传入控制器方法参数。

2.位置:在方法的参数类型前

3.参数:

  1. value:指定 cookie 的名称。
  2. required:是否必须有此 cookie。

十、@ModelAttribute

1.作用:它可以用于修饰方法和参数。出现在方法上,表示当前方法会在控制器的方法执行之前,先执行。它可以修饰没有返回值的方法,也可以修饰有具体返回值的方法。出现在参数上,获取指定的数据给参数赋值。

3.参数:

  1. value:用于获取数据的 key。key 可以是 POJO 的属性名称,也可以是 map 结构的 key

十一、@SessionAttribute

1.作用:用于将值存入session域中。

2.位置:在类上

3.参数:

  1. value:用于指定存入的属性名称
  2. type:用于指定存入的数据类型。

4.其他:

  1. Model类,将值存入request域中
  2. ModelMap类,可以从域中取值,包括session
  3. sessionStatus.setComplete();用于删除session中的内容

About Joyk


Aggregate valuable and interesting links.
Joyk means Joy of geeK