聊聊springmvc中controller的方法的参数注解方式

2023-09-22 17:18:05 54

绪论

相信接触过springmvc的同学都知道，在springmvc的控制层中，我们在方法的参数中可以使用注解标识。比如下面例子：

publicMaplogin(@PathVariable("loginParams")StringloginParams)

@PathVariable注解就标识了这个参数是作为一个请求地址模板变量的（不清楚的同学可以先学习一下restful设计风格）。这些注解都是spring内置注解，那么我们可不可以自定义注解来实现自己的业务逻辑处理呢？答案是可以的，spring团队的一大设计哲学思想就是让自己的系统有无限可能性的拓展。spring框架底层又是如何解析这些参数的注解的呢？

那么在学习自定义参数注解之前，我们先了解一下spring底层是怎么来解析这些注解参数的。实际上，这些处理过程是要涉及到配置文件的加载和解析以及一堆的各种处理，小弟功力尚浅，就分析不到那么多了，只是简单过一下。

内置参数注解的解析

下面，我们从源码角度来分析：

首先，sping定义了一个统一的方法参数注解解析接口HandlerMethodArgumentResolver，所有方法参数解析类都需要实现这个接口，接口很简单，定义了两个方法：

publicinterfaceHandlerMethodArgumentResolver{

/**
*判断方法参数是否包含指定的参数注解
*含有返回true，不含有返回false
*/
booleansupportsParameter(MethodParameterparameter);

/**
*在给定的具体的请求中，把方法的参数解析到参数值里面，返回解析到的参数值，没有返回null
*只有在supportsParameter返回true的时候，resolveArgument方法才会执行
*/
ObjectresolveArgument(MethodParameterparameter,ModelAndViewContainermavContainer,
NativeWebRequestwebRequest,WebDataBinderFactorybinderFactory)throwsException;

}

现在，带着大家看看@PathVariable参数注解的解析具体过程，源代码如下：

publicclassPathVariableMethodArgumentResolverextendsAbstractNamedValueMethodArgumentResolver
implementsUriComponentsContributor{

/*
*这里省略其它方法
*
/

@Override
publicbooleansupportsParameter(MethodParameterparameter){
//不含有PathVariable注解，返回false
if(!parameter.hasParameterAnnotation(PathVariable.class)){
returnfalse;
}
//PathVariable注解的参数类型是Map类型
if(Map.class.isAssignableFrom(parameter.getParameterType())){
StringparamName=parameter.getParameterAnnotation(PathVariable.class).value();
returnStringUtils.hasText(paramName);
}
returntrue;
}

//PathVariableMethodArgumentResolver没有重写resolveArgument，直接使用AbstractNamedValueMethodArgumentResolver默认行为
/*
*如果supportsParameter返回true，在这里真正处理参数
*
*/
protectedvoidhandleResolvedValue(Objectarg,Stringname,MethodParameterparameter,
ModelAndViewContainermavContainer,NativeWebRequestrequest){

Stringkey=View.PATH_VARIABLES;
intscope=RequestAttributes.SCOPE_REQUEST;
MappathVars=(Map)request.getAttribute(key,scope);
if(pathVars==null){
pathVars=newHashMap();
request.setAttribute(key,pathVars,scope);
}
//把参数的key-value放进请求域，也就是把值赋给了方法参数，比如请求路径是：api/v1/task/{id}，方法参数@PathVariable("id")StringtaskId，那么此时name=taskId,org=id的值
//当然，怎么把请求地址中对应的值获取出来，不在这篇博客的讨论范畴。大家只要记得参数注解是这样解析处理的就可以了
pathVars.put(name,arg);
}

}

AbstractNamedValueMethodArgumentResolver的resolveArgument方法如下

publicfinalObjectresolveArgument(MethodParameterparameter,ModelAndViewContainermavContainer,
NativeWebRequestwebRequest,WebDataBinderFactorybinderFactory)throwsException{

ClassparamType=parameter.getParameterType();
//获取请求参数的key-value
NamedValueInfonamedValueInfo=getNamedValueInfo(parameter);
//解析参数名
Objectarg=resolveName(namedValueInfo.name,parameter,webRequest);
if(arg==null){
if(namedValueInfo.defaultValue!=null){
arg=resolveDefaultValue(namedValueInfo.defaultValue);
}
elseif(namedValueInfo.required&&!parameter.getParameterType().getName().equals("java.util.Optional")){
handleMissingValue(namedValueInfo.name,parameter);
}
arg=handleNullValue(namedValueInfo.name,arg,paramType);
}
elseif("".equals(arg)&&namedValueInfo.defaultValue!=null){
arg=resolveDefaultValue(namedValueInfo.defaultValue);
}
//数据绑定
if(binderFactory!=null){
WebDataBinderbinder=binderFactory.createBinder(webRequest,null,namedValueInfo.name);
try{
arg=binder.convertIfNecessary(arg,paramType,parameter);
}
catch(ConversionNotSupportedExceptionex){
thrownewMethodArgumentConversionNotSupportedException(arg,ex.getRequiredType(),
namedValueInfo.name,parameter,ex.getCause());
}
catch(TypeMismatchExceptionex){
thrownewMethodArgumentTypeMismatchException(arg,ex.getRequiredType(),
namedValueInfo.name,parameter,ex.getCause());

}
}

/*
*最后的处理是交给handleResolvedValue，handleResolvedValue方法是抽象方法，我们回来看看一下PathVariableMethodArgumentResolver的handleResolvedValue方法是抽象方法的具体实现
*
*／
handleResolvedValue(arg,namedValueInfo.name,parameter,mavContainer,webRequest);

returnarg;
}

可以知道，@PathVariable标识的参数，会被对应参数解析器把对应值解析到一个Map结构中保存到requestscope。

总的来说，实现处理注解参数思路还是比较简单的，定义一个类实现HandlerMethodArgumentResolver接口，在对应方法里面进行处理就可以了。接下来我们就来一次自定义注解参数解析的实战。

自定义注解参数解析演练

我们模拟一下获取当前任务信息。

首先我们定义一个注解

packagetop.mingzhijie.demo.springmvc.anntation;

importjava.lang.annotation.ElementType;
importjava.lang.annotation.Retention;
importjava.lang.annotation.RetentionPolicy;
importjava.lang.annotation.Target;

/**代表当前任务
*@authorwunanliang
*@date2017/10/21
*@since1.0.0
*/
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.PARAMETER)
public@interfaceCurrentTask{
Stringvalue()default"";
}

