python模块介绍-httplib:HTTP协议客户端和HTTPS协议客户端

python模块介绍-httplib:HTTP协议客户端 

注意:httplib模块在Python3.0中已更名为http.client。2to3脚本会自动修改import当你的源代码转换时到3.0时。

httplib实现了HTTP和HTTPS的客户端协议,一般不直接使用,在python更高层的封装模块中(urllib,urllib2)使用了它的HTTP和HTTPS实现。其中HTTPS需要socket编译了SSL支持。HTTP类仅仅是和python1.5.2及以前的版本兼容,不推荐使用。

代码:Lib/httplib.py

接口

基本类

  • class httplib.HTTPConnection(host[, port[, strict[, timeout[, source_address]]]]) :

HttpConnection的实例表示与HTTP服务器的事务。实例化时需要传递主机和可选的端口号。如果没有端口号,试图以host:port格式从主机字符串提取,如果提取失败则使用默认的HTTP端口(80)。参数strict默认为false,表示在无法解析状态行时(status line)不能被HTTP/1.0或1.1解析时不抛出BadStatusLine异常;可选参数timeout表示即阻塞在多少秒后超时,如果没有给出默认使用全局超时设置。可选参数source_address表示HTTP的源地址(host, port)。

timeout为2.6添加,source_address为2.7添加。

1
>>>  import  httplib>>> h1  =  httplib.HTTPConnection( 'automationtesting.sinaapp.com' )>>> h1  =  httplib.HTTPConnection( 'automationtesting.sinaapp.com:80' )>>> h1  =  httplib.HTTPConnection( 'automationtesting.sinaapp.com' , 80 )>>> h1  =  httplib.HTTPConnection( 'automationtesting.sinaapp.com' , 80 , timeout = 10 )
  • class httplib.HTTPSConnection(host[, port[, key_file[, cert_file[, strict[, timeout[, source_address]]]]]])

HttpConnection的子类,使用SSL与安全服务器通信。默认端口为443。key_file是包含PEM格式私钥的文件名称。 cert_file中是PEM格式的证书链文件。

注意不支持验证服务器的证书。timeout为2.6添加,source_address为2.7添加。

  • class httplib.HTTPResponse(sock, debuglevel=0, strict=0)

实例连接成功之后返回的类,不能由用户实例化。

  • class httplib.HTTPMessage

HTTPMessage实例用于保存HTTP响应头。它使用mimetools.Message类实现,并提供了处理HTTP头的工具函数。它不直接实例化的用户。不能由用户实例化。

异常

  • exception httplib.HTTPException

Exception的子类,此模块中的其他异常的基类。下面的类默认是该类的直接子类。

  • httplib.NotConnected

  • httplib.InvalidURL

  • httplib.UnknownProtocol

  • httplib.UnknownTransferEncoding

  • httplib.UnimplementedFileMode

  • httplib.IncompleteRead

  • httplib.ImproperConnectionState

  • httplib.CannotSendRequest

ImproperConnectionState的一个子类。

  • httplib.CannotSendHeader

ImproperConnectionState的一个子类。

  • httplib.ResponseNotReady

ImproperConnectionState的一个子类。

  • httplib.BadStatusLine

服务器返回的HTTP状态码不认识时产生。

常量和类变量

  • httplib.HTTP_PORT:HTTP协议的默认端口,恒为80。

  • httplib.HTTPS_PORT:HTTPS协议的默认端口,恒为443。

  • httplib.responses:映射HTTP1.1状态代码映射到W3C的名字的字典。2.5新增

1
>>> httplib.responses[httplib.NOT_FOUND] 'Not Found'

HTTPConnection类的方法

  • HTTPConnection.request(method, url[, body[, headers]])

发送请求HTTP请求到服务器,使用方法method和指定的地址url。如果有body,一般是字符串数据,将在headers之后发送。当然body也可以是支持fileno()和read()方法的文件对象,这时会发送文件内容。header内容长度会自动填充为正确的值,headers是额外HTTP头的映射,会和请求一起发送。2.6开始支持文件对象。

  • HTTPConnection.getresponse()

