社区精选 | OpenMMLab 为什么要引入 Hook 机制嘞?

让我们一起来看看我们第一位投稿大佬在 hook 机制方面的分享吧!

欢迎大家在留言区积极参与讨论哦!

本文由 Yimian Dai 投稿,OpenMMLab 社区专属ID:429212,目前正在攻读博士学位,研究领域涵盖图像处理、计算机视觉及遥感。

本文内容

为什么要设计 Hook 机制?

Hook 机制的运作流程

Hook 机制的底层实现

案例:mmseg 中的 Hooks

1. 为什么要设计 Hook 机制?

OpenMMLab 系列的一个显著特点就是其采用的 Hook 机制。与易于理解且对新手友好的 Gluon-CV 相比,Hook 机制无疑增加了初学者使用 OpenMMLab 系列工具箱的难度。那么,为什么要引入 Hook 机制呢?

实际上,OpenMMLab 中的 Hook 机制是面向切面编程(Aspect Oriented Program, AOP)思想的一种体现。从抽象的角度来看,问为什么要引入 Hook 机制,实际上是在问在软件开发中,为什么要采用这种面向切面编程的设计模式。

我个人浅显的理解,提出面向切面编程是为了解决面向对象编程(Object Oriented Programming,OOP)中的代码重复性问题。面向对象编程的思想是职责分配,将功能分散到不同的对象类中,在不同类中设计不同的方法。如果两个类 A、B 都需要使用同一种方法,可以将该方法写在一个独立的类 C 中,然后让这两个类各自继承类 C。然而,这么做存在两个问题。

第一个问题是,对于不支持多重继承的语言,如 Java,继承类 C 后就不能再继承其他类了。如果类 C 中的功能并不是类 A、B 的主要功能,通过继承类 C 来获取其方法就不合适了。简单的解决方案是分别在类 A、B 中实现类 C 中的那个子函数,这样一来,相同的代码就会在两处存在,代码的重复性大大增加。如果你要修改该方法,必须在两处都进行修改。两处还可以处理,如果这种情况有 m 个,每个重复 n 处呢?

第二个问题是,即使能够继承,类 A、B 与类 C 就耦合在一起了。如果存在一个与类 C 具有相似但不同子函数的类 D,我希望能够让类 A、B 通过用户配置选项动态地选择是调用类 C 还是类 D 中的子函数,那么这种直接继承的方案也没法提供这种动态选择的灵活性。

本质上,除了继承之外,面向对象编程所追求的封装特性切断了类与类之间的联系和共享。然而,为了降低代码的重复性、提升软件的模块化水平,需要将分散在各个类内的重复代码统一起来,两者之间就存在了矛盾。

这种在程序运行时,动态地将所需代码插入到类的指定方法、指定位置上的编程思想就是面向切面编程。其中,几个类共同需要调用的、为此被抽取出来的代码片段称为切面,其会在程序运行时被插入到指定类的指定方法中,而被插入的那些类、那些方法称为切入点。面向切面编程,使得我们可以把和当前的业务逻辑无关的部分抽到单独的一层中去,实现无侵入式的功能扩展。

正是通过 Hook 机制,OpenMMLab 系列能够对网络实现以及算法训练、测试流程进行抽象和解耦,从而达到了相当高的模块化水平,即重复代码大大减少。

2. Hook 机制的运作流程

Hook 机制并不是 OpenMMLab 独有的,只是由于我代码经验不足,第一次见到而已。钩子编程(hooking)是计算机程序设计中的术语,指通过拦截软件模块间的函数调用、消息传递、事件传递来修改或扩展操作系统、应用程序或其他软件组件的程序执行流程。其中,处理被拦截的函数调用、事件、消息的代码被称为钩子(hook),也就是前文 AOP 编程中的切面。

在 OpenMMLab 中,Hook 机制由 Runner 类(如 IterBasedRunner, EpochBasedRunner)和 HOOK 类(如 EvalHook)配合完成,共同构成了训练框架的架构规范。

首先,在 OpenMMLab 中,负责网络训练测试全流程的 Runner 类在训练测试周期中定义了一系列触发器,如下所示:

