RestTemplate：使用 Map 傳遞參數

環境

1. jdk 7
2. spring 4.3.24.RELEASE

原因

在使用 RestTemplate 的過程中，使用 java.util.HashMap 傳遞參數一直不生效。根據 這里 的說法，需要使用 MultiValueMap 和 其實現類 LinkedMultiValueMap。

分析

下面從源碼來看，為什么 HashMap 不生效而 LinkedMultiValueMap 可以生效。

debug 源碼

跟着源碼一直走下去，可以發現一個關鍵的類：FormHttpMessageConverter，這個類的 canWrite 方法如下：

public boolean canWrite(Class<?> clazz, MediaType mediaType) {
    if (!MultiValueMap.class.isAssignableFrom(clazz)) {
        return false;
    }
    if (mediaType == null || MediaType.ALL.equals(mediaType)) {
        return true;
    }
    for (MediaType supportedMediaType : getSupportedMediaTypes()) {
        if (supportedMediaType.isCompatibleWith(mediaType)) {
            return true;
        }
    }
    return false;
}

在這里檢查了請求中傳遞的類型是否實現了 MultiValueMap，所以不是這個類型的不能被處理。
java.util.HashMap 不是 MultiValueMap 類型，所以不能被處理。

示例

package jiangbo.springweb.rest;

import org.springframework.util.LinkedMultiValueMap;
import org.springframework.util.MultiValueMap;
import org.springframework.web.client.RestTemplate;

public class RestTemplateDemo04 {

    public static void main(String[] args) {

        String url = "https://dx.ipyy.net/sms.aspx";

        MultiValueMap<String, String> parameters = new LinkedMultiValueMap<>();

        RestTemplate restTemplate = new RestTemplate();
        String result = restTemplate.postForObject(url, parameters, String.class);

        System.out.println(result);

        parameters.add("action", "send");
        result = restTemplate.postForObject(url, parameters, String.class);

        System.out.println(result);
    }
}