用于在请求发送以后从服务器端获取响应。返回HTTPResponse实例。注意发送下一条请求之前必须读完整个响应。

  • HTTPConnection.set_debuglevel(level)

设置调试级别(调试输出打印量)。默认的调试级别为0 ,表示没有调试输出打印。

  • HTTPConnection.set_tunnel(host, port=None, headers=None)

设置HTTP连接隧道的主机和端口。需要通过代理服务器做HTTPS连接时使用。header参数必须为额外HTTP头的映射随CONNECT一起发送。2.7新增。

  • HTTPConnection.connect()

对象创建之后连接到指定的服务器。

  • HTTPConnection.close()

关闭到服务器的连接。

下面四个函数可以代替request()一步步发送请求。

  • HTTPConnection.putrequest(request, selector[, skip_host[, skip_accept_encoding]])

连接到服务器后的第一个调用。它发送由request字符串,selector字符串, HTTP版本(HTTP/1.1)的行数据到服务器。设置skip_host为非Fasle值可禁用自动发送主机,设置skip_accept_encoding为非Fasle值可禁用接受编码。skip_accept_encoding为2.4添加。

  • HTTPConnection.putheader(header, argument[, ...])

发送一个RFC 822样式头到服务器。它发送由header,一个冒号和一个空格,第一个参数到服务器。如果有更多参数会发送多行,每行由一个tab和一个参数组成。

  • HTTPConnection.endheaders(message_body=None)

发送空行到服务器,指示header的结束。可选的optional message_body参数可以用来传递与请求相关的消息体。消息体如果是字符串将在消息头的包发送,如果它是字符串,否则用单独数据包。2.7加入message_body。

  • HTTPConnection.send(data)

将数据发送到服务器。endheaders()之后,getresponse()之前使用。

HTTPResponse类的方法

  • HTTPResponse.read([amt])

读取并返回response的body,或下面的amt字节。

  • HTTPResponse.getheader(name[, default])

获得头名,如果没有匹配的头返回default。

  • HTTPResponse.getheaders()

返回(header, value)元组构成的列表。2.4新增。

  • HTTPResponse.fileno()

返回底层套接字的的fileno。

  • HTTPResponse.msg

包含响应头的mimetools.Message实例。

  • HTTPResponse.version

服务器使用的HTTP协议版本。10表示HTTP/1.011表示HTTP/1.1。

  • HTTPResponse.status

由服务器返回的状态代码。

  • HTTPResponse.reason

服务器的原因短语。

实例

HTTP GET

1
2
3
#!/usr/bin/env python# -*- coding: utf-8 -*-import httplibconn = httplib.HTTPConnection("www.python.org")conn.request("GET", "/index.html")r1 = conn.getresponse()print r1.status, r1.reason#data1 = r1.read()print data1
conn.request( "GET" "/parrot.spam" )r2  =  conn.getresponse() print  r2.status, r2.reason
data2  =  r2.read() #print data2conn.close()

执行结果

1
2
3
# ./http_get.py 
200 OK
404 Not Found

HTTP HEAD

注意HEAD不会返回任何数据。

1
2
#!/usr/bin/env python# -*- coding: utf-8 -*-import httplibconn = httplib.HTTPConnection("www.python.org")conn.request("HEAD","/index.html")res = conn.getresponse()print res.status, res.reason
data  =  res.read() print  len (data) print  data  = =  ''conn.close()

执行结果

1
2
3
4
# ./http_head.py 
200 OK
0
True

HTTP POST

1
2
3
4
#!/usr/bin/env python# -*- coding: utf-8 -*-import httplib, urllibparams = urllib.urlencode({'@number': 12524, '@type': 'issue', '@action': 'show'})headers = {"Content-type": "application/x-www-form-urlencoded",
     "Accept" "text/plain" }conn  =  httplib.HTTPConnection( "bugs.python.org" )conn.request( "POST" , "", params, headers)response  =  conn.getresponse() print  response.status, response.reason
data  =  response.read() print  data
conn.close()

执行结果

1
2
3
4
# ./http_head.py 
# ./test.py 
302 Found
Redirecting to <a href= "http://bugs.python.org/issue12524" >http: //bugs .python.org /issue12524 < /a >

