NewtonsoftJsonNegotiator Class

Definition

Namespace

Codebelt.Extensions.Carter.AspNetCore.Newtonsoft.Json

Assemblies

Codebelt.Extensions.Carter.AspNetCore.Newtonsoft.Json.dll

Source

src/Codebelt.Extensions.Carter.AspNetCore.Newtonsoft.Json/NewtonsoftJsonNegotiator.cs

The NewtonsoftJsonNegotiator integrates Newtonsoft.Json serialization into the Carter response pipeline. Register it as the response negotiator to have all HttpResponse.Negotiate() calls produce JSON output using Newtonsoft.Json's configurable serializer.

Availability: .NET 10

Example

The following example demonstrates how to register NewtonsoftJsonNegotiator with a custom converter and negotiate a response model.

using System;
using System.IO;
using System.Text;
using System.Threading;
using System.Threading.Tasks;
using Codebelt.Extensions.Carter.AspNetCore.Newtonsoft.Json;
using Codebelt.Extensions.Newtonsoft.Json.Formatters;
using Microsoft.AspNetCore.Http;
using Microsoft.Extensions.Options;
using Microsoft.Net.Http.Headers;

namespace DocfxExample;

public static class NewtonsoftJsonNegotiatorExample
{
    public static async Task DemonstrateAsync()
    {
        var options = Options.Create(new NewtonsoftJsonFormatterOptions());
        var negotiator = new NewtonsoftJsonNegotiator(options);
        var acceptHeader = MediaTypeHeaderValue.Parse("application/json");
        if (negotiator.CanHandle(acceptHeader))
        {
            var context = new DefaultHttpContext();
            context.Request.Headers.Accept = "application/json";
            var model = new { Name = "Newtonsoft", Value = 42 };
            await negotiator.Handle(context.Request, context.Response, model, CancellationToken.None);
            context.Response.Body.Position = 0;
            using var reader = new StreamReader(context.Response.Body, Encoding.UTF8);
            Console.WriteLine(await reader.ReadToEndAsync());
        }
    }
}

public class NewtonsoftJsonNegotiator : ConfigurableResponseNegotiator<NewtonsoftJsonFormatterOptions>, IConfigurable<NewtonsoftJsonFormatterOptions>, IResponseNegotiator

Inheritance

object

Configurable<NewtonsoftJsonFormatterOptions>

ConfigurableResponseNegotiator<NewtonsoftJsonFormatterOptions>

NewtonsoftJsonNegotiator

Implements

IConfigurable<NewtonsoftJsonFormatterOptions>

IResponseNegotiator

Inherited Members

ConfigurableResponseNegotiator<NewtonsoftJsonFormatterOptions>.CanHandle(MediaTypeHeaderValue)

ConfigurableResponseNegotiator<NewtonsoftJsonFormatterOptions>.ContentType

ConfigurableResponseNegotiator<NewtonsoftJsonFormatterOptions>.GetEncoding(HttpRequest)

ConfigurableResponseNegotiator<NewtonsoftJsonFormatterOptions>.Handle<T>(HttpRequest, HttpResponse, T, CancellationToken)

Configurable<NewtonsoftJsonFormatterOptions>.Options

Constructors

Name	Description
NewtonsoftJsonNegotiator(IOptions<NewtonsoftJsonFormatterOptions>)	Initializes a new instance of the NewtonsoftJsonNegotiator class.

Methods

Name	Description
GetDefaultEncoding()	Returns UTF-8 without a byte-order mark (BOM) as the default character encoding for this negotiator.
GetFormatter()	Returns a new NewtonsoftJsonFormatter configured with the current NewtonsoftJsonFormatterOptions.

See Also

ConfigurableResponseNegotiator<TOptions>