Python之Requests库

安装

pip install requests

Response对象

Response对象包含服务器返回的所有信息，也包含请求的Request信息

Requests库的2个重要对象@2x.png

Response 对象的属性

属性	说明
r.status_code	HTTP请求的返回状态，200表示连接成功，404表示失败
r.text	HTTP响应内容的字符串形式，即，url对应的页面内容
r.encoding	从HTTP header中猜测的响应内容编码方式
r.apparent_encoding	从内容中分析出的响应内容编码方式(备选编码方式)
r.content	HTTP响应内容的二进制形式

Response 对象的属性@2x.png

Response 对象的编码

• r.encoding:如果header中不存在charset，则认为编码为ISO‐8859‐1 r.text根据r.encoding显示网页内容
• r.apparent_encoding:根据网页内容分析出的编码方式 可以看作是r.encoding的备选

Requests 库的异常

异常	说明
requests.ConnectionError	网络连接错误异常，如DNS查询失败、拒绝连接等
requests.HTTPError	HTTP错误异常
requests.URLRequired	URL缺失异常
requests.TooManyRedirects	超过最大重定向次数，产生重定向异常
requests.ConnectTimeout	连接远程服务器超时异常
requests.Timeout	请求URL超时，产生超时异常
r.raise_for_status()	如果不是200，产生异常 requests.HTTPError

• r.raise_for_status()在方法内部判断r.status_code是否等于200，不需要 增加额外的if语句，该语句便于利用try‐except进行异常处理

try:
    r = requests.get("http://www.baidu.com/")
    r.raise_for_status()
    r.encoding = r.apparent_encoding
    print(r.text)
except:
    print("产生异常")

HTTP协议 与 Requests库

HTTP协议方法	Requests库方法	功能一致性
GET	requests.get()	一致
HEAD	requests.head()	一致
POST	requests.post()	一致
PUT	requests.put()	一致
PATCH	requests.patch()	一致
DELETE	requests.delete()	一致

• GET 请求获取URL位置的资源
• HEAD 请求获取URL位置资源的响应消息报告，即获得该资源的头部信息
• POST 请求向URL位置的资源后附加新的数据
• PUT 请求向URL位置存储一个资源，覆盖原URL位置的资源
• PATCH 请求局部更新URL位置的资源，即改变该处资源的部分内容
• DELETE 请求删除URL位置存储的资源

PATCH 和 PUT 的区别

假设URL位置有一组数据UserInfo，包括UserID、UserName等20个字段
需求:用户修改了UserName，其他不变

• 采用PATCH，仅向URL提交UserName的局部更新请求
• 采用PUT，必须将所有20个字段一并提交到URL，未提交字段被删除 PATCH的最主要好处:节省网络带宽

Requests 库的7个主要方法

方法	说明
requests.request()	构造一个请求，支撑以下各方法的基础方法
requests.get()	获取HTML网页的主要方法，对应于HTTP的GET
requests.head()	获取HTML网页头信息的方法，对应于HTTP的HEAD
requests.post()	向HTML网页提交POST请求的方法，对应于HTTP的POST
requests.put()	向HTML网页提交PUT请求的方法，对应于HTTP的PUT
requests.patch()	向HTML网页提交局部修改请求，对应于HTTP的PATCH
requests.delete()	向HTML页面提交删除请求，对应于HTTP的DELETE

requests.request()

requests.request(method, url, **kwargs)

• method : 请求方式，对应get/put/post等7种
  • r = requests.request('GET', url, **kwargs)
  • r = requests.request('HEAD', url, **kwargs)
  • r = requests.request('POST', url, **kwargs)
  • r = requests.request('PUT', url, **kwargs)
  • r = requests.request('PATCH', url, **kwargs)
  • r = requests.request('delete', url, **kwargs) r = requests.request('OPTIONS', url, **kwargs)
• url : 拟获取页面的url链接
• **kwargs :控制访问的参数，共13个，均为可选项
  • params : 字典或字节序列，作为参数增加到url中
  • data : 字典、字节序列或文件对象，作为Request的内容
  • json : JSON格式的数据，作为Request的内容
  • headers : 字典，HTTP定制头
  • cookies : 字典或CookieJar，Request中的cookie
  • auth : 元组，支持HTTP认证功能
  • files : 字典类型，传输文件
  • timeout : 设定超时时间，秒为单位
  • proxies : 字典类型，设定访问代理服务器，可以增加登录认证
  • allow_redirects : True/False，默认为True，重定向开关
  • stream : True/False，默认为True，获取内容立即下载开关
  • verify : True/False，默认为True，认证SSL证书开关
  • cert : 本地SSL证书路径

requests.get()

requests.get(url, params=None, **kwargs)

• url : 拟获取页面的url链接
• params : url中的额外参数，字典或字节流格式，可选
• **kwargs: 12个控制访问的参数

requests.head()

requests.head(url, **kwargs)

• url : 拟获取页面的url链接
• **kwargs: 12个控制访问的参数

requests.post()

requests.post(url, data=None, json=None, **kwargs)

• url : 拟更新页面的url链接
• data : 字典、字节序列或文件，Request的内容
• json : JSON格式的数据，Request的内容
• **kwargs: 12个控制访问的参数

requests.put()

requests.put(url, data=None, **kwargs)

• url : 拟更新页面的url链接
• data : 字典、字节序列或文件，Request的内容
• **kwargs: 12个控制访问的参数

requests.patch()

requests.patch(url, data=None, **kwargs)

• url : 拟更新页面的url链接
• data : 字典、字节序列或文件，Request的内容
• **kwargs: 12个控制访问的参数

requests.delete()

requests.delete(url, **kwargs)

• url : 拟删除页面的url链接
• **kwargs: 12个控制访问的参数