# 省略 ...self.call_hook('before_train_epoch')for i, data_batch in enumerate(self.data_loader):    # 省略 ...    self.call_hook('before_train_iter')    # 省略 ...    self.call_hook('after_train_iter')    # 省略 ...self.call_hook('after_train_epoch')

其次,在与 Runner 类配合的 Hook 类及其子类中,也定义了一堆与上面 Runner 类的触发器中 before_run, before_epoch, before_train_iter, after_train_iter, after_epoch, after_run 等步骤/时刻/节点同名的函数,被称为钩子函数,如下所示:

class Hook:    def before_run(self, runner):        pass    def after_run(self, runner):        pass    def before_epoch(self, runner):        pass    def after_epoch(self, runner):        pass    def before_iter(self, runner):        pass    def after_iter(self, runner):        pass    # ... 省略

当然,上面这个 Hook 类是最原始的实现,也就是基本什么功能都没有实现。如果想定义一些操作,实现一些功能,可以继承这个类并定制我们需要的功能,比如 mmcv.runner.hooks.evaluation 模块中的 EvalHook 类继承了最原始的 Hook 类,将里面的子函数基本都具体实现了;而 mmseg.core.evaluation 模块中的 EvalHook 类则进一步继承了前一个 EvalHook 类,重写了 after_train_iter 和 after_train_epoch 两个子函数。

有了相互配合的 Runner 类和 Hook 类之后,Runner 类实例运行到特定时刻,就会通过触发器函数调用各个 Hook 类中的钩子函数,从而完成特定的功能。例如,每个或者隔几个 after_epoch 或者 after_train_iter 触发器时刻,可以通过 EvalHook 的 after_train_iter 函数调用 _do_evaluate 函数完成对 validation set 的 evaluation。

个人感觉,这套 Hook 机制很像通信系统中的轮流询问机制,是一套在算法生命周期中规定好了种种操作的训练框架规范。其之所以起作用,是因为在 Runner 类的被调用方法中,每一个节点都规定了 call 相应 hook 函数的操作。Runner 类在训练过程中会依次轮流询问端口,也就是依次 call 下每个节点的 hook 函数,如果对应钩子函数有被专门定制过,那就执行该功能。如果没有,那就是个空函数,直接 pass 了,继续执行下一步,从而实现了拦截模块间的函数调用、消息传递、事件传递,从而修改或扩展组件的行为。

3. Hook 机制的底层实现

在清楚了 Runner 类与 Hook 类配合实现 Hook 机制的运作流程后,还剩下两个问题。第一个问题是,怎么让 Runner 类实例知道去调用某个具体的 Hook 类实例的子函数,也就是怎么将 Runner 类实例和 Hook 类实例关联起来?第二个问题是,Runner 类实例可能会调用多个 Hook 对象,每个 Hook 对象都会有各自同名的子函数,比如 after_train_iter,这种情况是如何处理的?

对于第一个问题,是通过 Runner 类的 register_hook 函数将 HOOK 类实例注册进 Runner 类实例的。我们以 MMSegmentation 为例,在训练模型的时候,会调用 mmseg.apis 模块的 train_segmentor 函数。其中有两步是给 IterBasedRunner 类实例 runner 注册 training hooks 和 validation hooks:

runner.register_training_hooks(cfg)runner.register_hook(eval_hook(val_dataloader, eval_cfg))

Runner 类提供了两种注册 hook 的方法:

1. register_hook 方法是直接传入一个实例化的 HOOK 对象,并将它插入到 Runner 类实例的 self._hooks 列表中;

2. register_hook_from_cfg 方法是传入一个配置项 cfg,根据配置项来实例化 HOOK 对象,然后再将其插入到 self._hooks 列表中。

实际上,第二种方法就是先调用 mmcv.build_from_cfg 方法生成一个实例化的 HOOK 对象,然后再调用第一种 register_hook 方法将实例化后的 HOOK 对象插入到 self._hooks 列表中。

有了存有注册了的 Hook 类实例的 self._hooks 列表,Runner 类在运行中调用注册了的 Hook 类实例的子函数也就顺理成章了。看一下 BaseRunner 类中 call_hook 函数的定义,其中 fn_name 就是 self.call_hook(‘after_train_iter’) 传入的 after_train_iter。getattr(hook, fn_name)(self) 其实就是在调用 self._hooks 列表中的 hook 对象的名为 fn_name 的函数,比如 EvalHook 类实例的 after_train_iter 方法。至此,第一个问题,如何动态地将想要的 Hook 类实例的某个方法插入到 Runner 类实例的运行过程中已经实现了。

