File: ModelBinding\ParameterBinder.cs
Web Access
Project: src\src\Mvc\Mvc.Core\src\Microsoft.AspNetCore.Mvc.Core.csproj (Microsoft.AspNetCore.Mvc.Core)
// Licensed to the .NET Foundation under one or more agreements.
// The .NET Foundation licenses this file to you under the MIT license.
 
using Microsoft.AspNetCore.Mvc.Abstractions;
using Microsoft.AspNetCore.Mvc.Infrastructure;
using Microsoft.AspNetCore.Mvc.ModelBinding.Validation;
using Microsoft.Extensions.Logging;
using Microsoft.Extensions.Options;
 
namespace Microsoft.AspNetCore.Mvc.ModelBinding;
 
/// <summary>
/// Binds and validates models specified by a <see cref="ParameterDescriptor"/>.
/// </summary>
public partial class ParameterBinder
{
    private readonly IModelMetadataProvider _modelMetadataProvider;
    private readonly IModelBinderFactory _modelBinderFactory;
    private readonly IObjectModelValidator _objectModelValidator;
 
    /// <summary>
    /// Initializes a new instance of <see cref="ParameterBinder"/>.
    /// </summary>
    /// <param name="modelMetadataProvider">The <see cref="IModelMetadataProvider"/>.</param>
    /// <param name="modelBinderFactory">The <see cref="IModelBinderFactory"/>.</param>
    /// <param name="validator">The <see cref="IObjectModelValidator"/>.</param>
    /// <param name="mvcOptions">The <see cref="MvcOptions"/> accessor.</param>
    /// <param name="loggerFactory">The <see cref="ILoggerFactory"/>.</param>
    /// <remarks>The <paramref name="mvcOptions"/> parameter is currently ignored.</remarks>
    public ParameterBinder(
        IModelMetadataProvider modelMetadataProvider,
        IModelBinderFactory modelBinderFactory,
        IObjectModelValidator validator,
        IOptions<MvcOptions> mvcOptions,
        ILoggerFactory loggerFactory)
    {
        ArgumentNullException.ThrowIfNull(modelMetadataProvider);
        ArgumentNullException.ThrowIfNull(modelBinderFactory);
        ArgumentNullException.ThrowIfNull(validator);
        ArgumentNullException.ThrowIfNull(mvcOptions);
        ArgumentNullException.ThrowIfNull(loggerFactory);
 
        _modelMetadataProvider = modelMetadataProvider;
        _modelBinderFactory = modelBinderFactory;
        _objectModelValidator = validator;
        Logger = loggerFactory.CreateLogger(GetType());
    }
 
    /// <summary>
    /// The <see cref="ILogger"/> used for logging in this binder.
    /// </summary>
    protected ILogger Logger { get; }
 
    /// <summary>
    /// Binds a model specified by <paramref name="parameter"/> using <paramref name="value"/> as the initial value.
    /// </summary>
    /// <param name="actionContext">The <see cref="ActionContext"/>.</param>
    /// <param name="modelBinder">The <see cref="IModelBinder"/>.</param>
    /// <param name="valueProvider">The <see cref="IValueProvider"/>.</param>
    /// <param name="parameter">The <see cref="ParameterDescriptor"/></param>
    /// <param name="metadata">The <see cref="ModelMetadata"/>.</param>
    /// <param name="value">The initial model value.</param>
    /// <returns>The result of model binding.</returns>
    public virtual Task<ModelBindingResult> BindModelAsync(
        ActionContext actionContext,
        IModelBinder modelBinder,
        IValueProvider valueProvider,
        ParameterDescriptor parameter,
        ModelMetadata metadata,
        object? value)
        => BindModelAsync(actionContext, modelBinder, valueProvider, parameter, metadata, value, container: null).AsTask();
 
    /// <summary>
    /// Binds a model specified by <paramref name="parameter"/> using <paramref name="value"/> as the initial value.
    /// </summary>
    /// <param name="actionContext">The <see cref="ActionContext"/>.</param>
    /// <param name="modelBinder">The <see cref="IModelBinder"/>.</param>
    /// <param name="valueProvider">The <see cref="IValueProvider"/>.</param>
    /// <param name="parameter">The <see cref="ParameterDescriptor"/></param>
    /// <param name="metadata">The <see cref="ModelMetadata"/>.</param>
    /// <param name="value">The initial model value.</param>
    /// <param name="container">The container for the model.</param>
    /// <returns>The result of model binding.</returns>
    public virtual async ValueTask<ModelBindingResult> BindModelAsync(
        ActionContext actionContext,
        IModelBinder modelBinder,
        IValueProvider valueProvider,
        ParameterDescriptor parameter,
        ModelMetadata metadata,
        object? value,
        object? container)
    {
        ArgumentNullException.ThrowIfNull(actionContext);
        ArgumentNullException.ThrowIfNull(modelBinder);
        ArgumentNullException.ThrowIfNull(valueProvider);
        ArgumentNullException.ThrowIfNull(parameter);
        ArgumentNullException.ThrowIfNull(metadata);
 
        Log.AttemptingToBindParameterOrProperty(Logger, parameter, metadata);
 
        if (parameter.BindingInfo?.RequestPredicate?.Invoke(actionContext) == false)
        {
            Log.ParameterBinderRequestPredicateShortCircuit(Logger, parameter, metadata);
            return ModelBindingResult.Failed();
        }
 
