< draft-wilde-json-seq-suffix-01.txt   draft-wilde-json-seq-suffix-03.txt >
Network Working Group E. Wilde Network Working Group E. Wilde
Internet-Draft CA Technologies Internet-Draft CA Technologies
Intended status: Experimental November 28, 2016 Intended status: Informational December 31, 2016
Expires: June 1, 2017 Expires: July 4, 2017
A Media Type Structured Syntax Suffix for JSON Text Sequences A Media Type Structured Syntax Suffix for JSON Text Sequences
draft-wilde-json-seq-suffix-01 draft-wilde-json-seq-suffix-03
Abstract Abstract
Structured Syntax Suffixes for media types allow other media types to Structured Syntax Suffixes for media types allow other media types to
build on them and make it explicit that they are built on an existing build on them and make it explicit that they are built on an existing
media type as their foundation. This specification defines and media type as their foundation. This specification defines and
registers "+json-seq" as a structured syntax suffix for JSON Text registers "+json-seq" as a structured syntax suffix for JSON Text
Sequences. Sequences.
Note to Readers Note to Readers
[[ The RFC Editor is requested to remove this section at publication.
]]
This draft should be discussed on the ietf mailing list This draft should be discussed on the ietf mailing list
(<https://www.ietf.org/mailman/listinfo/ietf>). (<https://www.ietf.org/mailman/listinfo/ietf>).
Online access to all versions and files is available on GitHub Online access to all versions and files is available on GitHub
(<https://github.com/dret/I-D/tree/master/json-seq-suffix>). (<https://github.com/dret/I-D/tree/master/json-seq-suffix>).
Status of This Memo Status of This Memo
This Internet-Draft is submitted in full conformance with the This Internet-Draft is submitted in full conformance with the
provisions of BCP 78 and BCP 79. provisions of BCP 78 and BCP 79.
skipping to change at page 1, line 42 skipping to change at page 1, line 45
Internet-Drafts are working documents of the Internet Engineering Internet-Drafts are working documents of the Internet Engineering
Task Force (IETF). Note that other groups may also distribute Task Force (IETF). Note that other groups may also distribute
working documents as Internet-Drafts. The list of current Internet- working documents as Internet-Drafts. The list of current Internet-
Drafts is at http://datatracker.ietf.org/drafts/current/. Drafts is at http://datatracker.ietf.org/drafts/current/.
Internet-Drafts are draft documents valid for a maximum of six months Internet-Drafts are draft documents valid for a maximum of six months
and may be updated, replaced, or obsoleted by other documents at any and may be updated, replaced, or obsoleted by other documents at any
time. It is inappropriate to use Internet-Drafts as reference time. It is inappropriate to use Internet-Drafts as reference
material or to cite them other than as "work in progress." material or to cite them other than as "work in progress."
This Internet-Draft will expire on June 1, 2017. This Internet-Draft will expire on July 4, 2017.
Copyright Notice Copyright Notice
Copyright (c) 2016 IETF Trust and the persons identified as the Copyright (c) 2016 IETF Trust and the persons identified as the
document authors. All rights reserved. document authors. All rights reserved.
This document is subject to BCP 78 and the IETF Trust's Legal This document is subject to BCP 78 and the IETF Trust's Legal
Provisions Relating to IETF Documents Provisions Relating to IETF Documents
(http://trustee.ietf.org/license-info) in effect on the date of (http://trustee.ietf.org/license-info) in effect on the date of
publication of this document. Please review these documents publication of this document. Please review these documents
carefully, as they describe your rights and restrictions with respect carefully, as they describe your rights and restrictions with respect
to this document. Code Components extracted from this document must to this document. Code Components extracted from this document must
include Simplified BSD License text as described in Section 4.e of include Simplified BSD License text as described in Section 4.e of
the Trust Legal Provisions and are provided without warranty as the Trust Legal Provisions and are provided without warranty as
described in the Simplified BSD License. described in the Simplified BSD License.
Table of Contents Table of Contents
1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 2 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 2
2. Terminology . . . . . . . . . . . . . . . . . . . . . . . . . 2 2. Terminology . . . . . . . . . . . . . . . . . . . . . . . . . 2
3. The "+json-seq" Structured Syntax Suffix . . . . . . . . . . 2 3. The "+json-seq" Structured Syntax Suffix . . . . . . . . . . 3
4. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 3 4. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 3
5. Security Considerations . . . . . . . . . . . . . . . . . . . 4 5. Security Considerations . . . . . . . . . . . . . . . . . . . 4
6. References . . . . . . . . . . . . . . . . . . . . . . . . . 4 6. References . . . . . . . . . . . . . . . . . . . . . . . . . 4
6.1. Normative References . . . . . . . . . . . . . . . . . . 4 6.1. Normative References . . . . . . . . . . . . . . . . . . 4
6.2. Non-Normative References . . . . . . . . . . . . . . . . 5 6.2. Informative References . . . . . . . . . . . . . . . . . 5
Appendix A. Acknowledgements . . . . . . . . . . . . . . . . . . 5 Appendix A. Acknowledgements . . . . . . . . . . . . . . . . . . 5
Author's Address . . . . . . . . . . . . . . . . . . . . . . . . 5 Author's Address . . . . . . . . . . . . . . . . . . . . . . . . 5
1. Introduction 1. Introduction
Media Type Structured Syntax Suffixes [RFC6838] were introduced as a Media Type Structured Syntax Suffixes [RFC6838] were introduced as a
way for a media type to signal that is based on another media type as way for a media type to signal that it is based on another media type
its foundation. Some structured syntax suffixes were registered as its foundation. Some structured syntax suffixes were registered
initially [RFC6839], including "+json" for the widely popular JSON initially [RFC6839], including "+json" for the widely popular JSON
Format [RFC7159] format. Format [RFC7159].
JSON Text Sequences [RFC7464] is a new specification in the JSON JSON Text Sequences [RFC7464] is a recent specification in the JSON
space that defines how a sequence of multiple JSON texts can be space that defines how a sequence of multiple JSON texts can be
represented in one representation. Since this specification can be represented in one representation. This document defines and
used as the foundation for other formats, this specification defines registers the "+json-seq" structured syntax suffix in the Structured
and registers the "+json-seq" structured syntax suffix. Syntax Suffix Registry.
2. Terminology 2. Terminology
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
"SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
document are to be interpreted as described in RFC 2119 [RFC2119]. document are to be interpreted as described in [RFC2119].
3. The "+json-seq" Structured Syntax Suffix 3. The "+json-seq" Structured Syntax Suffix
The use case for the "+json-seq" structured syntax suffix is the same The use case for the "+json-seq" structured syntax suffix is the same
as for "+json": It SHOULD be used by media types when parsing the as for "+json": It SHOULD be used by media types when parsing the
JSON Text Sequence of a media type leads to a meaningful result, by JSON Text Sequence of a media type leads to a meaningful result, by
simply using the generic JSON Text Sequence processing. simply using the generic JSON Text Sequence processing.
Applications encountering such a media type can then either simply Applications encountering such a media type can then either simply
use generic processing if all they need is a generic view of the JSON use generic processing if all they need is a generic view of the JSON
Text Sequence, or they can use generic JSON Text Sequence tools for Text Sequence, or they can use generic JSON Text Sequence tools for
initial parsing, and then can implement their own specific processing initial parsing, and then can implement their own specific processing
on top of that generic parsing tool. on top of that generic parsing tool.
4. IANA Considerations 4. IANA Considerations
IANA has added the following "+json-seq" structured syntax suffix to Structured Syntax Suffixes are registered within the "Structured
its registry of structured syntax suffixes established by [RFC6838]: Syntax Suffix Registry" maintained at
<https://www.iana.org/assignments/media-type-structured-suffix>.
IANA is requested to register the "+json-seq" structured syntax
suffix in accordance with [RFC6838].
Name: JSON Text Sequence Name: JSON Text Sequence
+suffix: +json-seq +suffix: +json-seq
References: [RFC7464] References: [RFC7464], RFC [[ RFC Editor, please insert assigned
RFC number. ]]
Encoding considerations: See [RFC7464] Section 2.2 Encoding considerations: See [RFC7464] Section 2.2
Fragment identifier considerations: The syntax and semantics of Fragment identifier considerations: The syntax and semantics of
fragment identifiers specified for +json-seq SHOULD be as fragment identifiers specified for +json-seq SHOULD be as
specified for "application/json-seq". (At publication of this specified for "application/json-seq". (At publication of this
document, there is no fragment identification syntax defined for document, there is no fragment identification syntax defined for
"application/json-seq".) "application/json-seq".)
The syntax and semantics for fragment identifiers for a The syntax and semantics for fragment identifiers for a
skipping to change at page 3, line 50 skipping to change at page 4, line 12
identifier does not resolve per the +json-seq rules, then identifier does not resolve per the +json-seq rules, then
process as specified in "xxx/yyy+json-seq". process as specified in "xxx/yyy+json-seq".
For cases not defined in +json-seq, then process as For cases not defined in +json-seq, then process as
specified in "xxx/yyy+json-seq". specified in "xxx/yyy+json-seq".
Interoperability considerations: n/a Interoperability considerations: n/a
Security considerations: See [RFC7464] Section 3 Security considerations: See [RFC7464] Section 3
Contact: Applications and Real-Time Area Working Group Contact: Applications and Real-Time Area Discussion
(art@ietf.org) (art@ietf.org), or any IESG designated successor.
Author/Change controller: The Applications and Real-Time Area Author/Change controller: The Applications and Real-Time Area
Working Group. IESG has change control over this registration. Working Group. IESG has change control over this registration.
5. Security Considerations 5. Security Considerations
All "Security Considerations" (Section 3) of RFC 7464 [RFC7464] All the security considerations of JSON Text Sequences [RFC7464]
apply. They are as follows: apply. They are as follows:
All the security considerations of JSON [RFC7159] apply. This format All the security considerations of JSON [RFC7159] apply. This format
provides no cryptographic integrity protection of any kind. provides no cryptographic integrity protection of any kind.
As usual, parsers must operate on input that is assumed to be As usual, parsers must operate on input that is assumed to be
untrusted. This means that parsers must fail gracefully in the face untrusted. This means that parsers must fail gracefully in the face
of malicious inputs. of malicious inputs.
Note that incremental JSON text parsers can produce partial results Note that incremental JSON text parsers can produce partial results
skipping to change at page 5, line 5 skipping to change at page 5, line 14
[RFC6838] Freed, N., Klensin, J., and T. Hansen, "Media Type [RFC6838] Freed, N., Klensin, J., and T. Hansen, "Media Type
Specifications and Registration Procedures", BCP 13, Specifications and Registration Procedures", BCP 13,
RFC 6838, DOI 10.17487/RFC6838, January 2013, RFC 6838, DOI 10.17487/RFC6838, January 2013,
<http://www.rfc-editor.org/info/rfc6838>. <http://www.rfc-editor.org/info/rfc6838>.
[RFC7464] Williams, N., "JavaScript Object Notation (JSON) Text [RFC7464] Williams, N., "JavaScript Object Notation (JSON) Text
Sequences", RFC 7464, DOI 10.17487/RFC7464, February 2015, Sequences", RFC 7464, DOI 10.17487/RFC7464, February 2015,
<http://www.rfc-editor.org/info/rfc7464>. <http://www.rfc-editor.org/info/rfc7464>.
6.2. Non-Normative References 6.2. Informative References
[RFC6839] Hansen, T. and A. Melnikov, "Additional Media Type [RFC6839] Hansen, T. and A. Melnikov, "Additional Media Type
Structured Syntax Suffixes", RFC 6839, Structured Syntax Suffixes", RFC 6839,
DOI 10.17487/RFC6839, January 2013, DOI 10.17487/RFC6839, January 2013,
<http://www.rfc-editor.org/info/rfc6839>. <http://www.rfc-editor.org/info/rfc6839>.
[RFC7159] Bray, T., Ed., "The JavaScript Object Notation (JSON) Data [RFC7159] Bray, T., Ed., "The JavaScript Object Notation (JSON) Data
Interchange Format", RFC 7159, DOI 10.17487/RFC7159, March Interchange Format", RFC 7159, DOI 10.17487/RFC7159, March
2014, <http://www.rfc-editor.org/info/rfc7159>. 2014, <http://www.rfc-editor.org/info/rfc7159>.
Appendix A. Acknowledgements Appendix A. Acknowledgements
Thanks for comments and suggestions provided by Allan Doyle, Sean Thanks for comments and suggestions provided by Ben Campbell, Allan
Leonard, and Alexey Melnikov. Doyle, Warren Kumari, Sean Leonard, Alexey Melnikov, Brian Raymor,
and Peter Yee.
Author's Address Author's Address
Erik Wilde Erik Wilde
CA Technologies CA Technologies
Email: erik.wilde@dret.net Email: erik.wilde@dret.net
URI: http://dret.net/netdret/ URI: http://dret.net/netdret/
 End of changes. 17 change blocks. 
23 lines changed or deleted 33 lines changed or added

This html diff was produced by rfcdiff 1.48. The latest version is available from http://tools.ietf.org/tools/rfcdiff/