理解HTTP之Content-Type


0x01.About

查看 Restful API 报头插件:Chrome插件REST Console,以及发送 Restful API 工具:Chrome插件POST Man

HTTP 1.1 规范中,HTTP 请求方式有 OPTIONS、GET、HEAD、POST、PUT、DELETE、TRACE、CONNECT。通常我们用的只有 GET、POST,然而对于 Restful API 规范来说,请求资源要用 PUT 方法,删除资源要用 DELETE 方法。

例如发送个 DELETE 包:

http://example.com/my/resource?id=12345

那么通过 id 就能获取到信息,这个包只有 header,并不存在 body,下面讨论几个包含body 的发包的 body 传输格式。

0x02.Content-Type

Content-Type 用于指定内容类型,一般是指网页中存在的 Content-TypeContent-Type
属性指定请求和响应的 HTTP 内容类型。如果未指定 ContentType,默认为 text/html

nginx 中有个配置文件 mime.types,主要是标示 Content-Type 的文件格式。

下面是几个常见的 Content-Type

  • text/html
  • text/plain
  • text/css
  • text/javascript
  • application/x-www-form-urlencoded
  • multipart/form-data
  • application/json
  • application/xml
  • ......

前面几个都很好理解,都是 htmlcssjavascript 的文件类型,后面四个是 POST 的发包方式。

0x03.application/x-www-form-urlencoded

application/x-www-form-urlencoded 是常用的表单发包方式,普通的表单提交,或者 js 发包,默认都是通过这种方式。

比如一个简单地表单:

<form enctype="application/x-www-form-urlencoded" action="http://homeway.me/post.php" method="POST">
    <input type="text" name="name" value="homeway">
    <input type="text" name="key" value="nokey">
    <input type="submit" value="submit">
</form>

那么服务器收到的 raw header 会类似:

Accept:text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8
Accept-Encoding:gzip, deflate
Accept-Language:zh-CN,zh;q=0.8,en;q=0.6,zh-TW;q=0.4,gl;q=0.2,de;q=0.2
Cache-Control:no-cache
Connection:keep-alive
Content-Length:17
Content-Type:application/x-www-form-urlencoded

那么服务器收到的 raw body 会是:name=homeway&key=nokey,在 php 中,通过$_POST 就可以获得数组形式的数据。

0x04.multipart/form-data

multipart/form-data 用在发送文件的POST包。

这里假设我用 pythonrequest 发送一个文件给服务器:

data = {
    "key1": "123",
    "key2": "456",
}
files = {'file': open('index.py', 'rb')}
res = requests.post(url="http://localhost/upload", method="POST", data=data, files=files)
print res

通过工具,可以看到我发送的数据内容如下:

POST http://www.homeway.me HTTP/1.1
Content-Type:multipart/form-data; boundary=------WebKitFormBoundaryOGkWPJsSaJCPWjZP

------WebKitFormBoundaryOGkWPJsSaJCPWjZP
Content-Disposition: form-data; name="key2"
456
------WebKitFormBoundaryOGkWPJsSaJCPWjZP
Content-Disposition: form-data; name="key1"
123
------WebKitFormBoundaryOGkWPJsSaJCPWjZP
Content-Disposition: form-data; name="file"; filename="index.py"

这里 Content-Type 告诉我们,发包是以 multipart/form-data 格式来传输,另外,还有 boundary 用于分割数据。

当文件太长,HTTP 无法在一个包之内发送完毕,就需要分割数据,分割成一个一个 chunk 发送给服务端,
那么 -- 用于区分数据快,而后面的数据 ------WebKitFormBoundaryOGkWPJsSaJCPWjZP
就是标示区分包作用。

0x05.text/xml

微信用的是这种数据格式发送请求的。

POST http://www.homeway.me HTTP/1.1 
Content-Type: text/xml

<?xml version="1.0"?>
<resource>
    <id>123</id>
    <params>
        <name>
            <value>homeway</value>
        </name>
        <age>
            <value>22</value>
        </age>
    </params>
</resource>

php$_POST 只能读取 application/x-www-form-urlencoded 数据,$_FILES 只能读取 multipart/form-data 类型数据,那么,要读取 text/xml 格式的数据,可以用:

