python 绑定本地端口发送数据

数据库接口/ DB-API

在Python中，数据库是通过适配器(Adaptor)来连接访问数据库的，适配器通常与数据库客户端接口(通常为C语言编写)想连接，而不同的适配器都会尽量满足相同的DB-API标准。

为了保证不同数据库的数据库接口能够通用于适配器，以减少使用不同数据库接口是需要对代码进行大幅改动，Python的DB-SIG(数据库特殊兴趣小组)制定了DB-API的标准，该API为不同的关系数据库提供了一致的接口，使得使用不同数据库的代码间移植变得更加简单。数据库接口目前的版本为DB-API(2.0)，可前往Python官网查看最新版本。

通用标准/ General Standard

对于任意的数据库适配器db，需要提供至少以下几项通用标准，以保证可移植性。

1属性/ Attribute

1.1 apilevel属性

属性调用: al = db.apilevel

属性功能:返回当前适配器支持的DB-API版本

属性参数: al

al: str类型，目前支持"1.0"和"2.0"两种，如果该适配器未指定，则假定为"1.0"

1.2 threadsafety属性

属性调用: tsf = db.threadsafety

属性功能:返回当前适配器支持的线程安全等级

属性参数: tsf

tsf: int类型，线程安全等级
threadsafety
Meaning
0
Threads may not share the module.
1
Threads may share the module, but not connections.
2
Threads may share the module and connections.
3
Threads may share the module, connections and cursors.
1.3 paramstyle属性
属性调用: psy = db.paramstyle
属性功能:返回当前适配器支持的参数风格
属性参数: psy
psy: str类型，参数风格的说明
paramstyle
Meaning
qmark
Question mark style, e.g. ...WHERE name=?
numeric
Numeric, positional style, e.g. ...WHERE name=:1
named
Named style, e.g. ...WHERE name=:name
format
ANSI C printf format codes, e.g. ...WHERE name=%s
pyformat
Python extended format codes, e.g. ...WHERE name=%(name)s
2函数/ Function
2.1 connect ()函数
函数调用: cnx = db.connect/Connection/Connect(*args, **kwargs)
函数功能:生成一个数据库的连接对象
传入参数: args, kwargs
host: str类型，连接的主机地址，未传入或‘localhost’都将连接本地数据库
user: str类型，登入数据库的用户名
password/passwd: str类型，登录数据库的密码
database/db: str类型，使用的数据库schema名称
返回参数: cnx
cnx: obj类型，一个数据库连接实例
3类/ Class
3.1 Connection类
类实例化：cnx = db.connect/Connection/Connect(*args, **kwargs)
类的功能:用于联系数据库API的连接对象
传入参数: args, kwargs
host: str类型，连接的主机地址，未传入或‘localhost’都将连接本地数据库
user: str类型，登入数据库的用户名
password/passwd: str类型，登录数据库的密码
database/db: str类型，使用的数据库schema名称
返回参数: cnx
cnx: obj类型，一个数据库连接实例

3.1.1 close()方法

函数调用: cnx.close()

函数功能:关闭数据库连接

传入参数:无

返回参数:无

3.1.2 commit()方法

函数调用: cnx.commit()

函数功能:提交当前事务，通常当命令具有执行修改等性质的时候需要此函数完成确认

传入参数:无

返回参数:无

3.1.3 rollback()方法

函数调用: cnx.rollback()

函数功能:取消当前事务

传入参数:无

