位置: 编程技术 - 正文

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操作)

  • 2020年小微企业所得税税率
  • 地税办理流程
  • 小规模不动产租赁增值税税率是多少
  • 认缴出资怎么填财务报表
  • 银行贷款受托支付后,钱怎么转回来
  • 个人代开房租普票需要缴纳哪些税种?
  • 可供出售金融资产计入什么科目
  • 辅导期一般纳税人什么意思
  • 财务报表分析方法有
  • 拆装厂房
  • 技术服务费属于现代服务吗
  • 固定资产融资租赁账务处理
  • 工资中的考核罚款会计怎么处理?
  • 收外汇需要提供什么
  • 行政单位基建账统一核算
  • 异地预缴企业所得税几个点
  • 个体工商户地税没有申报罚款多少
  • 收据能入账抵税吗
  • 长期待摊费用当月减少当月摊销吗
  • 银行对账单不平衡
  • 有哪些固定资产可以抵税
  • 发票丢失税局怎么罚款
  • 接受国外企业捐款的条件
  • 生育津贴支付方式
  • 电动汽车的出路在哪里
  • 辅助核算的内容
  • 苹果14promax电池掉电很快
  • biospwds最新版
  • kkfileview启动组件失败
  • PHP:imagecolorresolvealpha()的用法_GD库图像处理函数
  • 分公司开业开场白
  • 代缴房产税代缴的人要负责吗
  • 委托加工物资实际成本构成一般包括
  • 微信小程序使用时间记录查询
  • 公司内部往来双向挂账
  • js获取各种屏幕信息
  • vuexl
  • 数字图像处理课后题答案
  • 员工办理健康证需要什么材料
  • 进什么税额
  • 预缴个人所得税怎么做分录
  • 退税没有退的部分怎么做账
  • 劳务外经证预缴税款
  • 企业办理税务注销需要什么资料
  • 差额征税的专用发票能抵扣吗
  • 研发费用如何进账
  • sql server使用sql server身份登录
  • 小规模纳税人取得普通发票可以抵扣吗
  • 公司一年发两次奖金
  • 委托代理进口账务处理
  • 不动产登记流程有哪些
  • 差旅费的进项税额需要转出吗
  • 供应商奖惩制度具体办法
  • 计提是好是坏
  • 残保金工资总额是按计提还是发放
  • 代垫运杂费计入销售收入吗
  • 小型润滑油生产设备要哪些
  • zmweb.exe是什么进程
  • xp系统怎么删除系统
  • win2000注册表
  • centos failed to start login service
  • wp_official_1.1.3.apk软件下载
  • 删除windows.edb
  • ubuntu18.04网络
  • ubuntu安装音乐软件
  • ubuntu彻底删除
  • kdeskcore.exe是什么
  • 如何灵活使用蒙恬
  • 修改linux系统用户密码
  • window7iis配置步骤
  • win8.1怎么重新装系统
  • windows更新
  • node.js配置
  • dos命令语法
  • 复制链接
  • 编写批处理
  • python 聚类算法包
  • python常用的库
  • js命名函数
  • 税务局风控
  • 免责声明:网站部分图片文字素材来源于网络,如有侵权,请及时告知,我们会第一时间删除,谢谢! 邮箱:opceo@qq.com

    鄂ICP备2023003026号

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

    友情链接: 武汉网站建设