使用 Pitcher 简化卫语句 -

反骨仔

2023-05-13 2023-05-13 约 455 字预计阅读 1 分钟 - 次阅读

什么是卫语句

在方法的开头，我们经常会添加一些检查代码，当检查条件为 true 时立刻从方法中返回。

这样的单独检查代码被称为“卫语句”。

例如，我们在添加用户时会检查用户名不能为空，年龄必须大于 0：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15


public void AddUser(string name, int age)
{
    if (string.IsNullOrWhiteSpace(name))
    {
        throw new ArgumentException("用户名不能为空!", nameof(name));
    }

    if (age<=0)
    {
        throw new ArgumentOutOfRangeException(nameof(age), "年龄必须大于0!");
    }

    //正常业务逻辑
    ...
}

卫语句可以把我们的视线从异常处理中解放出来，集中精力到实现正常业务逻辑代码中。

Pitcher

但是，当这些检查代码过多时，会让代码显得杂乱无章，可读性较低。

这时，可以使用 nuget 包 Pitcher 来帮助我们优化代码。

根据条件抛出异常

示例代码如下:

1
2
3
4
5
6
7
8


public void AddUser(string name, int age)
{
    Throw.When(string.IsNullOrWhiteSpace(name), new ArgumentNullException(nameof(name)));
    Throw.When(age <= 0, new ArgumentOutOfRangeException(nameof(age)));

    //正常业务逻辑
    ...
}

简化参数检查

对于 ArgumentNullException 和 ArgumentOutOfRangeException，可以使用更简化的方法。

示例代码如下:

1
2


Throw.ArgumentNull.WhenNullOrWhiteSpace(name, nameof(name));
Throw.ArgumentOutOfRange.WhenNegativeNumber(age, nameof(age));

泛型异常

对于没有参数的异常或者不关心参数的情况，可以使用 Throw<T>。

示例代码如下:

1

Throw<InvalidOperationException>.When(age <= 0);

使用 Pitcher 简化卫语句

什么是卫语句

Pitcher

根据条件抛出异常

简化参数检查

泛型异常

相关链接