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
- import httplib2
- h = httplib2.Http(".cache")
- resp, content = h.request("http://example.org/", "GET")
Authentication
- 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
- 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
- >>> 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
- #!/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
- 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/")
======================================================================================
下面是我自己对模块功能的尝试:
- 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)来查看