Spring Boot Map 使用指南

一、Map 是什么？

Map 是一种常用的数据结构，用于存储一组键值对，并能够通过 key 查找对应的 value。在 Java 中，Map 是一个接口，在 Spring Boot 中也有很多用法。

Spring Boot 的 Map 主要用于处理两个场景：配置文件和 HTTP 请求参数。在配置文件中，Map 通常用于存储一组属性和对应的值；在 HTTP 请求中，Map 用于存储 query 参数和 form data。

二、Map 的基本使用

要创建一个 Map 对象，可以使用 Java 中的 HashMap、TreeMap 或者 LinkedHashMap。其中，HashMap 是最常用的，它的 key 是无序的，性能也比其他两个高很多。

Map<String, Object> map = new HashMap<>();
map.put("name", "John");
map.put("age", 20);
map.put("gender", "male");

可以使用 get 方法通过 key 查找对应的 value：

String name = (String)map.get("name");
int age = (int)map.get("age");
String gender = (String)map.get("gender");

Map 还支持遍历，可以使用 forEach 方法或者 Iterator 进行遍历：

map.forEach((key, value) -> System.out.println(key + ": " + value));
for (Map.Entry<String, Object> entry : map.entrySet()) {
    System.out.println(entry.getKey() + ": " + entry.getValue());
}

三、Spring Boot 中的 Map

1、配置文件中的 Map

在 application.yml 或者 application.properties 配置文件中，可以使用 Map 存储一组属性和对应的值。例如：

my:
  config:
    map:
      name: John
      age: 20
      gender: male

可以使用 @Value 注解和 ${} 占位符来获取 Map 中的值：

@Value("${my.config.map}")
private Map<String, Object> configMap;

也可以使用 @ConfigurationProperties 注解来绑定 Map：

@Configuration
@ConfigurationProperties(prefix = "my.config")
public class MyConfig {
    
    private Map<String, Object> map;

    // getter and setter
}

2、HTTP 请求参数中的 Map

在处理 HTTP 请求时，Map 常常用于存储 query 参数和 form data。可以使用 @RequestParam 或者 @RequestBody 注解将 Map 绑定到方法参数中：

@GetMapping("/test")
public void test(@RequestParam Map<String, Object> params) {
    // do something with params
}

@PostMapping("/test")
public void test(@RequestBody Map<String, Object> body) {
    // do something with body
}

四、Map 的高级用法

1、Map 的常用操作

除了基本的 put、get、forEach 和遍历操作外，Map 还支持很多其他的操作。例如，可以使用 containsKey、containsValue、remove、replace 等方法来操作 Map 中的元素。

map.containsKey("name"); // true
map.containsValue("female"); // false
map.remove("name");
map.replace("age", 20, 21);

2、Map 的排序

默认情况下，Map 是按照插入顺序存储元素的。但是，如果需要对 Map 进行排序，可以使用 TreeMap，在创建 TreeMap 时指定一个 Comparator。例如，按照 key 升序排序：

Map<String, Object> map = new TreeMap<>((s1, s2) -> s1.compareTo(s2));

3、Map 的合并

在处理配置文件时，可能需要将多个 Map 合并成一个。可以使用 Stream 的 reduce 方法来进行合并操作。

Map<String, Object> map1 = new HashMap<>();
map1.put("name", "John");
map1.put("age", 20);

Map<String, Object> map2 = new HashMap<>();
map2.put("gender", "male");

Map<String, Object> result = Stream.of(map1, map2)
        .reduce(new HashMap<>(), (m1, m2) -> {
            m1.putAll(m2);
            return m1;
        });
// result: {name=John, age=20, gender=male}

五、总结

本文主要介绍了 Spring Boot Map 的基本使用和高级用法，包括在配置文件中使用 Map、处理 HTTP 请求参数中的 Map、常用操作、排序和合并等。