File: ModelBinding\EnumerableValueProviderTest.cs
Web Access
Project: src\src\Mvc\Mvc.Core\test\Microsoft.AspNetCore.Mvc.Core.Test.csproj (Microsoft.AspNetCore.Mvc.Core.Test)
// Licensed to the .NET Foundation under one or more agreements.
// The .NET Foundation licenses this file to you under the MIT license.
 
using System.Globalization;
using Microsoft.Extensions.Primitives;
 
namespace Microsoft.AspNetCore.Mvc.ModelBinding;
 
public abstract class EnumerableValueProviderTest
{
    protected static Dictionary<string, StringValues> BackingStore { get; } = new Dictionary<string, StringValues>
        {
            { "some", new[] { "someValue1", "someValue2" } },
            { "null_value", StringValues.Empty },
            { "prefix.name", new[] { "someOtherValue" } },
            { "prefix.null_value", StringValues.Empty },
            { "prefix.property1.property", StringValues.Empty },
            { "prefix.property2[index]", StringValues.Empty },
            { "prefix[index1]", StringValues.Empty },
            { "prefix[index1].property1", StringValues.Empty },
            { "prefix[index1].property2", StringValues.Empty },
            { "prefix[index2].property", StringValues.Empty },
            { "[index]", StringValues.Empty },
            { "[index].property", StringValues.Empty },
            { "[index][anotherIndex]", StringValues.Empty },
        };
 
    [Fact]
    public void ContainsPrefix_WithEmptyCollection_ReturnsFalseForEmptyPrefix()
    {
        // Arrange
        var backingStore = new Dictionary<string, StringValues>();
        var valueProvider = GetEnumerableValueProvider(BindingSource.Query, backingStore, culture: null);
 
        // Act
        var result = valueProvider.ContainsPrefix(string.Empty);
 
        // Assert
        Assert.False(result);
    }
 
    [Fact]
    public void ContainsPrefix_WithNonEmptyCollection_ReturnsTrueForEmptyPrefix()
    {
        // Arrange
        var valueProvider = GetEnumerableValueProvider(BindingSource.Query, BackingStore, culture: null);
 
        // Act
        var result = valueProvider.ContainsPrefix(string.Empty);
 
        // Assert
        Assert.True(result);
    }
 
    [Theory]
    [InlineData("some")]
    [InlineData("prefix")]
    [InlineData("prefix.name")]
    [InlineData("[index]")]
    [InlineData("prefix[index1]")]
    public void ContainsPrefix_WithNonEmptyCollection_ReturnsTrueForKnownPrefixes(string prefix)
    {
        // Arrange
        var valueProvider = GetEnumerableValueProvider(BindingSource.Query, BackingStore, culture: null);
 
        // Act & Assert
        Assert.True(valueProvider.ContainsPrefix(prefix));
    }
 
    [Fact]
    public void ContainsPrefix_WithNonEmptyCollection_ReturnsFalseForUnknownPrefix()
    {
        // Arrange
        var valueProvider = GetEnumerableValueProvider(BindingSource.Query, BackingStore, culture: null);
 
        // Act
        var result = valueProvider.ContainsPrefix("biff");
 
        // Assert
        Assert.False(result);
    }
 
    [Fact]
    public void GetKeysFromPrefix_EmptyPrefix_ReturnsAllPrefixes()
    {
        // Arrange
        var expected = new Dictionary<string, string>
            {
                { "index", "[index]" },
                { "null_value", "null_value" },
                { "prefix", "prefix" },
                { "some", "some" },
            };
        var valueProvider = GetEnumerableValueProvider(BindingSource.Query, BackingStore, culture: null);
 
        // Act
        var result = valueProvider.GetKeysFromPrefix(string.Empty);
 
        // Assert
        Assert.Equal(expected, result.OrderBy(kvp => kvp.Key));
    }
 
    [Fact]
    public void GetKeysFromPrefix_UnknownPrefix_ReturnsEmptyDictionary()
    {
        // Arrange
        var valueProvider = GetEnumerableValueProvider(BindingSource.Query, BackingStore, culture: null);
 
        // Act
        var result = valueProvider.GetKeysFromPrefix("abc");
 
        // Assert
        Assert.Empty(result);
    }
 
    [Fact]
    public void GetKeysFromPrefix_KnownPrefix_ReturnsMatchingItems()
    {
        // Arrange
        var expected = new Dictionary<string, string>
            {
                { "name", "prefix.name" },
                { "null_value", "prefix.null_value" },
                { "property1", "prefix.property1" },
                { "property2", "prefix.property2" },
                { "index1", "prefix[index1]" },
                { "index2", "prefix[index2]" },
            };
        var valueProvider = GetEnumerableValueProvider(BindingSource.Query, BackingStore, culture: null);
 
        // Act
        var result = valueProvider.GetKeysFromPrefix("prefix");
 
        // Assert
        Assert.Equal(expected, result);
    }
 
