MultiValueMap类介绍

向前冲的小牛

于 2023-12-14 17:04:54 发布

阅读量1.2k

点赞数 23

文章标签： java 数据结构散列表

本文链接：https://blog.csdn.net/m0_74870921/article/details/134999516

版权

介绍

MultiValueMap 是一个用于存储键值对的数据结构，与标准的不同，它允许一个键关联多个值。在Java中，通常用于处理HTTP请求中的参数，其中一个参数可以具有多个值。MapMultiValueMap

MultiValueMap 不是Java标准库中的一部分，但它可以在许多Java库和框架中找到。Spring Framework是一个广泛使用的示例，它提供了一个接口以及具体的实现。MultiValueMaporg.springframework.util.MultiValueMapMultiValueMap 是一个用于存储键值对的数据结构，与标准的不同，它允许一个键关联多个值。在Java中，通常用于处理HTTP请求中的参数，其中一个参数可以具有多个值。

以下是接口的一些常见方法：MultiValueMap

add(K key, V value): 将指定的键与指定的值关联，如果该键已经存在，则将值添加到键的值列表中。
addAll(K key, List<? extends V> values): 将指定的键与一组值关联。
getFirst(K key): 获取指定键的第一个值。
get(K key): 获取指定键的所有值。
getOrDefault(K key, List<V> defaultValue): 获取指定键的所有值，如果键不存在，则返回默认值。
remove(K key): 从中删除指定键及其关联的所有值。MultiValueMap
set(K key, V value): 将指定键与单个值关联，覆盖已存在的值。
setAll(Map<K, V> values): 将一组键值对添加到中，覆盖已存在的值。MultiValueMap

数据结构

Spring Framework中的MultiValueMap接口通常使用LinkedHashMap的实现来表示底层数据结构。具体来说，LinkedMultiValueMap是MultiValueMap接口的一个常见实现，它使用LinkedHashMap作为其内部数据结构来存储键值对。这意味着它维护了键值对的插入顺序，并且每个键可以映射到一个值列表，这个列表可以包含一个或多个值。

LinkedHashMap是Java标准库中的一个数据结构，它继承自HashMap，但添加了对插入顺序的维护。这使得LinkedMultiValueMap在处理HTTP请求参数等需要保持顺序的场景中非常有用，因为它可以确保键值对的顺序与插入顺序一致。

    public void add(K key, @Nullable V value) {
        List<V> values = (List)this.targetMap.computeIfAbsent(key, (k) -> {
            return new ArrayList(1);
        });
        values.add(value);
    }

从这段add方法源码可以看出，它的map里的value值是一个ArrayList。

应用场景

MultiValueMap 类通常用于处理具有多个值的键值对数据，它在许多不同的应用场景中都非常有用。以下是一些常见的实际应用场景：

HTTP请求参数处理：在Web开发中，客户端通常会将多个参数传递给服务器。这些参数可以使用MultiValueMap 来表示，其中每个参数名关联多个值。这样可以轻松地处理查询字符串参数、表单数据、HTTP请求头等。
表单数据处理：当处理HTML表单提交时，表单字段可以具有多个值。例如，一个多选框可以选择多个选项，这些选项都会提交到服务器。使用MultiValueMap 可以有效地处理这些表单数据。
配置管理：某些配置参数可能会具有多个值。例如，一个应用程序的配置文件可以使用MultiValueMap 来表示，其中每个配置项都可以有多个值。这对于管理复杂的配置数据非常有用。
请求参数分组：在某些情况下，您可能希望将一组参数按照某种方式分组或分类。MultiValueMap 可以帮助您实现这种分组，以便更容易处理和分析数据。
数据聚合：在某些数据处理场景中，您可能需要将多个值聚合到一个键下。例如，您可能希望将多个用户的评论关联到一个文章ID上。MultiValueMap 可以帮助您有效地进行数据聚合。
参数化测试：在单元测试中，您可能需要测试相同的功能但使用不同的参数值。MultiValueMap 可以用于管理参数集合，以便轻松地进行参数化测试。
数据收集和分析：在数据分析领域，您可能需要收集和存储多个数据点，其中每个数据点可以关联多个维度或标签。MultiValueMap 可以用于组织和分析这些多维数据。

下面一段代码演示HTTP请求参数处理

import org.springframework.util.LinkedMultiValueMap;
import org.springframework.util.MultiValueMap;

public class HttpRequestParameterHandling {
    public static void main(String[] args) {
        // 模拟一个HTTP请求参数，使用MultiValueMap表示
        MultiValueMap<String, String> requestParams = new LinkedMultiValueMap<>();
        requestParams.add("name", "John");
        requestParams.add("name", "Alice");
        requestParams.add("age", "30");
        requestParams.add("city", "New York");
        requestParams.add("city", "Los Angeles");

        // 获取特定参数的值
        String name = requestParams.getFirst("name");
        System.out.println("Name: " + name);

        // 获取所有参数的值
        System.out.println("All Names: " + requestParams.get("name"));
        System.out.println("All Cities: " + requestParams.get("city"));

        // 检查参数是否存在
        boolean hasGender = requestParams.containsKey("gender");
        System.out.println("Has Gender Parameter: " + hasGender);

        // 删除特定参数及其值
        requestParams.remove("age");
        System.out.println("All Parameters after removing 'age': " + requestParams);

        // 遍历所有参数
        System.out.println("Iterating through all parameters:");
        for (String key : requestParams.keySet()) {
            for (String value : requestParams.get(key)) {
                System.out.println(key + ": " + value);
            }
        }
    }
}

总结

MultiValueMap（多值映射）是一种数据结构，它允许一个键映射到多个值，通常用于表示具有多个值的HTTP请求参数或其他类似的数据。在Java中，MultiValueMap通常被用作键到值列表的映射，其中一个键可以关联多个值。这使得处理重复键的数据更加方便，而不需要手动管理多个值的列表。