HTTP PUT

客户端的HTTP PUT请求和POST类似。不同之处在于服务器端允许PUT创建资源。

1
>>>  # This creates an HTTP message>>> # with the content of BODY as the enclosed representation>>> # for the resource http://localhost:8080/foobar...>>> import httplib>>> BODY = "***filecontents***">>> conn = httplib.HTTPConnection("localhost", 8080)>>> conn.request("PUT", "/file", BODY)>>> response = conn.getresponse()>>> print resp.status, response.reason200, OK


相关实例应用

客户端的HTTP PUT请求和POST类似。不同之处在于服务器端允许PUT创建资源。

1



举例1 http对象定义:
#!/usr/bin/env python
# coding: gbk

import os  
import httplib  
import socket  
import urllib
import json

class HTTPClient( object ):
    """
        http通讯协议,客户端常用方法
    """
    # Client对象属性
    host=None
    port=None
    timeout=None
    METHOD = "POST" # 默认为POST方式提交
    # http头信息
    HEADERS = { "Content-Type": "application/x-www-form-urlencoded"
    }
    # Client对象行为
    def __init__( self, host, port=8080, timeout=60):
        self.host = host
        self.port = port
        self.timeout = timeout
        
    def get_conn( self ):
        """
            获取http连接对象
        """
        conn = None
        try:
            conn = httplib.HTTPConnection( self.host, self.port, timeout=self.timeout)
            return conn
        except:
            raise
    
    def request( self, conn, url, params, method=None, headers=None):
        """
            发送请求
        """
        try:
            if not method:
                method = self.METHOD
            if not headers:
                headers = self.HEADERS
            if type( headers ) != dict:
                raise RuntimeError( "headers数据异常" )
                
            if not headers.has_key( "Content-Type" ):
                headers.update( self.HEADERS )
                
            if method == 'POST':
                ctype = headers.get( 'Content-Type' ).upper()
                if 'application/x-www-form-urlencoded'.upper() in ctype:
                    params  = urllib.urlencode( params ) # params要求是字典
                    conn.request( method, url, params, headers)
                elif 'application/json'.upper() in ctype:
                    params = json.dumps( params ) # 默认encoding utf-8
                    headers = {
                        "Content-Type" : ctype
                    }
                    conn.request( method, url, params, headers)
                elif 'text/xml'.upper() in ctype:
                    headers = {
                        "Content-Type" : ctype
                    }
                    conn.request( method, url, params, headers)
                else:
                    raise RuntimeError( "暂不支持[%s]类请求" % ctype )
            elif method == 'GET':
                params = urllib.urlencode( params )  # params要求是字典
                _url = "%s?%s" % ( url, params )
                conn.request( method, _url, None, headers )
            else:
                raise RuntimeError( "暂不支持[%s]类请求" % method )
            resp = conn.getresponse()
            return resp
        except:
            raise
        
    def close_conn( self, conn ):
        """
            关闭连接
        """
        conn.close()




def test( host ):
    import hashlib
    conn = None
    try:
        client = HTTPClient( host, port='9077' ) # 获取https客户端对象
        conn = client.get_conn() # 获取连接对象
        secret = '8d939eabe1839d3784cb28de32b0a092'
        aid    = '99990001'
        d = {
            "header":{ "version":"1.0", "method":"create"},
            "data":{
                "aid":"99990001",
                "desc":"30#啤酒500箱,立即发货".decode("gbk").encode("utf-8"),
                "logid":"13911119999",
                "amount":"000000000100",
                "localtime":"20141120201120",
                "orderid":"20150108101110",
                "callback": urllib.unquote( "https://46.17.189.110/ordernotice" )
            }
        }
        
        hash = hashlib.md5()
        
        hash.update( '%s%s%s%s' % ( secret, d['data']['orderid'], d['data']['amount'], d['data']['callback'] ) )
        d['data']['token'] = hash.hexdigest()
        url="/callback/khzf"
        
        
        # 支付订单查询
        headers = { 'Content-Type' : "text/xml"}
        d = """<?xml version="1.0" encoding="GBK"?><packet><transName>KHCS</transName><Plain>BTermSsn=140918000000|ETermSsn=140918112019|MercCode=983708160002901|OTranAbbr=KHZF</Plain><Signature>12fec0b699ccdd97696cc855147221c418532a9ba9b6ad22be21d7f78f6ed580b22931ff6be69769e18b262e9986595c6a854825a840febf48d9e2316e2a8de722c28f035cd61ebd20ad99329e046e84f0f17d57bb0f22a83019976d7c446cfb5f7190c4365e4f078bc5933b436ac0c742824de0576cc8cb4c859f8c8452f31d</Signature></packet>"""
        resp = client.request( conn, url, d, headers=headers, method="POST" )
        
        print resp.status, resp.reason
        
    except RuntimeError, e:
        print e
    finally:
        if conn: conn.close()
        
