File: RequestBuilder.cs
Web Access
Project: src\src\Hosting\TestHost\src\Microsoft.AspNetCore.TestHost.csproj (Microsoft.AspNetCore.TestHost)
// Licensed to the .NET Foundation under one or more agreements.
// The .NET Foundation licenses this file to you under the MIT license.
 
using System.Net.Http;
 
namespace Microsoft.AspNetCore.TestHost;
 
/// <summary>
/// Used to construct a HttpRequestMessage object.
/// </summary>
public class RequestBuilder
{
    private readonly HttpRequestMessage _req;
 
    /// <summary>
    /// Construct a new HttpRequestMessage with the given path.
    /// </summary>
    /// <param name="server"></param>
    /// <param name="path"></param>
    public RequestBuilder(TestServer server, string path)
    {
        TestServer = server ?? throw new ArgumentNullException(nameof(server));
        _req = new HttpRequestMessage(HttpMethod.Get, path);
    }
 
    /// <summary>
    /// Gets the <see cref="TestServer"/> instance for which the request is being built.
    /// </summary>
    public TestServer TestServer { get; }
 
    /// <summary>
    /// Configure any HttpRequestMessage properties.
    /// </summary>
    /// <param name="configure"></param>
    /// <returns>This <see cref="RequestBuilder"/> for chaining.</returns>
    public RequestBuilder And(Action<HttpRequestMessage> configure)
    {
        ArgumentNullException.ThrowIfNull(configure);
 
        configure(_req);
        return this;
    }
 
    /// <summary>
    /// Add the given header and value to the request or request content.
    /// </summary>
    /// <param name="name"></param>
    /// <param name="value"></param>
    /// <returns>This <see cref="RequestBuilder"/> for chaining.</returns>
    public RequestBuilder AddHeader(string name, string value)
    {
        if (!_req.Headers.TryAddWithoutValidation(name, value))
        {
            if (_req.Content == null)
            {
                _req.Content = new StreamContent(Stream.Null);
            }
            if (!_req.Content.Headers.TryAddWithoutValidation(name, value))
            {
                // TODO: throw new ArgumentException(string.Format(CultureInfo.CurrentCulture, Resources.InvalidHeaderName, name), "name");
                throw new ArgumentException("Invalid header name: " + name, nameof(name));
            }
        }
        return this;
    }
 
    /// <summary>
    /// Set the request method and start processing the request.
    /// </summary>
    /// <param name="method"></param>
    /// <returns>The resulting <see cref="HttpResponseMessage"/>.</returns>
    public Task<HttpResponseMessage> SendAsync(string method)
    {
        _req.Method = new HttpMethod(method);
        return TestServer.CreateClient().SendAsync(_req);
    }
 
    /// <summary>
    /// Set the request method to GET and start processing the request.
    /// </summary>
    /// <returns>The resulting <see cref="HttpResponseMessage"/>.</returns>
    public Task<HttpResponseMessage> GetAsync()
    {
        _req.Method = HttpMethod.Get;
        return TestServer.CreateClient().SendAsync(_req);
    }
 
    /// <summary>
    /// Set the request method to POST and start processing the request.
    /// </summary>
    /// <returns>The resulting <see cref="HttpResponseMessage"/>.</returns>
    public Task<HttpResponseMessage> PostAsync()
    {
        _req.Method = HttpMethod.Post;
        return TestServer.CreateClient().SendAsync(_req);
    }
}