@RequestMapping使用详解

一、@RequestMapping注解的属性：

所有属性都是可选的，但其默认属性是 value 。

当 value 是其唯一属性时，可以省略属性名，例如下面两种标注的含义相同:

@RequestMapping(value = “/login”)
@RequestMapping(“/login”)

两个注解是等价的。

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

<a th:href="@{/testRequestMapping}">测试@RequestMapping的value属性-->/testRequestMapping</a><br>
<a th:href="@{/test}">测试@RequestMapping的value属性-->/test</a><br>

@RequestMapping(value = {"/testRequestMapping", "/test"})
public String testRequestMapping(){
    return "success";
}

/testRequestMapping，/test两个路径 都能映射到该方法上。

二、@RequestMapping注解的使用

1. @RequestMapping标注在类上

当标注在一个类上时，该类中的所有方法都将映射为相对于类级别的请求，表示该控制器所处理的所有请求都被映射到 value 属性值所指定的路径下。表示类中的所有响应请求的方法都是以该地址作为父路径。

2.@RequestMapping标注在方法上

当标注在一个方法上时，该方法将成为一个请求处理方法，它会在程序接收到对应的URL时被调用。

三、@RequestMapping注解的派生注解

1、对于处理指定请求方式的控制器方法，SpringMVC中提供了@RequestMapping的派生注解
处理get请求的映射–>@GetMapping
处理post请求的映射–>@PostMapping
处理put请求的映射–>@PutMapping
处理delete请求的映射–>@DeleteMapping
2、常用的请求方式有get，post，put，delete
但是目前浏览器只支持get和post，若在form表单提交时，为method设置了其他请求方式的字符串（put或delete），则按照默认的请求方式get处理
若要发送put和delete请求，则需要通过spring提供的过滤器HiddenHttpMethodFilter，在RESTful部分会讲到

@RestController
@Api(tags = "ProjectController", value = "项目管理")
@RequestMapping("/project")
public class ProjectController {

    private static final Logger LOGGER = LoggerFactory.getLogger(ProjectController.class);
    @Autowired
    private UserService userService;
    @Autowired
    private KcProjectService projectService;
	


	@ApiOperation(value = "上传工程")
    @PostMapping(value = "/upload")
    public CommonResult<?> upload(Principal principal,
     	@ApiParam(required = true, value = "文件")@RequestParam("file") MultipartFile file) {
			
		return null;
    }
	
	
	@ApiOperation(value = "获得工程列表（关键词 分页）")
    @GetMapping(value = "/getList")
    public CommonResult<?> getList(Principal principal,
	     @RequestParam(required = false) String keyword,
	     @Validated PagingParam pagingParam) {
	     
	     return null;
    }
}

四、@RequestMapping注解的params属性（了解）

@RequestMapping注解的params属性通过请求的请求参数匹配请求映射

@RequestMapping注解的params属性是一个字符串类型的数组，可以通过四种表达式设置请求参数和请求映射的匹配关系

“param”：要求请求映射所匹配的请求必须携带param请求参数

“!param”：要求请求映射所匹配的请求必须不能携带param请求参数

“param=value”：要求请求映射所匹配的请求必须携带param请求参数且param=value

“param!=value”：要求请求映射所匹配的请求必须携带param请求参数但是param!=value

五、@RequestMapping注解的headers属性（了解）

@RequestMapping注解的headers属性通过请求的请求头信息匹配请求映射

@RequestMapping注解的headers属性是一个字符串类型的数组，可以通过四种表达式设置请求头信息和请求映射的匹配关系

“header”：要求请求映射所匹配的请求必须携带header请求头信息

“!header”：要求请求映射所匹配的请求必须不能携带header请求头信息

“header=value”：要求请求映射所匹配的请求必须携带header请求头信息且header=value

“header!=value”：要求请求映射所匹配的请求必须携带header请求头信息且header!=value

若当前请求满足@RequestMapping注解的value和method属性，但是不满足headers属性，此时页面显示404错误，即资源未找到。