File: ContentNegotiationTest.cs
Web Access
Project: src\src\Mvc\test\Mvc.FunctionalTests\Microsoft.AspNetCore.Mvc.FunctionalTests.csproj (Microsoft.AspNetCore.Mvc.FunctionalTests)
// 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;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Runtime.Serialization;
using System.Text;
using BasicWebSite.Models;
using Microsoft.AspNetCore.Mvc.Formatters.Xml;
using Microsoft.AspNetCore.InternalTesting;
using Newtonsoft.Json;
using Microsoft.Extensions.Logging;
using System.Reflection;
using Xunit.Abstractions;
 
namespace Microsoft.AspNetCore.Mvc.FunctionalTests;
 
public class ContentNegotiationTest : LoggedTest
{
    protected override void Initialize(TestContext context, MethodInfo methodInfo, object[] testMethodArguments, ITestOutputHelper testOutputHelper)
    {
        base.Initialize(context, methodInfo, testMethodArguments, testOutputHelper);
        Factory = new MvcTestFixture<BasicWebSite.StartupWithoutEndpointRouting>(LoggerFactory);
        Client = Factory.CreateDefaultClient();
    }
 
    public override void Dispose()
    {
        Factory.Dispose();
        base.Dispose();
    }
 
    public MvcTestFixture<BasicWebSite.StartupWithoutEndpointRouting> Factory { get; private set; }
    public HttpClient Client { get; private set; }
 
    [Fact]
    public async Task ProducesAttribute_SingleContentType_PicksTheFirstSupportedFormatter()
    {
        // Arrange
        // Selects custom even though it is last in the list.
        var expectedContentType = MediaTypeHeaderValue.Parse("application/custom;charset=utf-8");
        var expectedBody = "Written using custom format.";
 
        // Act
        var response = await Client.GetAsync("http://localhost/Normal/WriteUserUsingCustomFormat");
 
        // Assert
        Assert.Equal(expectedContentType, response.Content.Headers.ContentType);
        var body = await response.Content.ReadAsStringAsync();
        Assert.Equal(expectedBody, body);
    }
 
    [Fact]
    public async Task ProducesAttribute_MultipleContentTypes_RunsConnegToSelectFormatter()
    {
        // Arrange
        var expectedContentType = MediaTypeHeaderValue.Parse("application/json;charset=utf-8");
        var expectedBody = $"{{{Environment.NewLine}  \"name\": \"My name\",{Environment.NewLine}" +
            $"  \"address\": \"My address\"{Environment.NewLine}}}";
 
        // Act
        var response = await Client.GetAsync("http://localhost/Normal/MultipleAllowedContentTypes");
 
        // Assert
        Assert.Equal(expectedContentType, response.Content.Headers.ContentType);
        var body = await response.Content.ReadAsStringAsync();
        Assert.Equal(expectedBody, body);
    }
 
    [Fact]
    public async Task NoProducesAttribute_ActionReturningString_RunsUsingTextFormatter()
    {
        // Arrange
        var expectedContentType = MediaTypeHeaderValue.Parse("text/plain;charset=utf-8");
        var expectedBody = "NormalController";
 
        // Act
        var response = await Client.GetAsync("http://localhost/Normal/ReturnClassName");
 
        // Assert
        Assert.Equal(expectedContentType, response.Content.Headers.ContentType);
        var body = await response.Content.ReadAsStringAsync();
        Assert.Equal(expectedBody, body);
    }
 
    [Fact]
    public async Task NoProducesAttribute_ActionReturningAnyObject_RunsUsingDefaultFormatters()
    {
        // Arrange
        var expectedContentType = MediaTypeHeaderValue.Parse("application/json;charset=utf-8");
 
        // Act
        var response = await Client.GetAsync("http://localhost/Normal/ReturnUser");
 
        // Assert
        Assert.Equal(expectedContentType, response.Content.Headers.ContentType);
    }
 
