SpringMVC-RequestMapping注解

几个概念

1. 什么是MVC

• MVC是一种软件架构的思想，将软件按照模型、视图、控制器来划分
• M：Model，模型层，指工程中的JavaBean，作用是处理数据
  • 实体类Bean：专门存储业务数据的，如 Student、User 等
  • 业务处理 Bean：指 Service 或 Dao 对象，专门用于处理业务逻辑和数据访问
• V：View，视图层，指工程中的html或jsp等页面，作用是与用户进行交互，展示数据
• C：Controller，控制层，指工程中的servlet，作用是接收请求和响应浏览器

2. SpringMVC的特点

• Spring 家族原生产品，与 IOC 容器等基础设施无缝对接
• 基于原生的Servlet，通过了功能强大的前端控制器DispatcherServlet，对请求和响应进行统一处理
• 表述层各细分领域需要解决的问题全方位覆盖，提供全面解决方案
• 代码清新简洁，大幅度提升开发效率
• 内部组件化程度高，可插拔式组件即插即用，想要什么功能配置相应组件即可
• 性能卓著，尤其适合现代大型、超大型互联网项目要求

3. web.xml

<!-- 配置 springMVC -->
<servlet>
	<servlet-name>springMVC</servlet-name>
	<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
	
	<!-- 
		配置一个初始化参数: SpringMVC 配置文件的位置和名称
		默认的配置文件为: /WEB-INF/<servlet-name>-servlet.xml
	--> 
	<init-param>
		<param-name>contextConfigLocation</param-name>
		<!-- 
			使用classpath:表示从类路径查找配置文件
			例如maven工程中的src/main/resources 
		-->
		<param-value>classpath:springMVC.xml</param-value>
	</init-param>
	
	<!-- 
 		通过此标签将启动控制DispatcherServlet的初始化时间提前到服务器启动时
	-->
	<load-on-startup>1</load-on-startup>
</servlet>

<servlet-mapping>
	<servlet-name>springMVC</servlet-name>
	<!--
        设置springMVC的核心控制器所能处理的请求路径
        /所匹配的请求可以是/login或.html或.js或.css方式的请求路径
        但是/不能匹配.jsp请求路径的请求
    -->
	<url-pattern>/</url-pattern>
</servlet-mapping>