接着模拟一个业务逻辑处理服务类

packagetop.mingzhijie.demo.springmvc.method.arguments.anntation;

importtop.mingzhijie.demo.springmvc.entity.Task;

importjava.util.HashMap;
importjava.util.Map;

/**
*模拟任务业务类
*
*@authorwunanliang
*@date2017/10/21
*@since1.0.0
*/
publicclassTaskService{

privatestaticMaptaskMap=newHashMap();

static{
taskMap.put("001",newTask("task1",10,true));
taskMap.put("002",newTask("task2",1,false));
taskMap.put("003",newTask("task3",20,false));
}

publicstaticTaskfindTaskById(StringtaskId){
returntaskMap.get(taskId);
}

}

编写任务类

packagetop.mingzhijie.demo.springmvc.entity;

/**
*@authorwunanliang
*@date2017/10/21
*@since1.0.0
*/
publicclassTask{

privateStringname;
privateintresolvedCount;//参与人数
privatebooleanallowStudent;

publicTask(){}

publicTask(Stringname,intresolvedCount,booleanallowStudent){
this.name=name;
this.resolvedCount=resolvedCount;
this.allowStudent=allowStudent;
}

publicbooleanisAllowStudent(){
returnallowStudent;
}

publicvoidsetAllowStudent(booleanallowStudent){
this.allowStudent=allowStudent;
}

publicintgetResolvedCount(){
returnresolvedCount;
}

publicvoidsetResolvedCount(intresolvedCount){
this.resolvedCount=resolvedCount;
}

publicStringgetName(){
returnname;
}

publicvoidsetName(Stringname){
this.name=name;
}

@Override
publicStringtoString(){
return"Task{"+
"name='"+name+'\''+
",resolvedCount="+resolvedCount+
",allowStudent="+allowStudent+
'}';
}
}

编写注解参数处理类

packagetop.mingzhijie.demo.springmvc.method.arguments.anntation;

importorg.springframework.core.MethodParameter;
importorg.springframework.web.bind.support.WebDataBinderFactory;
importorg.springframework.web.context.request.NativeWebRequest;
importorg.springframework.web.method.support.HandlerMethodArgumentResolver;
importorg.springframework.web.method.support.ModelAndViewContainer;
importtop.mingzhijie.demo.springmvc.anntation.CurrentTask;
importtop.mingzhijie.demo.springmvc.entity.Task;

/**
*@authorwunanliang
*@date2017/10/21
*@since1.0.0
*/
publicclassTaskHandlerMethodArgumentResolverimplementsHandlerMethodArgumentResolver{

publicbooleansupportsParameter(MethodParametermethodParameter){

booleanhasAnn=methodParameter.hasParameterAnnotation(CurrentTask.class);
returnhasAnn;
}

publicObjectresolveArgument(MethodParametermethodParameter,ModelAndViewContainermodelAndViewContainer,NativeWebRequestnativeWebRequest,WebDataBinderFactorywebDataBinderFactory)throwsException{

Tasktask=null;
StringcurTaskId=(String)nativeWebRequest.getParameter("cur_task_id");
if(curTaskId!=null&&!"".equals(curTaskId)){
task=TaskService.findTaskById(curTaskId);
}

if(task==null){
System.out.println("为找到对应的任务");
}else{
if(task.isAllowStudent()){
System.out.println("当前任务不允许学生参加哦");
}else{
System.out.println("学生可以参加当前任务哦");
}
}
returntask;
}
}

编写前端控制类

packagetop.mingzhijie.demo.springmvc.method.arguments.anntation;

importorg.springframework.web.bind.annotation.*;
importtop.mingzhijie.demo.springmvc.anntation.CurrentTask;
importtop.mingzhijie.demo.springmvc.entity.Task;

importjava.util.HashMap;
importjava.util.Map;

/**
*@authorwunanliang
*@date2017/10/21
*@since1.0.0
*/
@RestController
@RequestMapping("/tasks")
publicclassTaskController{

//这里使用@CurrentTask来表示Task参数
@RequestMapping(value="/join",method=RequestMethod.GET)
@ResponseBody
publicMapgJoinTask(@RequestParam("cur_task_id")StringtaskId,@CurrentTaskTasktask){
System.out.println(task);
Mapmap=newHashMap();
map.put("cur_task",task);
returnmap;
}

}

配置文件配置注解参数解析bean

运行，输入地址http://localhost:8888/demospringmvc/tasks/join?cur_task_id=001

获取到任务信息json数据：

{
"cur_task":{
"name":"task1",
"resolvedCount":10,
"allowStudent":true
}
}

可以看到，@CurrentTask标识的参数Task，在方法中就可以获取到经过TaskHandlerMethodArgumentResolver处理过的任务

使用场景

在我们web请求中，往往需要客户端待会token来进行身份验证，这样我们可以自定义参数注解来在指定的注解解析类里面来进行token的合法性的判断。这篇文章就到这里了～～

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持毛票票。

聊聊springmvc中controller的方法的参数注解方式

热门推荐

随机推荐