客户要求ASP.NET Core API返回特定格式，怎么办？(续2)

前言

前2次，我们都是假设客户需要返回不同的字符串格式。

但是，有可能客户要求的返回是非本文格式，比如文件流。

怎么办？

思路

前提，当然还是使用同一API接口，不影响现有使用方式。

虽然ASP.NET Core Web API默认使用SystemTextJsonOutputFormatter格式化响应，但是OutputFormatters集合里其实包含了StreamOutputFormatter。

那么实现目标就转化为，怎么让Web API使用StreamOutputFormatter？

DefaultOutputFormatterSelector

通过查看dotnet/aspnetcore源代码，我们找到了DefaultOutputFormatterSelector，它是选择IOutputFormatter以写入对当前请求的响应的默认实现：

其中，选择IOutputFormatter具体实现是通过判断CanWriteResult方法，代码如下：

foreach (var formatter in formatters)
{formatterContext.ContentType = new StringSegment();formatterContext.ContentTypeIsServerDefined = false;if (formatter.CanWriteResult(formatterContext)){return formatter;}
}

而StreamOutputFormatter是这样实现CanWriteResult方法的：

public bool CanWriteResult(OutputFormatterCanWriteContext context)
{if (context == null){throw new ArgumentNullException(nameof(context));}// Ignore the passed in content type, if the object is a Stream.if (context.Object is Stream){return true;}return false;
}

那么实现目标就转化为，怎么让Web API返回的是Stream？

操作返回类型

微软官方文档ASP.NET Core Web API 中控制器操作的返回类型^[1]提到，返回类型除了支持特定类型之外，还支持ActionResult<T>。

ActionResult<T>可以返回从ActionResult派生的类型或返回特定类型：

那么实现目标就转化为，将返回类型设为ActionResult<T>，根据条件返回T，或者返回特定ActionResult派生类，例如FileResult。

实现

具体实现代码如下，如果Accept Header是text/json则返回文件流：

[HttpGet]
public ActionResult<IEnumerable<WeatherForecast>> Get()
{var rng = new Random();var result = Enumerable.Range(1, 5).Select(index => new WeatherForecast{Date = DateTime.Now.AddDays(index),TemperatureC = rng.Next(-20, 55),Summary = Summaries[rng.Next(Summaries.Length)]}).ToArray();HttpContext.Request.Headers.TryGetValue("Accept", out var acceptValue);if (acceptValue.ToString() == "text/json"){using (var memory = new MemoryStream()){using (var writer = new StreamWriter(memory)){writer.Write(System.Text.Json.JsonSerializer.Serialize(result));writer.Flush();}return File(memory.ToArray(), "text/json", "WeatherForecast.json");} }return result;
}