        var modelBindingContext = DefaultModelBindingContext.CreateBindingContext(
            actionContext,
            valueProvider,
            metadata,
            parameter.BindingInfo,
            parameter.Name);
        modelBindingContext.Model = value;
 
        var parameterModelName = parameter.BindingInfo?.BinderModelName ?? metadata.BinderModelName;
        if (parameterModelName != null)
        {
            // The name was set explicitly, always use that as the prefix.
            modelBindingContext.ModelName = parameterModelName;
        }
        else if (modelBindingContext.ValueProvider.ContainsPrefix(parameter.Name))
        {
            // We have a match for the parameter name, use that as that prefix.
            modelBindingContext.ModelName = parameter.Name;
        }
        else
        {
            // No match, fallback to empty string as the prefix.
            modelBindingContext.ModelName = string.Empty;
        }
 
        await modelBinder.BindModelAsync(modelBindingContext);
 
        Log.DoneAttemptingToBindParameterOrProperty(Logger, parameter, metadata);
 
        var modelBindingResult = modelBindingContext.Result;
 
        if (_objectModelValidator is ObjectModelValidator baseObjectValidator)
        {
            Log.AttemptingToValidateParameterOrProperty(Logger, parameter, metadata);
 
            EnforceBindRequiredAndValidate(
                baseObjectValidator,
                actionContext,
                parameter,
                metadata,
                modelBindingContext,
                modelBindingResult,
                container);
 
            Log.DoneAttemptingToValidateParameterOrProperty(Logger, parameter, metadata);
        }
        else
        {
            // For legacy implementations (which directly implemented IObjectModelValidator), fall back to the
            // back-compatibility logic. In this scenario, top-level validation attributes will be ignored like
            // they were historically.
            if (modelBindingResult.IsModelSet)
            {
                _objectModelValidator.Validate(
                    actionContext,
                    modelBindingContext.ValidationState,
                    modelBindingContext.ModelName,
                    modelBindingResult.Model);
            }
        }
 
        return modelBindingResult;
    }
 
    private void EnforceBindRequiredAndValidate(
        ObjectModelValidator baseObjectValidator,
        ActionContext actionContext,
        ParameterDescriptor parameter,
        ModelMetadata metadata,
        ModelBindingContext modelBindingContext,
        ModelBindingResult modelBindingResult,
        object? container)
    {
        RecalculateModelMetadata(parameter, modelBindingResult, ref metadata);
 
        if (!modelBindingResult.IsModelSet && metadata.IsBindingRequired)
        {
            // Enforce BindingBehavior.Required (e.g., [BindRequired])
            var modelName = modelBindingContext.FieldName;
            var message = metadata.ModelBindingMessageProvider.MissingBindRequiredValueAccessor(modelName);
            actionContext.ModelState.TryAddModelError(modelName, message);
        }
        else if (modelBindingResult.IsModelSet)
        {
            // Enforce any other validation rules
            baseObjectValidator.Validate(
                actionContext,
                modelBindingContext.ValidationState,
                modelBindingContext.ModelName,
                modelBindingResult.Model,
                metadata,
                container);
        }
        else if (metadata.IsRequired)
        {
            // We need to special case the model name for cases where a 'fallback' to empty
            // prefix occurred but binding wasn't successful. For these cases there will be no
            // entry in validation state to match and determine the correct key.
            //
            // See https://github.com/aspnet/Mvc/issues/7503
            //
            // This is to avoid adding validation errors for an 'empty' prefix when a simple
            // type fails to bind. The fix for #7503 uncovered this issue, and was likely the
            // original problem being worked around that regressed #7503.
            var modelName = modelBindingContext.ModelName;
 
            if (string.IsNullOrEmpty(modelBindingContext.ModelName) &&
                parameter.BindingInfo?.BinderModelName == null)
            {
                // If we get here then this is a fallback case. The model name wasn't explicitly set
                // and we ended up with an empty prefix.
                modelName = modelBindingContext.FieldName;
            }
 
            // Run validation, we expect this to validate [Required].
            baseObjectValidator.Validate(
                actionContext,
                modelBindingContext.ValidationState,
                modelName,
                modelBindingResult.Model,
                metadata,
                container);
        }
    }
 
    private void RecalculateModelMetadata(
        ParameterDescriptor parameter,
        ModelBindingResult modelBindingResult,
        ref ModelMetadata metadata)
    {
        // Attempt to recalculate ModelMetadata for top level parameters and properties using the actual
        // model type. This ensures validation uses a combination of top-level validation metadata
        // as well as metadata on the actual, rather than declared, model type.
 
        if (!modelBindingResult.IsModelSet ||
            modelBindingResult.Model == null ||
            _modelMetadataProvider is not ModelMetadataProvider modelMetadataProvider)
        {
            return;
        }
 
        var modelType = modelBindingResult.Model.GetType();
        if (parameter is IParameterInfoParameterDescriptor parameterInfoParameter)
        {
            var parameterInfo = parameterInfoParameter.ParameterInfo;
            if (modelType != parameterInfo.ParameterType)
            {
                metadata = modelMetadataProvider.GetMetadataForParameter(parameterInfo, modelType);
            }
        }
        else if (parameter is IPropertyInfoParameterDescriptor propertyInfoParameter)
        {
            var propertyInfo = propertyInfoParameter.PropertyInfo;
            if (modelType != propertyInfo.PropertyType)
            {
                metadata = modelMetadataProvider.GetMetadataForProperty(propertyInfo, modelType);
            }
        }
    }
}