MmsCore.Expressions 0.2.2

[!IMPORTANT] This Project is not yet stable. Breaking changes may occur at any time.

MmsCore.Expressions

MmsCore.Expressionsには、ラムダ式の解析とパブリック・フィールドおよびプロパティへのアクセスを行うための静的クラスExpressionSupport、FieldAccessor、PropertyAccessorが用意されています。これらのクラスを使用すると、式ツリーで記述されたラムダ式からフィールド名やプロパティ名を抽出できるため、開発者は式ツリーやオブジェクト・フィールド、プロパティをより効率的に操作できるようになります。

🚀 Getting Started

PropertyAccessor

以下に PropertyAccessor の使用例を示します。

private class TestableClass1
{
    private readonly int _readonlyBackingFieldProperty;

    public TestableClass1()
    {
    }

    public TestableClass1(int readonlyAutoPropertyValue)
    {
        this.ReadonlyAutoProperty = readonlyAutoPropertyValue;
        this._readonlyBackingFieldProperty = readonlyAutoPropertyValue;
    }

    public string SomeProperty { get; set; } = default!;

    public int ReadonlyAutoProperty { get; private set; }

    public int ReadonlyBackingFieldProperty => this._readonlyBackingFieldProperty;

    public int WriteOnlyBackingFieldProperty
    {
        set { }
    }

    internal string InternalProperty { get; set; } = default!;

    protected string ProtectedProperty { get; set; } = default!;

    private string PrivateProperty { get; set; } = default!;
}

// PropertyAccessorを取得します。ここではTestableClass1のSomePropertyを対象にしています。
var accessor = PropertyAccessor.LookupOrNull((TestableClass1 target) => target.SomeProperty);

// 取得したPropertyAccessorを確認します。
Assert.NotNull(accessor);
Assert.Equal(typeof(TestableClass1), accessor.DeclaringType);
Assert.True(accessor.IsReadable);
Assert.True(accessor.IsWritable);
Assert.Equal(typeof(TestableClass1).GetProperty("SomeProperty"), accessor.Member);
Assert.Equal(typeof(string), accessor.MemberType);
Assert.Equal("SomeProperty", accessor.Name);

// TestableClass1のインスタンスを作成し、SomePropertyに値を設定します。
var test = new TestableClass1 { SomeProperty = "ほげ" };

// GetValueメソッドを使用してSomePropertyの値を取得し、期待値と一致することを確認します。
var actual = accessor.GetValue(test);
Assert.Equal("ほげ", actual);

// SetValueメソッドを使用してSomePropertyに新しい値を設定し、値が更新されたことを確認します。
accessor.SetValue(test, "もげもげ");
Assert.Equal("もげもげ", test.SomeProperty);

以下に PropertyAccessor.Lookup メソッドの使用例を示します。

// TestableClass1の型を指定してPropertyAccessorを取得します。
var accessors = PropertyAccessor.Lookup(typeof(TestableClass1));

// 取得したPropertyAccessorの数が4であることを確認します。
Assert.Equal(4, accessors.Count);

// 取得したPropertyAccessorのキーが期待通りであることを確認します。
Assert.Equal(
    ["SomeProperty", "ReadonlyAutoProperty", "ReadonlyBackingFieldProperty", "WriteOnlyBackingFieldProperty"],
    accessors.Keys);