【每周一库】- Mockall 一个强大的Rust对象模拟库(第四部分——完结)

2024-06-23 00:18

本文主要是介绍【每周一库】- Mockall 一个强大的Rust对象模拟库(第四部分——完结),希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

小编在去云南疯玩了一周后短暂忘记了自己的责任与价值,导致每周一库没有及时更新,非常抱歉!

这次是Mockall (对象模拟库) 系列的最后一篇。

关联类型

包含关联类型的特征也可以模拟。与通用特征不同,模拟出的结构型不是通用的,在定义模拟结构型时必须要指定关联的类型,这可以通过#[automock\]属性中的元项目来达成:

#[automock(type Key=u16; type Value=i32;)]
pub trait A {type Key;type Value;fn foo(&self, k: Self::Key) -> Self::Value;
}let mut mock = MockA::new();
mock.expect_foo().returning(|x: u16| i32::from(x));
assert_eq!(4, mock.foo(4));

多重特征与继承特征

在创建一个可以实现多种特征的模拟结构型时,无论有没有继承,都需要使用mock!宏。但在创建之后,模拟对象的使用方法无异。

pub trait A {fn foo(&self);
}pub trait B: A {fn bar(&self);
}mock! {// 需要模拟的结构型C {}// C 中需要实现的第一个特征trait A {fn foo(&self);}// C中需要实现的第二个特征trait B: A {fn bar(&self);}
}
let mut mock = MockC::new();
mock.expect_foo().returning(|| ());
mock.expect_bar().returning(|| ());
mock.foo();
mock.bar();

外部特征

Mockall还可以模拟在你控制之外的外部包中定义的特征与结构型,但是必须使用mock! 宏,而不是#[automock\]。你可以这样去模拟一个外部特征:

mock! {MyStruct {}     // 模拟结构型的名称, 不需要 "Mock" 前缀trait Clone {   // 需要模拟的特征的定义fn clone(&self) -> Self;}
}let mut mock1 = MockMyStruct::new();
let mock2 = MockMyStruct::new();
mock1.expect_clone().return_once(move || mock2);
let cloned = mock1.clone();

静态方法

Mockall还可以模拟静态的方法,但是需要注意,在模拟静态方法时的”期望“是全局的。如果你需要在多个不同测试中使用一个静态方法,必须要提供专属的同步。普通的方法中,期望是设置在模拟对象之上的。但是静态方法没有对应的模拟对象,所以必须要通过创建一个”语境“对象来设置这些期望:

#[automock]
pub trait A {fn foo() -> u32;
}let ctx = MockA::foo_context();
ctx.expect().returning(|| 99);
assert_eq!(99, MockA::foo());

一个常用的模式是用构造方法来模拟一个特征。在这种情况下,你可以利用构造方法来返回一个模拟对象。

struct Foo{}
#[automock]
impl Foo {fn from_i32(x: i32) -> Self {// ...}fn foo(&self) -> i32 {// ...}
}let ctx = MockFoo::from_i32_context();
ctx.expect().returning(|x| {let mut mock = MockFoo::default();mock.expect_foo().return_const(x);mock});
let foo = MockFoo::from_i32(42);
assert_eq!(42, foo.foo());

通用静态方法

模拟通用的结构型或特征的静态方法时,无论方法本身是不是通用的,都能无缝运行。

#[automock]
trait Foo<T: 'static> {fn new(t: T) -> MockFoo<T>;
}let ctx = MockFoo::<u32>::new_context();
ctx.expect().returning(|_| MockFoo::default());
let mock = MockFoo::<u32>::new(42u32);

语境检查点

当语境对象离开作用域时,所有的期望都会被清空。语境对象与其他模拟对象一样有一个checkpoint 方法。

#[automock]
pub trait A {fn foo() -> u32;
}let ctx = MockA::foo_context();
ctx.expect().times(1).returning(|| 99);
ctx.checkpoint();   // Panics!

模拟对象的检查点方法不会对静态方法进行检查。这种行为对同时使用多个模拟对象会比较有用,例如:

#[automock]
pub trait A {fn build() -> Self;fn bar(&self) -> i32;
}let ctx = MockA::build_context();
ctx.expect().times(2).returning(|| MockA::default());
let mut mock0 = MockA::build();
mock0.expect_bar().return_const(4);
mock0.bar();
mock0.checkpoint();     // 不会对build方法进行checkpoint
let mock1 = MockA::build();

还有一点值得注意的时:Mockall一般情况下会为每一个模拟结构型创建一个没有参数的new方法。但是在模拟一个已经包含名为new的方法的结构型时,Mockall则不会自动创建。

外部方程

Mockall还可以模拟外部方程。和静态方法一样,模拟外部方程时的期望是全局的。与模拟结构型时类似,为了使模拟的方程可被访问,需要对导入进行特别的调试。与关联类型一样,需要在#[automock\]属性中提供一些额外的信息模拟外部方程才可正常使用。

