Moq.AutoMock 技术文档

1. 安装指南

在您的项目中使用 Moq.AutoMock 前，需要先通过 NuGet 包管理器进行安装。您可以在 NuGet 包管理器控制台使用以下命令来安装：

Install-Package Moq.AutoMock

确保您的项目已正确添加了对 Moq 和 Moq.AutoMock 的引用。

2. 项目的使用说明

Moq.AutoMock 是一个自动模拟容器，用于 Moq。如果您使用依赖注入容器，并希望您的单元测试与构造函数参数的变化解耦，那么您可以使用 Moq.AutoMock。

以下是一些基本的使用示例：

创建实例

最简单的用法是构建一个用于单元测试的实例。

var mocker = new AutoMocker();
var car = mocker.CreateInstance<Car>();

car.DriveTrain.ShouldNotBeNull();
car.DriveTrain.ShouldImplement<IDriveTrain>();

特殊实例注册

如果您需要使用一个特殊的实例，可以使用 .Use(...) 方法进行注册。这与常规依赖注入容器中的注册非常类似。

var mocker = new AutoMocker();

mocker.Use<IDriveTrain>(new DriveTrain());
// 或者，设置一个模拟
mocker.Use<IDriveTrain>(x => x.Shaft.Length == 5);

var car = mocker.CreateInstance<Car>();

提取模拟

在某些时候，您可能需要获取自动生成的模拟。为此，请使用 .Get<>() 或 .GetMock<>() 方法。

var mocker = new AutoMocker();

// 假设您有一个需要验证的设置
mocker.Use<IDriveTrain>(x => x.Accelerate(42) == true);

var car = mocker.CreateInstance<Car>();
car.Accelerate(42);

// 然后，提取并验证
var driveTrainMock = mocker.GetMock<IDriveTrain>();
driveTrainMock.VerifyAll();

验证所有模拟

另外，还有一种更快的方法可以验证容器中的所有模拟：

var mocker = new AutoMocker();
mocker.Use<IDriveTrain>(x => x.Accelerate(42) == true);

var car = mocker.CreateInstance<Car>();
car.Accelerate(42);

// 此方法验证容器中的所有模拟
mocker.VerifyAll();

3. 项目API使用文档

Moq.AutoMock 提供以下主要方法和特性：

• AutoMocker()：构造函数，创建一个新的自动模拟容器。
• CreateInstance<T>()：创建指定类型的实例，该类型将自动填充所有依赖项的模拟。
• Use<T>(T instance)：注册一个特殊实例，替换默认的模拟实例。
• Use<T>(Func<T, bool> setup)：注册一个设置函数，用于配置模拟。
• Get<T>()：获取指定类型的模拟实例。
• GetMock<T>()：获取指定类型的模拟对象。
• VerifyAll()：验证容器中的所有模拟对象。

4. 项目安装方式

如前所述，使用 NuGet 包管理器安装 Moq.AutoMock，通过以下命令：

Install-Package Moq.AutoMock

确保安装后，在项目中引用了正确的程序集。