c# – 如何构建一个流利的嵌套Guard API

我正在构建一个简单的Guard API来防止非法参数传递给函数等等.

我有如下代码：

public static class Guard
{
    public static GuardArgument<T> Ensure<T>(T value,string argumentName)
    {
        return new GuardArgument<T>(value,argumentName);
    }
}

public class GuardArgument<T>
{
    public GuardArgument(T value,string argumentName)
    {
        Value = value;
        Name = Name;
    }

    public T Value { get; private set; }
    public string Name { get; private set; }
}

// Example extension for validity checks
public static GuardArgument<T> IsNotNull<T>(this GuardArgument<T> guardArgument,string errorMessage)
{
    if (guardArgument.Value == null)
    {
        throw new ArgumentNullException(guardArgument.Name,errorMessage);
    }

    return guardArgument;
}

目前代码可以以类似的方式使用(注意这只是一个愚蠢的例子)：

void DummyMethod(int? someObject) {

    Guard.Ensure(someObject,"someObject")
       .IsNotNull()
       .IsGreaterThan(0)
       .IsLessthan(10);
}

这一切都很好.现在我想要做的是扩展API,以便以下列方式将子属性包含在检查中：

Guard.Ensure(someObject,"someObject")
    .IsNotNull()
    .Property(
        (x => x.ChildProp1,"childProp1")
           .IsNotNull()
           .IsGreaterThan(10)
     )
     .Property(
        (x => x.ChildProp2,"childProp2")
           .IsNotNull()
           .IsLessthan(10)
     );

显然,新的.Property方法需要返回父GuardArgument才能链接.此外,子属性需要能够使用现有的检查方法(IsNotNull()等)来避免代码重复.

我无法解释如何构造lambda / property函数参数或者.Property方法应该在哪里找到 – 即应该是GuardArgument或其他地方的属性,或者即使API有更好的结构.

解决方法

以下功能允许与您想要的语法类似.

public static GuardArgument<T> Property<T,TProp>(this GuardArgument<T> guardArgument,Func<T,TProp> getProperty,string propertyName,Action<GuardArgument<TProp>> validate)
{
    GuardArgument<TProp> propertyguardArgument = new GuardArgument<TProp>(getProperty(guardArgument.Value),propertyName);

    validate(propertyguardArgument);

    return guardArgument;
}

该函数为选定的属性创建一个新的GuardArgument,然后将其传递给Action参数,以允许您根据需要进行验证.

这也允许无限链接的属性,虽然我不确定将是特别可读.

用法：

Guard.Ensure(someObject,"someObject")
     .IsNotNull()
     .Property(x => x.ChildProp1,"childProp1",childProp1 =>
         childProp1.IsNotNull()
                   .IsLessthan(10)
                   .Property(y => y.InnerChildProperty,"innerChildProperty",innerChildProperty =>
                       innerChildProperty.IsNotNull()
                    )
     )
     .Property(x => x.ChildProp2,"childProp2",childProp2 =>
         childProp2.IsNotNull()
                   .IsGreaterThan(10)
     );