if __name__ == '__main__':
    test( '42.96.249.190' )


举例2 https对象定义:
#!/usr/bin/env python
# coding: gbk




import os  
import httplib  
import socket  
import urllib
import json
from jnxlk_utils import str_to_dic




class HTTPSClient( object ):
    """
        https 通讯,客户端常用方法
    """
    # Client对象属性
    host=None
    port=None
    key_file=None
    cert_file=None
    timeout=None
    METHOD = "POST" # 默认为POST方式提交
    # http头信息
    HEADERS = { "Content-Type": "application/x-www-form-urlencoded"
    }
    # Client对象行为
    def __init__( self, host, port=443, key_file=None, cert_file=None, timeout=60):
        self.host = host
        self.port = port
        self.key_file = key_file
        self.cert_file = cert_file
        self.timeout = timeout
        
    def get_conn( self ):
        """
            获取http连接对象
        """
        conn = None
        try:
            conn = httplib.HTTPSConnection( self.host, self.port, self.key_file, self.cert_file, timeout=self.timeout)
            return conn
        except:
            raise
    
    def request( self, conn, url, params, method=None, headers=None):
        """
            发送请求
        """
        try:
            if not method:
                method = self.METHOD
            if not headers:
                headers = self.HEADERS
            if type( headers ) != dict:
                raise RuntimeError( "headers数据异常" )
                
            if not headers.has_key( "Content-Type" ):
                headers.update( self.HEADERS )
                
            if method == 'POST':
                ctype = headers.get( 'Content-Type' ).upper()
                if 'application/x-www-form-urlencoded'.upper() in ctype:
                    params  = urllib.urlencode( params ) # params要求是字典
                    conn.request( method, url, params, headers)
                elif 'application/json'.upper() in ctype:
                    params = json.dumps( params ) # 默认encoding utf-8
                    headers = {
                        "Content-Type" : ctype
                    }
                    conn.request( method, url, params, headers)
                elif 'text/xml'.upper() in ctype:
                    headers = {
                        "Content-Type" : ctype
                    }
                    conn.request( method, url, params, headers)
                else:
                    raise RuntimeError( "暂不支持[%s]类请求" % ctype )
            elif method == 'GET':
                params = urllib.urlencode( params )  # params要求是字典
                _url = "%s?%s" % ( url, params )
                conn.request( method, _url, None, headers )
            else:
                raise RuntimeError( "暂不支持[%s]类请求" % method )
            resp = conn.getresponse()
            return resp
        except:
            raise
        
    def close_conn( self, conn ):
        """
            关闭连接
        """
        conn.close()


举例3 http通讯应用:
# coding: gbk




import os  
import httplib  
import socket  
import urllib
from http_client import HTTPClient
from uni.apis.utils import ftp_put, ftp_get
from uni.core import logp
from shangjie.conf import settings




  
__all__ = ["SignVerify"]




