位置: 编程技术 - 正文

Bottle框架中的装饰器类和描述符应用详解(pebble框架)

编辑:rootadmin

推荐整理分享Bottle框架中的装饰器类和描述符应用详解(pebble框架),希望有所帮助,仅作参考,欢迎阅读内容。

文章相关热门搜索词:框架vaexposed,框架用法,boosting框架,框架double,框架bounce,框架用法,框架用法,bie框架,内容如对您有帮助,希望把文章链接给更多的朋友!

最近在阅读Python微型Web框架Bottle的源码,发现了Bottle中有一个既是装饰器类又是描述符的有趣实现。刚好这两个点是Python比较的难理解,又混合在一起,让代码有些晦涩难懂。但理解代码之后不由得为Python语言的简洁优美赞叹。所以把相关知识和想法稍微整理,以供分享。

正文

Bottle是Python的一个微型Web框架,所有代码都在一个bottle.py文件中,只依赖标准库实现,兼容Python 2和Python 3,而且最新的稳定版0.代码也只有行左右。虽然小,但它实现了Web框架基本功能。这里就不以过多的笔墨去展示Bottle框架,需要的请访问其网站了解更多。这里着重介绍与本文相关的重要对象request。在Bottle里,request对象代表了当前线程处理的请求,客户端发送的请求数据如表单数据,请求网站和cookie都可以从request对象中获得。下面是官方文档中的两个例子from bottle import request, route, response, template

那么Bottle是如何实现的呢?根据WSGI接口规定,所有的HTTP请求信息都包含在一个名为envrion的dict对象中。所以Bottle要做的就是把HTTP请求信息从environ解析出来。在深入Request类如何实现之前先要了解下Bottle的FormsDict。FormsDict与字典类相似,但扩展了一些功能,比如支持属性访问、一对多的键值对、WTForms支持等。它在Bottle中被广泛应用,如上面的示例中cookie和query数据都以FormsDict存储,所以我们可以用request.query.page的方式获取相应属性值。

下面是0.版Bottle中Request类的部分代码,0.版中Request类继承了BaseRequest,为了方便阅读我把代码合并在一起,同时还有重要的DictProperty的代码。需要说明的是Request类__init__传入的environ参数就是WSGI协议中包含HTTP请求信息的envrion,而query方法中的_parse_qsl函数可以接受形如/forum&#;id=1&page=5原始查询字符串然后以[(key1, value1), (ke2, value2), …]的list返回。

