003-RFC关于媒体类型说明

一、概述

RFC-822   Standard for ARPA Internet text messages [ARPA互连网文本信息标准]
RFC-2045 MIME Part 1: Format of Internet Message Bodies [MIME 第1部分:互联网信息主体的格式]
RFC-2046 MIME Part 2: Media Types [MIME 第2部分:多媒体类型]
RFC-2047 MIME Part 3: Header Extensions for Non-ASCII Text [MIME 第3部分:非ASCII文本的页眉扩展名]
RFC-2048 MIME Part 4: Registration Procedures [MIME 第4部分:注册程序]
RFC-2049 MIME Part 5: Conformance Criteria and Examples [MIME 第5部分:一致性标准和案例]


RFC-2616 Hypertext Transfer Protocol -- HTTP/1.1

RFC-4627 The application/json Media Type for JavaScript Object Notation (JSON)

RFC-3023 XML Media Type

RFC-6838 媒体类型规范和注册程序

一、application/vnd[.github][.version].[params]+json

1.1、命名要求

RFC地址:https://tools.ietf.org/html/rfc6838#section-4.2

  所有注册媒体类型必须分配*类型和子类型名称。这些名称的组合具有独特性识别媒体类型和子类型名称facet标识注册树。   类型和子类型名称必须符合以下ABNF:
     type-name = restricted-name
     subtype-name = restricted-name

     restricted-name = restricted-name-first *126restricted-name-chars
     restricted-name-first  = ALPHA / DIGIT
     restricted-name-chars  = ALPHA / DIGIT / "!" / "#" /
                              "$" / "&" / "-" / "^" / "_"
     restricted-name-chars =/ "." ; Characters before first dot always
                                  ; specify a facet name
     restricted-name-chars =/ "+" ; Characters after last plus always
                                  ; specify a structured syntax suffix

1.2、application/vnd[.github][.version].[params]+json分析

1、application含义

rfc地址:https://tools.ietf.org/html/rfc6838#section-4.2.5

  application是一个*类型被应用与离散数据不同于其他类型, 

2、vnd含义

rfc地址:https://tools.ietf.org/html/rfc6838#section-3.2

  供应商子类型,一般用于vnd.github,同级别的还有prs.个人的,其中[.github][.version].[params]是用户自定义的Vendor Tree

3、+json含义

1>结构化语法名称后缀

RFC地址:https://tools.ietf.org/html/rfc6838#section-4.2.8

  该文档还标准化了一个约定(使用后缀'+ xml')用于命名媒体类型......当这些媒体类型时表示XML MIME(多用途Internet邮件扩展)实体。
  也就是说,它指定了要附加的后缀(在这种情况下,“+ xml”)    到基本子类型名称。

2>理解“+xml”

  基于XML的媒体类型的'+ xml'命名约定

rfc地址:https://tools.ietf.org/html/rfc7303#section-9.6

  本规范建议使用'+ xml'命名约定    用于识别基于XML的媒体类型,符合识别    在[RFC6838]中的结构化语法名称后缀。这允许使用    通用XML处理器和技术的各种各样的    使用现有的最低成本的不同XML文档类型    媒体类型注册的框架。

3>通过Application/xslt+xml来理解Application/xslt+json

RFC地址:https://tools.ietf.org/html/rfc3023#section-8.16

Content-type: application/xslt+xml

  可扩展样式表语言(XSLT)文档是XML文档    其内容描述了其他XML文档的样式表,如    由[XSLT]定义。

  作为基于XML的格式,XSLT文档应该是    在MIME内容类型中使用'+ xml'后缀约定标识符。

4》+ json结构化语法后缀

RFC地址:https://tools.ietf.org/html/rfc6839#section-3.1

  [RFC4627]定义“application/json”媒体类型。后缀 “+ json”可以与任何表示如下的媒体类型一起使用 为“application / json”建立的。

注意事项:

  为其指定的片段标识符的语法和语义+ json应该按照“application / json”的规定。

  特定的片段标识符的语法和语义“xxx / yyy + json”应该按如下方式处理:

    对于+ json中定义的情况,片段标识符解析根据+ json规则,然后按照+ json中的指定进行处理。

1.3、通过Accept或者Content-Type传输

RFC地址:https://tools.ietf.org/html/rfc2616#section-14.1 

 Accept request-header字段可用于指定某些媒体    响应可接受的类型。

语法定义

       Accept         = "Accept" ":"
                        #( media-range [ accept-params ] )

       media-range    = ( "*/*"
                        | ( type "/" "*" )
                        | ( type "/" subtype )
                        ) *( ";" parameter )
       accept-params  = ";" "q" "=" qvalue *( accept-extension )
       accept-extension = ";" token [ "=" ( token | quoted-string ) ]

星号“*”字符用于将媒体类型分组到范围中,    “* / *”表示所有媒体类型,“type / *”表示某种type媒体类型下的左右子类型。

每个媒体范围可以跟随一个或多个accept-params,以“q”参数开始,表示权重因子。第一个“q”参数(如果有)将媒体范围分开来自accept-params的参数。权重因子允许用户或代理设置,范围从0-1,默认值是1;

示例一、

Accept: text/*, text/html, text/html;level=1, */*

优先权

       1) text/html;level=1
       2) text/html
       3) text/*
       4) */*

实例二、

Accept: text/*;q=0.3, text/html;q=0.7, text/html;level=1,
               text/html;level=2;q=0.4, */*;q=0.5

优先权

       text/html;level=1         = 1
       text/html                 = 0.7
       text/plain                = 0.3
       image/jpeg                = 0.5
       text/html;level=2         = 0.4
       text/html;level=3         = 0.7

简单理解:Accept: text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8

意思:支持的 MIME 类型分别是 text/html、application/xhtml+xml、application/xml 和 */*,优先顺序是它们从左到右的排列顺序。

详解:

  Accept表示浏览器支持的 MIME 类型;

  MIME的英文全称是 Multipurpose Internet Mail Extensions(多功能 Internet 邮件扩充服务),它是一种多用途网际邮件扩充协议,在1992年最早应用于电子邮件系统,但后来也应用到浏览器。

    text/html,application/xhtml+xml,application/xml 都是 MIME 类型,也可以称为媒体类型和内容类型,斜杠前面的是 type(类型),斜杠后面的是 subtype(子类型);type 指定大的范围,subtype 是 type 中范围更明确的类型,即大类中的小类。

    Text:用于标准化地表示的文本信息,文本消息可以是多种字符集和或者多种格式的;

    text/html表示 html 文档;

    Application:用于传输应用程序数据或者二进制数据;

    application/xhtml+xml表示 xml格式的xhtml类型文档;

    application/xml表示 xml 文档。

 

 

 

 

 

 

 

 

 

 

 

 

   
上一篇:RFC和http


下一篇:gateway调用后台系统时选择RFC的决定逻辑