一、概述
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
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 文档。
的