4. <url-pattern>标签中使用/和/*的区别：

• /  所匹配的请求可以是/login或.html或.js或.css方式的请求路径，但是/不能匹配.jsp请求路径的请求因此就可以避免在访问jsp页面时，该请求被DispatcherServlet处理，从而找不到相应的页面
• /*  则能够匹配所有请求，例如在使用过滤器时，若需要对所有请求进行过滤，就需要使用/*的写法

5. SpringMVC.xml

<!-- 自动扫描包 -->
<context:component-scan base-package="com.my.mvc.controller"/>

<!-- Thymeleaf的视图解析器 配置其一即可-->
<bean id="viewResolver" class="org.thymeleaf.spring5.view.ThymeleafViewResolver">
    <property name="order" value="1"/>
    <property name="characterEncoding" value="UTF-8"/>
    <property name="templateEngine">
        <bean class="org.thymeleaf.spring5.SpringTemplateEngine">
            <property name="templateResolver">
                <bean class="org.thymeleaf.spring5.templateresolver.SpringResourceTemplateResolver">
                    <!-- 视图前缀 -->
                    <property name="prefix" value="/WEB-INF/templates/"/>
    
                    <!-- 视图后缀 -->
                    <property name="suffix" value=".html"/>
                    <property name="templateMode" value="HTML5"/>
                    <property name="characterEncoding" value="UTF-8" />
                </bean>
            </property>
        </bean>
    </property>
</bean>

<!-- jsp的配置视图解析器 配置其一即可-->
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
	<property name="prefix" value="/WEB-INF/views/"></property>
	<property name="suffix" value=".jsp"></property>
</bean>

<!-- 
	处理静态资源，例如html、js、css、jpg
	若只设置该标签，则只能访问静态资源，其他请求则无法访问
	此时必须设置<mvc:annotation-driven/>解决问题
 -->
<mvc:default-servlet-handler/>

<!-- 开启mvc注解驱动 -->
<mvc:annotation-driven>
    <mvc:message-converters>
        <!-- 处理响应中文内容乱码 -->
        <bean 
			class="org.springframework.http.converter.StringHttpMessageConverter">
            <property name="defaultCharset" value="UTF-8" />
            <property name="supportedMediaTypes">
                <list>
                    <value>text/html</value>
                    <value>application/json</value>
                </list>
            </property>
        </bean>
    </mvc:message-converters>
</mvc:annotation-driven>

@RequestMapping

1. 注解的位置

• @RequestMapping标识一个类：设置映射请求的请求路径的初始信息
• @RequestMapping标识一个方法：设置映射请求请求路径的具体信息

@Controller
@RequestMapping("/test")
public class RequestMappingController {

	//此时请求映射所映射的请求的请求路径为：/test/testRequestMapping
    @RequestMapping("/testRequestMapping")
    public String testRequestMapping(){
        return "success";
    }

}

2. value属性

• value属性通过请求的请求地址匹配请求映射
• value属性是一个字符串类型的数组，表示该请求映射能够匹配多个请求地址所对应的请求

3. method属性

• method属性是一个RequestMethod类型的数组，表示该请求映射能够匹配多种请求方式的请求
• 请求方式不满足method属性，则浏览器报错405：Request method 'POST' not supported
• 目前浏览器只支持get和post，若在form表单提交时，为method设置了其他请求方式的字符串（put或delete），则按照默认的请求方式get处理
• 若要发送put和delete请求，则需要通过spring提供的过滤器HiddenHttpMethodFilter

4. 处理指定请求方式的@RequestMapping的派生注解

• 处理get请求的映射-->@GetMapping：用来获取资源
• 处理post请求的映射-->@PostMapping：用来新建资源
• 处理put请求的映射-->@PutMapping：用来更新资源
• 处理delete请求的映射-->@DeleteMapping：用来删除资源

5. params属性

• "param"：要求请求映射所匹配的请求必须携带param请求参数
• "!param"：要求请求映射所匹配的请求必须不能携带param请求参数
• "param=value"：要求请求映射所匹配的请求必须携带param请求参数且param=value
• "param!=value"：要求请求映射所匹配的请求必须携带param请求参数但是param!=value

6. headers属性

• "header"：要求请求映射所匹配的请求必须携带header请求头信息
• "!header"：要求请求映射所匹配的请求必须不能携带header请求头信息
• "header=value"：要求请求映射所匹配的请求必须携带header请求头信息且header=value
• "header!=value"：要求请求映射所匹配的请求必须携带header请求头信息且header!=value

@RequestMapping(
		value = "/testParamsAndHeaders",
		params = {"username","password!=123456"},
		headers = {"Host=localhost:8080"}
)
public String testParamsAndHeaders(){
	return "success";
}

7. SpringMVC支持ant风格的路径

• ？：表示任意的单个字符
• *：表示任意的0个或多个字符
• /**：表示任意的一层或多层目录

/user/*/createUser：
匹配/user/aaa/createUser、/user/bbb/createUser等 URL

/user/**/createUser：
匹配/user/createUser、/user/aaa/bbb/createUser等 URL

/user/createUser??：
匹配/user/createUseraa、/user/createUserbb等 URL

@RequestMapping("/a?a/testAnt")
@RequestMapping("/a*a/testAnt")
@RequestMapping("/**/testAnt")
public String testAnt(){
    return "success";
}

8. SpringMVC支持路径中的占位符

• 请求地址/deleteUser/1
• value属性中通过占位符{xxx}表示传输的数据，在通过@PathVariable注解，将占位符所表示的数据赋值给控制器方法的形参

@RequestMapping("/testRest/{id}/{username}")
public String testRest(@PathVariable("id") String id, 
        @PathVariable("username") String username){
    System.out.println("id:"+id+",username:"+username);
    return "success";
}