位置: 编程技术 - 正文

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

  • 所得税的记账凭证
  • 税收指的是什么
  • 个体工商户生产经营所得税税率表2021
  • 残保基金怎么算
  • 电子税务局发票验旧怎么操作
  • 加油充值卡发票能入账吗
  • 应收票据背书转让分录
  • 如何判断会计政策变动
  • 员工意外险费用
  • 洗车费怎么做会计分录
  • 库存商品的进销存怎么做账
  • 劳动保险费属于营业外支出吗
  • 离职员工的工资应该多久结清
  • 非生产用设备及器具
  • 年终结账后,应当更换新账的有( )
  • 企业注销时有未抵扣的留抵
  • 社保滞纳金是否影响企业信用等级
  • 处于汇总期
  • 个人抬头的医药费可以进费用吗
  • 工资薪金所得的个人所得税筹划方法
  • 如何栽柑橘苗
  • 利用Windows Media将二进制文件转音频
  • 企业买金税盘做什么科目
  • 在windows中桌面是
  • mac电脑色彩设置
  • 清算期间会计科目
  • php中自定义函数
  • adamax优化器
  • 世界上最早的计算机是
  • 生产企业外销收入账务处理
  • 委托外发加工会计分录
  • 公司报销额度是什么意思
  • 高通 adc
  • 小规模纳税人结转未交增值税
  • 表单验证用什么方法实现
  • win11显卡驱动不兼容
  • 大二一学期学分多少合适
  • 自动驾驶科普
  • 核定征收的纳税人能否享受六税两费减免
  • 错账的类型及对应的更正方法
  • 销售旧货税率
  • 织梦如何使用
  • mysql有输入输出语句
  • 供热管道属于什么结构类型
  • db2数据库安装服务器的环境
  • 收据能否入账
  • 安装购买的材料怎么做账
  • 建行E信通贴现需要发票吗
  • 政府补助都有哪些类型
  • 应交税金为负数应该填在资产负债表哪一栏
  • 超市被盗怎么办
  • 员工报销培训费怎么做账
  • mysql获取表行数的方法
  • mysql8.0 win7
  • mysql int(3)与int(11)的区别详解
  • ios 数据库版本升级
  • mysql怎么切换到bin目录
  • mysql 5.7.33安装
  • win8支持固态硬盘吗
  • XP系统怎么设置双屏幕
  • 解决win10蓝屏
  • windows显示缩略图
  • linux基金会什么时候成立
  • Win7系统如何打开磁盘管理工具
  • win7系统在那个文件夹
  • mac中quick-cocos2dx-2.2.5+sublime text 2搭建lua的开发环境
  • 返回场景和音乐的区别
  • linux安装oracle数据库步骤
  • shell操作
  • python数据导出
  • javascript的理解
  • mysql数据表复制
  • viewstock
  • 谈谈对人才是第一资源的理解
  • 简单介绍中秋节
  • js函数详解
  • python默认方法
  • 保险是不是跟车走
  • 企业自建厂房在建工程会计账务处理
  • 消费税的纳税人是买方还是卖方
  • 免责声明:网站部分图片文字素材来源于网络,如有侵权,请及时告知,我们会第一时间删除,谢谢! 邮箱:opceo@qq.com

    鄂ICP备2023003026号

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

    友情链接: 武汉网站建设