def call_hook(self, fn_name):    """Call all hooks.    Args:        fn_name (str): The function name in each hook to be called, such as            "before_train_epoch".    """    for hook in self._hooks:        getattr(hook, fn_name)(self)

对于第二个问题,从上面 call_hook 函数的定义也可以看出,在 Runner 实例的 run 函数运行过程中,在每一个设置 call_hook 函数的节点,都会就轮流执行一遍 self._hooks 列表中所有 hook 实例中该时刻对应的方法。比如,对于 after_train_iter 这个时刻,就是遍历一遍所有 hook 实例的 after_train_iter 方法。如果只有一个 Hook 实例重写了该方法,而其他实例的该方法都是 pass,那也无所谓。但如果有两个及以上实例的该方法实现不是 pass,那这就涉及到一个哪个实例的方法该先被调用的问题,具体到程序中,则是每个 Hook 了实例被插入到 self._hooks 列表的位置的前后,因为 call_hook 函数是依次调用的。

优先级这点,在注册 hook 的时候就已经实现了,priority 是默认变量。从下面 register_hook 函数的定义就可以看出,对于新注册的一个 Hook 实例,按照其指定的优先级,没有指定就默认 ‘NORMAL’ 优先级,插入到 self._hooks 中,优先级越高的,越靠前。如果新注册的 Hook 实例与就有的 Hook 实例优先级相同,那就按照先来后到,先来的排在更前面。至此,第二个问题也解决了。

def register_hook(self, hook, priority='NORMAL'):    """Register a hook into the hook list.    The hook will be inserted into a priority queue, with the specified    priority (See :class:`Priority` for details of priorities).    For hooks with the same priority, they will be triggered in the same    order as they are registered.    Args:        hook (:obj:`Hook`): The hook to be registered.        priority (int or str or :obj:`Priority`): Hook priority.            Lower value means higher priority.    """    assert isinstance(hook, Hook)    if hasattr(hook, 'priority'):        raise ValueError('"priority" is a reserved attribute for hooks')    priority = get_priority(priority)    hook.priority = priority    # insert the hook to a sorted list    inserted = False    for i in range(len(self._hooks) - 1, -1, -1):        if priority >= self._hooks[i].priority:            self._hooks.insert(i + 1, hook)            inserted = True            break    if not inserted:        self._hooks.insert(0, hook)

4. 案例:mmseg 中的 Hooks

在下图中,我整理了 mmseg 的 tools/train.py 整个运行周期中会用到的所有 hooks 对应的具体的 Hook 类以及相应被调用的时刻。

社区精选 | OpenMMLab 为什么要引入 Hook 机制嘞?(点击查看大图)

另外,以 IterBasedRunner 为例,整理了这些 Hooks 被调用的时刻以及相应的优先级(先后顺序)。

社区精选 | OpenMMLab 为什么要引入 Hook 机制嘞?(点击查看大图)

大家是否在 Yimian Dai 同学的启发下有所收获呢?

欢迎各位大佬多多投递想法,也欢迎大家一同交流

以上就是社区精选 | OpenMMLab 为什么要引入 Hook 机制嘞?的详细内容,更多请关注创想鸟其它相关文章!

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/9101.html

(0)
打赏 微信扫一扫 微信扫一扫 支付宝扫一扫 支付宝扫一扫
上一篇 2025年11月9日 10:30:45
下一篇 2025年11月9日 10:31:54

