Solon v2.8.0

B、MVC 的参数注入规则

</> markdown

关于 MVC 参数注入,主要尊守以下规则:

  • 参数名与请求数据名一一对应。
  • 当对上不上时,会采用整体数据注入(如果接收的是实体)
  • 参数名与请求数据同名时,又想整体注入(如果接收的是实体),可使用 @Body 注解强制标注

1、表单参数注入

请求样本数据:

GET http://localhost:8080/demo?select=1&select=2&user=noear

支持单字段注入(要求参数名,与请求数据名一一对应)

@Controller
public class DemoController{
    @Mapping("demo")
    public void demo(String[] select, String user){
    }
}

支持整体注入(要求参数名,不能与请求数据名对应)

public class PostDo{
    public String[] select;
    public String user;
}

@Controller
public class DemoController{
    @Mapping("demo")
    public void demo(PostDo postDo){ //参数名,不能是 select 或 user
    }
    
    @Mapping("demo")
    public void demo(@Body PostDo user){ //参数名如果与数据名相同。需要使用 @Body 来标明它是接收所有请求数据
    }
}

2、结构型参数注入(类似 properties 和 jsonpath 格式参数)

请求样本数据:

  • ?user.id=1&user.name=noear&user.type[0]=a&user.type[1]=b
  • ?type[]=a&type[]=b
  • ?order[id]=a

此特性,需要引入序列化插件:solon.serialization.properties。规则细节参考“序列化数据注入”。

3、序列化数据注入(比如 json, hessian, protostuff, fury)

请求样本数据:

POST http://localhost:8080/demo
{user:'noear',select:[1,2],data:{code:1,label:'b'}}

支持单字段注入(要求参数名,与请求数据的一级字段名对应)

@Controller
public class DemoController{
    @Mapping("demo")
    public void demo(String[] select, String user){
    }
}

支持整体注入(要求参数名,不能与请求数据的一级字段名对应)

public class PostDo{
    public String[] select;
    public String user;
}

@Controller
public class DemoController{
    @Mapping("demo")
    public void demo(PostDo postDo){ //参数名,不能是 select 或 user
    }
    
    @Mapping("demo")
    public void demo(@Body PostDo user){ //参数名如果与数据名相同。需要使用 @Body 来标明它是接收所有请求数据
    }
}

支持局部注入(要求参数名,不能与请求数据名对应)

public class PostDo{
    public String[] select;
    public String user;
}

public class DataDo{
    public int code;
    public String label;
}

@Controller
public class DemoController{
    @Mapping("demo")
    public void demo(PostDo postDo, String user, DataDo data){ //postDo 接收整体数据,user,data 接收局部数据
    }
}

4、特殊类型的注入转换

  • 表单数据注入时

借助"转换器",比如请求 ?demo=1 要转换成实体 Demo。具体参考:内核支持的几种特殊 Bean

  • 序列化数据注入

这个需要,给序列化组件添加对应的解码器,或者使用其特定的注解或特性。