首页 > 代码库 > ASP.NET Web API MediaTypeFormatter

ASP.NET Web API MediaTypeFormatter

2024-07-27 21:29:27   227人阅读

MediaTypeFormatter提供了HTTP Request body data与.Net类型之间的无缝转换。

什么是MediaType

Media Type指的是HTTP header中的content-type，它定义了在HTTP Body中的数据的格式。Media Type也用于Http RequestHeader中的Accept头，表明改Request期望收到的Response的body的格式。

你可以使用标准的media type，比如application/json, application/xml。你也可以定义自己的media type.

什么是MediaTypeFormatter

MediaTypeFormatter用于在Http Body和.Net之间进行转换。

所有的MediaTypeFormatter都继承自抽象类MediaTypeFormatter

public abstract class MediaTypeFormatter{
    // properties    public Collection<MediaTypeHeaderValue> SupportedMediaTypes { get; private set; }      public Collection<Encoding> SupportedEncodings { get; private set; }      public Collection<MediaTypeMapping> MediaTypeMappings { get; private set; }      // methods    public virtual Task<object> ReadFromStreamAsync(Type type, Stream stream, HttpContentHeaders contentHeaders, IFormatterLogger formatterLogger)    {        // to be overriden by base class    }     public virtual Task WriteToStreamAsync(Type type, object value, Stream stream, HttpContentHeaders contentHeaders, TransportContext transportContext)    {       // to be overriden by base class    }    public abstract bool CanReadType(Type type);    public abstract bool CanWriteType(Type type);}

要定义自己的MediaTypeFormatter，只需要实现上述抽象类即可。

这里有详细的例子

http://www.asp.net/web-api/overview/formats-and-model-binding/media-formatters

怎么使用自定义的formatter

要把一个media type formatter加入Web API Pipeline,

public static void ConfigureApis(HttpConfiguration config){    config.Formatters.Add(new ProductCsvFormatter()); }

什么时候Web API Framework会用到MediaTypeFormatter

我们前面说过，media type主要用于HTTP Request/Response header中的content-type，和HTTP Request header中的Accept。

HTTP Request/Response header中的content-type

当Web API接收到HTTP Request请求，并且需要读取body信息时（比如，使用FromBody属性），Web API会检查content-type的类型，然后使用已注册的formatter去deserialize。

HTTP Request header中的Accept

假设我们有一个Product类

    [DataContract(Name = "Product", Namespace = "http://www.azure.com")]    public class Product    {        [DataMember]        public int Id { get; set; }        [DataMember]        public string Name { get; set; }        [DataMember]        public string Category { get; set; }        [DataMember]        public decimal Price { get; set; }    }

以及一个Web API的controller

public HttpResponseMessage Get(){     var product = new Product() { Id = 1, Name = "Gizmo", Category = "Widgets", Price = 1.99M };     return Request.CreateResponse(HttpStatusCode.OK, product);}

这个controller返回一个HttpResponseMessage对象，里面包含一个product。

此时，Web API会检查该Request的Header中Accept的内容，然后调用相应的formatter去序列号product对象。

我们可以使用fiddler发送以下request

User-Agent: FiddlerHost: localhost:9664Accept: application/xml

那么我们得到的response是

HTTP/1.1 200 OKCache-Control: no-cachePragma: no-cacheContent-Type: application/xml; charset=utf-8Expires: -1Server: Microsoft-IIS/8.0X-AspNet-Version: 4.0.30319X-Powered-By: ASP.NETDate: Sat, 18 Oct 2014 08:35:21 GMTContent-Length: 187<Product xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.azure.com"><Category>Widgets</Category><Id>1</Id><Name>Gizmo</Name><Price>1.99</Price></Product>

注意Content-Type，以及body的格式。

如果我们发送以下request

User-Agent: FiddlerHost: localhost:9664Accept: application/json

 

我们得到的response是

HTTP/1.1 200 OKCache-Control: no-cachePragma: no-cacheContent-Type: application/json; charset=utf-8Expires: -1Server: Microsoft-IIS/8.0X-AspNet-Version: 4.0.30319X-SourceFiles: =?UTF-8?B?YzpcdXNlcnNcZWR3YW5nXGRvY3VtZW50c1x2aXN1YWwgc3R1ZGlvIDIwMTNcUHJvamVjdHNcV2ViQXBwVGVzdFxXZWJBcHBUZXN0XGFwaVx2YWx1ZXM=?=X-Powered-By: ASP.NETDate: Sat, 18 Oct 2014 09:22:45 GMTContent-Length: 57{"Id":1,"Name":"Gizmo","Category":"Widgets","Price":1.99}

 

Web API使用XmlMediaTypeFormatter处理xml media type。XmlMediaTypeFormatter默认使用DataContractSerializer进行序列化。

使用JsonMediaTypeFormatter处理json media type。JsonMediaTypeFormatter默认使用Json.net进行序列化。

 

ASP.NET Web API MediaTypeFormatter


联系
我们