返回参数:无
3.1.4 cursor()方法
函数调用: cur = cnx.cursor()
函数功能:使用该连接对象创建返回一个游标对象
传入参数:无
返回参数: cur
cur: obj类型，游标对象的实例，可以通过游标进行操作数据库
3.2 Cursor类
类实例化：cur = cnx.cursor()
类的功能:一个用于操作数据库的游标对象
传入参数: args, kwargs
host: str类型，连接的主机地址，未传入或‘localhost’都将连接本地数据库
user: str类型，登入数据库的用户名
password/passwd: str类型，登录数据库的密码
database/db: str类型，使用的数据库schema名称
返回参数: cnx
cnx: obj类型，一个数据库连接实例
3.2.1 arraysize属性
属性调用: as = cur.arraysize
属性功能:表示使用fetchmany()方法时，一次性取出的结果行数，默认为1
属性参数: as
as: int类型，一次性fetch的行数
3.2.2 connection属性
属性调用: cnx = cur.connection
属性功能:返回生成该游标的connection实例
属性参数: cnx
cnx: obj类型，生成当前游标的连接实例
3.2.3 description属性
属性调用: dsp = cur.description
属性功能:返回当前游标的活动状态
属性参数: dsp
dsp: tuple/NoneType类型，一个7元素元组描述当前状态
3.2.4 lastrowid属性
属性调用: rid = cur.lastrowid
属性功能:上次修改行的ID，不支持则返回None
属性参数: rid
rid: int/NoneType类型，修改的行ID
3.2.5 rowcount属性
属性调用: roc = cur.rowcount
属性功能:上次execute*()修改行所影响的行数
属性参数: roc
roc: int类型，修改影响的行数
3.2.6 close()方法
函数调用: cur.close()
函数功能:关闭游标
传入参数:无
返回参数:无
3.2.7 execute()方法
函数调用: [r =] cur.execute(query, args=None)
函数功能:执行数据库命令
传入参数: query, args
query: str类型，执行的SQL命令行
args: sequence/mapping类型，query使用的参数
返回参数: r
r: int类型，执行所影响的行数
3.2.8 executemany()方法
函数调用: [r =] cur.executemany(query, args)
函数功能:执行多条数据库命令，类似execute()和map()的结合
传入参数: query, args
query: str类型，执行的SQL命令行
args: sequence/mapping类型，query使用的参数
返回参数: r
r: int类型，执行所影响的行数
3.2.9 fetchone()方法
函数调用: r = cur.fetchone()
函数功能:获取查询结果的下一行
传入参数:无
返回参数: r
r: tuple类型，查询结果的下一条信息的元组
3.2.10 fetchmany()方法
函数调用: r = cur.fetchmany(size=cursor.arraysize)
函数功能:获取查询结果的下n行，默认为arraysize的设置值
传入参数: size
size: int类型，查询下n行
返回参数: r
r: tuple类型，查询结果的下n条信息的元组
3.2.11 fetchall()方法
函数调用: r = cur.fetchall()
函数功能:获取查询结果的所有(剩余)行
传入参数:无
返回参数: r
r: tuple类型，查询结果的所有剩余信息元组
4补充知识/ Complement Knowledge
4.1 Cursor与Connection
在MySQL中，Connection生成的实例利用query函数已经可以完成基本的SQL数据库操作，而Cursor的execute功能与其类似，但是引入Cursor可以使在不必要的时候销毁Cursor节省资源占用，同时无需断开连接。参考 stack overflow 链接。
5应用实例/ Complement Knowledge
下面的例子中将构建一个简单的通用适配器驱动，其中实现了各种适配器通用的函数方法。
1 classSqlConnector():2 def __init__(self, adaptor):3 self.adaptor =adaptor4 self.result =None5 #Check Adaptor info
6 print('Adaptor %s apply DB-API %s, thread safety: %d, parameter style: %s' % (adaptor.__name__, adaptor.apilevel, adaptor.threadsafety, adaptor.paramstyle))7
8 #Login by user name and password
9 def login(self, **kwargs):10 #Create a connection obj
11 self.cnx = self.adaptor.connect(**kwargs)12
13 deflogoff(self):14 self.cnx.close()15
16 def query_sql(self, sql, show=True):17 #Method one: Use Connection
18 '''
19 self.cnx.query(sql)20 self.result = self.cnx.store_result()21 r = self.result.fetch_row(0, )22 self.cnx.commit()23 '''
24 #Method two: Use Cursor
25 cur =self.cnx.cursor()26 cur.execute(sql)27 r =cur.fetchall()28 self.cnx.commit()29 cur.close()30
31 ifshow:32 splt = '\n' + ((len(sql)+6)*'-')33 msg = ''.join(('\n{: ^10} |').format(str(i)) if x.index(i) == 0 else ('{: ^10} |').format(str(i)) for x in r for i inx)34 s = ('{:-^%d}'%(len(sql)+6)).format(sql) + msg +splt35 print(s)36 return (i for x in r for i inx)37
38 defexec_sql(self, sql):39 cur =self.cnx.cursor()40 cur.execute(sql)41 self.cnx.commit()42 cur.close()43
44 defcommit(self):45 self.cnx.commit()46
47 if __name__ == '__main__':48 importMySQLdb49 importpymssql50 r = input('Please choose your adaptor:\n(M)MySQL\n(S)MsSQL\n')51 adaptor_list = {'M': MySQLdb, 'S': pymssql}52 c =SqlConnector(adaptor_list[r.upper()])53 #No local MSSQL server
54 c.login(host='localhost', user='root', password='root')55 c.logoff()
第 1-6 行，建立适配器的类，在初始化用利用适配器的通用属性查看适配器的基本信息，包括适配器名称，使用的DB-API等级，线程安全等级，参数风格等。
第 8-14 行，定义登录退出函数，登录时创建连接实例，退出时关闭。
第 16-36 行，定义请求函数，对于数据库的操作有两种方式实现，第一种是使用Connection，第二种是使用Cursor，同时对请求的结果进行显示。
第 38-45 行，定义执行函数，用于执行SQL的命令语句，对于有修改性质的语句必须commit后才能在数据库端生效。
第 47-55 行，最后仅对数据库进行登录退出测试，由于本地仅安装了MYSQL，没有安装MSSQL的服务器，因此无法登录MSSQL。
运行结果如下
Please choose your adaptor:
(M)MySQL
(S)MsSQL
M
Adaptor MySQLdb apply DB-API 2.0, thread safety: 1, parameter style: format
参考链接