mod ffi {use mockall::automock;#[automock(mod mock;)]extern "C" {pub fn foo(x: u32) -> i64;}
}cfg_if! {if #[cfg(test)] {use self::ffi::mock::foo;} else {use self::ffi::foo;}
}fn do_stuff() -> i64 {unsafe{ foo(42) }
}#[cfg(test)]
mod t {use super::*;#[test]fn test_foo() {let ctx = ffi::mock::foo_context();ctx.expect().returning(|x| i64::from(x + 1));assert_eq!(43, do_stuff());}
}

模块

除了可以模拟外部方程之外,Mockall还可以为所有Rust方程的模块派生出模拟,这个功能需要使用每日构建功能,在你的包中需要启用feature(proc_macro_hygiene)。使用方法与模拟外部功能一样,但是模拟模块的命名是自动生成的。

#![feature(proc_macro_hygiene)]
mod outer {use mockall::automock;#[automock()]pub(super) mod inner {pub fn bar(x: u32) -> i64 {// ...}}
}cfg_if! {if #[cfg(test)] {use outer::mock_inner as inner;} else {use outer::inner;}
}#[cfg(test)]
mod t {use super::*;#[test]fn test_foo_bar() {let ctx = inner::bar_context();ctx.expect().returning(|x| i64::from(x + 1));assert_eq!(5, inner::bar(4));}
}

这篇关于【每周一库】- Mockall 一个强大的Rust对象模拟库(第四部分——完结)的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/1085810

相关文章

在java中如何将inputStream对象转换为File对象(不生成本地文件)

《在java中如何将inputStream对象转换为File对象(不生成本地文件)》:本文主要介绍在java中如何将inputStream对象转换为File对象(不生成本地文件),具有很好的参考价... 目录需求说明问题解决总结需求说明在后端中通过POI生成Excel文件流,将输出流(outputStre

Mysql删除几亿条数据表中的部分数据的方法实现

《Mysql删除几亿条数据表中的部分数据的方法实现》在MySQL中删除一个大表中的数据时,需要特别注意操作的性能和对系统的影响,本文主要介绍了Mysql删除几亿条数据表中的部分数据的方法实现,具有一定... 目录1、需求2、方案1. 使用 DELETE 语句分批删除2. 使用 INPLACE ALTER T

C#原型模式之如何通过克隆对象来优化创建过程

《C#原型模式之如何通过克隆对象来优化创建过程》原型模式是一种创建型设计模式,通过克隆现有对象来创建新对象,避免重复的创建成本和复杂的初始化过程,它适用于对象创建过程复杂、需要大量相似对象或避免重复初... 目录什么是原型模式?原型模式的工作原理C#中如何实现原型模式?1. 定义原型接口2. 实现原型接口3

Java实现将byte[]转换为File对象

《Java实现将byte[]转换为File对象》这篇文章将通过一个简单的例子为大家演示Java如何实现byte[]转换为File对象,并将其上传到外部服务器,感兴趣的小伙伴可以跟随小编一起学习一下... 目录前言1. 问题背景2. 环境准备3. 实现步骤3.1 从 URL 获取图片字节数据3.2 将字节数组

Javascript访问Promise对象返回值的操作方法

《Javascript访问Promise对象返回值的操作方法》这篇文章介绍了如何在JavaScript中使用Promise对象来处理异步操作,通过使用fetch()方法和Promise对象,我们可以从... 目录在Javascript中,什么是Promise1- then() 链式操作2- 在之后的代码中使

MyBatis的配置对象Configuration作用及说明

《MyBatis的配置对象Configuration作用及说明》MyBatis的Configuration对象是MyBatis的核心配置对象,它包含了MyBatis运行时所需的几乎所有配置信息,这个对... 目录MyBATis配置对象Configuration作用Configuration 对象的主要作用C

CSS模拟 html 的 title 属性(鼠标悬浮显示提示文字效果)

《CSS模拟html的title属性(鼠标悬浮显示提示文字效果)》:本文主要介绍了如何使用CSS模拟HTML的title属性,通过鼠标悬浮显示提示文字效果,通过设置`.tipBox`和`.tipBox.tipContent`的样式,实现了提示内容的隐藏和显示,详细内容请阅读本文,希望能对你有所帮助... 效

SpringBoot实现导出复杂对象到Excel文件

《SpringBoot实现导出复杂对象到Excel文件》这篇文章主要为大家详细介绍了如何使用Hutool和EasyExcel两种方式来实现在SpringBoot项目中导出复杂对象到Excel文件,需要... 在Spring Boot项目中导出复杂对象到Excel文件,可以利用Hutool或EasyExcel

Springboot控制反转与Bean对象的方法

《Springboot控制反转与Bean对象的方法》文章介绍了SpringBoot中的控制反转(IoC)概念,描述了IoC容器如何管理Bean的生命周期和依赖关系,它详细讲解了Bean的注册过程,包括... 目录1 控制反转1.1 什么是控制反转1.2 SpringBoot中的控制反转2 Ioc容器对Bea

Java对象和JSON字符串之间的转换方法(全网最清晰)

《Java对象和JSON字符串之间的转换方法(全网最清晰)》:本文主要介绍如何在Java中使用Jackson库将对象转换为JSON字符串,并提供了一个简单的工具类示例,该工具类支持基本的转换功能,... 目录前言1. 引入 Jackson 依赖2. 创建 jsON 工具类3. 使用示例转换 Java 对象为