class SignVerify( object ):
    
    """
        证书验证类
        url="/jnhxsdgsetcsjpay/sign"   # 无文件签名
        url1="/jnhxsdgsetcsjpay/signFile"  # 有文件签名
        url2="/jnhxsdgsetcsjpay/signcheck" # 签名验签
        url2="/jnhxsdgsetcsjpay/signcheckFile" # 有文件签名验签 
    """
    url = None
    host = None
    url = None
    def __init__( self, host, port, url=None, timeout=30 ):
        """
            创建验证类
        """
        self.host = host
        self.port = port
        self.url  = url
        self.timeout = timeout
                
    def getSignData( self, plainData, filename = None, user=None, passwd=None ):
        """
            根据原始报文数据plainData
            生成签名signData
            @filename   : 文件是否存在的标志,非空即表示有文件
            @plainData : 原始报文
            @filename  : 文件名
        """
        self.url = "/jnhxsdgsetcsjpay/sign"  # 无文件时需要访问的路径
        if filename:
            # host , port , user , passwd
            self.url = "/jnhxsdgsetcsjpay/signFile"  # 有文件时需要访问的路径
            ftp_put( self.host , 21 , user , passwd ,  os.path.join(settings.FTP_JAVA_PATH,filename) )
            logp.info( '文件传送java服务器成功' )
        method = "POST"
        conn = None
        try:
            # 获得httpsclient对象
            http_client = HTTPClient( self.host, self.port )
            
            # 连接三方
            conn = http_client.get_conn()
            
            # 构造请求字典
            headers = { # http请求头
                 'Content-Type':"application/x-www-form-urlencoded"
            }
            data = {
                "plain":plainData
            }
            response = http_client.request( conn, self.url, data, method=method, headers=headers )
            # 解析报文  返回的报文eval()一下就可以转换成字典格式  成功时:{'response':'True','return_value':'签名串'}  失败时:{'response':'False','return_value':'失败原因'}
            resp = response.read()
            ############返回的resp是字符串,需要转换成字典,注意修改他行批扣流程#############
            resp = eval( resp )
            # print '签名后的返回内容:', response.status, response.reason, resp
        except Exception, e:
            logp.info( 'java加解密服务器报错:%s'%str(e) )
            resp = {}
        finally:
            if conn : 
                conn.close()
        return resp
        
    def verSignData( self, plainData, filename=None, user=None, passwd=None  ):
        """
            根据原始报文判断签名是否正确;
            批量查询类交易、文件传输类交易这两支交易需要在验签成功后返回一个文件名;
            @ filename   : 文件是否存在的标志,非空即表示有文件
            @ plainData : 原始报文
            @ return True,filename=None or False
        """
        self.url = "/jnhxsdgsetcsjpay/signcheck"
        if filename:
            self.url = "/jnhxsdgsetcsjpay/signcheckFile"
        method = "POST"
        conn = None
        try:
            # 获得httpsclient对象
            http_client = HTTPClient( self.host, self.port )
            
            # 连接三方
            conn = http_client.get_conn()
            
            # 构造请求字典
            headers = { # http请求头
                 'Content-Type':"application/x-www-form-urlencoded"
            }
            
            data = {
                "plain":plainData
            } 
            
            response = http_client.request( conn, self.url, data, method=method, headers=headers )
            # 解析报文
            resp = response.read() # 一个字符串
            logp.info( '验签的返回内容:%s,%s,%s'%(response.status, response.reason, resp) )
            ############返回的resp是字符串,需要转换成字典,注意修改他行批扣流程#############
            resp = eval( resp )    # 转换成字典:成功时:{'response':'True','return_value':'空值','filename':'文件名'}  失败时:{'response':'False','return_value':'失败原因','filename':'空值'}
            
            if resp['filename']:
                # host , port , user , passwd
                ftp_get( self.host , 21 , user , passwd , os.path.join(settings.FTP_JAVA_PATH,resp['filename']) )
                
                logp.info( '成功从java服务模块的D:/file文件中获取到文件!' ) 
                
        except Exception, e:
            raise
            resp = {}
        finally:
            if conn : 
                conn.close()
        return resp






举例4 https通讯应用:


举例3 http通讯应用:
# coding: gbk




import os  
import httplib  
import socket  
import urllib
from http_client import HTTPClient
from uni.apis.utils import ftp_put, ftp_get
from uni.core import logp
from shangjie.conf import settings




  
__all__ = ["SignVerify"]