    [Fact]
    public void GetKeysFromPrefix_IndexPrefix_ReturnsMatchingItems()
    {
        // Arrange
        var expected = new Dictionary<string, string>
            {
                { "property", "[index].property" },
                { "anotherIndex", "[index][anotherIndex]" }
            };
        var valueProvider = GetEnumerableValueProvider(BindingSource.Query, BackingStore, culture: null);
 
        // Act
        var result = valueProvider.GetKeysFromPrefix("[index]");
 
        // Assert
        Assert.Equal(expected, result);
    }
 
    [Fact]
    public void GetValue_SingleValue()
    {
        // Arrange
        var culture = new CultureInfo("fr-FR");
        var valueProvider = GetEnumerableValueProvider(BindingSource.Query, BackingStore, culture);
 
        // Act
        var result = valueProvider.GetValue("prefix.name");
 
        // Assert
        Assert.Equal("someOtherValue", (string)result);
        Assert.Equal(culture, result.Culture);
    }
 
    [Fact]
    public void GetValue_MultiValue()
    {
        // Arrange
        var culture = new CultureInfo("fr-FR");
        var valueProvider = GetEnumerableValueProvider(BindingSource.Query, BackingStore, culture);
 
        // Act
        var result = valueProvider.GetValue("some");
 
        // Assert
        Assert.Equal(new[] { "someValue1", "someValue2" }, result.Values);
        Assert.Equal("someValue1,someValue2", (string)result);
        Assert.Equal(culture, result.Culture);
    }
 
    [Theory]
    [InlineData("null_value")]
    [InlineData("prefix.null_value")]
    public void GetValue_NullValue(string key)
    {
        // Arrange
        var culture = new CultureInfo("fr-FR");
        var valueProvider = GetEnumerableValueProvider(BindingSource.Query, BackingStore, culture);
 
        // Act
        var result = valueProvider.GetValue(key);
 
        // Assert
        Assert.Equal(ValueProviderResult.None, result);
    }
 
    [Fact]
    public void GetValue_NullMultipleValue()
    {
        // Arrange
        var backingStore = new Dictionary<string, StringValues>
            {
                { "key", new string[] { null, null, "value" } },
            };
        var culture = new CultureInfo("fr-FR");
        var valueProvider = GetEnumerableValueProvider(BindingSource.Query, backingStore, culture);
 
        // Act
        var result = valueProvider.GetValue("key");
 
        // Assert
        Assert.Equal(new[] { null, null, "value" }, result.Values);
    }
 
    [Fact]
    public void GetValue_ReturnsNullIfKeyNotFound()
    {
        // Arrange
        var valueProvider = GetEnumerableValueProvider(BindingSource.Query, BackingStore, culture: null);
 
        // Act
        var result = valueProvider.GetValue("prefix");
 
        // Assert
        Assert.Equal(ValueProviderResult.None, result);
    }
 
    [Fact]
    public virtual void GetValue_EmptyKey()
    {
        // Arrange
        var store = new Dictionary<string, StringValues>(BackingStore)
            {
                { string.Empty, "some-value" },
            };
        var valueProvider = GetEnumerableValueProvider(BindingSource.Query, store, culture: null);
 
        // Act
        var result = valueProvider.GetValue(string.Empty);
 
        // Assert
        Assert.Equal(ValueProviderResult.None, result);
    }
 
    [Fact]
    public virtual void FilterInclude()
    {
        // Arrange
        var provider = GetBindingSourceValueProvider(BindingSource.Query, BackingStore, culture: null);
 
        var bindingSource = new BindingSource(
            BindingSource.Query.Id,
            displayName: null,
            isGreedy: true,
            isFromRequest: true);
 
        // Act
        var result = provider.Filter(bindingSource);
 
        // Assert
        Assert.NotNull(result);
        Assert.Same(result, provider);
    }
 
    [Fact]
    public void FilterExclude()
    {
        // Arrange
        var provider = GetBindingSourceValueProvider(BindingSource.Query, BackingStore, culture: null);
 
        var bindingSource = new BindingSource(
            "Test",
            displayName: null,
            isGreedy: true,
            isFromRequest: true);
 
        // Act
        var result = provider.Filter(bindingSource);
 
        // Assert
        Assert.Null(result);
    }
 
    protected IBindingSourceValueProvider GetBindingSourceValueProvider(
        BindingSource bindingSource,
        Dictionary<string, StringValues> values,
        CultureInfo culture)
    {
        var provider = GetEnumerableValueProvider(bindingSource, values, culture) as IBindingSourceValueProvider;
 
        // All IEnumerableValueProvider implementations also implement IBindingSourceValueProvider.
        Assert.NotNull(provider);
 
        return provider;
    }
 
    protected abstract IEnumerableValueProvider GetEnumerableValueProvider(
        BindingSource bindingSource,
        Dictionary<string, StringValues> values,
        CultureInfo culture);
}