全网最适合入门的面向对象编程教程:52 Python 函数方法与接口-Protocol 协议与接口

image

摘要:

在 Python 中,协议(Protocol)和接口(Interface)是用于定义类和对象之间交互的一种方式,特别是在实现多态性和代码可重用性时,协议是一种抽象概念,描述了对象所需实现的方法和属性,而不关心具体的类或实现。

原文链接:

FreakStudio的博客

往期推荐:

学嵌入式的你,还不会面向对象??!

全网最适合入门的面向对象编程教程:00 面向对象设计方法导论

全网最适合入门的面向对象编程教程:01 面向对象编程的基本概念

全网最适合入门的面向对象编程教程:02 类和对象的 Python 实现-使用 Python 创建类

全网最适合入门的面向对象编程教程:03 类和对象的 Python 实现-为自定义类添加属性

全网最适合入门的面向对象编程教程:04 类和对象的Python实现-为自定义类添加方法

全网最适合入门的面向对象编程教程:05 类和对象的Python实现-PyCharm代码标签

全网最适合入门的面向对象编程教程:06 类和对象的Python实现-自定义类的数据封装

全网最适合入门的面向对象编程教程:07 类和对象的Python实现-类型注解

全网最适合入门的面向对象编程教程:08 类和对象的Python实现-@property装饰器

全网最适合入门的面向对象编程教程:09 类和对象的Python实现-类之间的关系

全网最适合入门的面向对象编程教程:10 类和对象的Python实现-类的继承和里氏替换原则

全网最适合入门的面向对象编程教程:11 类和对象的Python实现-子类调用父类方法

全网最适合入门的面向对象编程教程:12 类和对象的Python实现-Python使用logging模块输出程序运行日志

全网最适合入门的面向对象编程教程:13 类和对象的Python实现-可视化阅读代码神器Sourcetrail的安装使用

全网最适合入门的面向对象编程教程:全网最适合入门的面向对象编程教程:14 类和对象的Python实现-类的静态方法和类方法

全网最适合入门的面向对象编程教程:15 类和对象的 Python 实现-__slots__魔法方法

全网最适合入门的面向对象编程教程:16 类和对象的Python实现-多态、方法重写与开闭原则

全网最适合入门的面向对象编程教程:17 类和对象的Python实现-鸭子类型与“file-like object“

全网最适合入门的面向对象编程教程:18 类和对象的Python实现-多重继承与PyQtGraph串口数据绘制曲线图

全网最适合入门的面向对象编程教程:19 类和对象的 Python 实现-使用 PyCharm 自动生成文件注释和函数注释

全网最适合入门的面向对象编程教程:20 类和对象的Python实现-组合关系的实现与CSV文件保存

全网最适合入门的面向对象编程教程:21 类和对象的Python实现-多文件的组织:模块module和包package

全网最适合入门的面向对象编程教程:22 类和对象的Python实现-异常和语法错误

全网最适合入门的面向对象编程教程:23 类和对象的Python实现-抛出异常

全网最适合入门的面向对象编程教程:24 类和对象的Python实现-异常的捕获与处理

全网最适合入门的面向对象编程教程:25 类和对象的Python实现-Python判断输入数据类型

全网最适合入门的面向对象编程教程:26 类和对象的Python实现-上下文管理器和with语句

全网最适合入门的面向对象编程教程:27 类和对象的Python实现-Python中异常层级与自定义异常类的实现

全网最适合入门的面向对象编程教程:28 类和对象的Python实现-Python编程原则、哲学和规范大汇总

全网最适合入门的面向对象编程教程:29 类和对象的Python实现-断言与防御性编程和help函数的使用

全网最适合入门的面向对象编程教程:30 Python的内置数据类型-object根类

全网最适合入门的面向对象编程教程:31 Python的内置数据类型-对象Object和类型Type

全网最适合入门的面向对象编程教程:32 Python的内置数据类型-类Class和实例Instance

全网最适合入门的面向对象编程教程:33 Python的内置数据类型-对象Object和类型Type的关系

全网最适合入门的面向对象编程教程:34 Python的内置数据类型-Python常用复合数据类型:元组和命名元组

全网最适合入门的面向对象编程教程:35 Python的内置数据类型-文档字符串和__doc__属性

全网最适合入门的面向对象编程教程:36 Python的内置数据类型-字典

全网最适合入门的面向对象编程教程:37 Python常用复合数据类型-列表和列表推导式

全网最适合入门的面向对象编程教程:38 Python常用复合数据类型-使用列表实现堆栈、队列和双端队列

全网最适合入门的面向对象编程教程:39 Python常用复合数据类型-集合

全网最适合入门的面向对象编程教程:40 Python常用复合数据类型-枚举和enum模块的使用

全网最适合入门的面向对象编程教程:41 Python常用复合数据类型-队列(FIFO、LIFO、优先级队列、双端队列和环形队列)

全网最适合入门的面向对象编程教程:42 Python常用复合数据类型-collections容器数据类型

全网最适合入门的面向对象编程教程:43 Python常用复合数据类型-扩展内置数据类型

全网最适合入门的面向对象编程教程:44 Python内置函数与魔法方法-重写内置类型的魔法方法

全网最适合入门的面向对象编程教程:45 Python实现常见数据结构-链表、树、哈希表、图和堆