class SignVerify( object ):
    
    """
        证书验证类
        url="/jnhxsdgsetcsjpay/sign"   # 无文件签名
        url1="/jnhxsdgsetcsjpay/signFile"  # 有文件签名
        url2="/jnhxsdgsetcsjpay/signcheck" # 签名验签
        url2="/jnhxsdgsetcsjpay/signcheckFile" # 有文件签名验签 
    """
    url = None
    host = None
    url = None
    def __init__( self, host, port, url=None, timeout=30 ):
        """
            创建验证类
        """
        self.host = host
        self.port = port
        self.url  = url
        self.timeout = timeout
                
    def getSignData( self, plainData, filename = None, user=None, passwd=None ):
        """
            根据原始报文数据plainData
            生成签名signData
            @filename   : 文件是否存在的标志,非空即表示有文件
            @plainData : 原始报文
            @filename  : 文件名
        """
        self.url = "/jnhxsdgsetcsjpay/sign"  # 无文件时需要访问的路径
        if filename:
            # host , port , user , passwd
            self.url = "/jnhxsdgsetcsjpay/signFile"  # 有文件时需要访问的路径
            ftp_put( self.host , 21 , user , passwd ,  os.path.join(settings.FTP_JAVA_PATH,filename) )
            logp.info( '文件传送java服务器成功' )
        method = "POST"
        conn = None
        try:
            # 获得httpsclient对象
            http_client = HTTPClient( self.host, self.port )
            
            # 连接三方
            conn = http_client.get_conn()
            
            # 构造请求字典
            headers = { # http请求头
                 'Content-Type':"application/x-www-form-urlencoded"
            }
            data = {
                "plain":plainData
            }
            response = http_client.request( conn, self.url, data, method=method, headers=headers )
            # 解析报文  返回的报文eval()一下就可以转换成字典格式  成功时:{'response':'True','return_value':'签名串'}  失败时:{'response':'False','return_value':'失败原因'}
            resp = response.read()
            ############返回的resp是字符串,需要转换成字典,注意修改他行批扣流程#############
            resp = eval( resp )
            # print '签名后的返回内容:', response.status, response.reason, resp
        except Exception, e:
            logp.info( 'java加解密服务器报错:%s'%str(e) )
            resp = {}
        finally:
            if conn : 
                conn.close()
        return resp
        
    def verSignData( self, plainData, filename=None, user=None, passwd=None  ):
        """
            根据原始报文判断签名是否正确;
            批量查询类交易、文件传输类交易这两支交易需要在验签成功后返回一个文件名;
            @ filename   : 文件是否存在的标志,非空即表示有文件
            @ plainData : 原始报文
            @ return True,filename=None or False
        """
        self.url = "/jnhxsdgsetcsjpay/signcheck"
        if filename:
            self.url = "/jnhxsdgsetcsjpay/signcheckFile"
        method = "POST"
        conn = None
        try:
            # 获得httpsclient对象
            http_client = HTTPClient( self.host, self.port )
            
            # 连接三方
            conn = http_client.get_conn()
            
            # 构造请求字典
            headers = { # http请求头
                 'Content-Type':"application/x-www-form-urlencoded"
            }
            
            data = {
                "plain":plainData
            } 
            
            response = http_client.request( conn, self.url, data, method=method, headers=headers )
            # 解析报文
            resp = response.read() # 一个字符串
            logp.info( '验签的返回内容:%s,%s,%s'%(response.status, response.reason, resp) )
            ############返回的resp是字符串,需要转换成字典,注意修改他行批扣流程#############
            resp = eval( resp )    # 转换成字典:成功时:{'response':'True','return_value':'空值','filename':'文件名'}  失败时:{'response':'False','return_value':'失败原因','filename':'空值'}
            
            if resp['filename']:
                # host , port , user , passwd
                ftp_get( self.host , 21 , user , passwd , os.path.join(settings.FTP_JAVA_PATH,resp['filename']) )
                
                logp.info( '成功从java服务模块的D:/file文件中获取到文件!' ) 
                
        except Exception, e:
            raise
            resp = {}
        finally:
            if conn : 
                conn.close()
        return resp

举例3 http通讯应用:    
  • 0
    点赞
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值