|
// Licensed to the .NET Foundation under one or more agreements.
// The .NET Foundation licenses this file to you under the MIT license.
using System.Diagnostics.CodeAnalysis;
using Microsoft.AspNetCore.Internal;
using Microsoft.AspNetCore.Routing;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Logging;
namespace Microsoft.AspNetCore.Http.HttpResults;
/// <summary>
/// An <see cref="IResult"/> that returns a Found (302), Moved Permanently (301), Temporary Redirect (307),
/// or Permanent Redirect (308) response with a Location header.
/// Targets a registered route.
/// </summary>
public sealed partial class RedirectToRouteHttpResult : IResult
{
/// <summary>
/// Initializes a new instance of the <see cref="RedirectToRouteHttpResult"/> with the values
/// provided.
/// </summary>
/// <param name="routeValues">The parameters for the route.</param>
[RequiresUnreferencedCode(RouteValueDictionaryTrimmerWarning.Warning)]
internal RedirectToRouteHttpResult(object? routeValues)
: this(routeName: null, routeValues: routeValues)
{
}
/// <summary>
/// Initializes a new instance of the <see cref="RedirectToRouteHttpResult"/> with the values
/// provided.
/// </summary>
/// <param name="routeName">The name of the route.</param>
/// <param name="routeValues">The parameters for the route.</param>
[RequiresUnreferencedCode(RouteValueDictionaryTrimmerWarning.Warning)]
internal RedirectToRouteHttpResult(
string? routeName,
object? routeValues)
: this(routeName, routeValues, permanent: false)
{
}
/// <summary>
/// Initializes a new instance of the <see cref="RedirectToRouteHttpResult"/> with the values
/// provided.
/// </summary>
/// <param name="routeName">The name of the route.</param>
/// <param name="routeValues">The parameters for the route.</param>
/// <param name="permanent">If set to true, makes the redirect permanent (301).
/// Otherwise a temporary redirect is used (302).</param>
[RequiresUnreferencedCode(RouteValueDictionaryTrimmerWarning.Warning)]
internal RedirectToRouteHttpResult(
string? routeName,
object? routeValues,
bool permanent)
: this(routeName, routeValues, permanent, fragment: null)
{
}
/// <summary>
/// Initializes a new instance of the <see cref="RedirectToRouteHttpResult"/> with the values
/// provided.
/// </summary>
/// <param name="routeName">The name of the route.</param>
/// <param name="routeValues">The parameters for the route.</param>
/// <param name="permanent">If set to true, makes the redirect permanent (301).
/// Otherwise a temporary redirect is used (302).</param>
/// <param name="fragment">The fragment to add to the URL.</param>
[RequiresUnreferencedCode(RouteValueDictionaryTrimmerWarning.Warning)]
internal RedirectToRouteHttpResult(
string? routeName,
object? routeValues,
bool permanent,
string? fragment)
: this(routeName, routeValues, permanent, preserveMethod: false, fragment: fragment)
{
}
/// <summary>
/// Initializes a new instance of the <see cref="RedirectToRouteHttpResult"/> with the values
/// provided.
/// </summary>
/// <param name="routeName">The name of the route.</param>
/// <param name="routeValues">The parameters for the route.</param>
/// <param name="permanent">If set to true, makes the redirect permanent (301).
/// Otherwise a temporary redirect is used (302).</param>
/// <param name="preserveMethod">If set to true, make the temporary redirect (307)
/// or permanent redirect (308) preserve the initial request method.</param>
/// <param name="fragment">The fragment to add to the URL.</param>
[RequiresUnreferencedCode(RouteValueDictionaryTrimmerWarning.Warning)]
internal RedirectToRouteHttpResult(
string? routeName,
object? routeValues,
bool permanent,
bool preserveMethod,
string? fragment) : this(
routeName,
new RouteValueDictionary(routeValues),
permanent,
preserveMethod,
fragment)
{
}
/// <summary>
/// Initializes a new instance of the <see cref="RedirectToRouteHttpResult"/> with the values
/// provided.
/// </summary>
/// <param name="routeName">The name of the route.</param>
/// <param name="routeValues">The parameters for the route.</param>
/// <param name="permanent">If set to true, makes the redirect permanent (301).
/// Otherwise a temporary redirect is used (302).</param>
/// <param name="preserveMethod">If set to true, make the temporary redirect (307)
/// or permanent redirect (308) preserve the initial request method.</param>
/// <param name="fragment">The fragment to add to the URL.</param>
internal RedirectToRouteHttpResult(
string? routeName,
RouteValueDictionary? routeValues,
bool permanent,
bool preserveMethod,
string? fragment)
{
RouteName = routeName;
RouteValues = routeValues ?? new RouteValueDictionary();
PreserveMethod = preserveMethod;
Permanent = permanent;
Fragment = fragment;
}
/// <summary>
/// Gets the name of the route to use for generating the URL.
/// </summary>
public string? RouteName { get; }
/// <summary>
/// Gets the route data to use for generating the URL.
/// </summary>
public RouteValueDictionary RouteValues { get; }
/// <summary>
/// Gets the value that specifies that the redirect should be permanent if true or temporary if false.
/// </summary>
public bool Permanent { get; }
/// <summary>
/// Gets an indication that the redirect preserves the initial request method.
/// </summary>
public bool PreserveMethod { get; }
/// <summary>
/// Gets the fragment to add to the URL.
/// </summary>
public string? Fragment { get; }
/// <inheritdoc />
public Task ExecuteAsync(HttpContext httpContext)
{
ArgumentNullException.ThrowIfNull(httpContext);
var linkGenerator = httpContext.RequestServices.GetRequiredService<LinkGenerator>();
var destinationUrl = linkGenerator.GetUriByRouteValues(
httpContext,
RouteName,
RouteValues,
fragment: Fragment == null ? FragmentString.Empty : new FragmentString("#" + Fragment));
if (string.IsNullOrEmpty(destinationUrl))
{
throw new InvalidOperationException("No route matches the supplied values.");
}
// Creating the logger with a string to preserve the category after the refactoring.
var loggerFactory = httpContext.RequestServices.GetRequiredService<ILoggerFactory>();
var logger = loggerFactory.CreateLogger("Microsoft.AspNetCore.Http.Result.RedirectToRouteResult");
Log.RedirectToRouteResultExecuting(logger, destinationUrl, RouteName);
if (PreserveMethod)
{
httpContext.Response.StatusCode = Permanent ?
StatusCodes.Status308PermanentRedirect : StatusCodes.Status307TemporaryRedirect;
httpContext.Response.Headers.Location = destinationUrl;
}
else
{
httpContext.Response.Redirect(destinationUrl, Permanent);
}
return Task.CompletedTask;
}
private static partial class Log
{
[LoggerMessage(1, LogLevel.Information,
"Executing RedirectToRouteResult, redirecting to {Destination} from route {RouteName}.",
EventName = "RedirectToRouteResultExecuting")]
public static partial void RedirectToRouteResultExecuting(ILogger logger, string destination, string? routeName);
}
}
|