query方法的逻辑和代码都比较简单,就是从environ中获取'QUERY_STRING',并用把原始查询字符串解析为一个FormsDict,将这个FormsDict赋值给environ[‘bottle.request.query']并返回。但这个函数的装饰器的作用就有些难以理解,装饰器的实现方式都是”dunder”特殊方法,有些晦涩难懂。如果上来就看这些源码可能难以理解代码实现的功能。那不如这些放一边,假设自己要实现这些方法,你会写出什么代码。

一开始你可能写出这样的代码。

这样确实实现了解析查询字符串的功能,但每次在调用这个方法时都需要对原始查询字符串解析一次,实际上在处理某特请求时,查询字符串是不会改变的,所以我们只需要解析一次并把它保存起来,下次使用时直接返回就好了。另外此时的query方法还是一个普通方法,必须使用这样的方法来调用它

query后面的小括号让语句显得不那么协调,其实就是我觉得它丑。要是也能和官方文档中的示例实现以属性访问的方式获取相应的数据就好了。所以代码还得改改。

第二版改变的代码就两处,一个是使用property装饰器,实现了request.query的访问方式;另一个就是在query函数体中增加了判断'bottle.get.query'是否在environ中的判断语句,实现了只解析一次的要求。第二版几乎满足了所有要求,它表现得就像Bottle中真正的query方法一样。但它还是有些缺陷。

首先,Request类并不只有query一个方法,如果要编写完整的Request类就会发现,有很多方法的代码与query相似,都是从environ中解析出需要的数据,而且都只需要解析一次,保存起来,第二次或以后访问时返回保存的数据就好了。所以可以考虑将属性管理的代码从方法体内抽象出来,正好Python中的描述符可以实现这样的功能。另外如果使用Bottle的开发者在写代码时不小心尝试进行request.query = some_data的赋值时,将会抛出如下错误。

我们确实希望属性是只读的,在对其赋值时应该抛出错误,但这样的报错信息并没有提供太多有用的信息,导致调bug时一头雾水,找不到方向。我们更希望抛出如

这样明确的错误信息。

所以第三版的代码可以这样写

Bottle框架中的装饰器类和描述符应用详解(pebble框架)

第三版的代码没有使用property装饰器,而是使用了描述符这个技巧。如果你之前没有见到过描述符,在这里限于篇幅只能做个简单的介绍,但描述符涉及知识点众多,如果有不清楚之处可以看看《流畅的Python》第章属性描述符,里面有非常详细的介绍。

简单来说,描述符是对多个属性运用相同存取逻辑的一种方式,如Bottle框架里我们需要对很多属性都进行判断某个键是否在environ中,如果在则返回,如果不在,需要解析一次这样的存取逻辑。而描述符需要实现特定协议,包括__set__, __get__, __delete___方法,分别对应设置,读取和删除属性的方法。他么的参数也比较特殊,如__get__方法的三个参数self, obj, cls分别对应描述符实例的引用,对第三版的代码来说就是Descriptor(‘environ', ‘bottle.get.query', query, read_only=True)创建的实例的引用;obj则对应将某个属性托管给描述的实例对象的引用,对应的应该为request对象;而cls则为Request类的引用。在调用request.query时编译器会自动传入这些参数。如果以Request.query的方式调用,那么obj参数的传入值为None,这时候通常的处理是返回描述符实例。

在Descriptor中__get__方法的代码最多,也比较难理解,但如果记住其参数的意义也没那么难。下面以query的实现为例,我添加一些注释来帮助理解

而__set__, __delete__代码比较简单,在这里我们把只读属性在赋值和删除时抛出的错误定制为AttributeError(‘Read only property.'),方便调试。

通过使用描述符这个有些难懂的方法,我们可以在Request的方法中专心于编写如何解析的代码,不用担心属性的存取逻辑。和在每个方法中都使用if判断相比高到不知道哪里去。但美中不足的是,这样让我们的方法代码后面拖着一个“小尾巴”,即

怎么去掉这个这个“小尾巴“呢?回顾之前的代码几乎都是对query之类的方法进行修饰,所以可以尝试使用装饰器,毕竟装饰器就是对某个函数进行修饰的,而且我们应该使用参数化的装饰器,这样才能将envrion等参数传递给装饰器。如果要实现参数化装饰器就需要一个装饰器工厂函数,也就是说装饰器的代码里需要嵌套至少3个函数体,写起来有写绕,代码可阅读性也有差。更大的问题来自如何将描述符与装饰器结合起来,因为Descriptor是一个类而不是方法。

解决办法其实挺简单的。如果知道Python中函数也是对象,实现了__call__方法的对象可以表现得像函数一样。所以我们可以修改Descirptor的代码,实现__call__方法,让它的实例成为callable对象就可以把它用作装饰器;而要传入的参数可以以实例属性存储起来,通过self.attribute的形式访问,而不是像使用工厂函数实现参数化装饰器时通过闭包来实现参数的访问获取。这时候再来看看Bottle里的DictProperty代码

其实就是一个有描述符作用的装饰器类,它的使用方法很简单:

拆开会更好理解点:

再把@实现的语法糖拆开:

再修改以下代码形式:

是不是和第三版的实现方式非常相似。

但我们可以使用装饰器把方法体后面那个不和谐的赋值语句”小尾巴“去掉,将属性存取管理抽象出来,而且只需要使用一行非常简便的装饰器把这个功能添加到某个方法上。这也许就是Python的美之一吧。

写在后面

DictProperty涉及知识远不止文中涉及的那么简单,如果你还是不清楚DictProperty的实现功能,建议阅读《流畅的Python》第7章和第章,对装饰器和描述符有详细的描述,另外《Python Cookbook》第三版第9章元编程有关于参数化装饰器和装饰器类的叙述和示例。如果你对Bottle为什么要实现这样的功能感到困惑,建议阅读Bottle的文档和WSGI相关的文章。

其实前一阵再阅读Bottle源码时就想写一篇文章,但奈何许久不写东西文笔生疏加上医院实习期间又比较忙,一直推到现在才终于磕磕绊绊地把我阅读的Bottle源码的一些感悟写出来,希望对喜欢Python的各位有些帮助把。

总结

标签: pebble框架

本文链接地址:https://www.jiuchutong.com/biancheng/368746.html 转载请保留说明!

上一篇:Python探索之URL Dispatcher实例详解(python urllib urlopen)

下一篇:Python探索之SocketServer详解(python socket操作)

  • 私立学校要交社保吗
  • 增值税电子发票查询平台
  • 奖金算不算工资薪金所得
  • 烟丝是消费税的征收范围
  • 企业亏损结转年限举例说明
  • 汇算清缴上年度金额怎么填
  • 房地产企业没有退还的履约保证金税务
  • 股票卖出印花税费率
  • 记账凭证的具体审计目标
  • 发票隔月报送可以么?
  • 当月未认证发票分录
  • 增值税电子发票怎么下载
  • 往年的企业所得税季报可以更正吗
  • 兼营免税减税项目
  • 建设单位增值税抵扣
  • 进项税额抵扣的情况有哪些
  • 金融业营业税改增值税
  • 个人出租房屋合同协议书
  • 租赁农民土地应该开发票吗
  • 坏账准备的计提是什么意思
  • 预提固定资产折旧费
  • 所得税费用计算典型例题
  • 委托贷款利息收入增值税
  • 汇缴交的所得税如何做账
  • 契税和增值税的计税依据
  • 财政拨款的贴息怎么计算
  • win11版本英文
  • vue怎么使用本地存储比较好
  • 哪些收入需要交消费税
  • 为什么微信转账不成功
  • web无法运行
  • 核定征收的企业注销需要缴纳个人所得税吗
  • 已计提完的固定资产怎么弄
  • thinkphp框架的作用
  • 与资产相关的政府补助有哪些
  • javafiles
  • windows2022下载
  • web前端框架是什么
  • 当月注销外管证个税账户也会注销吗
  • 金银首饰包装物消费税
  • 企业没有研发费用怎么做账
  • 公司注销剩余的发票怎么作废
  • 营运资金为正数说明企业什么
  • 应税货物销售额含税吗
  • 投资性房地产成本模式转公允模式差额
  • 差旅费补助无发票的文件依据
  • 劳务公司的账务处理会计分录
  • 为什么运输合肥料检测核辐射人会拿一个玻璃棒
  • 银行承兑到期后未兑付
  • 存货取得长期股权投资
  • 资产负债表中的货币资金怎么算
  • 税法上的营业收入怎么算
  • 资产负债表和科目余额表怎么核对
  • 代开的专票作废了怎么做账?
  • 公司增资有什么作用
  • 企业办增项怎样办理
  • 自制原始凭证的填制
  • mysql几天能学会
  • 简单基是什么
  • mysql使用的协议
  • mysql5.7.22安装
  • windows已保护你的电脑,阻止你的应用
  • xp系统无法更换桌面壁纸
  • win8的显示设置
  • win10无法启动diagnostic policy service
  • linuxone
  • android快捷键设置
  • 杀死oracle进程
  • unity游戏开发常用技术
  • nodejs递归创建目录
  • javascript教程完整版
  • python xml.etree.ElementTree遍历xml所有节点实例详解
  • jquery取消单选框选中
  • opencv识别结果输出
  • [推荐]抖音上那些好看的视频和有才的帐号
  • 源代码举例
  • 四川国税局发票查询
  • 提问:请问海淀区各税务所管辖范围都是哪里?
  • 互联网服务业有哪些行业
  • 印花税会计分录怎么做 印花税需要计提吗
  • 免责声明:网站部分图片文字素材来源于网络,如有侵权,请及时告知,我们会第一时间删除,谢谢! 邮箱:opceo@qq.com

    鄂ICP备2023003026号

    网站地图: 企业信息 工商信息 财税知识 网络常识 编程技术

    友情链接: 武汉网站建设