Network Working Group J. Snell
Internet-Draft November 9, 2010
Updates: 4287 (if approved)
Intended status: Informational
Expires: May 13, 2011
The Atom Link "inline" Extension
draft-snell-atompub-inline-01.txt
Abstract
This specification adds a mechanism to the Atom Syndication Format
which publishers of Atom Feed and Entry documents can use to embed
representations of linked resources into a child element of the atom:
link element.
Status of this Memo
This Internet-Draft is submitted to IETF in full conformance with the
provisions of BCP 78 and BCP 79.
Internet-Drafts are working documents of the Internet Engineering
Task Force (IETF). Note that other groups may also distribute
working documents as Internet-Drafts. The list of current Internet-
Drafts is at http://datatracker.ietf.org/drafts/current/.
Internet-Drafts are draft documents valid for a maximum of six months
and may be updated, replaced, or obsoleted by other documents at any
time. It is inappropriate to use Internet-Drafts as reference
material or to cite them other than as "work in progress."
This Internet-Draft will expire on May 13, 2011.
Copyright Notice
Copyright (c) 2010 IETF Trust and the persons identified as the
document authors. All rights reserved.
This document is subject to BCP 78 and the IETF Trust's Legal
Provisions Relating to IETF Documents
(http://trustee.ietf.org/license-info) in effect on the date of
publication of this document. Please review these documents
carefully, as they describe your rights and restrictions with respect
to this document. Code Components extracted from this document must
include Simplified BSD License text as described in Section 4.e of
the Trust Legal Provisions and are provided without warranty as
described in the Simplified BSD License.
Snell Expires May 13, 2011 [Page 1]
Internet-Draft Atom inline November 2010
Table of Contents
1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 3
2. Notational Conventions . . . . . . . . . . . . . . . . . . . . 3
3. The 'atom:inline' element . . . . . . . . . . . . . . . . . . . 3
4. Security Considerations . . . . . . . . . . . . . . . . . . . . 4
5. IANA Considerations . . . . . . . . . . . . . . . . . . . . . . 5
6. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . . 5
7. Normative References . . . . . . . . . . . . . . . . . . . . . 5
Author's Address . . . . . . . . . . . . . . . . . . . . . . . . . 6
Snell Expires May 13, 2011 [Page 2]
Internet-Draft Atom inline November 2010
1. Introduction
This specification introduces a mechanism to the Atom Syndication
Format which publishes of Atom document can use to embed
representations of linked resources into a child element of the atom:
link element.
2. Notational Conventions
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
"SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
document are to be interpreted as described in BCP 14, [RFC2119]
This specification uses XML Namespaces [W3C.REC-xml-names-19990114]
to uniquely identify XML element names. It uses the following
namespace prefix for the indicated namespace URI;
"atom": "http://www.w3.org/2005/Atom"
3. The 'atom:inline' element
The atom:inline element MAY be used as the child of an atom:link
element to embed representations of the resource referenced by the
containing atom:link.
inline = element atom:inline {
(text|anyElement)*
}
An atom:link element MUST NOT contain more than one atom:inline
element.
If the value of the containing link element's type attribute begins
with "text/" (case insensitive), the content of atom:inline MUST NOT
contain child elements.
If the value of the link element's type attribute is an XML media
type [RFC3023] or ends with "+xml" or "/xml" (case insensitive), the
content of the atom:inline element MAY include child elements and
SHOULD be suitable for handling as the indicated media type. This
would normally mean that the atom:inline element would contain a
single child element that would serve as the root element of the XML
document of the indicated type.
If the value of the link element's type attribute is "application/
json" or ends with "+json" or "/json" (case insensitive), and the
Snell Expires May 13, 2011 [Page 3]
Internet-Draft Atom inline November 2010
character-set encoding of the enclosing Atom document is UTF-8,
UTF-16 or UTF-32, the content of the atom:inline element MUST be the
plain-text representation of the linked JSON document. The content
MAY be preceded and followed in the atom:inline element by white
space.
For all other values of the type attribute, the content of atom:
inline MUST be a valid Base64 encoding, as described in [RFC3548],
section 3. When decoded, it SHOULD be suitable for handling as the
indicated media type. In this case, the characters in the Base64
encoding MAY be preceded and followed in the atom:inline element by
white space, and lines are separated by a single newline (U+000A)
character.
...
...
This is an example{"a":"foo","b":"bar","c:"baz"}ew0KICAiaWQiOiJodHRwOi8vZXhhbXBsZS5vcm
cvZm9vIiwNCiAgInRpdGxlIjoiZm9vIg0KfQ==
...
...
...
4. Security Considerations
TBD
Snell Expires May 13, 2011 [Page 4]
Internet-Draft Atom inline November 2010
5. IANA Considerations
There are no IANA considerations for this document.
6. Acknowledgements
The author gratefully acknowledges the feedback from the members of
the Atom Publishing Format and Protocol working group during the
development of this specification.
7. Normative References
[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate
Requirement Levels", BCP 14, RFC 2119, March 1997.
[RFC3023] Murata, M., St. Laurent, S., and D. Kohn, "XML Media
Types", RFC 3023, January 2001.
[RFC3548] Josefsson, S., "The Base16, Base32, and Base64 Data
Encodings", RFC 3548, July 2003.
[RFC3986] Berners-Lee, T., Fielding, R., and L. Masinter, "Uniform
Resource Identifier (URI): Generic Syntax", STD 66,
RFC 3986, January 2005.
[RFC4287] Nottingham, M., Ed. and R. Sayre, Ed., "The Atom
Syndication Format", RFC 4287, December 2005.
[W3C.REC-xml-20040204]
Maler, E., Yergeau, F., Paoli, J., Bray, T., and C.
Sperberg-McQueen, "Extensible Markup Language (XML) 1.0
(Third Edition)", World Wide Web Consortium
FirstEdition REC-xml-20040204, February 2004,
.
[W3C.REC-xml-names-19990114]
Bray, T., Hollander, D., and A. Layman, "Namespaces in
XML", World Wide Web Consortium FirstEdition REC-xml-
names-19990114, January 1999,
.
[W3C.REC-xmlbase-20010627]
Marsh, J., "XML Base", World Wide Web Consortium
FirstEdition REC-xmlbase-20010627, June 2001,
.
Snell Expires May 13, 2011 [Page 5]
Internet-Draft Atom inline November 2010
Author's Address
James M Snell
Phone:
Email: jasnell@us.ibm.com
URI: http://ibm.com
Snell Expires May 13, 2011 [Page 6]