httplib2---python下的http请求终结者(转)

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)来查看