🔥 了解 Solon MVC 的参数注入规则

关于 Solon 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){ } } 

• 序列化数据注入

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