几种常用内容类型（Content-Type）的http客户端开发实例

在开发过程中，通常会遇到与其他服务做信息交换的情况，大多数情况下会通过http接口实现信息的交换。但是不同的服务接口指定的Content-Type类型是不同的。下文将通过实际的例子展示，常用的集中内容类型的http请求如何开发。

Content-Type（内容类型），一般是指网页中存在的 Content-Type，用于定义网络文件的类型和网页的编码，决定浏览器将以什么形式、什么编码读取这个文件，这就是经常看到一些 PHP 网页点击的结果却是下载一个文件或一张图片的原因。

Content-Type 标头告诉客户端实际返回的内容的内容类型。s

http支持的Content-Type种类很多，但是实际中常用的主要有三种：application/x-www-form-urlencoded，application/form-data，application/json。

1、一个通用的请求方法

var httpTr = &http.Transport{
    //控制主机的最大空闲连接数，0为没有限制
    MaxIdleConns:        100,
    MaxIdleConnsPerHost: 100,
    //长连接在关闭之前，保持空闲的最长时间，0表示没限制。
    IdleConnTimeout: 60 * time.Second,
}

var client = &http.Client{
    Timeout:   20 * time.Second,
    Transport: httpTr,
}

func SendRequest(url string, method string, contentType string, param io.Reader, respData interface{}, headers ...map[string]string) error {
    var err error

    req, err := http.NewRequest(method, url, param)
    if err != nil {
        err = fmt.Errorf("create http request failed: %s", err.Error())
        return err
    }

    req.Header.Set("Content-Type", contentType)

    if headers != nil {
        for _, h := range headers {
            for k, v := range h {
                req.Header.Set(k, v)
            }
        }
    }

    resp, err := client.Do(req)
    if err != nil {
        err = fmt.Errorf("send http request failed: %s", err.Error())
        return err
    }
    defer resp.Body.Close()

    respBytes, err := ioutil.ReadAll(resp.Body)
    if err != nil {
        err = fmt.Errorf("read response data failed: %s", err.Error())
        return err
    }
    logger.Debug("read the response ok:", string(respBytes))

    // 解析响应
    if err = json.Unmarshal(respBytes, respData); err != nil {
        logger.Error(err.Error())
        err = fmt.Errorf("unmarshal response data failed: %s", err.Error())
        return err
    }
    return nil
}

2、application/json格式

func PostJsonRequest(url string, requestData interface{}, responseData interface{}, headers ...map[string]string) error {
    var err error

    logger.Debugf("url: %s, req: %+v", url, requestData)
    jsonParamBytes, err := json.Marshal(requestData)
    if err != nil {
        err = fmt.Errorf("Marshal json error:%s ", err.Error())
        return err
    }
    logger.Debugf("request json:%s", string(jsonParamBytes))

    paramData := bytes.NewBuffer(jsonParamBytes)
    err = SendRequest(url, "POST", "application/json", paramData, responseData, headers...)
    if err != nil {
        return err
    }

    return nil
}

3、application/x-www-form-urlencoded格式

func PostUrlEncodedRequest(urlstr string, requestData map[string]string, responseData interface{}) error {
    var err error
    var body = make(url.Values)

    if requestData != nil {
        for k, v := range requestData {
            body[k] = []string{v}
            logger.Debug("build form data ok.")
        }
    }
    data := strings.NewReader(body.Encode())

    logger.Debugf("url: %s, req: %+v", urlstr, data)

    err = SendRequest(urlstr, "POST", "application/x-www-form-urlencoded", data, responseData)
    if err != nil {
        return err
    }

    return nil
}

4、application/form-data格式

func PostFormDataRequest(urlstr string, requestData map[string]string, responseData interface{}) error {
    var err error
    body := new(bytes.Buffer)
    writer := multipart.NewWriter(body)

    if requestData != nil {
        for k, v := range requestData {
            err = writer.WriteField(k, v)
            if err != nil {
                err = fmt.Errorf("write form field %s:%s failed: %s", k, v, err.Error())
                return err
            }
            logger.Debug("build form data ok.")
        }
    }
    if err = writer.Close(); err != nil {
        err = fmt.Errorf("close multipart form writer failed: %s", err.Error())
    }

    err = SendRequest(urlstr, "POST", writer.FormDataContentType(), body, responseData)
    if err != nil {
        return fmt.Errorf("do sendRequest error with param %s:%s", body, err.Error())
    }

    return nil
}

上述事例默认返回数据为json类型，这也是当前 http接口最常用的信息交互数据格式。开发时可以根据实际的情况修改返回值处理逻辑。此外，请求方法类型也可以根据实际需求进行修改，如果请求方法类型不匹配将无法返回正确结果。