相关推荐

  • CSS mask属性无法获取图片:为什么我的图片不见了?

    CSS mask属性无法获取图片 在使用CSS mask属性时,可能会遇到无法获取指定照片的情况。这个问题通常表现为: 网络面板中没有请求图片:尽管CSS代码中指定了图片地址,但网络面板中却找不到图片的请求记录。 问题原因: 此问题的可能原因是浏览器的兼容性问题。某些较旧版本的浏览器可能不支持CSS…

    2025年12月24日
    900
  • Uniapp 中如何不拉伸不裁剪地展示图片?

    灵活展示图片:如何不拉伸不裁剪 在界面设计中,常常需要以原尺寸展示用户上传的图片。本文将介绍一种在 uniapp 框架中实现该功能的简单方法。 对于不同尺寸的图片,可以采用以下处理方式: 极端宽高比:撑满屏幕宽度或高度,再等比缩放居中。非极端宽高比:居中显示,若能撑满则撑满。 然而,如果需要不拉伸不…

    2025年12月24日
    400
  • 如何让小说网站控制台显示乱码,同时网页内容正常显示?

    如何在不影响用户界面的情况下实现控制台乱码? 当在小说网站上下载小说时,大家可能会遇到一个问题:网站上的文本在网页内正常显示,但是在控制台中却是乱码。如何实现此类操作,从而在不影响用户界面(UI)的情况下保持控制台乱码呢? 答案在于使用自定义字体。网站可以通过在服务器端配置自定义字体,并通过在客户端…

    2025年12月24日
    800
  • 如何在地图上轻松创建气泡信息框?

    地图上气泡信息框的巧妙生成 地图上气泡信息框是一种常用的交互功能,它简便易用,能够为用户提供额外信息。本文将探讨如何借助地图库的功能轻松创建这一功能。 利用地图库的原生功能 大多数地图库,如高德地图,都提供了现成的信息窗体和右键菜单功能。这些功能可以通过以下途径实现: 高德地图 JS API 参考文…

    2025年12月24日
    400
  • 如何使用 scroll-behavior 属性实现元素scrollLeft变化时的平滑动画?

    如何实现元素scrollleft变化时的平滑动画效果? 在许多网页应用中,滚动容器的水平滚动条(scrollleft)需要频繁使用。为了让滚动动作更加自然,你希望给scrollleft的变化添加动画效果。 解决方案:scroll-behavior 属性 要实现scrollleft变化时的平滑动画效果…

    2025年12月24日
    000
  • 如何为滚动元素添加平滑过渡,使滚动条滑动时更自然流畅?

    给滚动元素平滑过渡 如何在滚动条属性(scrollleft)发生改变时为元素添加平滑的过渡效果? 解决方案:scroll-behavior 属性 为滚动容器设置 scroll-behavior 属性可以实现平滑滚动。 html 代码: click the button to slide right!…

    2025年12月24日
    500
  • 为什么设置 `overflow: hidden` 会导致 `inline-block` 元素错位?

    overflow 导致 inline-block 元素错位解析 当多个 inline-block 元素并列排列时,可能会出现错位显示的问题。这通常是由于其中一个元素设置了 overflow 属性引起的。 问题现象 在不设置 overflow 属性时,元素按预期显示在同一水平线上: 不设置 overf…

    2025年12月24日 好文分享
    400
  • 网页使用本地字体:为什么 CSS 代码中明明指定了“荆南麦圆体”,页面却仍然显示“微软雅黑”?

    网页中使用本地字体 本文将解答如何将本地安装字体应用到网页中,避免使用 src 属性直接引入字体文件。 问题: 想要在网页上使用已安装的“荆南麦圆体”字体,但 css 代码中将其置于第一位的“font-family”属性,页面仍显示“微软雅黑”字体。 立即学习“前端免费学习笔记(深入)”; 答案: …

    2025年12月24日
    000
  • 如何选择元素个数不固定的指定类名子元素?

    灵活选择元素个数不固定的指定类名子元素 在网页布局中,有时需要选择特定类名的子元素,但这些元素的数量并不固定。例如,下面这段 html 代码中,activebar 和 item 元素的数量均不固定: *n *n 如果需要选择第一个 item元素,可以使用 css 选择器 :nth-child()。该…

    2025年12月24日
    200
  • 使用 SVG 如何实现自定义宽度、间距和半径的虚线边框?

    使用 svg 实现自定义虚线边框 如何实现一个具有自定义宽度、间距和半径的虚线边框是一个常见的前端开发问题。传统的解决方案通常涉及使用 border-image 引入切片图片,但是这种方法存在引入外部资源、性能低下的缺点。 为了避免上述问题,可以使用 svg(可缩放矢量图形)来创建纯代码实现。一种方…

    2025年12月24日
    100
  • 如何让“元素跟随文本高度,而不是撑高父容器?

    如何让 元素跟随文本高度,而不是撑高父容器 在页面布局中,经常遇到父容器高度被子元素撑开的问题。在图例所示的案例中,父容器被较高的图片撑开,而文本的高度没有被考虑。本问答将提供纯css解决方案,让图片跟随文本高度,确保父容器的高度不会被图片影响。 解决方法 为了解决这个问题,需要将图片从文档流中脱离…

    2025年12月24日
    000
  • 为什么我的特定 DIV 在 Edge 浏览器中无法显示?

    特定 DIV 无法显示:用户代理样式表的困扰 当你在 Edge 浏览器中打开项目中的某个 div 时,却发现它无法正常显示,仔细检查样式后,发现是由用户代理样式表中的 display none 引起的。但你疑问的是,为什么会出现这样的样式表,而且只针对特定的 div? 背后的原因 用户代理样式表是由…

    2025年12月24日
    200
  • inline-block元素错位了,是为什么?

    inline-block元素错位背后的原因 inline-block元素是一种特殊类型的块级元素,它可以与其他元素行内排列。但是,在某些情况下,inline-block元素可能会出现错位显示的问题。 错位的原因 当inline-block元素设置了overflow:hidden属性时,它会影响元素的…

    2025年12月24日
    000
  • 为什么 CSS mask 属性未请求指定图片?

    解决 css mask 属性未请求图片的问题 在使用 css mask 属性时,指定了图片地址,但网络面板显示未请求获取该图片,这可能是由于浏览器兼容性问题造成的。 问题 如下代码所示: 立即学习“前端免费学习笔记(深入)”; icon [data-icon=”cloud”] { –icon-cl…

    2025年12月24日
    200
  • 为什么使用 inline-block 元素时会错位?

    inline-block 元素错位成因剖析 在使用 inline-block 元素时,可能会遇到它们错位显示的问题。如代码 demo 所示,当设置了 overflow 属性时,a 标签就会错位下沉,而未设置时却不会。 问题根源: overflow:hidden 属性影响了 inline-block …

    2025年12月24日
    000
  • 如何利用 CSS 选中激活标签并影响相邻元素的样式?

    如何利用 css 选中激活标签并影响相邻元素? 为了实现激活标签影响相邻元素的样式需求,可以通过 :has 选择器来实现。以下是如何具体操作: 对于激活标签相邻后的元素,可以在 css 中使用以下代码进行设置: li:has(+li.active) { border-radius: 0 0 10px…

    2025年12月24日
    100
  • 为什么我的 CSS 元素放大效果无法正常生效?

    css 设置元素放大效果的疑问解答 原提问者在尝试给元素添加 10em 字体大小和过渡效果后,未能在进入页面时看到放大效果。探究发现,原提问者将 CSS 代码直接写在页面中,导致放大效果无法触发。 解决办法如下: 将 CSS 样式写在一个单独的文件中,并使用 标签引入该样式文件。这个操作与原提问者观…

    2025年12月24日
    000
  • 如何模拟Windows 10 设置界面中的鼠标悬浮放大效果?

    win10设置界面的鼠标移动显示周边的样式(探照灯效果)的实现方式 在windows设置界面的鼠标悬浮效果中,光标周围会显示一个放大区域。在前端开发中,可以通过多种方式实现类似的效果。 使用css 使用css的transform和box-shadow属性。通过将transform: scale(1.…

    2025年12月24日
    200
  • 为什么我的 em 和 transition 设置后元素没有放大?

    元素设置 em 和 transition 后不放大 一个 youtube 视频中展示了设置 em 和 transition 的元素在页面加载后会放大,但同样的代码在提问者电脑上没有达到预期效果。 可能原因: 问题在于 css 代码的位置。在视频中,css 被放置在单独的文件中并通过 link 标签引…

    2025年12月24日
    100
  • 为什么我的 Safari 自定义样式表在百度页面上失效了?

    为什么在 Safari 中自定义样式表未能正常工作? 在 Safari 的偏好设置中设置自定义样式表后,您对其进行测试却发现效果不同。在您自己的网页中,样式有效,而在百度页面中却失效。 造成这种情况的原因是,第一个访问的项目使用了文件协议,可以访问本地目录中的图片文件。而第二个访问的百度使用了 ht…

    2025年12月24日
    000

发表回复

登录后才能评论
关注微信