file=fopen(‘php://input′,‘rb′);
data = fread(file,length);
fclose(file);

或者

$data = file_get_contents(‘php://input’);

0x06.application/json

通过 json 形式将数据发送给服务器,一开始,我尝试通过 curl,给服务器发送application/json 格式包,然而我收到的数据如下:

————————–e1e1406176ee348a 
Content-Disposition: form-data; name=”nid” 2 ————————–e1e1406176ee348a 
Content-Disposition: form-data; name=”uuid” cf9dc994-a4e7-3ad6-bc54-41965b2a0dd7 ————————–e1e1406176ee348a 
Content-Disposition: form-data; name=”access_token” 956731586df41229dbfec08dd5d54eedb98d73d2 ————————–e1e1406176ee348a–

后来想想明白了,HTTP 通信中并不存在所谓的 json,而是将 string 转成 json 罢了,也就是,application/json 可以将它理解为 text/plain,普通字符串。

之所以出现那么多乱七八糟的 ------- 应该是 php 数组传输进去,存在的转换问题吧(我目前能想到的原因)。

本文出自 夏日小草,转载请注明出处:http://homeway.me/2015/07/19/understand-http-about-content-type/

iOS 通过 POST 上传图片

iOS 上传图片以 multipart/form-data 进行上传。

  1. 使用 URLRequest
func uploadAvatar() {
    var request  = URLRequest(url: URL(string: "https://xxxxx")!)
    request.httpMethod = "POST"
    let boundary = "Boundary-\(UUID().uuidString)"
    let params = ["userId": "123", "token": "xxxxxxx"]
    request.setValue("multipart/form-data; boundary=\(boundary)", forHTTPHeaderField: "Content-Type")
    request.httpBody = createBody(parameters: params,
                            boundary: boundary,
                            data: UIImageJPEGRepresentation(chosenImage, 1.0)!,
                            mimeType: "image/jpg",
                            filename: "avatar.jpg")
}
func createBody(parameters: [String: String],
                boundary: String,
                data: Data,
                mimeType: String,
                filename: String) -> Data {
    let body = NSMutableData()
    
    let boundaryPrefix = "--\(boundary)\r\n"
    
    for (key, value) in parameters {
        body.appendString(boundaryPrefix)
        body.appendString("Content-Disposition: form-data; name=\"\(key)\"\r\n\r\n")
        body.appendString("\(value)\r\n")
    }
    
    body.appendString(boundaryPrefix)
    body.appendString("Content-Disposition: form-data; name=\"file\"; filename=\"\(filename)\"\r\n")
    body.appendString("Content-Type: \(mimeType)\r\n\r\n")
    body.append(data)
    body.appendString("\r\n")
    body.appendString("--".appending(boundary.appending("--")))
    
    return body as Data
}
extension NSMutableData {
    func appendString(_ string: String) {
        let data = string.data(using: String.Encoding.utf8, allowLossyConversion: false)
        append(data!)
    }
}
  1. 使用 Moya
/// 实际网络请求对象
var task: Task {
    switch self {
    case .uploadAvatar(let model):
        guard let data = model.data else { return .request }
        let token = "xxxxxx".data(using: String.Encoding.utf8, allowLossyConversion: false)
        let userId = "123".data(using: String.Encoding.utf8, allowLossyConversion: false)
        let tokenData = MultipartFormData(provider: .data(token!), name: "token")
        let userIdData = MultipartFormData(provider: .data(userId!), name: "userId")
        let imgData = MultipartFormData(provider: .data(data), name: "file", fileName: "avatar.jpg", mimeType: "image/jpg")
        return .upload(.multipart([userIdData, tokenData, imgData]))
    default:
        return .request
    }
}

参考

推荐阅读更多精彩内容

  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 89,209评论 13 123
  • 整体Retrofit内容如下: 1、Retrofit解析1之前哨站——理解RESTful2、Retrofit解析2...
    隔壁老李头阅读 6,733评论 4 30
  • # 一度蜜v3.0协议 --- # 交互协议 [TOC] ## 协议说明 ### 请求参数 下表列出了v3.0版协...
    c5e350bc5b40阅读 155评论 0 0
  • HTTP全称为HyperText Transfer Protocol,从名字不难看出这是一种基于文本的网络协议,对...
    MrPeak阅读 880评论 3 20
  • 取前3个字符 取后3个字符 遍历字符串 插入字符串 替换字符串 字符串切片,获取interesting 字符串切片...
    Rocherster阅读 645评论 0 2