👁 Image
Codebelt.Extensions.Carter.AspNetCore.Xml 1.0.4

Codebelt.Extensions.Carter.AspNetCore.Xml

An XML response negotiator for Carter in ASP.NET Core minimal APIs.

About

Codebelt.Extensions.Carter.AspNetCore.Xml extends the Codebelt.Extensions.Carter package with a dedicated XML response negotiator for Carter, capable of serializing response models to XML format using System.Xml.XmlWriter.

Use this package when you need XML-first integrations and want Carter endpoints to participate in explicit content negotiation.

CSharp Example

Functional-test style sample (same bootstrapping pattern used by this repository):

using System.Net.Http.Headers;
using System.Threading.Tasks;
using Carter;
using Codebelt.Extensions.Carter.Assets;
using Codebelt.Extensions.Carter.AspNetCore.Xml;
using Codebelt.Extensions.Xunit.Hosting.AspNetCore;
using Cuemon.Extensions.AspNetCore.Xml;
using Microsoft.AspNetCore.Builder;
using Microsoft.Extensions.DependencyInjection;

using var response = await MinimalWebHostTestFactory.RunAsync(
 services =>
 {
 services.AddMinimalXmlOptions(o =>
 {
 o.Settings.Writer.Indent = true;
 });
 services.AddCarter(configurator: c => c
 .WithModule<WorldModule>()
 .WithResponseNegotiator<XmlResponseNegotiator>());
 services.AddRouting();
 },
 app =>
 {
 app.UseRouting();
 app.UseEndpoints(endpoints => endpoints.MapCarter());
 },
 _ => { },
 async client =>
 {
 client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/xml"));
 return await client.GetAsync("/world/statistical-regions");
 });

Program-style usage for production apps (remember to inherit from ICarterModule for your endpoints and add other services as needed):

using Carter;
using Codebelt.Extensions.Carter.AspNetCore.Xml;
using Cuemon.Extensions.AspNetCore.Xml;
using Microsoft.AspNetCore.Builder;
using Microsoft.Extensions.DependencyInjection;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddMinimalXmlOptions();
builder.Services.AddCarter(c => c
 .WithResponseNegotiator<XmlResponseNegotiator>());

var app = builder.Build();
app.MapCarter();
app.Run();

Related Packages

• Codebelt.Extensions.Carter 📦
• Codebelt.Extensions.Carter.AspNetCore.Newtonsoft.Json 📦
• Codebelt.Extensions.Carter.AspNetCore.Text.Json 📦
• Codebelt.Extensions.Carter.AspNetCore.Text.Yaml 📦
• Codebelt.Extensions.Carter.AspNetCore.Xml 📦