Solon v3.0.3

C、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 格式参数）

请求样本数据：

  • ?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、关于枚举注入

  • 基本结构的，传入 name 可自动转换
  • 定制结构的，参考下面的“特殊类型”

5、特殊类型的注入转换

  • 表单数据注入时

借助"转换器"，比如请求 ?demo=1 要转换成实体 Demo。示例：

@Component
public class DemoConverter implements Converter<String, Demo> {
    @Override
    public Demo convert(String value) throws ConvertException {
        return Demo.parse(value);
    }
}

//应用示例（http://....?demo=1。 通过转换器把 1 转为 Demo 实体）
@Controller
public class DemoController {
    @Mapping("test")
    public void test(Demo demo){
    
    }
}
  • 序列化数据注入

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