SpringBoot——关于Controller的简单使用
映射注解
@Controller和@RestController
这两个都是用来标注类为controller的，不同之处在于@Controller标记的类默认返回视图，@RestController标记的类返回的是数据（字符串，json数据等等），之前为了达到@RestController的效果，需要在@Controller标记的类中使用@ResponseBody标签（@RestController = @Controller + @ResponseBody），@ResponseBody可以加在类或者方法上（指定全类或者某个方法返回数据）；
@RequestMapping()以及细化的@xxxxxMapping
@RequestMapping()用于指定请求路径的映射，可以使用在类或者方法上（控制在整个类的作用域或者方法的作用域，例如可以为类中的方法设置一个总的父级路径）；
@RequestMapping()注解可设置的参数：
- consumes：设定Content-Type缩小请求范围，只处理指定content-type的请求，可以直接使用字符串或者数组或者MediaType定义好的类型，也支持“*”通配符匹配（例如：consumes = "text/plain"、consumes = {"text/plain", "application/*"}、consumes = MediaType.IMAGE_JPEG_VALUE），可以使用“!”进行否定指定该类型之外的（consumes = "!text/plain"）；该参数可以用在类和方法上，并且方法上的会覆盖类上的设定；
- headers：设定header缩小请求范围，可以指定header（headers = "My-Header=myValue"），也可以用“!=”指定排除（headers = "My-Header!=myValue"），也可以不设置值指定必须拥有该名称的header（headers = "My-Header"），或者使用“!”指定不能有该名称的header（headers = "!My-Header"），也支持“*”通配符（headers = "content-type=text/*"），也可以配置多个header（headers = {"myheader1=abc", "!myheader2"}）；该参数可以用在类和方法上，当用在类上时，所有方法都继承该参数，即在执行方法前先验证类上的header限制；
- method：设定http请求的方法缩小请求范围，支持：GET, POST, HEAD, OPTIONS, PUT, PATCH, DELETE, TRACE；该参数可以用在类和方法上，当用在类上时，所有方法都继承该参数，执行方法前先验证类上的method；
- name：为映射分配一个名字；该参数可以用在类和方法上，当类和方法都使用name时，组合名字是使用“#”连接起来的；
- params：设定请求的参数缩小请求范围，参数跟headers的设置类似，也支持“a=1”、“a!=1”、“a”、“!a”；该参数可以用在类和方法上，当用在类上时，所有方法继承该参数，在执行方法前先验证类上的params限制；
- path：映射路径（等同value参数），支持Ant-style格式通配符（?匹配任何单字符、*匹配0或任意数量的字符、**匹配0或任意数量的目录），在方法上也支持相对类中path的路径，也支持使用占位符（"/{my_path}"），支持配置多个路径（path = {"/abc", "/def"}）；该参数可以用在类和方法上，当用在类上时，所有方法继承该path；没有显式配置路径映射方法的都会映射到空路径；
- produces：设置媒体类型，可以设置多个，其中一个必须配合请求里的可接受的媒体类型，通常是从Accept标头里提取的；如果媒体类型带有参数（像“charset=UTF-8”）并且请求里的媒体类型也带有参数，则参数的值必须匹配；也可以使用“!”匹配指定媒体类型之外的其他所有Accept配置类型的请求；该参数可以用在类和方法上，并且方法级的会覆盖掉类级的；
- value：path的别名，@RequestMapping("/test")等同于@RequestMapping(path = "/test")；
还有一些特定方法的专用的映射：@GetMapping、@PostMapping、@DeleteMapping、@PatchMapping、@PutMapping，只接受指定method的请求，相当于@RequestMapping加method参数，其他的参数跟@RequestMapping的基本一致；
另外要注意路径映射的唯一性，例如：不能出现两个完全一样的@PostMapping("/abc")，但可以出现@RequestMapping("/abc")和@PostMapping("/abc")并存的情况，这时"/abc"的post请求被分到第二个上，其他method的请求分到第一个；@PostMapping(value = "/aaa", params = "a")和@PostMapping(value = "/aaa", params = "b")也可以共存，带参数a的执行第一个，带参数b的执行第二个，但是如果post请求里既有a又有b参数则会造成歧义返回错误；很多情况下启动时不会报异常，只在请求的时候异常；
参数注解
controller方法的参数有使用注解和不使用注解两种方式，可用的注解：
@RequestParam
该注解可以接收请求地址里?后面用&连接的参数，可以接收post的form表单数据（通常content-type为multipart/form-data），也可以接收浏览器原生form表单数据（content-type为application/x-www-form-urlencoded，数据按照key=val&key=val编码，并进行URL转码）；
@RequestParam可设置的参数：
- defaultValue：当未提供参数或者参数为空时，设置一个默认值，当提供默认值时会默认required为false；
- name：给参数绑定一个名字；（等同value）
- required：设置参数是否是必须，默认true（不传递参数会异常）；如果参数非必须可设置为false，或者提供一个defaultValue；
- value：name的别名；
该注解通常可以省略，通常用于参数名不一致、需要默认值、必传的时候；
参数可以一个一个独立的写，也可以封装到一个Bean对象里（get和set方法），另外bean也可以跟独立的参数同时支持，bean里的参数名也可以跟独立的参数同名，都能读取到值，也可以同名不同类型（例如bean里a的是int，独立的a参数也可以是String）；如果是内部类的bean主要是static的；
关于参数类型，一般用String接收，有时也可以用数值，用数值时要确保传来的值能转换成数值（传来的都是String，会自动转对应数值类型），对于String类型的参数会将能读取到的3处的值合并在一起，中间用逗号隔开，对于数值类型只会读取最优先的一个；三种数据来源的读取优先顺序：form-data > 请求地址里?后的 > x-www-form-urlencoded；
@RequestParam的form表单也可以用来接收文件，利用MultipartFile类可以接收文件；
接收文件的Demo：
@RequestMapping("/aaa")
public String a(@RequestParam MultipartFile myfile) {
String filename = myfile.getOriginalFilename();
System.out.println(filename);
File dest = new File(filename);
try {
Files.write(dest.toPath(), myfile.getBytes());
} catch (IOException e) {
e.printStackTrace();
}
return "ABC";
}测试结果：
@RequestBody
通常用于接收post请求体的数据，一般是json数据，也可以是字符串或数值；
@RequestBody可设置的参数：
- required：设置body内容是否是必须，默认true（不传递body会异常）；如果想要body为空时传递null，则设该值为false；
@RequestBody只能有一个，通常接收json数据使用自定义类，将各个字段放到一个类中，字段属性使用@JsonProperty注释或者使用getter()setter()，如果是内部类也需要static class；
关于@JsonProperty可设置的项：
- access：可选属性，用于改变访问器（getter）和构造器（构造函数里、setter）的可见性，或者由其他私有或者其他可见性控制（例如private getter）；默认Access.AUTO完全由其他可见性和注解控制；可用的值：Access.AUTO、Access.READ_ONLY、Access.READ_WRITE、Access.WRITE_ONLY；
- defaultValue：设置默认值；
- index：设置属性的数值索引，使用二进制表示，可能用于其他语言或者工具；
- required：设置属性是否必须，默认false，只用于创建属性的时候验证，对于其他setter等方式不验证；
- value：设置属性的名字，默认值为“”，将尝试使用注释的属性名；（构造方法没有默认属性名可用，空字符串是非法的值）
@PathVariable
用于获取url地址里的参数，跟@RequestMapping设置的路径里的{}搭配使用；
@PathVarialbe可设置的参数：
- name：为路径参数绑定一个名字（对应路径url里{}里的名字）；（等同value）
- required：设置路径参数是否必须，默认true（不传递路径参数会异常）；如果希望没有路径参数时传递null则可以设置为false；
- value：name别名；
@RequestHeader
用于获取请求的header；
@RequestHeader可设置的参数：
- defaultValue：设置默认header的值，设置会将required默认为false；
- name：设置header的名字；
- required：设置header是否必须，默认true；
- value：name别名；
@CookieValue
用于获取cookie值；
@CookieValue可设置的参数：
- defaultValue：设置默认cookie值，设置会将required默认为false；
- name：设定绑定cookie的名字；
- required：设置cookie是否必须，默认true；
- value：name别名；
另外，注解可以一同使用，用来同时读取请求地址上的路径参数、地址?后的参数、消息体的内容、header、cookie等等；
关于返回值
可以返回任意数据，也可以不返回数据；可以返回字符串，数值，集合，对象等可序列化的值，复杂类型的返回值会被转换成json数据返回；
返回自定义的对象，类里的属性需要至少有一个是可公开可访问的，没有可访问属性会报错；需要序列化返回给调用接口的属性可以使用public修饰属性，或者使用public的getter方法，或者使用@JsonProperty标签里的access控制（可以用默认的AUTO或者READ_ONLY、READ_WRITE都可），其他没有修饰的属性不会返回；
测试Demo：
配置文件test5.properties：
server.port=8899
server.servlet.context-path=/test5controller
result.ok=okay启动类：
/**
* 2022年11月3日上午10:57:27
*/
package testspringboot.test5controller;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.annotation.PropertySource;
/**
* @author XWF
*
*/
@SpringBootApplication
@PropertySource("test5.properties")
public class Test5Main {
/**
* @param args
*/
public static void main(String[] args) {
SpringApplication.run(Test5Main.class, args);
}
}
controller类：
/**
* 2022年11月3日上午11:02:28
*/
package testspringboot.test5controller;
import java.util.HashMap;
import java.util.Map;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
import com.fasterxml.jackson.annotation.JsonProperty;
import testspringboot.test.MyParams;
import testspringboot.test.MyResult;
/**
* @author XWF
*
*/
@RestController
@RequestMapping(value = "/myController")
public class MyController {
@Value(value = "${result.ok}")
private String ok;
//处理/和/test0两个请求，并指定必须为PUT请求，并且参数必须有a不能有b，参数c必须为C，参数d不能为D或者不存在d
@RequestMapping(value = {"/", "/test0"}, method = RequestMethod.PUT, params = {"a", "!b", "c=C", "d!=D"})
public void test0(@RequestParam String a, @RequestParam(required = false) String d ) {//有@RequestParam String d则必须要有d参数，可以用required设置非必须
System.out.println("a=" + a);
System.out.println("d=" + d);
}
@RequestMapping(value = "/test1/{x1}/{x2}")
public String test1(@PathVariable String x1, @PathVariable String x2) {
System.out.println("x1=" + x1);
System.out.println("x2=" + x2);
return "test1 ok";
}
//处理get请求
@GetMapping(value = "/test2{num}")
public int test2(@PathVariable("num") int x) {
System.out.println("x=" + x);
return x;
}
//处理post请求
@PostMapping(value = "/test3/form")
public Map test3(@RequestParam("Name") String name, @RequestParam("No") String no) {
System.out.println(String.format("Name=%s,No=%s", name, no));
Map m = new HashMap<>();
m.put("K1", name.toUpperCase());
m.put("K2", no.toUpperCase());
return m;
}
@PostMapping(value = "/test4")
public Result test4(@RequestBody Params params) {
System.out.println("params=" + params);
return new Result(100, "Finished");
}
static class Params{//内部类参数需要指定static
@JsonProperty("name")//指定json字段
String name;
@JsonProperty("age")
int age;
public Params() {//内部类参数需要构造方法
;
}
@Override
public String toString() {
return "Params [name=" + name + ", age=" + age + "]";
}
}
class Result{
@JsonProperty("ResultCode")
int code;
@JsonProperty("CodeDescription")
String desc;
public Result(int code, String desc) {
super();
this.code = code;
this.desc = desc;
}
}
@PostMapping(value = "/test5")
public MyResult test5(@RequestBody MyParams p) {
System.out.println("MyParams=" + p);
return new MyResult(200, ok);
}
}
/**
* 2022年11月3日上午11:24:23
*/
package testspringboot.test5controller;
/**
* @author XWF
*
*/
public class MyParams {
public String stringParam;
public int intParam;
@Override
public String toString() {
return "MyParams [stringParam=" + stringParam + ", intParam=" + intParam + "]";
}
}
/**
* 2022年11月3日上午11:24:32
*/
package testspringboot.test5controller;
/**
* @author XWF
*
*/
public class MyResult {
public long code;
public String description;
public MyResult(long code, String description) {
super();
this.code = code;
this.description = description;
}
}
测试结果：
test0
test1
test2
test3
test4
test5