    [Theory]
    [InlineData("/;q=0.9")]
    [InlineData("/;q=0.9, invalid;q=0.5;application/json;q=0.1")]
    [InlineData("/invalid;q=0.9, application/json;q=0.1,invalid;q=0.5")]
    [InlineData("text/html, application/json, image/jpeg, *; q=.2, */*; q=.2")]
    public async Task ContentNegotiationWithPartiallyValidAcceptHeader_SkipsInvalidEntries(string acceptHeader)
    {
        // Arrange
        var expectedContentType = MediaTypeHeaderValue.Parse("application/json;charset=utf-8");
        var request = new HttpRequestMessage(HttpMethod.Get, "http://localhost/ContentNegotiation/UserInfo_ProducesWithTypeOnly");
        request.Headers.TryAddWithoutValidation("Accept", acceptHeader);
 
        // Act
        var response = await Client.SendAsync(request);
 
        // Assert
        Assert.Equal(HttpStatusCode.OK, response.StatusCode);
        Assert.Equal(expectedContentType, response.Content.Headers.ContentType);
    }
 
    [Fact]
    public async Task ProducesAttributeWithTypeOnly_RunsRegularContentNegotiation()
    {
        // Arrange
        var expectedContentType = MediaTypeHeaderValue.Parse("application/json;charset=utf-8");
        var expectedOutput = "{\"name\":\"John\",\"address\":\"One Microsoft Way\"}"{\"name\":\"John\",\"address\":\"One Microsoft Way\"}";
        var request = new HttpRequestMessage(
            HttpMethod.Get,
            "http://localhost/ContentNegotiation/UserInfo_ProducesWithTypeOnly");
        request.Headers.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
 
        // Act
        var response = await Client.SendAsync(request);
 
        // Assert
        Assert.Equal(HttpStatusCode.OK, response.StatusCode);
        Assert.Equal(expectedContentType, response.Content.Headers.ContentType);
        var actual = await response.Content.ReadAsStringAsync();
        Assert.Equal(expectedOutput, actual);
    }
 
    [ConditionalFact]
    // Mono issue - https://github.com/aspnet/External/issues/18
    [FrameworkSkipCondition(RuntimeFrameworks.Mono)]
    public async Task ProducesAttribute_WithTypeAndContentType_UsesContentType()
    {
        // Arrange
        var expectedContentType = MediaTypeHeaderValue.Parse("application/xml;charset=utf-8");
        var expectedOutput = "<User xmlns:i=\"http://www.w3.org/2001/XMLSchema-instance\" " +
            "xmlns=\"http://schemas.datacontract.org/2004/07/BasicWebSite.Models\">" +
            "<Address>One Microsoft Way</Address><Name>John</Name></User>";
        var request = new HttpRequestMessage(
            HttpMethod.Get,
            "http://localhost/ContentNegotiation/UserInfo_ProducesWithTypeAndContentType");
        request.Headers.Accept.Add(new MediaTypeWithQualityHeaderValue("application/xml"));
 
        // Act
        var response = await Client.SendAsync(request);
 
        // Assert
        Assert.Equal(HttpStatusCode.OK, response.StatusCode);
        Assert.Equal(expectedContentType, response.Content.Headers.ContentType);
        var actual = await response.Content.ReadAsStringAsync();
        XmlAssert.Equal(expectedOutput, actual);
    }
 
    [Theory]
    [InlineData("http://localhost/FallbackOnTypeBasedMatch/UseTheFallback_WithDefaultFormatters")]
    [InlineData("http://localhost/FallbackOnTypeBasedMatch/OverrideTheFallback_WithDefaultFormatters")]
    public async Task NoAcceptAndRequestContentTypeHeaders_UsesFirstFormatterWhichCanWriteType(string url)
    {
        // Arrange
        var expectedContentType = MediaTypeHeaderValue.Parse("application/json;charset=utf-8");
 
        // Act
        var response = await Client.GetAsync(url + "?input=100");
 
        // Assert
        Assert.Equal(HttpStatusCode.OK, response.StatusCode);
        Assert.Equal(expectedContentType, response.Content.Headers.ContentType);
        var actual = await response.Content.ReadAsStringAsync();
        Assert.Equal("100", actual);
    }
 
    [Fact]
    public async Task NoMatchingFormatter_ForTheGivenContentType_Returns406()
    {
        // Arrange & Act
        var response = await Client.GetAsync("http://localhost/Normal/ReturnUser_NoMatchingFormatter");
 
        // Assert
        Assert.Equal(HttpStatusCode.NotAcceptable, response.StatusCode);
    }
 
    [Theory]
    [InlineData(
        "ContactInfoUsingV3Format",
        "text/vcard; version=v3.0; charset=utf-8",
        @"BEGIN:VCARD
FN:John Williams
END:VCARD
")]
    [InlineData(
        "ContactInfoUsingV4Format",
        "text/vcard; version=v4.0; charset=utf-8",
        @"BEGIN:VCARD
FN:John Williams
GENDER:M
END:VCARD
")]
    public async Task ProducesAttribute_WithMediaTypeHavingParameters_IsCaseInsensitiveMatch(
        string action,
        string expectedMediaType,
        string expectedResponseBody)
    {
        // Arrange & Act
        var response = await Client.GetAsync("http://localhost/ProducesWithMediaTypeParameters/" + action);
 
        // Assert
        Assert.Equal(HttpStatusCode.OK, response.StatusCode);
        Assert.NotNull(response.Content);
        var contentType = response.Content.Headers.ContentType;
        Assert.NotNull(contentType);
        Assert.Equal(expectedMediaType, contentType.ToString());
 
        var actualResponseBody = await response.Content.ReadAsStringAsync();
        Assert.Equal(expectedResponseBody, actualResponseBody, ignoreLineEndingDifferences: true);
    }
 
    [Fact]
    public async Task ProducesAttribute_OnAction_OverridesTheValueOnClass()
    {
        // Arrange
        // Value on the class is application/json.
        var expectedContentType = MediaTypeHeaderValue.Parse(
            "application/custom_ProducesContentBaseController_Action;charset=utf-8");
        var expectedBody = "ProducesContentBaseController";
 
        // Act
        var response = await Client.GetAsync("http://localhost/ProducesContentBase/ReturnClassName");
 
        // Assert
        Assert.Equal(expectedContentType, response.Content.Headers.ContentType);
        var body = await response.Content.ReadAsStringAsync();
        Assert.Equal(expectedBody, body);
    }
 
    [Fact]
    public async Task ProducesAttribute_OnDerivedClass_OverridesTheValueOnBaseClass()
    {
        // Arrange
        var expectedContentType = MediaTypeHeaderValue.Parse(
            "application/custom_ProducesContentOnClassController;charset=utf-8");
        var expectedBody = "ProducesContentOnClassController";
 
        // Act
        var response = await Client.GetAsync(
            "http://localhost/ProducesContentOnClass/ReturnClassNameWithNoContentTypeOnAction");
 
        // Assert
        Assert.Equal(expectedContentType, response.Content.Headers.ContentType);
        var body = await response.Content.ReadAsStringAsync();
        Assert.Equal(expectedBody, body);
    }
 
    [Fact]
    public async Task ProducesAttribute_OnDerivedAction_OverridesTheValueOnBaseClass()
    {
        // Arrange
        var expectedContentType = MediaTypeHeaderValue.Parse(
            "application/custom_NoProducesContentOnClassController_Action;charset=utf-8");
        var expectedBody = "NoProducesContentOnClassController";
 
        // Act
        var response = await Client.GetAsync("http://localhost/NoProducesContentOnClass/ReturnClassName");
 
        // Assert
        Assert.Equal(expectedContentType, response.Content.Headers.ContentType);
        var body = await response.Content.ReadAsStringAsync();
        Assert.Equal(expectedBody, body);
    }
 
    [Fact]
    public async Task ProducesAttribute_OnDerivedAction_OverridesTheValueOnBaseAction()
    {
        // Arrange
        var expectedContentType = MediaTypeHeaderValue.Parse(
            "application/custom_NoProducesContentOnClassController_Action;charset=utf-8");
        var expectedBody = "NoProducesContentOnClassController";
 
        // Act
        var response = await Client.GetAsync("http://localhost/NoProducesContentOnClass/ReturnClassName");
 
        // Assert
        Assert.Equal(expectedContentType, response.Content.Headers.ContentType);
        var body = await response.Content.ReadAsStringAsync();
        Assert.Equal(expectedBody, body);
    }
 
    [Fact]
    public async Task ProducesAttribute_OnDerivedClassAndAction_OverridesTheValueOnBaseClass()
    {
        // Arrange
        var expectedContentType = MediaTypeHeaderValue.Parse(
            "application/custom_ProducesContentOnClassController_Action;charset=utf-8");
        var expectedBody = "ProducesContentOnClassController";
 
        // Act
        var response = await Client.GetAsync(
            "http://localhost/ProducesContentOnClass/ReturnClassNameContentTypeOnDerivedAction");
 
        // Assert
        Assert.Equal(expectedContentType, response.Content.Headers.ContentType);
        var body = await response.Content.ReadAsStringAsync();
        Assert.Equal(expectedBody, body);
    }
 
    [Fact]
    public async Task ProducesAttribute_IsNotHonored_ForJsonResult()
    {
        // Arrange
        var expectedContentType = MediaTypeHeaderValue.Parse("application/json;charset=utf-8");
        var expectedBody = "{\"methodName\":\"Produces_WithNonObjectResult\"}"{\"methodName\":\"Produces_WithNonObjectResult\"}";
 
        // Act
        var response = await Client.GetAsync("http://localhost/ProducesJson/Produces_WithNonObjectResult");
 
        // Assert
        Assert.Equal(expectedContentType, response.Content.Headers.ContentType);
        var body = await response.Content.ReadAsStringAsync();
        Assert.Equal(expectedBody, body);
    }
 
    [ConditionalFact]
    // Mono issue - https://github.com/aspnet/External/issues/18
    [FrameworkSkipCondition(RuntimeFrameworks.Mono)]
    public async Task XmlFormatter_SupportedMediaType_DoesNotChangeAcrossRequests()
    {
        // Arrange
        var expectedContentType = MediaTypeHeaderValue.Parse("application/xml;charset=utf-8");
        var expectedBody = @"<User xmlns:i=""http://www.w3.org/2001/XMLSchema-instance"" " +
            @"xmlns=""http://schemas.datacontract.org/2004/07/BasicWebSite.Models""><Address>" +
            @"One Microsoft Way</Address><Name>John</Name></User>";
 
        for (int i = 0; i < 5; i++)
        {
            var request = new HttpRequestMessage(HttpMethod.Get, "http://localhost/ContentNegotiation/UserInfo");
            request.Headers.Accept.Add(new MediaTypeWithQualityHeaderValue("application/xml"));
            request.Headers.AcceptCharset.Add(new StringWithQualityHeaderValue("utf-8"));
 
            // Act and Assert
            var response = await Client.SendAsync(request);
 
            Assert.Equal(expectedContentType, response.Content.Headers.ContentType);
            var body = await response.Content.ReadAsStringAsync();
            Assert.Equal(expectedBody, body);
        }
    }
 
    [Theory]
    [InlineData(null)]
    [InlineData("text/plain")]
    [InlineData("text/plain; charset=utf-8")]
    [InlineData("text/html, application/xhtml+xml, image/jxr, */*")] // typical browser accept header
    public async Task ObjectResult_WithStringReturnType_DefaultToTextPlain(string acceptMediaType)
    {
        // Arrange
        var request = new HttpRequestMessage(HttpMethod.Get, "FallbackOnTypeBasedMatch/ReturnString");
        request.Headers.Accept.ParseAdd(acceptMediaType);
 
        // Act
        var response = await Client.SendAsync(request);
 
        // Assert
        Assert.Equal(HttpStatusCode.OK, response.StatusCode);
        Assert.Equal("text/plain; charset=utf-8", response.Content.Headers.ContentType.ToString());
        var actualBody = await response.Content.ReadAsStringAsync();
        Assert.Equal("Hello World!", actualBody);
    }
 
    [Fact]
    public async Task ObjectResult_WithStringReturnType_AndNonTextPlainMediaType_DoesNotReturnTextPlain()
    {
        // Arrange
        var targetUri = "http://localhost/FallbackOnTypeBasedMatch/ReturnString";
        var request = new HttpRequestMessage(HttpMethod.Get, targetUri);
        request.Headers.Accept.Add(MediaTypeWithQualityHeaderValue.Parse("application/json"));
 
        // Act
        var response = await Client.SendAsync(request);
 
        // Assert
        Assert.Equal(HttpStatusCode.OK, response.StatusCode);
        Assert.Equal("application/json; charset=utf-8", response.Content.Headers.ContentType.ToString());
        var actualBody = await response.Content.ReadAsStringAsync();
        Assert.Equal("\"Hello World!\"", actualBody);
    }
 
    [Fact]
    public async Task NoMatchOn_RequestContentType_FallsBackOnTypeBasedMatch_NoMatchFound_Returns406()
    {
        // Arrange
        var targetUri = "http://localhost/FallbackOnTypeBasedMatch/FallbackGivesNoMatch/?input=1234";
        var content = new StringContent("1234", Encoding.UTF8, "application/custom");
        var request = new HttpRequestMessage(HttpMethod.Post, targetUri);
        request.Headers.Accept.Add(MediaTypeWithQualityHeaderValue.Parse("application/custom1"));
        request.Content = content;
 
        // Act
        var response = await Client.SendAsync(request);
 
        // Assert
        Assert.Equal(HttpStatusCode.NotAcceptable, response.StatusCode);
    }
 
    [Fact]
    public async Task InvalidResponseContentType_WithNotMatchingAcceptHeader_Returns406()
    {
        // Arrange
        var targetUri = "http://localhost/InvalidContentType/SetResponseContentTypeJson";
        var request = new HttpRequestMessage(HttpMethod.Get, targetUri);
        request.Headers.Accept.Add(MediaTypeWithQualityHeaderValue.Parse("application/custom1"));
 
        // Act
        var response = await Client.SendAsync(request);
 
        // Assert
        Assert.Equal(HttpStatusCode.NotAcceptable, response.StatusCode);
    }
 
    [Fact]
    public async Task InvalidResponseContentType_WithMatchingAcceptHeader_Returns406()
    {
        // Arrange
        var targetUri = "http://localhost/InvalidContentType/SetResponseContentTypeJson";
        var request = new HttpRequestMessage(HttpMethod.Get, targetUri);
        request.Headers.Accept.Add(MediaTypeWithQualityHeaderValue.Parse("application/json"));
 
        // Act
        var response = await Client.SendAsync(request);
 
        // Assert
        Assert.Equal(HttpStatusCode.NotAcceptable, response.StatusCode);
    }
 
    [Fact]
    public async Task InvalidResponseContentType_WithoutAcceptHeader_Returns406()
    {
        // Arrange
        var targetUri = "http://localhost/InvalidContentType/SetResponseContentTypeJson";
        var request = new HttpRequestMessage(HttpMethod.Get, targetUri);
 
        // Act
        var response = await Client.SendAsync(request);
 
        // Assert
        Assert.Equal(HttpStatusCode.NotAcceptable, response.StatusCode);
    }
 
    [Fact]
    public async Task ProducesAttribute_And_FormatFilterAttribute_Conflicting()
    {
        // Arrange & Act
        var response = await Client.GetAsync(
            "http://localhost/FormatFilter/ProducesTakesPrecedenceOverUserSuppliedFormatMethod?format=json");
 
        // Assert
        // Explicit content type set by the developer takes precedence over the format requested by the end user
        Assert.Equal(HttpStatusCode.NotFound, response.StatusCode);
    }
 
    [Fact]
    public async Task ProducesAttribute_And_FormatFilterAttribute_Collaborating()
    {
        // Arrange & Act
        var response = await Client.GetAsync(
            "http://localhost/FormatFilter/ProducesTakesPrecedenceOverUserSuppliedFormatMethod");
 
        // Assert
        Assert.Equal(HttpStatusCode.OK, response.StatusCode);
        var body = await response.Content.ReadAsStringAsync();
        Assert.Equal("MethodWithFormatFilter", body);
    }
 
    [Fact]
    public async Task ProducesAttribute_CustomMediaTypeWithJsonSuffix_RunsConnegAndSelectsJsonFormatter()
    {
        // Arrange
        var expectedMediaType = MediaTypeHeaderValue.Parse("application/vnd.example.contact+json; v=2; charset=utf-8");
        var request = new HttpRequestMessage(HttpMethod.Get, "http://localhost/ProducesWithMediaTypeSuffixesController/ContactInfo");
        request.Headers.Add("Accept", "application/vnd.example.contact+json; v=2");
 
        // Act
        var response = await Client.SendAsync(request);
 
        // Assert
        Assert.Equal(expectedMediaType, response.Content.Headers.ContentType);
        var body = await response.Content.ReadAsStringAsync();
        var contact = JsonConvert.DeserializeObject<Contact>(body);
        Assert.Equal("Jason Ecsemelle", contact.Name);
    }
 
    [Fact]
    public async Task ProducesAttribute_CustomMediaTypeWithXmlSuffix_RunsConnegAndSelectsXmlFormatter()
    {
        // Arrange
        var expectedMediaType = MediaTypeHeaderValue.Parse("application/vnd.example.contact+xml; v=2; charset=utf-8");
        var request = new HttpRequestMessage(HttpMethod.Get, "http://localhost/ProducesWithMediaTypeSuffixesController/ContactInfo");
        request.Headers.Add("Accept", "application/vnd.example.contact+xml; v=2");
 
        // Act
        var response = await Client.SendAsync(request);
 
        // Assert
        Assert.Equal(expectedMediaType, response.Content.Headers.ContentType);
        var bodyStream = await response.Content.ReadAsStreamAsync();
        var xmlDeserializer = new DataContractSerializer(typeof(Contact));
        var contact = xmlDeserializer.ReadObject(bodyStream) as Contact;
        Assert.Equal("Jason Ecsemelle", contact.Name);
    }
 
    [Fact]
    public async Task FormatFilter_XmlAsFormat_ReturnsXml()
    {
        // Arrange
        var expectedBody = "<FormatFilterController.Customer xmlns:i=\"http://www.w3.org/2001/XMLSchema-instance\""
            + " xmlns=\"http://schemas.datacontract.org/2004/07/BasicWebSite.Controllers.ContentNegotiation\">"
            + "<Name>John</Name></FormatFilterController.Customer>";
 
        // Act
        var response = await Client.GetAsync(
            "http://localhost/FormatFilter/CustomerInfo?format=xml");
 
        // Assert
        Assert.Equal(HttpStatusCode.OK, response.StatusCode);
        Assert.Equal("application/xml; charset=utf-8", response.Content.Headers.ContentType.ToString());
        var body = await response.Content.ReadAsStringAsync();
        Assert.Equal(expectedBody, body);
    }
}