Python： httplib2模块

yxsailing

　　[+]
　　httplib2功能介绍：http://code.google.com/p/httplib2/
　　httplib2实例页面：http://code.google.com/p/httplib2/w/list
　　httplib2问题提交：http://code.google.com/p/httplib2/issues/list
　　好吧，我觉得官方的样例还是比较全的，这里就直接贴一下吧。

Simple Retrieval
　　

[python] view plaincopy

• import httplib2
  
• h = httplib2.Http(".cache")
  
• resp, content = h.request("http://example.org/", "GET")
  

　　

Authentication
　　

[python] view plaincopy

• import httplib2
  
• h = httplib2.Http(".cache")
  
• h.add_credentials('name', 'password')
  
• resp, content = h.request("https://example.org/chap/2",   ##ssl + base认证
  
•     "PUT", body="This is text",
  
•     headers={'content-type':'text/plain'} )
  

　　

Cache-Control
　　

[python] view plaincopy

• import httplib2
  
• h = httplib2.Http(".cache")
  
• resp, content = h.request("http://bitworking.org/")  #请求被缓存，下次还会用这个缓存而不去发送新的请求，缓存生效时间有web配置决定
  
• ...
  
• resp, content = h.request("http://bitworking.org/",
  
•     headers={'cache-control':'no-cache'})   ##设置不用缓存，当次将不用缓存，而是直接发一个新的请求
  

　　

Forms
　　

[python] view plaincopy

• >>> from httplib2 import Http
  
• >>> from urllib import urlencode
  
• >>> h = Http()
  
• >>> data = dict(name="Joe", comment="A test comment")
  
• >>> resp, content = h.request("http://bitworking.org/news/223/Meet-Ares", "POST", urlencode(data))
  
• >>> resp
  
• {'status': '200', 'transfer-encoding': 'chunked', 'vary': 'Accept-Encoding,User-Agent',
  
• 'server': 'Apache', 'connection': 'close', 'date': 'Tue, 31 Jul 2007 15:29:52 GMT',
  
• 'content-type': 'text/html'}
  

　　

Cookies
　　

[python] view plaincopy

• #!/usr/bin/env python
  
• 
  
• import urllib
  
• import httplib2
  
• 
  
• http = httplib2.Http()
  
• 
  
• url = 'http://www.example.com/login'
  
• body = {'USERNAME': 'foo', 'PASSWORD': 'bar'}
  
• headers = {'Content-type': 'application/x-www-form-urlencoded'}
  
• response, content = http.request(url, 'POST', headers=headers, body=urllib.urlencode(body))
  
• 
  
• headers = {'Cookie': response['set-cookie']}   ###将获得cookie设置到请求头中，以备下次请求使用
  
• 
  
• url = 'http://www.example.com/home'
  
• response, content = http.request(url, 'GET', headers=headers)  ##本次请求就不用带用户名，密码了
  

　　

Proxies
　　

[python] view plaincopy

• import httplib2
  
• import socks      ##需要第三方模块
  
• 
  
• httplib2.debuglevel=4
  
• h = httplib2.Http(proxy_info = httplib2.ProxyInfo(socks.PROXY_TYPE_HTTP, 'localhost', 8000))
  
• r,c = h.request("http://bitworking.org/news/")
  

　　

　　======================================================================================
　　下面是我自己对模块功能的尝试：

[python] view plaincopy

•    Http对象的构造方法：
  
•    __init__(self, cache=None, timeout=None, proxy_info=None, ca_certs=None, disable_ssl_certificate_validation=False)
  
•        proxy_info 的值是一个 ProxyInfo instance.
  
• |
  
• |      'cache'：
  
•         存放cache的位置，要么为字符串，要么为支持文件缓存接口的对象
  
• |
  
• |      timeout：
  
•         超时时间，默认时会取python对socket链接超时的值
  
• |
  
• |      ca_certs：
  
•         一个用于ssl服务器认证用的包涵了主CA认证的文件路径，默认会使用httplib2绑定的证书
  
• |
  
• |      disable_ssl_certificate_validation：
  
•         确定是否进行ssl认证
  
• |
  
• |  add_certificate(self, key, cert, domain)
  
• |      添加一个ssl认证key和文件
  
• |
  
• |  add_credentials(self, name, password, domain='')
  
• |      添加一个用户名，密码信息
  
• |
  
• |  clear_credentials(self)
  
• |      删除掉所有的用户名，密码信息，貌似还是可以存多个用户名和密码
  
• 
  
• 
  
•    Http.request(self, uri, method='GET', body=None, headers=None, redirections=5, connection_type=None)
  
•    说明：
  
•    执行单次的http请求
  
• 
  
•    uri：
  
•    一个以'http' 或 'https'开头的资源定位符字串，必须是一个绝对的地址
  
• 
  
•    method：
  
•    支持所有的http请求方式。如： GET, POST, DELETE, etc..
  
• 
  
•    body：
  
•    请求的附件数据，一个经过urllib.urlencode编码的字符串
  
• 
  
•    headers：
  
•    请求头信息，一个字典对象
  
• 
  
•    redirections：
  
•    最大的自动连续的重定向次数默认为5
  
• 
  
•    返回：
  
•    (response, content)元组，response是一个httplib2.Response对象，content就是包含网页源码的字符串
  
• 
  
• 
  
•    httplib2.Response对象
  
•    其实就是一个包含所有头信息的字典，因为它本身就是集成自字典对象的
  

　　
另外，httplib2模块本身还有其它的对象或属性，可以通过print dir(httplib2)来查看