HTTP(HyperText Transfer Protocol,超文本传输协议),是客户端和服务器之间的一种数据传输协议。
- 浏览器:用户输入网址后回车或点击链接->DNS查询->浏览器拼装HTTP报文并发送请求给服务器->服务器处理请求后发送响应报文给浏览器 -> 浏览器解析响应报文并使用渲染引擎显示
- 手机APP:用户点击或界面自动触发联网->代码调用拼装HTTP报文并发送请求到服务器->服务器处理请求后发送响应报文给手机->代码处理响应报文并作出相应处理(存储、展示、加工等)
URI,Uniform Resource Identifier ,统一资源标识符。
URL,Uniform Resource Locator,统一资源定位符。描述了一台特定服务器上某资源的特定位置。它分为三部分:协议类型、服务器地址(和端口号)、路径Path。一般遵循语法:协议类型://服务器地址[:端口号]/路径
。比如:https://baidu.com/x/yy
分为2种:请求报文、响应报文
GET /users HTTP/1.1
Host: api.github.com
Content-Type: text/plain
Content-Length: 243
fafasfajfhajfjas
- 第一行是请求行
- method: GET
- path: /users
- HTTP version : HTTP/1.1
- 第2、3、4行是Header
- 最后一行是Body
HTTP/1.1 200 0K
content-type: application/ json; charset=utf-8
cache-control: public, max-age=60, s-maxage=60
vary: Accept , Accept-Encoding
etag: W/"Ø2eec5b334bØe4c05253d3f4138daa46"
content-encoding: gzip
{"data":...}
- 第一行的状态行
- HTTP version : HTTP/1.1
- status code : 200
- status message : OK
- 第2、3、4、5、6行是header
- 最后一行是Body
HTTP1.0 定义了三种请求方法: GET, POST 和 HEAD方法。
HTTP1.1 新增了六种请求方法:OPTIONS、PUT、PATCH、DELETE、TRACE 和 CONNECT 方法。
下面我们来讲讲常用的GET、POST、PUT、DELETE、HEAD
GET请求用于获取资源,对服务器数据不进行修改,不发送Body。
GET /users/1 HTTP/1.1
Host: api.github.com
对应的Retrofit代码:
@GET("/users/{id}")
Call<User> getUser(@Path("id") String id,@Query("gender") String gender);
POST用于增加或修改资源,发送给服务器的内容写在Body里面。
POST /users HTTP/1.1
Host: api.github.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 13
name=xfhy&gender=male
对应Retrofit代码
@FormUrlEncoded
@POST("/users")
Call<User> addUser(@Field("name") String name,@Field("gender") String gender);
PUT用于修改资源,发送给服务器的内容写在Body里面
PUT /useers/1 HTTP/1.1
Host: api.github.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 13
gender=male
对应Retrofit代码:
@FormUrlEncoded
@PUT("users/{id}")
Call<User> updateGender(@Path("id") String id,@Field("gender") String gender);
DELETE用于删除资源,不发送Body。
DELETE /users/1 HTTP/1.1
Host: api.github.com
对应Retrofit代码:
@DELETE("/users/{id}")
Call<User> getUser(@Path("id") String id,@Query("gender") String gender);
HEAD方法与GET类似,但是服务器只会返回首部,不会返回Body。
作用:
- 在不获取资源的情况下了解资源的情况(比如,判断其类型)
- 通过查看响应中的状态码,查看资源是否存在
- 通过查看首部,测试资源是否被修改
状态码是三位数字,用于对响应结果做出类型化描述(如「获取成功」「内容未找到」)
- 1xx: 临时性消息。 如:100(继续发送)、101(正在切换协议)
- 2xx: 成功。如200(OK)、201(创建成功)
- 3xx:重定向。如301(永久移动)、302(暂时移动)、304(内容未改变)
- 4xx:客户端错误。如400(客户端请求错误)、401(认证失败)、403(被禁止)、404(找不到内容)
- 5xx:服务器错误。如500(服务器内部错误)
HTTP协议的请求和响应报文中必定包含HTTP首部,也就是Header。HTTP消息的元数据(metadata),有些东西放Body里面不合理,放Header里面就刚好。
下面来介绍一些常见的Header:
目标主机。这个Host不是在网络上用于寻址的,而是在目标服务器上用于定位子服务器的。
指定Body的类型,主要有4类:
- text/html
- x-www-form-urlencoded
- multipart/form-data
- application/json,image/jpeg,application/zip ...
请web页面返回响应的类型,Body中返回HTML文本。格式如下:
HTTP/1.1 200 OK
Content-Type: text/html; charset=utf-8
Content-Length: 432
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
......
web页面纯文本表单的提交方式
POST /users/ HTTP/1.1
Host: api.github.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 21
name=xfhy&gender=male
对应Retrofit代码:
@FormUrlEncoded
@POST("/users")
Call<User> addUser(@Field("name") String name,@Field("gender") String gender);
web页面含有二进制文件时的提交方式,比如同时提交一个文件+文件名。
POST /users HTTP/1.1
Host: api.github.com
Content-Type: multipart/form-data; boundary=---- WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Length: 2382
------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="name"
xfhy
------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="avatar";
filename="avatar.jpg"
Content-Type: image/jpeg
JFIFHHvOwX9jximQrWa......
------WebKitFormBoundary7MA4YWxkTrZu0gW--
其中boundary是分割符的意思,参数的名称是name,值是xfhy。
对应Retrofit代码:
@Multipart
@POST("/users")
Call<User> addUser(@Part("name") RequestBody name,@Part("avatar") RequestBody avatar);
...
RequestBody namePart = RequestBody.create(MediaType.parse("text/plain"), nameStr);
RequestBody avatarPart = RequestBody.create(MediaType.parse("image/jpeg"), avatarFile);
api.addUser(namePart, avatarPart);
单项内容(文本或非文本都可以),用于Web Api的响应或者POST、PUT的请求
请求中提交JSON
POST /users HTTP/1.1
Host: api.github.com
Content-Type: application/json; charset=utf-8
Content-Length: 38
{"data":"xxxx"}
对应Retrofit代码:
@POST("/users")
Call<User> addUser(@Body("user") User user);
...
//需要使用JSON相关的Converter,Retrofit才会帮我们把JSON转为User
api.addUser(user);
响应中返回JSON:
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Content-Length: 234
{"data":"wocao"}
请求中提交二进制内容:
POST /user/1/avatar HTTP/1.1
Host: api.github.com
Content-Type: image/jpeg
Content-Length: 3132
JHFFGJFHJVVJ&...
对应Retrofit代码:
@POST("users/{id}/avatar")
Call<User> updateAvatar(@Path("id") String id,@Body RequestBody avatar);
...
RequestBody avatarBody = RequestBody.create(MediaType.parse("image/jpeg"), avatarFile);
api.updateAvatar(id, avatarBody)
响应中返回二进制内容:
HTTP/1.1 200 OK
Content-Type: image/jpeg
Content-Length: 7989
JGGJHGGHJ6768....
指定Body的长度(字节)。
用于当响应发起时,内容长度还没确定的情况下。和Content-Length不同时使用。用途是尽早给出响应,减少用户等待。
格式:
HTTP/1.1 200 OK
Content-Type: text/html
Transfer-Encoding: chunked
2
aa
2
dd
6
fafafs
0
指定重定向的目标URL
用户代理,即是谁实际发送请求、接受响应的,例如手机浏览器、某款app。
按范围取数据(比如在断点续传时)。
- Accept-Range: bytes 响应报文中出现,表示服务器支持按字节来取范围数据
- Range: bytes=- 请求报文中出现,表示要取哪段数据
- Content-Range: -/total 响应报文中出现,表示发送的是哪段数据
作用: 断点续传、多线程下载。
- Accept:客户端能接受的数据类型。如text/html
- Accept-Charset: 客户端接受的字符集。如utf-8
- Accept-Encoding: 客户端接受的压缩编码类型。如gzip
- Content-Encoding: 压缩类型。如gzip
作用: 在客户端或中间网络节点缓存数据,降低从服务器取数据的频率,以提高网络性能。