全网最适合入门的面向对象编程教程:46 Python函数方法与接口-函数与事件驱动框架

全网最适合入门的面向对象编程教程:47 Python函数方法与接口-回调函数Callback

全网最适合入门的面向对象编程教程:48 Python函数方法与接口-位置参数、默认参数、可变参数和关键字参数

全网最适合入门的面向对象编程教程:49 Python函数方法与接口-函数与方法的区别和lamda匿名函数

全网最适合入门的面向对象编程教程:50 Python函数方法与接口-接口和抽象基类

全网最适合入门的面向对象编程教程:51 Python函数方法与接口-使用Zope实现接口

更多精彩内容可看:

给你的 Python 加加速:一文速通 Python 并行计算

一文搞懂 CM3 单片机调试原理

肝了半个月,嵌入式技术栈大汇总出炉

电子计算机类比赛的“武林秘籍”

一个MicroPython的开源项目集锦:awesome-micropython,包含各个方面的Micropython工具库

Avnet ZUBoard 1CG开发板—深度学习新选择

SenseCraft 部署模型到Grove Vision AI V2图像处理模块

文档和代码获取:

可访问如下链接进行对文档下载:

https://github.com/leezisheng/Doc

image

本文档主要介绍如何使用 Python 进行面向对象编程,需要读者对 Python 语法和单片机开发具有基本了解。相比其他讲解 Python 面向对象编程的博客或书籍而言,本文档更加详细、侧重于嵌入式上位机应用,以上位机和下位机的常见串口数据收发、数据处理、动态图绘制等为应用实例,同时使用 Sourcetrail 代码软件对代码进行可视化阅读便于读者理解。

相关示例代码获取链接如下:https://github.com/leezisheng/Python-OOP-Demo

正文

协议 protocol 在 python3.8 开始引入的,协议是抽象基类 (ABC) 的替代方案,作为在语言中定义结构类型或“鸭子类型”的一种方式。协议是对象必须具有的一组方法或属性,以便被认为与该协议兼容。协议使你能够定义接口,而无需显式创建类或从特定基类继承。

协议是使用 typing.Protocol 类或 typing.Protocol 装饰器定义的。

以下为示例代码,首先我们定义一个名为 Printable 的协议,该协议要求对象具有打印方法。 Protocol 类允许我们定义必须由符合协议的对象实现的抽象方法(在本例中为打印)。

from typing import Protocol

class Printable(Protocol):
    def print(self) -> None:
        pass

要实现协议,我们不需要显式声明它。相反,我们可以通过实现所需的方法来确保对象符合协议。这是一个例子:在此示例中,Book 类通过提供所需的打印方法来实现 Printable 协议。Book 类的任何实例都可以被视为 Printable 对象。

协议主要用于类型提示和静态类型检查。我们可以使用协议作为类型注释来指示参数或变量必须符合特定协议。这是一个例子:

def print_object(obj: Printable) -> None:
    obj.print()

在此示例中,print_object 函数采用 Printable 类型的参数 obj。这意味着传递给此函数的任何对象都必须实现 Printable 协议中定义的 print 方法。

接下来,我们定义一个没有 print 方法的类

_# 定义CD类,没有打印方法_
class CD:
    def __init__(self, title: str):
        self.title = title

    def play(self) -> None:
        print(f"play music Title: {self.title}")

接下来,实例化两个类,并且测试是否能使用 print_object 函数:

book_obj = Book("Piece and Love")
print_object(book_obj)
cd_obj = CD("Piece and Love")
print_object(cd_obj)

运行结果如下:

image

在 IDE 中实际上也会有相关提示:

image

实际上,协议的实质含义可以理解为“这个类只要有 xxxx 方法,那么它就会隐式地成为我的子类”,这个东西主要是给静态类型检查工具看的,性质上和 PEP 484 与 PEP 526 是一样的。我们也可以利用 @typing.runtime_checkable 装饰器将协议类标记为运行时协议,这种协议可以与 isinstance()和 issubclass()一起使用。当应用于非协议类时,这会引发 TypeError。

_# 导入协议Protocol_
from typing import Protocol
import typing
_# 定义Printable协议,需要具有打印方法_
@typing.runtime_checkable
class Printable(Protocol):
    def print(self) -> None:
        pass
... ...
_# 创建对象实例_
book_obj = Book("Piece and Love")
print_object(book_obj)
cd_obj = CD("Piece and Love")
_# 类型检查_
print(isinstance(Book,Printable))
assert isinstance(book_obj,Printable)
print(isinstance(CD,Printable))
assert isinstance(cd_obj,Printable)

运行结果如下:

image

我们也可以定义组合多个其他协议的协议。以下我们使用序列化方法定义了一个名为 Serialized 的协议。然后我们定义另一个名为 PrintableAndSerializing 的协议,它结合了 Printable 和 Serializing 协议。

class Serializable(Protocol):
    def serialize(self) -> str:
        pass

class PrintableAndSerializable(Printable, Serializable):
    pass

相比抽象基类等方式,协议提供了一种在 Python 中定义结构类型的方法,允许我们创建接口而无需显式继承。它们使类型检查器能够动态验证对象是否遵守定义的协议,从而增强代码的正确性和可维护性。

image