Äcdocutils.nodes
document
q)Åq}q(U nametypesq}q(X���text/xmlqNX���xml1.0qàX���ianaqàX���xml 1.1q àX���xml 1.0q
àX���rfc2616q àX���rfc0020q àX���rfc4627q
àX���unicodeqàX���rfc2046qàX���application/jsonqNX4���setting content-type and content-disposition headersqNX���xml1.1qàX���xmlqàX
���iana_mediaqàX���version 2.0 content-typeqNX.���preserving media type metadata between systemsqNX���media type metadataqNX���application/javascriptqNX���application/xmlqNX ���w3c_headersqàX���rfc6657qàX
���rfc2616-sec14q àX ���section 3.2q àX���rfc6266q àX���version 1.x content-typeq NX
���iana_charsq àX
���text/plainq!NX���rfc7303q"àX ���rules for various content typesq#NX���rfc4180q$àX���text/javascriptq%NX ���spolsky2003q&àX���text/csvq'NX���what is this thing?q(NuUsubstitution_defsq)}q*Uparse_messagesq+]q,cdocutils.nodes
system_message
q-)Åq.}q/(U rawsourceq0U�U
attributesq1}q2(Udupnamesq3]UlevelKUidsq4]q5Uid1q6aUbackrefsq7]q8Uid2q9aUsourceXf���/var/lib/jenkins/jobs/API_Documentation_trunk/workspace/api-documentation/source/design/what_is_it.txtq:Uclassesq;]Unamesq<]UlineKsUtypeUWARNINGq=uUparentq>cdocutils.nodes
list_item
q?)Åq@}qA(h0X4��The media type as provided by the producer of the object should be specified
and should be preserved as part of the system metadata so that the media type
may be reliably presented to downstream consumers. When specified in the
``Content-Type`` header, the media type overrides the default value present
in the associated objectFormat. When present in System Metadata, that value
overrides a value presented in the ``Content-Type``header. In practice,
System Metadata is retrieved separately from the object, and so such an
override will optional for consumers.
h>cdocutils.nodes
enumerated_list
qB)ÅqC}qD(h0U�h>cdocutils.nodes
section
qE)ÅqF}qG(h0U�h>hE)ÅqH}qI(h0U�h>hUsourceqJh:UtagnameqKUsectionqLh1}qM(h3]h;]h7]h4]qNUwhat-is-this-thingqOah<]qPh(auUlineqQKUdocumentqRhUchildrenqS]qT(cdocutils.nodes
title
qU)ÅqV}qW(h0X���What is This Thing?qXh>hHhJh:hKUtitleqYh1}qZ(h3]h;]h7]h4]h<]uhQKhRhhS]q[cdocutils.nodes
Text
q\X���What is This Thing?q]ÖÅq^}q_(h0hXh>hVubaubcdocutils.nodes
paragraph
q`)Åqa}qb(h0Xa���**It does not make sense to have a string without knowing what encoding it
uses** [Spolsky2003_].h>hHhJh:hKU paragraphqch1}qd(h3]h;]h7]h4]h<]uhQKhRhhS]qe(cdocutils.nodes
strong
qf)Åqg}qh(h0XQ���**It does not make sense to have a string without knowing what encoding it
uses**h1}qi(h3]h;]h7]h4]h<]uh>hahS]qjh\XM���It does not make sense to have a string without knowing what encoding it
usesqkÖÅql}qm(h0U�h>hgubahKUstrongqnubh\X��� [qoÖÅqp}qq(h0X��� [h>haubcdocutils.nodes
reference
qr)Åqs}qt(h0X ���Spolsky2003_UresolvedquKh>hahKU referenceqvh1}qw(UnameX ���Spolsky2003UrefuriqxX3���http://www.joelonsoftware.com/articles/Unicode.htmlqyh4]h7]h3]h;]h<]uhS]qzh\X ���Spolsky2003q{ÖÅq|}q}(h0U�h>hsubaubh\X���].q~ÖÅq}qÄ(h0X���].h>haubeubhE)ÅqÅ}qÇ(h0U�h>hHhJh:hKhLh1}qÉ(h3]h;]h7]h4]qÑUmedia-type-metadataqÖah<]qÜhauhQK hRhhS]qá(hU)Åqà}qâ(h0X���Media Type Metadataqäh>hÅhJh:hKhYh1}qã(h3]h;]h7]h4]h<]uhQK hRhhS]qåh\X���Media Type MetadataqçÖÅqé}qè(h0häh>hàubaubh`)Åqê}që(h0X»��In DataONE content may be transferred multiple times between multiple locations,
and each transfer must result in an accurate representation of the original
content. DataONE achieves this by transferring byte copies of content between
clients and servers using the HTTP protocol, and verifying that the checksum
computed by the origin matches that retrieved. Hence the bytes are accurately
transferred and can be reliably transferred again by the consumer.qíh>hÅhJh:hKhch1}qì(h3]h;]h7]h4]h<]uhQK hRhhS]qîh\X»��In DataONE content may be transferred multiple times between multiple locations,
and each transfer must result in an accurate representation of the original
content. DataONE achieves this by transferring byte copies of content between
clients and servers using the HTTP protocol, and verifying that the checksum
computed by the origin matches that retrieved. Hence the bytes are accurately
transferred and can be reliably transferred again by the consumer.qïÖÅqñ}qó(h0híh>hêubaubh`)Åqò}qô(h0X ��In order to properly interpret how to use the object, the consumer must know the
*media type* of the object. The media type (formerly the MIME or Multipurpose
Internet Mail Extensions Type) is metadata about an object that can be used by
the consumer to determine what the object is. The IANA (Internet Assigned
Numbers Authority [IANA_]) provides a controlled list of media types
[IANA_MEDIA_] (henceforth "IANA Media Types") that are used during internet
transfer of objects to inform the receiver of the type of object being
transferred.h>hÅhJh:hKhch1}qö(h3]h;]h7]h4]h<]uhQKhRhhS]qõ(h\XQ���In order to properly interpret how to use the object, the consumer must know the
qúÖÅqù}qû(h0XQ���In order to properly interpret how to use the object, the consumer must know the
h>hòubcdocutils.nodes
emphasis
qü)Åq†}q°(h0X ���*media type*h1}q¢(h3]h;]h7]h4]h<]uh>hòhS]q£h\X
���media typeq§ÖÅq•}q¶(h0U�h>h†ubahKUemphasisqßubh\XÓ��� of the object. The media type (formerly the MIME or Multipurpose
Internet Mail Extensions Type) is metadata about an object that can be used by
the consumer to determine what the object is. The IANA (Internet Assigned
Numbers Authority [q®ÖÅq©}q™(h0XÓ��� of the object. The media type (formerly the MIME or Multipurpose
Internet Mail Extensions Type) is metadata about an object that can be used by
the consumer to determine what the object is. The IANA (Internet Assigned
Numbers Authority [h>hòubhr)Åq´}q¨(h0X���IANA_huKh>hòhKhvh1}q≠(UnameX���IANAhxX���http://www.iana.org/qÆh4]h7]h3]h;]h<]uhS]qØh\X���IANAq∞ÖÅq±}q≤(h0U�h>h´ubaubh\X.���]) provides a controlled list of media types
[q≥ÖÅq¥}qµ(h0X.���]) provides a controlled list of media types
[h>hòubhr)Åq∂}q∑(h0X ���IANA_MEDIA_huKh>hòhKhvh1}q∏(UnameX
���IANA_MEDIAhxX=���http://www.iana.org/assignments/media-types/media-types.xhtmlqπh4]h7]h3]h;]h<]uhS]q∫h\X
���IANA_MEDIAqªÖÅqº}qΩ(h0U�h>h∂ubaubh\Xì���] (henceforth "IANA Media Types") that are used during internet
transfer of objects to inform the receiver of the type of object being
transferred.qæÖÅqø}q¿(h0Xì���] (henceforth "IANA Media Types") that are used during internet
transfer of objects to inform the receiver of the type of object being
transferred.h>hòubeubh`)Åq¡}q¬(h0X.���The media type can be determined several ways:q√h>hÅhJh:hKhch1}qƒ(h3]h;]h7]h4]h<]uhQKhRhhS]q≈h\X.���The media type can be determined several ways:q∆ÖÅq«}q»(h0h√h>h¡ubaubcdocutils.nodes
bullet_list
q…)Åq }qÀ(h0U�h>hÅhJh:hKU bullet_listqÃh1}qÕ(UbulletqŒX���*h4]h7]h3]h;]h<]uhQK hRhhS]qœ(h?)Åq–}q—(h0X ���examine the bytes of the objectq“h>h hJh:hKU list_itemq”h1}q‘(h3]h;]h7]h4]h<]uhQNhRhhS]q’h`)Åq÷}q◊(h0h“h>h–hJh:hKhch1}qÿ(h3]h;]h7]h4]h<]uhQK hS]qŸh\X ���examine the bytes of the objectq⁄ÖÅq€}q‹(h0h“h>h÷ubaubaubh?)Åq›}qfi(h0X&���infer from the file name of the objectqflh>h hJh:hKh”h1}q‡(h3]h;]h7]h4]h<]uhQNhRhhS]q·h`)Åq‚}q„(h0hflh>h›hJh:hKhch1}q‰(h3]h;]h7]h4]h<]uhQK hS]qÂh\X&���infer from the file name of the objectqÊÖÅqÁ}qË(h0hflh>h‚ubaubaubh?)ÅqÈ}qÍ(h0X4���additional metadata provided by the object producer
h>h hJh:hKh”h1}qÎ(h3]h;]h7]h4]h<]uhQNhRhhS]qÏh`)ÅqÌ}qÓ(h0X3���additional metadata provided by the object producerqÔh>hÈhJh:hKhch1}q(h3]h;]h7]h4]h<]uhQK hS]qÒh\X3���additional metadata provided by the object producerqÚÖÅqÛ}qÙ(h0hÔh>hÌubaubaubeubh`)Åqı}qˆ(h0X0��The most reliable general solution is for the media type metadata to be provided
by the object producer. This is especially important for ambiguous object types
such as text documents since the character encoding can in many cases only be
reliably determined by the application that created the document.q˜h>hÅhJh:hKhch1}q¯(h3]h;]h7]h4]h<]uhQK!hRhhS]q˘h\X0��The most reliable general solution is for the media type metadata to be provided
by the object producer. This is especially important for ambiguous object types
such as text documents since the character encoding can in many cases only be
reliably determined by the application that created the document.q˙ÖÅq˚}q¸(h0h˜h>hıubaubh`)Åq˝}q˛(h0X∑��In some cases, the IANA Media Type by itself does not provide sufficient
information for a consumer to reliably process an object. For example a text
document with IANA Media Type of ``text/plain`` may have been created using any
of hundreds of character sets [IANA_CHARS_]. In these cases, an additional
``charset`` parameter is specified, and this information along with the IANA
Media Type is required to properly interpret a text file.h>hÅhJh:hKhch1}qˇ(h3]h;]h7]h4]h<]uhQK&hRhhS]r���(h\X∑���In some cases, the IANA Media Type by itself does not provide sufficient
information for a consumer to reliably process an object. For example a text
document with IANA Media Type of r��ÖÅr��}r��(h0X∑���In some cases, the IANA Media Type by itself does not provide sufficient
information for a consumer to reliably process an object. For example a text
document with IANA Media Type of h>h˝ubcdocutils.nodes
literal
r��)År��}r��(h0X���``text/plain``h1}r��(h3]h;]h7]h4]h<]uh>h˝hS]r��h\X
���text/plainr ��ÖÅr
��}r ��(h0U�h>j��ubahKUliteralr ��ubh\X@��� may have been created using any
of hundreds of character sets [r
��ÖÅr��}r��(h0X@��� may have been created using any
of hundreds of character sets [h>h˝ubhr)År��}r��(h0X ���IANA_CHARS_huKh>h˝hKhvh1}r��(UnameX
���IANA_CHARShxXC���http://www.iana.org/assignments/character-sets/character-sets.xhtmlr��h4]h7]h3]h;]h<]uhS]r��h\X
���IANA_CHARSr��ÖÅr��}r��(h0U�h>j��ubaubh\X!���]. In these cases, an additional
r��ÖÅr��}r��(h0X!���]. In these cases, an additional
h>h˝ubj��)År��}r ��(h0X ���``charset``h1}r ��(h3]h;]h7]h4]h<]uh>h˝hS]r ��h\X���charsetr ��ÖÅr ��}r!��(h0U�h>j��ubahKj ��ubh\X{��� parameter is specified, and this information along with the IANA
Media Type is required to properly interpret a text file.r"��ÖÅr#��}r$��(h0X{��� parameter is specified, and this information along with the IANA
Media Type is required to properly interpret a text file.h>h˝ubeubh`)År%��}r&��(h0X(��DataONE expands on the metadata describing an object by recording additional
information in :class:`Types.SystemMetadata` that accompanies every object.
Amongst this additional metadata is a ``formatId`` that, like the IANA Media
Type, provides a pointer to additional information (a
:class:`Types.ObjectFormat`) about the object for the benefit of downstream
consumers. The ``ObjectFormat`` structure is a controlled list of object
classifications that augments the IANA Media Type to support use by analytical
tools employed by researchers and other.h>hÅhJh:hKhch1}r'��(h3]h;]h7]h4]h<]uhQK-hRhhS]r(��(h\X\���DataONE expands on the metadata describing an object by recording additional
information in r)��ÖÅr*��}r+��(h0X\���DataONE expands on the metadata describing an object by recording additional
information in h>j%��ubcsphinx.addnodes
pending_xref
r,��)År-��}r.��(h0X ���:class:`Types.SystemMetadata`r/��h>j%��hJh:hKU pending_xrefr0��h1}r1��(UreftypeX���classUrefwarnr2��âU reftargetr3��X���Types.SystemMetadataU refdomainX���pyr4��h4]h7]U refexplicitâh3]h;]h<]Urefdocr5��X���design/what_is_itr6��Upy:classr7��NU py:moduler8��NuhQK-hS]r9��j��)År:��}r;��(h0j/��h1}r<��(h3]h;]r=��(Uxrefr>��j4��X���py-classr?��eh7]h4]h<]uh>j-��hS]r@��h\X���Types.SystemMetadatarA��ÖÅrB��}rC��(h0U�h>j:��ubahKj ��ubaubh\XF��� that accompanies every object.
Amongst this additional metadata is a rD��ÖÅrE��}rF��(h0XF��� that accompanies every object.
Amongst this additional metadata is a h>j%��ubj��)ÅrG��}rH��(h0X ���``formatId``h1}rI��(h3]h;]h7]h4]h<]uh>j%��hS]rJ��h\X���formatIdrK��ÖÅrL��}rM��(h0U�h>jG��ubahKj ��ubh\XQ��� that, like the IANA Media
Type, provides a pointer to additional information (a
rN��ÖÅrO��}rP��(h0XQ��� that, like the IANA Media
Type, provides a pointer to additional information (a
h>j%��ubj,��)ÅrQ��}rR��(h0X���:class:`Types.ObjectFormat`rS��h>j%��hJh:hKj0��h1}rT��(UreftypeX���classj2��âj3��X���Types.ObjectFormatU refdomainX���pyrU��h4]h7]U refexplicitâh3]h;]h<]j5��j6��j7��Nj8��NuhQK-hS]rV��j��)ÅrW��}rX��(h0jS��h1}rY��(h3]h;]rZ��(j>��jU��X���py-classr[��eh7]h4]h<]uh>jQ��hS]r\��h\X���Types.ObjectFormatr]��ÖÅr^��}r_��(h0U�h>jW��ubahKj ��ubaubh\X@���) about the object for the benefit of downstream
consumers. The r`��ÖÅra��}rb��(h0X@���) about the object for the benefit of downstream
consumers. The h>j%��ubj��)Årc��}rd��(h0X���``ObjectFormat``h1}re��(h3]h;]h7]h4]h<]uh>j%��hS]rf��h\X ���ObjectFormatrg��ÖÅrh��}ri��(h0U�h>jc��ubahKj ��ubh\X°��� structure is a controlled list of object
classifications that augments the IANA Media Type to support use by analytical
tools employed by researchers and other.rj��ÖÅrk��}rl��(h0X°��� structure is a controlled list of object
classifications that augments the IANA Media Type to support use by analytical
tools employed by researchers and other.h>j%��ubeubh`)Årm��}rn��(h0X—���In this manner the combination of an object and it's System Metadata provides
the information necessary for a consumer to discern what the object is and so
what applications might be used to ingest the object.ro��h>hÅhJh:hKhch1}rp��(h3]h;]h7]h4]h<]uhQK6hRhhS]rq��h\X—���In this manner the combination of an object and it's System Metadata provides
the information necessary for a consumer to discern what the object is and so
what applications might be used to ingest the object.rr��ÖÅrs��}rt��(h0jo��h>jm��ubaubeubhFhE)Åru��}rv��(h0U�h>hHhJh:hKhLh1}rw��(h3]h;]h7]h4]rx��U4setting-content-type-and-content-disposition-headersry��ah<]rz��hauhQKéhRhhS]r{��(hU)År|��}r}��(h0X4���Setting Content-Type and Content-Disposition Headersr~��h>ju��hJh:hKhYh1}r��(h3]h;]h7]h4]h<]uhQKéhRhhS]rÄ��h\X4���Setting Content-Type and Content-Disposition HeadersrÅ��ÖÅrÇ��}rÉ��(h0j~��h>j|��ubaubh`)ÅrÑ��}rÖ��(h0X��The purpose of the HTTP ``Content-Type`` header is to inform the receiver of a
byte stream what the payload actually is. Parameters may be included with the
``Content-Type`` to provide additional information for the consumer (e.g. the
``charset`` parameter for text sub-types).h>ju��hJh:hKhch1}rÜ��(h3]h;]h7]h4]h<]uhQKêhRhhS]rá��(h\X���The purpose of the HTTP rà��ÖÅrâ��}rä��(h0X���The purpose of the HTTP h>jÑ��ubj��)Årã��}rå��(h0X���``Content-Type``h1}rç��(h3]h;]h7]h4]h<]uh>jÑ��hS]ré��h\X ���Content-Typerè��ÖÅrê��}rë��(h0U�h>jã��ubahKj ��ubh\Xu��� header is to inform the receiver of a
byte stream what the payload actually is. Parameters may be included with the
rí��ÖÅrì��}rî��(h0Xu��� header is to inform the receiver of a
byte stream what the payload actually is. Parameters may be included with the
h>jÑ��ubj��)Årï��}rñ��(h0X���``Content-Type``h1}ró��(h3]h;]h7]h4]h<]uh>jÑ��hS]rò��h\X ���Content-Typerô��ÖÅrö��}rõ��(h0U�h>jï��ubahKj ��ubh\X>��� to provide additional information for the consumer (e.g. the
rú��ÖÅrù��}rû��(h0X>��� to provide additional information for the consumer (e.g. the
h>jÑ��ubj��)Årü��}r†��(h0X ���``charset``h1}r°��(h3]h;]h7]h4]h<]uh>jÑ��hS]r¢��h\X���charsetr£��ÖÅr§��}r•��(h0U�h>jü��ubahKj ��ubh\X ��� parameter for text sub-types).r¶��ÖÅrß��}r®��(h0X ��� parameter for text sub-types).h>jÑ��ubeubhE)År©��}r™��(h0U�h>ju��hJh:hKhLh1}r´��(h3]h;]h7]h4]r¨��Uversion-1-x-content-typer≠��ah<]rÆ��h auhQKñhRhhS]rØ��(hU)År∞��}r±��(h0X���Version 1.x Content-Typer≤��h>j©��hJh:hKhYh1}r≥��(h3]h;]h7]h4]h<]uhQKñhRhhS]r¥��h\X���Version 1.x Content-Typerµ��ÖÅr∂��}r∑��(h0j≤��h>j∞��ubaubh`)År∏��}rπ��(h0X��Media type tracking in Version 1.x is largely delegated to the ObjectFormat
referenced in the SystemMetadata associated with an object. A content producer
may provide a Content-Type header, but this information is not preserved as part
of the DataONE infrastructure. Hence, consumers that intend to re-expose the
object should endeavor to record the provided Content-Type and provide tha
header when re-transmitting the object. Such an action is however, undefined
within the Version 1.x DataONE service interfaces.r∫��h>j©��hJh:hKhch1}rª��(h3]h;]h7]h4]h<]uhQKòhRhhS]rº��h\X��Media type tracking in Version 1.x is largely delegated to the ObjectFormat
referenced in the SystemMetadata associated with an object. A content producer
may provide a Content-Type header, but this information is not preserved as part
of the DataONE infrastructure. Hence, consumers that intend to re-expose the
object should endeavor to record the provided Content-Type and provide tha
header when re-transmitting the object. Such an action is however, undefined
within the Version 1.x DataONE service interfaces.rΩ��ÖÅræ��}rø��(h0j∫��h>j∏��ubaubh`)År¿��}r¡��(h0X_���Lacking an explicltly set Content-Type, a Node may infer the Content-Type from the ObjectFormatr¬��h>j©��hJh:hKhch1}r√��(h3]h;]h7]h4]h<]uhQK†hRhhS]rƒ��h\X_���Lacking an explicltly set Content-Type, a Node may infer the Content-Type from the ObjectFormatr≈��ÖÅr∆��}r«��(h0j¬��h>j¿��ubaubeubhE)År»��}r…��(h0U�h>ju��hJh:hKhLh1}r ��(h3]h;]h7]h4]rÀ��Uversion-2-0-content-typerÃ��ah<]rÕ��hauhQK£hRhhS]rŒ��(hU)Årœ��}r–��(h0X���Version 2.0 Content-Typer—��h>j»��hJh:hKhYh1}r“��(h3]h;]h7]h4]h<]uhQK£hRhhS]r”��h\X���Version 2.0 Content-Typer‘��ÖÅr’��}r÷��(h0j—��h>jœ��ubaubhB)År◊��}rÿ��(h0U�h>j»��hJh:hKUenumerated_listrŸ��h1}r⁄��(Usuffixr€��U.h4]h7]h3]Uprefixr‹��U�h;]h<]Uenumtyper›��U
loweralpharfi��uhQK•hRhhS]rfl��(h?)År‡��}r·��(h0X„���``mediaType`` value is specified in SystemMetadata
The SystemMetdata.mediaType value is used to set the Content-Type header
value. The SystemMetadata.mediaType overrides a value that may be set in the
referenced ObjectFormat.
h>j◊��hJh:hKh”h1}r‚��(h3]h;]h7]h4]h<]uhQNhRhhS]r„��(h`)År‰��}rÂ��(h0X2���``mediaType`` value is specified in SystemMetadatah>j‡��hJh:hKhch1}rÊ��(h3]h;]h7]h4]h<]uhQK•hS]rÁ��(j��)ÅrË��}rÈ��(h0X
���``mediaType``h1}rÍ��(h3]h;]h7]h4]h<]uh>j‰��hS]rÎ��h\X ���mediaTyperÏ��ÖÅrÌ��}rÓ��(h0U�h>jË��ubahKj ��ubh\X%��� value is specified in SystemMetadatarÔ��ÖÅr��}rÒ��(h0X%��� value is specified in SystemMetadatah>j‰��ubeubh`)ÅrÚ��}rÛ��(h0XÆ���The SystemMetdata.mediaType value is used to set the Content-Type header
value. The SystemMetadata.mediaType overrides a value that may be set in the
referenced ObjectFormat.rÙ��h>j‡��hJh:hKhch1}rı��(h3]h;]h7]h4]h<]uhQKßhS]rˆ��h\XÆ���The SystemMetdata.mediaType value is used to set the Content-Type header
value. The SystemMetadata.mediaType overrides a value that may be set in the
referenced ObjectFormat.r˜��ÖÅr¯��}r˘��(h0jÙ��h>jÚ��ubaubeubh?)År˙��}r˚��(h0XO���``mediaType`` value not specified in SystemMetadata, available in ObjectFormat
h>j◊��hJh:hKh”h1}r¸��(h3]h;]h7]h4]h<]uhQNhRhhS]r˝��h`)År˛��}rˇ��(h0XN���``mediaType`` value not specified in SystemMetadata, available in ObjectFormath>j˙��hJh:hKhch1}r���(h3]h;]h7]h4]h<]uhQK´hS]r��(j��)År��}r��(h0X
���``mediaType``h1}r��(h3]h;]h7]h4]h<]uh>j˛��hS]r��h\X ���mediaTyper��ÖÅr��}r��(h0U�h>j��ubahKj ��ubh\XA��� value not specified in SystemMetadata, available in ObjectFormatr ��ÖÅr
��}r ��(h0XA��� value not specified in SystemMetadata, available in ObjectFormath>j˛��ubeubaubh?)År ��}r
��(h0XE���``mediaType`` value not specified in SystemMetadata or ObjectFormat
h>j◊��hJh:hKh”h1}r��(h3]h;]h7]h4]h<]uhQNhRhhS]r��h`)År��}r��(h0XC���``mediaType`` value not specified in SystemMetadata or ObjectFormath>j ��hJh:hKhch1}r��(h3]h;]h7]h4]h<]uhQK≠hS]r��(j��)År��}r��(h0X
���``mediaType``h1}r��(h3]h;]h7]h4]h<]uh>j��hS]r��h\X ���mediaTyper��ÖÅr��}r��(h0U�h>j��ubahKj ��ubh\X6��� value not specified in SystemMetadata or ObjectFormatr��ÖÅr ��}r ��(h0X6��� value not specified in SystemMetadata or ObjectFormath>j��ubeubaubeubeubeubhE)År ��}r ��(h0U�h>hHhJh:hKhLh1}r ��(h3]h;]h7]h4]r!��U rules-for-various-content-typesr"��ah<]r#��h#auhQK±hRhhS]r$��(hU)År%��}r&��(h0X ���Rules for Various Content Typesr'��h>j ��hJh:hKhYh1}r(��(h3]h;]h7]h4]h<]uhQK±hRhhS]r)��h\X ���Rules for Various Content Typesr*��ÖÅr+��}r,��(h0j'��h>j%��ubaubhE)År-��}r.��(h0U�h>j ��hJh:hKhLh1}r/��(h3]h;]h7]h4]r0��Uapplication-xmlr1��ah<]r2��hauhQK¥hRhhS]r3��(hU)År4��}r5��(h0X���application/xmlr6��h>j-��hJh:hKhYh1}r7��(h3]h;]h7]h4]h<]uhQK¥hRhhS]r8��h\X���application/xmlr9��ÖÅr:��}r;��(h0j6��h>j4��ubaubcdocutils.nodes
note
r<��)År=��}r>��(h0XK���``application/xml`` and ``text/xml`` are equivalent [RFC7303_ Section
9.2].h>j-��hJh:hKUnoter?��h1}r@��(h3]h;]h7]h4]h<]uhQNhRhhS]rA��h`)ÅrB��}rC��(h0XK���``application/xml`` and ``text/xml`` are equivalent [RFC7303_ Section
9.2].h>j=��hJh:hKhch1}rD��(h3]h;]h7]h4]h<]uhQK∏hS]rE��(j��)ÅrF��}rG��(h0X���``application/xml``h1}rH��(h3]h;]h7]h4]h<]uh>jB��hS]rI��h\X���application/xmlrJ��ÖÅrK��}rL��(h0U�h>jF��ubahKj ��ubh\X��� and rM��ÖÅrN��}rO��(h0X��� and h>jB��ubj��)ÅrP��}rQ��(h0X ���``text/xml``h1}rR��(h3]h;]h7]h4]h<]uh>jB��hS]rS��h\X���text/xmlrT��ÖÅrU��}rV��(h0U�h>jP��ubahKj ��ubh\X��� are equivalent [rW��ÖÅrX��}rY��(h0X��� are equivalent [h>jB��ubhr)ÅrZ��}r[��(h0X���RFC7303_huKh>jB��hKhvh1}r\��(UnameX���RFC7303hxX#���http://www.ietf.org/rfc/rfc7303.txtr]��h4]h7]h3]h;]h<]uhS]r^��h\X���RFC7303r_��ÖÅr`��}ra��(h0U�h>jZ��ubaubh\X��� Section
9.2].rb��ÖÅrc��}rd��(h0X��� Section
9.2].h>jB��ubeubaubh`)Åre��}rf��(h0XU���The use of UTF-8, without a BOM, is RECOMMENDED for all XML MIME entities
[RFC7303_].h>j-��hJh:hKhch1}rg��(h3]h;]h7]h4]h<]uhQKªhRhhS]rh��(h\XK���The use of UTF-8, without a BOM, is RECOMMENDED for all XML MIME entities
[ri��ÖÅrj��}rk��(h0XK���The use of UTF-8, without a BOM, is RECOMMENDED for all XML MIME entities
[h>je��ubhr)Årl��}rm��(h0X���RFC7303_huKh>je��hKhvh1}rn��(UnameX���RFC7303hxj]��h4]h7]h3]h;]h<]uhS]ro��h\X���RFC7303rp��ÖÅrq��}rr��(h0U�h>jl��ubaubh\X���].rs��ÖÅrt��}ru��(h0X���].h>je��ubeubh`)Årv��}rw��(h0XH��The document character set for XML is Unicode (ISO 10646), which means that XML
processors should behave as if they used Unicode internally. However, that does
not mean an XML document must be transmitted in Unicode. As long as client and
server agree on the encoding, they can use any encoding that can be converted to
Unicode.rx��h>j-��hJh:hKhch1}ry��(h3]h;]h7]h4]h<]uhQKæhRhhS]rz��h\XH��The document character set for XML is Unicode (ISO 10646), which means that XML
processors should behave as if they used Unicode internally. However, that does
not mean an XML document must be transmitted in Unicode. As long as client and
server agree on the encoding, they can use any encoding that can be converted to
Unicode.r{��ÖÅr|��}r}��(h0jx��h>jv��ubaubh`)År~��}r��(h0Xv���A challenge with XML documents is that there are three locations where character
encoding information may be provided:rÄ��h>j-��hJh:hKhch1}rÅ��(h3]h;]h7]h4]h<]uhQKƒhRhhS]rÇ��h\Xv���A challenge with XML documents is that there are three locations where character
encoding information may be provided:rÉ��ÖÅrÑ��}rÖ��(h0jÄ��h>j~��ubaubh…)ÅrÜ��}rá��(h0U�h>j-��hJh:hKhÃh1}rà��(hŒX���*h4]h7]h3]h;]h<]uhQK«hRhhS]râ��(h?)Årä��}rã��(h0X<���A Byte Order Marker (BOM) at the begining of the entity bodyrå��h>jÜ��hJh:hKh”h1}rç��(h3]h;]h7]h4]h<]uhQNhRhhS]ré��h`)Årè��}rê��(h0jå��h>jä��hJh:hKhch1}rë��(h3]h;]h7]h4]h<]uhQK«hS]rí��h\X<���A Byte Order Marker (BOM) at the begining of the entity bodyrì��ÖÅrî��}rï��(h0jå��h>jè��ubaubaubh?)Årñ��}ró��(h0X=���An XML encoding property present at the start of the documentrò��h>jÜ��hJh:hKh”h1}rô��(h3]h;]h7]h4]h<]uhQNhRhhS]rö��h`)Årõ��}rú��(h0jò��h>jñ��hJh:hKhch1}rù��(h3]h;]h7]h4]h<]uhQK»hS]rû��h\X=���An XML encoding property present at the start of the documentrü��ÖÅr†��}r°��(h0jò��h>jõ��ubaubaubh?)År¢��}r£��(h0X?���A charset property present in the ``Content-Type`` HTTP header
h>jÜ��hJh:hKh”h1}r§��(h3]h;]h7]h4]h<]uhQNhRhhS]r•��h`)År¶��}rß��(h0X>���A charset property present in the ``Content-Type`` HTTP headerh>j¢��hJh:hKhch1}r®��(h3]h;]h7]h4]h<]uhQK…hS]r©��(h\X"���A charset property present in the r™��ÖÅr´��}r¨��(h0X"���A charset property present in the h>j¶��ubj��)År≠��}rÆ��(h0X���``Content-Type``h1}rØ��(h3]h;]h7]h4]h<]uh>j¶��hS]r∞��h\X ���Content-Typer±��ÖÅr≤��}r≥��(h0U�h>j≠��ubahKj ��ubh\X ��� HTTP headerr¥��ÖÅrµ��}r∂��(h0X ��� HTTP headerh>j¶��ubeubaubeubh`)År∑��}r∏��(h0X÷���Each of these are optional, and when present may provide conflicting
information. `Section 3.2 <RFC7303>`_ of RFC7303 provides guidelines for how to
infer the character encoding of a document. In order of priority:h>j-��hJh:hKhch1}rπ��(h3]h;]h7]h4]h<]uhQKÀhRhhS]r∫��(h\XR���Each of these are optional, and when present may provide conflicting
information. rª��ÖÅrº��}rΩ��(h0XR���Each of these are optional, and when present may provide conflicting
information. h>j∑��ubhr)Åræ��}rø��(h0X���`Section 3.2 <RFC7303>`_h1}r¿��(UnameX ���Section 3.2hxX���RFC7303r¡��h4]h7]h3]h;]h<]uh>j∑��hS]r¬��h\X ���Section 3.2r√��ÖÅrƒ��}r≈��(h0U�h>jæ��ubahKhvubcdocutils.nodes
target
r∆��)År«��}r»��(h0X
��� <RFC7303>U
referencedr…��Kh>j∑��hKUtargetr ��h1}rÀ��(Urefurij¡��h4]rÃ��U section-3-2rÕ��ah7]h3]h;]h<]rŒ��h auhS]ubh\Xl��� of RFC7303 provides guidelines for how to
infer the character encoding of a document. In order of priority:rœ��ÖÅr–��}r—��(h0Xl��� of RFC7303 provides guidelines for how to
infer the character encoding of a document. In order of priority:h>j∑��ubeubcdocutils.nodes
block_quote
r“��)År”��}r‘��(h0U�h>j-��hJNhKU block_quoter’��h1}r÷��(h3]h;]h7]h4]h<]uhQNhRhhS]r◊��hB)Årÿ��}rŸ��(h0U�h1}r⁄��(j€��U.h4]h7]h3]j‹��U�h;]h<]j›��Uarabicr€��uh>j”��hS]r‹��(h?)År›��}rfi��(h0XM���A BOM (Section 3.3) is authoritative if it is present in an XML MIME
entity;
h1}rfl��(h3]h;]h7]h4]h<]uh>jÿ��hS]r‡��h`)År·��}r‚��(h0XL���A BOM (Section 3.3) is authoritative if it is present in an XML MIME
entity;r„��h>j›��hJh:hKhch1}r‰��(h3]h;]h7]h4]h<]uhQKœhS]rÂ��h\XL���A BOM (Section 3.3) is authoritative if it is present in an XML MIME
entity;rÊ��ÖÅrÁ��}rË��(h0j„��h>j·��ubaubahKh”ubh?)ÅrÈ��}rÍ��(h0X`���In the absence of a BOM (Section 3.3), the charset parameter is
authoritative if it is present.
h1}rÎ��(h3]h;]h7]h4]h<]uh>jÿ��hS]rÏ��h`)ÅrÌ��}rÓ��(h0X_���In the absence of a BOM (Section 3.3), the charset parameter is
authoritative if it is present.rÔ��h>jÈ��hJh:hKhch1}r��(h3]h;]h7]h4]h<]uhQK“hS]rÒ��h\X_���In the absence of a BOM (Section 3.3), the charset parameter is
authoritative if it is present.rÚ��ÖÅrÛ��}rÙ��(h0jÔ��h>jÌ��ubaubahKh”ubh?)Årı��}rˆ��(h0Xf��If an XML MIME entity is received where the charset parameter is omitted,
no information is being provided about the character encoding by the MIME
Content-Type header. XML-aware consumers MUST follow the requirements in
section 4.3.3 of [XML_] that directly address this case. XML-unaware MIME
consumers SHOULD NOT assume a default encoding in this case.
h1}r˜��(h3]h;]h7]h4]h<]uh>jÿ��hS]r¯��h`)År˘��}r˙��(h0Xe��If an XML MIME entity is received where the charset parameter is omitted,
no information is being provided about the character encoding by the MIME
Content-Type header. XML-aware consumers MUST follow the requirements in
section 4.3.3 of [XML_] that directly address this case. XML-unaware MIME
consumers SHOULD NOT assume a default encoding in this case.h>jı��hJh:hKhch1}r˚��(h3]h;]h7]h4]h<]uhQK’hS]r¸��(h\X���If an XML MIME entity is received where the charset parameter is omitted,
no information is being provided about the character encoding by the MIME
Content-Type header. XML-aware consumers MUST follow the requirements in
section 4.3.3 of [r˝��ÖÅr˛��}rˇ��(h0X���If an XML MIME entity is received where the charset parameter is omitted,
no information is being provided about the character encoding by the MIME
Content-Type header. XML-aware consumers MUST follow the requirements in
section 4.3.3 of [h>j˘��ubhr)År���}r��(h0X���XML_huKh>j˘��hKhvh1}r��(UnameX���XMLhxX*���http://www.w3.org/TR/2008/REC-xml-20081126r��h4]h7]h3]h;]h<]uhS]r��h\X���XMLr��ÖÅr��}r��(h0U�h>j���ubaubh\Xq���] that directly address this case. XML-unaware MIME
consumers SHOULD NOT assume a default encoding in this case.r��ÖÅr ��}r
��(h0Xq���] that directly address this case. XML-unaware MIME
consumers SHOULD NOT assume a default encoding in this case.h>j˘��ubeubahKh”ubehKjŸ��ubaubh`)År ��}r ��(h0X\���Section 8 of RFC7303_ provides several examples of consistent and inconsistent
XML encoding.h>j-��hJh:hKhch1}r
��(h3]h;]h7]h4]h<]uhQK€hRhhS]r��(h\X
���Section 8 of r��ÖÅr��}r��(h0X
���Section 8 of h>j ��ubhr)År��}r��(h0X���RFC7303_huKh>j ��hKhvh1}r��(UnameX���RFC7303hxj]��h4]h7]h3]h;]h<]uhS]r��h\X���RFC7303r��ÖÅr��}r��(h0U�h>j��ubaubh\XG��� provides several examples of consistent and inconsistent
XML encoding.r��ÖÅr��}r��(h0XG��� provides several examples of consistent and inconsistent
XML encoding.h>j ��ubeubh`)År ��}r ��(h0XX��An important consequence of the document character set is that values of numeric
character references (such as ǵ and ǵ for LATIN SMALL LETTER G WITH
ACUTE) are interpreted as Unicode characters - no matter what encoding you use
for your document. This is a common source of error among those who are not
clear about the distinction.r ��h>j-��hJh:hKhch1}r ��(h3]h;]h7]h4]h<]uhQKfihRhhS]r ��h\XX��An important consequence of the document character set is that values of numeric
character references (such as ǵ and ǵ for LATIN SMALL LETTER G WITH
ACUTE) are interpreted as Unicode characters - no matter what encoding you use
for your document. This is a common source of error among those who are not
clear about the distinction.r!��ÖÅr"��}r#��(h0j ��h>j ��ubaubh`)År$��}r%��(h0X��Note that not all Unicode characters can be used anywhere in XML. Certain
characters are excluded from use in tag names (elements and attributes), and
`XML 1.1 <XML1.1>`_ expands significantly on the range of characters that may
be used compared with `XML 1.0 <XML1.0>`_.h>j-��hJh:hKhch1}r&��(h3]h;]h7]h4]h<]uhQK‰hRhhS]r'��(h\Xó���Note that not all Unicode characters can be used anywhere in XML. Certain
characters are excluded from use in tag names (elements and attributes), and
r(��ÖÅr)��}r*��(h0Xó���Note that not all Unicode characters can be used anywhere in XML. Certain
characters are excluded from use in tag names (elements and attributes), and
h>j$��ubhr)År+��}r,��(h0X���`XML 1.1 <XML1.1>`_h1}r-��(UnameX���XML 1.1hxX���XML1.1r.��h4]h7]h3]h;]h<]uh>j$��hS]r/��h\X���XML 1.1r0��ÖÅr1��}r2��(h0U�h>j+��ubahKhvubj∆��)År3��}r4��(h0X ��� <XML1.1>j…��Kh>j$��hKj ��h1}r5��(Urefurij.��h4]r6��Uxml-1-1r7��ah7]h3]h;]h<]r8��h auhS]ubh\XQ��� expands significantly on the range of characters that may
be used compared with r9��ÖÅr:��}r;��(h0XQ��� expands significantly on the range of characters that may
be used compared with h>j$��ubhr)År<��}r=��(h0X���`XML 1.0 <XML1.0>`_h1}r>��(UnameX���XML 1.0hxX���XML1.0r?��h4]h7]h3]h;]h<]uh>j$��hS]r@��h\X���XML 1.0rA��ÖÅrB��}rC��(h0U�h>j<��ubahKhvubj∆��)ÅrD��}rE��(h0X ��� <XML1.0>j…��Kh>j$��hKj ��h1}rF��(Urefurij?��h4]rG��Uxml-1-0rH��ah7]h3]h;]h<]rI��h
auhS]ubh\X���.ÖÅrJ��}rK��(h0X���.h>j$��ubeubeubhE)ÅrL��}rM��(h0U�h>j ��hJh:hKhLh1}rN��(h3]h;]h7]h4]rO��Utext-xmlrP��ah<]rQ��hauhQKÎhRhhS]rR��(hU)ÅrS��}rT��(h0X���text/xmlrU��h>jL��hJh:hKhYh1}rV��(h3]h;]h7]h4]h<]uhQKÎhRhhS]rW��h\X���text/xmlrX��ÖÅrY��}rZ��(h0jU��h>jS��ubaubh`)År[��}r\��(h0X���See application/xml.r]��h>jL��hJh:hKhch1}r^��(h3]h;]h7]h4]h<]uhQKÌhRhhS]r_��h\X���See application/xml.r`��ÖÅra��}rb��(h0j]��h>j[��ubaubeubhE)Årc��}rd��(h0U�h>j ��hJh:hKhLh1}re��(h3]h;]h7]h4]rf��Utext-csvrg��ah<]rh��h'auhQKÒhRhhS]ri��(hU)Årj��}rk��(h0X���text/csvrl��h>jc��hJh:hKhYh1}rm��(h3]h;]h7]h4]h<]uhQKÒhRhhS]rn��h\X���text/csvro��ÖÅrp��}rq��(h0jl��h>jj��ubaubh`)Årr��}rs��(h0X
���[RFC4180_]rt��h>jc��hJh:hKhch1}ru��(h3]h;]h7]h4]h<]uhQKÛhRhhS]rv��(h\X���[ÖÅrw��}rx��(h0X���[h>jr��ubhr)Åry��}rz��(h0X���RFC4180_huKh>jr��hKhvh1}r{��(UnameX���RFC4180hxX#���http://www.ietf.org/rfc/rfc4180.txtr|��h4]h7]h3]h;]h<]uhS]r}��h\X���RFC4180r~��ÖÅr��}rÄ��(h0U�h>jy��ubaubh\X���]ÖÅrÅ��}rÇ��(h0X���]h>jr��ubeubh`)ÅrÉ��}rÑ��(h0X���MIME media type name: textrÖ��h>jc��hJh:hKhch1}rÜ��(h3]h;]h7]h4]h<]uhQKıhRhhS]rá��h\X���MIME media type name: textrà��ÖÅrâ��}rä��(h0jÖ��h>jÉ��ubaubh`)Årã��}rå��(h0X���MIME subtype name: csvrç��h>jc��hJh:hKhch1}ré��(h3]h;]h7]h4]h<]uhQK˜hRhhS]rè��h\X���MIME subtype name: csvrê��ÖÅrë��}rí��(h0jç��h>jã��ubaubh`)Årì��}rî��(h0X���Required parameters: nonerï��h>jc��hJh:hKhch1}rñ��(h3]h;]h7]h4]h<]uhQK˘hRhhS]ró��h\X���Required parameters: nonerò��ÖÅrô��}rö��(h0jï��h>jì��ubaubh`)Årõ��}rú��(h0X$���Optional parameters: charset, headerrù��h>jc��hJh:hKhch1}rû��(h3]h;]h7]h4]h<]uhQK˚hRhhS]rü��h\X$���Optional parameters: charset, headerr†��ÖÅr°��}r¢��(h0jù��h>jõ��ubaubj“��)År£��}r§��(h0U�h>jc��hJh:hKj’��h1}r•��(h3]h;]h7]h4]h<]uhQNhRhhS]r¶��(h`)Årß��}r®��(h0Xñ���Common usage of CSV is US-ASCII, but other character sets defined by IANA for
the "text" tree may be used in conjunction with the "charset" parameter.r©��h>j£��hJh:hKhch1}r™��(h3]h;]h7]h4]h<]uhQK˝hS]r´��h\Xñ���Common usage of CSV is US-ASCII, but other character sets defined by IANA for
the "text" tree may be used in conjunction with the "charset" parameter.r¨��ÖÅr≠��}rÆ��(h0j©��h>jß��ubaubh`)ÅrØ��}r∞��(h0Xı���The "header" parameter indicates the presence or absence of the header
line.Valid values are "present" or "absent". Implementors choosing not to use
this parameter must make their own decisions as to whether the header line is
present or absent.r±��h>j£��hJh:hKhch1}r≤��(h3]h;]h7]h4]h<]uhQM�hS]r≥��h\Xı���The "header" parameter indicates the presence or absence of the header
line.Valid values are "present" or "absent". Implementors choosing not to use
this parameter must make their own decisions as to whether the header line is
present or absent.r¥��ÖÅrµ��}r∂��(h0j±��h>jØ��ubaubeubh`)År∑��}r∏��(h0X���Encoding considerations:rπ��h>jc��hJh:hKhch1}r∫��(h3]h;]h7]h4]h<]uhQMhRhhS]rª��h\X���Encoding considerations:rº��ÖÅrΩ��}ræ��(h0jπ��h>j∑��ubaubj“��)Årø��}r¿��(h0U�h>jc��hJh:hKj’��h1}r¡��(h3]h;]h7]h4]h<]uhQNhRhhS]r¬��h`)År√��}rƒ��(h0X¨���As per section 4.1.1. of RFC 2046 [3], this media type uses CRLF to denote
line breaks.However, implementors should be aware that some implementations
may use other values.r≈��h>jø��hJh:hKhch1}r∆��(h3]h;]h7]h4]h<]uhQMhS]r«��h\X¨���As per section 4.1.1. of RFC 2046 [3], this media type uses CRLF to denote
line breaks.However, implementors should be aware that some implementations
may use other values.r»��ÖÅr…��}r ��(h0j≈��h>j√��ubaubaubeubhE)ÅrÀ��}rÃ��(h0U�h>j ��hJh:hKhLh1}rÕ��(h3]h;]h7]h4]rŒ��U
text-plainrœ��ah<]r–��h!auhQM
hRhhS]r—��(hU)År“��}r”��(h0X
���text/plainr‘��h>jÀ��hJh:hKhYh1}r’��(h3]h;]h7]h4]h<]uhQM
hRhhS]r÷��h\X
���text/plainr◊��ÖÅrÿ��}rŸ��(h0j‘��h>j“��ubaubh`)År⁄��}r€��(h0X
���[RFC2046_]r‹��h>jÀ��hJh:hKhch1}r›��(h3]h;]h7]h4]h<]uhQMhRhhS]rfi��(h\X���[ÖÅrfl��}r‡��(h0X���[h>j⁄��ubhr)År·��}r‚��(h0X���RFC2046_huKh>j⁄��hKhvh1}r„��(UnameX���RFC2046hxX#���http://www.ietf.org/rfc/rfc2046.txtr‰��h4]h7]h3]h;]h<]uhS]rÂ��h\X���RFC2046rÊ��ÖÅrÁ��}rË��(h0U�h>j·��ubaubh\X���]ÖÅrÈ��}rÍ��(h0X���]h>j⁄��ubeubeubhE)ÅrÎ��}rÏ��(h0U�h>j ��hJh:hKhLh1}rÌ��(h3]h;]h7]h4]rÓ��Utext-javascriptrÔ��ah<]r��h%auhQMhRhhS]rÒ��(hU)ÅrÚ��}rÛ��(h0X���text/javascriptrÙ��h>jÎ��hJh:hKhYh1}rı��(h3]h;]h7]h4]h<]uhQMhRhhS]rˆ��h\X���text/javascriptr˜��ÖÅr¯��}r˘��(h0jÙ��h>jÚ��ubaubh`)År˙��}r˚��(h0X0���Obsoleted in favor of ``application/javascript``r¸��h>jÎ��hJh:hKhch1}r˝��(h3]h;]h7]h4]h<]uhQMhRhhS]r˛��(h\X���Obsoleted in favor of rˇ��ÖÅr���}r��(h0X���Obsoleted in favor of h>j˙��ubj��)År��}r��(h0X���``application/javascript``h1}r��(h3]h;]h7]h4]h<]uh>j˙��hS]r��h\X���application/javascriptr��ÖÅr��}r��(h0U�h>j��ubahKj ��ubeubeubhE)År ��}r
��(h0U�h>j ��hJh:hKhLh1}r ��(h3]h;]h7]h4]r ��Uapplication-javascriptr
��ah<]r��hauhQMhRhhS]r��hU)År��}r��(h0X���application/javascriptr��h>j ��hJh:hKhYh1}r��(h3]h;]h7]h4]h<]uhQMhRhhS]r��h\X���application/javascriptr��ÖÅr��}r��(h0j��h>j��ubaubaubhE)År��}r��(h0U�h>j ��hJh:hKhLh1}r��(h3]h;]h7]h4]r��Uapplication-jsonr ��ah<]r ��hauhQM hRhhS]r ��(hU)År ��}r ��(h0X���application/jsonr!��h>j��hJh:hKhYh1}r"��(h3]h;]h7]h4]h<]uhQM hRhhS]r#��h\X���application/jsonr$��ÖÅr%��}r&��(h0j!��h>j ��ubaubh`)År'��}r(��(h0XQ���JSON text SHALL be encoded in Unicode_ [RFC4627_]. The default encoding is UTF-8.r)��h>j��hJh:hKhch1}r*��(h3]h;]h7]h4]h<]uhQM!hRhhS]r+��(h\X ���JSON text SHALL be encoded in r,��ÖÅr-��}r.��(h0X ���JSON text SHALL be encoded in h>j'��ubhr)År/��}r0��(h0X���Unicode_huKh>j'��hKhvh1}r1��(UnameX���UnicodehxX���http://www.unicode.org/r2��h4]h7]h3]h;]h<]uhS]r3��h\X���Unicoder4��ÖÅr5��}r6��(h0U�h>j/��ubaubh\X��� [r7��ÖÅr8��}r9��(h0X��� [h>j'��ubhr)År:��}r;��(h0X���RFC4627_huKh>j'��hKhvh1}r<��(UnameX���RFC4627hxX#���http://www.ietf.org/rfc/rfc4627.txtr=��h4]h7]h3]h;]h<]uhS]r>��h\X���RFC4627r?��ÖÅr@��}rA��(h0U�h>j:��ubaubh\X!���]. The default encoding is UTF-8.rB��ÖÅrC��}rD��(h0X!���]. The default encoding is UTF-8.h>j'��ubeubh`)ÅrE��}rF��(h0X˝���Since the first two characters of a JSON text will always be ASCII characters
[RFC0020_], it is possible to determine whether an octet stream is UTF-8, UTF-16
(BE or LE), or UTF-32 (BE or LE) by looking at the pattern of nulls in the first
four octets::h>j��hJh:hKhch1}rG��(h3]h;]h7]h4]h<]uhQM#hRhhS]rH��(h\XO���Since the first two characters of a JSON text will always be ASCII characters
[rI��ÖÅrJ��}rK��(h0XO���Since the first two characters of a JSON text will always be ASCII characters
[h>jE��ubhr)ÅrL��}rM��(h0X���RFC0020_huKh>jE��hKhvh1}rN��(UnameX���RFC0020hxX#���http://www.ietf.org/rfc/rfc0020.txtrO��h4]h7]h3]h;]h<]uhS]rP��h\X���RFC0020rQ��ÖÅrR��}rS��(h0U�h>jL��ubaubh\X•���], it is possible to determine whether an octet stream is UTF-8, UTF-16
(BE or LE), or UTF-32 (BE or LE) by looking at the pattern of nulls in the first
four octets:rT��ÖÅrU��}rV��(h0X•���], it is possible to determine whether an octet stream is UTF-8, UTF-16
(BE or LE), or UTF-32 (BE or LE) by looking at the pattern of nulls in the first
four octets:h>jE��ubeubcdocutils.nodes
literal_block
rW��)ÅrX��}rY��(h0Xj���00 00 00 xx UTF-32BE
00 xx 00 xx UTF-16BE
xx 00 00 00 UTF-32LE
xx 00 xx 00 UTF-16LE
xx xx xx xx UTF-8h>j��hJh:hKU
literal_blockrZ��h1}r[��(U xml:spacer\��Upreserver]��h4]h7]h3]h;]h<]uhQM(hRhhS]r^��h\Xj���00 00 00 xx UTF-32BE
00 xx 00 xx UTF-16BE
xx 00 00 00 UTF-32LE
xx 00 xx 00 UTF-16LE
xx xx xx xx UTF-8r_��ÖÅr`��}ra��(h0U�h>jX��ubaubj∆��)Årb��}rc��(h0XD���.. _Spolsky2003: http://www.joelonsoftware.com/articles/Unicode.htmlj…��Kh>j��hJh:hKj ��h1}rd��(hxhyh4]re��U spolsky2003rf��ah7]h3]h;]h<]rg��h&auhQM2hRhhS]ubj∆��)Årh��}ri��(h0XM���.. _W3C_Headers: http://www.w3.org/International/questions/qa-headers-charseth>j��hJh:hKj ��h1}rj��(hxX<���http://www.w3.org/International/questions/qa-headers-charseth4]rk��U w3c-headersrl��ah7]h3]h;]h<]rm��hauhQM4hRhhS]ubj∆��)Årn��}ro��(h0X ���.. _IANA: http://www.iana.org/j…��Kh>j��hJh:hKj ��h1}rp��(hxhÆh4]rq��Uianarr��ah7]h3]h;]h<]rs��hauhQM6hRhhS]ubj∆��)Årt��}ru��(h0XM���.. _IANA_MEDIA: http://www.iana.org/assignments/media-types/media-types.xhtmlj…��Kh>j��hJh:hKj ��h1}rv��(hxhπh4]rw��U
iana-mediarx��ah7]h3]h;]h<]ry��hauhQM8hRhhS]ubj∆��)Årz��}r{��(h0XS���.. _IANA_CHARS: http://www.iana.org/assignments/character-sets/character-sets.xhtmlj…��Kh>j��hJh:hKj ��h1}r|��(hxj��h4]r}��U
iana-charsr~��ah7]h3]h;]h<]r��h auhQM:hRhhS]ubj∆��)ÅrÄ��}rÅ��(h0XI���.. _RFC2616-sec14: http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.htmlh>j��hJh:hKj ��h1}rÇ��(hxX6���http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.htmlh4]rÉ��U
rfc2616-sec14rÑ��ah7]h3]h;]h<]rÖ��h auhQM<hRhhS]ubj∆��)ÅrÜ��}rá��(h0X3���.. _XML: http://www.w3.org/TR/2008/REC-xml-20081126j…��Kh>j��hJh:hKj ��h1}rà��(hxj��h4]râ��Uxmlrä��ah7]h3]h;]h<]rã��hauhQM>hRhhS]ubj∆��)Årå��}rç��(h0X2���.. _XML1.0: http://www.w3.org/TR/REC-xml/#charsetsh>j��hJh:hKj ��h1}ré��(hxX&���http://www.w3.org/TR/REC-xml/#charsetsh4]rè��Uxml1-0rê��ah7]h3]h;]h<]rë��hauhQM@hRhhS]ubj∆��)Årí��}rì��(h0X0���.. _XML1.1: http://www.w3.org/TR/xml11/#charsetsh>j��hJh:hKj ��h1}rî��(hxX$���http://www.w3.org/TR/xml11/#charsetsh4]rï��Uxml1-1rñ��ah7]h3]h;]h<]ró��hauhQMBhRhhS]ubj∆��)Årò��}rô��(h0X0���.. _RFC0020: http://www.ietf.org/rfc/rfc0020.txtj…��Kh>j��hJh:hKj ��h1}rö��(hxjO��h4]rõ��Urfc0020rú��ah7]h3]h;]h<]rù��h auhQMDhRhhS]ubj∆��)Årû��}rü��(h0X0���.. _RFC2046: http://www.ietf.org/rfc/rfc2046.txtj…��Kh>j��hJh:hKj ��h1}r†��(hxj‰��h4]r°��Urfc2046r¢��ah7]h3]h;]h<]r£��hauhQMFhRhhS]ubj∆��)År§��}r•��(h0X0���.. _RFC2616: http://www.ietf.org/rfc/rfc2616.txtj…��Kh>j��hJh:hKj ��h1}r¶��(hxX#���http://www.ietf.org/rfc/rfc2616.txtrß��h4]r®��Urfc2616r©��ah7]h3]h;]h<]r™��h auhQMHhRhhS]ubj∆��)År´��}r¨��(h0X0���.. _RFC4180: http://www.ietf.org/rfc/rfc4180.txtj…��Kh>j��hJh:hKj ��h1}r≠��(hxj|��h4]rÆ��Urfc4180rØ��ah7]h3]h;]h<]r∞��h$auhQMJhRhhS]ubj∆��)År±��}r≤��(h0X0���.. _RFC4627: http://www.ietf.org/rfc/rfc4627.txtj…��Kh>j��hJh:hKj ��h1}r≥��(hxj=��h4]r¥��Urfc4627rµ��ah7]h3]h;]h<]r∂��h
auhQMLhRhhS]ubj∆��)År∑��}r∏��(h0X0���.. _RFC6266: http://www.ietf.org/rfc/rfc6266.txtj…��Kh>j��hJh:hKj ��h1}rπ��(hxX#���http://www.ietf.org/rfc/rfc6266.txtr∫��h4]rª��Urfc6266rº��ah7]h3]h;]h<]rΩ��h auhQMNhRhhS]ubj∆��)Åræ��}rø��(h0X/���.. _RFC6657: http://www.rfc.org/rfc/rfc6657.txth>j��hJh:hKj ��h1}r¿��(hxX"���http://www.rfc.org/rfc/rfc6657.txth4]r¡��Urfc6657r¬��ah7]h3]h;]h<]r√��hauhQMPhRhhS]ubj∆��)Årƒ��}r≈��(h0X0���.. _RFC7303: http://www.ietf.org/rfc/rfc7303.txtj…��Kh>j��hJh:hKj ��h1}r∆��(hxj]��h4]r«��Urfc7303r»��ah7]h3]h;]h<]r…��h"auhQMRhRhhS]ubj∆��)År ��}rÀ��(h0X$���.. _Unicode: http://www.unicode.org/j…��Kh>j��hJh:hKj ��h1}rÃ��(hxj2��h4]rÕ��UunicoderŒ��ah7]h3]h;]h<]rœ��hauhQMThRhhS]ubeubeubeubhJh:hKhLh1}r–��(h3]h;]h7]h4]r—��U.preserving-media-type-metadata-between-systemsr“��ah<]r”��hauhQK<hRhhS]r‘��(hU)År’��}r÷��(h0X.���Preserving Media Type Metadata Between Systemsr◊��h>hFhJh:hKhYh1}rÿ��(h3]h;]h7]h4]h<]uhQK<hRhhS]rŸ��h\X.���Preserving Media Type Metadata Between Systemsr⁄��ÖÅr€��}r‹��(h0j◊��h>j’��ubaubh`)År›��}rfi��(h0Xo��Once available, the media type metadata should be preserved with the object to
ensure that downstream consumers can utilize the content in the same way without
resorting to inference mechanisms with potentially different results. Hence it
is essential that media type information is considered an integral part of the
action of transferring an object between systems.rfl��h>hFhJh:hKhch1}r‡��(h3]h;]h7]h4]h<]uhQK>hRhhS]r·��h\Xo��Once available, the media type metadata should be preserved with the object to
ensure that downstream consumers can utilize the content in the same way without
resorting to inference mechanisms with potentially different results. Hence it
is essential that media type information is considered an integral part of the
action of transferring an object between systems.r‚��ÖÅr„��}r‰��(h0jfl��h>j›��ubaubh`)ÅrÂ��}rÊ��(h0Xô��When a server sends an object to a user agent (e.g. a CN acting as a client
retrieving a Science Metadata document from a MN, a script accessing content, or
a browser viewing something from a CN), the server should specify the media type
in the ``Content-Type`` field of the accompanying HTTP headers [RFC2616_ Section
14.17]. The ``Content-Type`` entity-header field indicates the media type
[IANA_MEDIA_] (formerly known as "MIME Type" or "Multipurpose Internet Mail
Extensions Type") of the entity-body sent to the recipient [RFC2616_]. The media
type entry of the Content-Type header is used to to inform the consumer of what
the bytes in the payload represent.h>hFhJh:hKhch1}rÁ��(h3]h;]h7]h4]h<]uhQKDhRhhS]rË��(h\Xı���When a server sends an object to a user agent (e.g. a CN acting as a client
retrieving a Science Metadata document from a MN, a script accessing content, or
a browser viewing something from a CN), the server should specify the media type
in the rÈ��ÖÅrÍ��}rÎ��(h0Xı���When a server sends an object to a user agent (e.g. a CN acting as a client
retrieving a Science Metadata document from a MN, a script accessing content, or
a browser viewing something from a CN), the server should specify the media type
in the h>jÂ��ubj��)ÅrÏ��}rÌ��(h0X���``Content-Type``h1}rÓ��(h3]h;]h7]h4]h<]uh>jÂ��hS]rÔ��h\X ���Content-Typer��ÖÅrÒ��}rÚ��(h0U�h>jÏ��ubahKj ��ubh\X)��� field of the accompanying HTTP headers [rÛ��ÖÅrÙ��}rı��(h0X)��� field of the accompanying HTTP headers [h>jÂ��ubhr)Årˆ��}r˜��(h0X���RFC2616_huKh>jÂ��hKhvh1}r¯��(UnameX���RFC2616hxjß��h4]h7]h3]h;]h<]uhS]r˘��h\X���RFC2616r˙��ÖÅr˚��}r¸��(h0U�h>jˆ��ubaubh\X��� Section
14.17]. The r˝��ÖÅr˛��}rˇ��(h0X��� Section
14.17]. The h>jÂ��ubj��)År���}r��(h0X���``Content-Type``h1}r��(h3]h;]h7]h4]h<]uh>jÂ��hS]r��h\X ���Content-Typer��ÖÅr��}r��(h0U�h>j���ubahKj ��ubh\X/��� entity-header field indicates the media type
[r��ÖÅr��}r ��(h0X/��� entity-header field indicates the media type
[h>jÂ��ubhr)År
��}r ��(h0X ���IANA_MEDIA_huKh>j��hKhvh1}r ��(UnameX
���IANA_MEDIAhxhπh4]h7]h3]h;]h<]uhS]r
��h\X
���IANA_MEDIAr��ÖÅr��}r��(h0U�h>j
��ubaubh\X|���] (formerly known as "MIME Type" or "Multipurpose Internet Mail
Extensions Type") of the entity-body sent to the recipient [r��ÖÅr��}r��(h0X|���] (formerly known as "MIME Type" or "Multipurpose Internet Mail
Extensions Type") of the entity-body sent to the recipient [h>jÂ��ubhr)År��}r��(h0X���RFC2616_huKh>jÂ��hKhvh1}r��(UnameX���RFC2616hxjß��h4]h7]h3]h;]h<]uhS]r��h\X���RFC2616r��ÖÅr��}r��(h0U�h>j��ubaubh\XÄ���]. The media
type entry of the Content-Type header is used to to inform the consumer of what
the bytes in the payload represent.r��ÖÅr ��}r ��(h0XÄ���]. The media
type entry of the Content-Type header is used to to inform the consumer of what
the bytes in the payload represent.h>jÂ��ubeubh`)År ��}r ��(h0X6��The server may also include a suggested filename in the Content-Disposition HTTP
header [RFC6266_]. This can be useful for consumers as it specifies a filename
that may be used by default for the content, and also provides a hint as to the
type of content being provided (i.e. through the file name extension).h>hFhJh:hKhch1}r ��(h3]h;]h7]h4]h<]uhQKNhRhhS]r!��(h\XY���The server may also include a suggested filename in the Content-Disposition HTTP
header [r"��ÖÅr#��}r$��(h0XY���The server may also include a suggested filename in the Content-Disposition HTTP
header [h>j ��ubhr)År%��}r&��(h0X���RFC6266_huKh>j ��hKhvh1}r'��(UnameX���RFC6266hxj∫��h4]h7]h3]h;]h<]uhS]r(��h\X���RFC6266r)��ÖÅr*��}r+��(h0U�h>j%��ubaubh\X’���]. This can be useful for consumers as it specifies a filename
that may be used by default for the content, and also provides a hint as to the
type of content being provided (i.e. through the file name extension).r,��ÖÅr-��}r.��(h0X’���]. This can be useful for consumers as it specifies a filename
that may be used by default for the content, and also provides a hint as to the
type of content being provided (i.e. through the file name extension).h>j ��ubeubh`)År/��}r0��(h0XÔ��All content in DataONE is accompanied by System Metadata which is used to
provide persistent information about the associated object that is useful for
maintaining the object state and for consumers. Content type in DataONE is
indicated in System Metadata by freference to an :class:`Types.Object Format`, a
complex structure that contains a ``formatId``, a ``formatName`` and a
``formatType``. In version 2.0 APIs, :class:`V2_0.Types.objectFormat` is
extended to include mimeType and extension.h>hFhJh:hKhch1}r1��(h3]h;]h7]h4]h<]uhQKShRhhS]r2��(h\X��All content in DataONE is accompanied by System Metadata which is used to
provide persistent information about the associated object that is useful for
maintaining the object state and for consumers. Content type in DataONE is
indicated in System Metadata by freference to an r3��ÖÅr4��}r5��(h0X��All content in DataONE is accompanied by System Metadata which is used to
provide persistent information about the associated object that is useful for
maintaining the object state and for consumers. Content type in DataONE is
indicated in System Metadata by freference to an h>j/��ubj,��)År6��}r7��(h0X ���:class:`Types.Object Format`r8��h>j/��hJh:hKj0��h1}r9��(UreftypeX���classj2��âj3��X���Types.Object FormatU refdomainX���pyr:��h4]h7]U refexplicitâh3]h;]h<]j5��j6��j7��Nj8��NuhQKShS]r;��j��)År<��}r=��(h0j8��h1}r>��(h3]h;]r?��(j>��j:��X���py-classr@��eh7]h4]h<]uh>j6��hS]rA��h\X���Types.Object FormatrB��ÖÅrC��}rD��(h0U�h>j<��ubahKj ��ubaubh\X&���, a
complex structure that contains a rE��ÖÅrF��}rG��(h0X&���, a
complex structure that contains a h>j/��ubj��)ÅrH��}rI��(h0X ���``formatId``h1}rJ��(h3]h;]h7]h4]h<]uh>j/��hS]rK��h\X���formatIdrL��ÖÅrM��}rN��(h0U�h>jH��ubahKj ��ubh\X���, a rO��ÖÅrP��}rQ��(h0X���, a h>j/��ubj��)ÅrR��}rS��(h0X���``formatName``h1}rT��(h3]h;]h7]h4]h<]uh>j/��hS]rU��h\X
���formatNamerV��ÖÅrW��}rX��(h0U�h>jR��ubahKj ��ubh\X��� and a
rY��ÖÅrZ��}r[��(h0X��� and a
h>j/��ubj��)År\��}r]��(h0X���``formatType``h1}r^��(h3]h;]h7]h4]h<]uh>j/��hS]r_��h\X
���formatTyper`��ÖÅra��}rb��(h0U�h>j\��ubahKj ��ubh\X���. In version 2.0 APIs, rc��ÖÅrd��}re��(h0X���. In version 2.0 APIs, h>j/��ubj,��)Årf��}rg��(h0X ���:class:`V2_0.Types.objectFormat`rh��h>j/��hJh:hKj0��h1}ri��(UreftypeX���classj2��âj3��X���V2_0.Types.objectFormatU refdomainX���pyrj��h4]h7]U refexplicitâh3]h;]h<]j5��j6��j7��Nj8��NuhQKShS]rk��j��)Årl��}rm��(h0jh��h1}rn��(h3]h;]ro��(j>��jj��X���py-classrp��eh7]h4]h<]uh>jf��hS]rq��h\X���V2_0.Types.objectFormatrr��ÖÅrs��}rt��(h0U�h>jl��ubahKj ��ubaubh\X/��� is
extended to include mimeType and extension.ru��ÖÅrv��}rw��(h0X/��� is
extended to include mimeType and extension.h>j/��ubeubh`)Årx��}ry��(h0XN��The use of a controlled list of object formats may be problematic however, when
considering that a particular type of object may have multiple media types (e.g.
an Excel spreadsheet) or may require more detail such as character encoding
information (e.g. a CSV or XML document) that may not be reliably inferred from
the object bytes.rz��h>hFhJh:hKhch1}r{��(h3]h;]h7]h4]h<]uhQK[hRhhS]r|��h\XN��The use of a controlled list of object formats may be problematic however, when
considering that a particular type of object may have multiple media types (e.g.
an Excel spreadsheet) or may require more detail such as character encoding
information (e.g. a CSV or XML document) that may not be reliably inferred from
the object bytes.r}��ÖÅr~��}r��(h0jz��h>jx��ubaubh`)ÅrÄ��}rÅ��(h0X ��Hence, the system metadata for an object should also include optional properties
for the media type specific to the object, the character encoding, and the
filename. This information may be provided with the object System Metadata or in
the Content-Type and Content-Disposition headers. Where the information in the
headers conflicts with that in the System Metadata, the System Metadata should
prevail (since presumably the system metadata was set correctly by the origin,
whereas a misconfigured server may be setting an incorrect value).r��h>hFhJh:hKhch1}r��(h3]h;]h7]h4]h<]uhQKahRhhS]r��h\X ��Hence, the system metadata for an object should also include optional properties
for the media type specific to the object, the character encoding, and the
filename. This information may be provided with the object System Metadata or in
the Content-Type and Content-Disposition headers. Where the information in the
headers conflicts with that in the System Metadata, the System Metadata should
prevail (since presumably the system metadata was set correctly by the origin,
whereas a misconfigured server may be setting an incorrect value).rÖ��ÖÅrÜ��}rá��(h0jÇ��h>jÄ��ubaubh`)Årà��}râ��(h0X���**Recommendations**rä��h>hFhJh:hKhch1}rã��(h3]h;]h7]h4]h<]uhQKihRhhS]rå��hf)Årç��}ré��(h0jä��h1}rè��(h3]h;]h7]h4]h<]uh>jà��hS]rê��h\X���Recommendationsrë��ÖÅrí��}rì��(h0U�h>jç��ubahKhnubaubhCeubhJh:hKjŸ��h1}rî��(j€��U.h4]h7]h3]j‹��U�h;]h<]j›��j€��uhQKkhRhhS]rï��(h?)Årñ��}ró��(h0Xè���(no change) The objectFormat is used to indicate to a consumer application
more detailed information than is available through the media type.
h>hChJh:hKh”h1}rò��(h3]h;]h7]h4]h<]uhQNhRhhS]rô��h`)Årö��}rõ��(h0Xé���(no change) The objectFormat is used to indicate to a consumer application
more detailed information than is available through the media type.rú��h>jñ��hJh:hKhch1}rù��(h3]h;]h7]h4]h<]uhQKkhS]rû��h\Xé���(no change) The objectFormat is used to indicate to a consumer application
more detailed information than is available through the media type.rü��ÖÅr†��}r°��(h0jú��h>jö��ubaubaubh?)År¢��}r£��(h0X¸���The ``mimeType`` element of the Draft v2.0 API should be renamed "mediaType"
and used to specify the default media type for an object should that
information not be explicitly provided through the Content-Type header
provided by the producer (Issue #)
h>hChJh:hKh”h1}r§��(h3]h;]h7]h4]h<]uhQNhRhhS]r•��h`)År¶��}rß��(h0X˚���The ``mimeType`` element of the Draft v2.0 API should be renamed "mediaType"
and used to specify the default media type for an object should that
information not be explicitly provided through the Content-Type header
provided by the producer (Issue #)h>j¢��hJh:hKhch1}r®��(h3]h;]h7]h4]h<]uhQKnhS]r©��(h\X���The r™��ÖÅr´��}r¨��(h0X���The h>j¶��ubj��)År≠��}rÆ��(h0X ���``mimeType``h1}rØ��(h3]h;]h7]h4]h<]uh>j¶��hS]r∞��h\X���mimeTyper±��ÖÅr≤��}r≥��(h0U�h>j≠��ubahKj ��ubh\XÎ��� element of the Draft v2.0 API should be renamed "mediaType"
and used to specify the default media type for an object should that
information not be explicitly provided through the Content-Type header
provided by the producer (Issue #)r¥��ÖÅrµ��}r∂��(h0XÎ��� element of the Draft v2.0 API should be renamed "mediaType"
and used to specify the default media type for an object should that
information not be explicitly provided through the Content-Type header
provided by the producer (Issue #)h>j¶��ubeubaubh@h?)År∑��}r∏��(h0X��For text media sub-types, or content that is textual (e.g. media type =
``application/xml`` or ``application/javascript``), a charset parameter
should be provided in the ``Content-Type`` header. When provided, this value
must be persisted in the system metadata associated with an object. When
``charset`` is specified in the System Metadata, it overrides a value that
may be present in the Content-Type header. In practice, System Metadata is
retrieved separately from the object, and so such an override will optional
for consumers.
h>hChJh:hKh”h1}rπ��(h3]h;]h7]h4]h<]uhQNhRhhS]r∫��h`)Årª��}rº��(h0X��For text media sub-types, or content that is textual (e.g. media type =
``application/xml`` or ``application/javascript``), a charset parameter
should be provided in the ``Content-Type`` header. When provided, this value
must be persisted in the system metadata associated with an object. When
``charset`` is specified in the System Metadata, it overrides a value that
may be present in the Content-Type header. In practice, System Metadata is
retrieved separately from the object, and so such an override will optional
for consumers.h>j∑��hJh:hKhch1}rΩ��(h3]h;]h7]h4]h<]uhQK|hS]ræ��(h\XH���For text media sub-types, or content that is textual (e.g. media type =
rø��ÖÅr¿��}r¡��(h0XH���For text media sub-types, or content that is textual (e.g. media type =
h>jª��ubj��)År¬��}r√��(h0X���``application/xml``h1}rƒ��(h3]h;]h7]h4]h<]uh>jª��hS]r≈��h\X���application/xmlr∆��ÖÅr«��}r»��(h0U�h>j¬��ubahKj ��ubh\X��� or r…��ÖÅr ��}rÀ��(h0X��� or h>jª��ubj��)ÅrÃ��}rÕ��(h0X���``application/javascript``h1}rŒ��(h3]h;]h7]h4]h<]uh>jª��hS]rœ��h\X���application/javascriptr–��ÖÅr—��}r“��(h0U�h>jÃ��ubahKj ��ubh\X1���), a charset parameter
should be provided in the r”��ÖÅr‘��}r’��(h0X1���), a charset parameter
should be provided in the h>jª��ubj��)År÷��}r◊��(h0X���``Content-Type``h1}rÿ��(h3]h;]h7]h4]h<]uh>jª��hS]rŸ��h\X ���Content-Typer⁄��ÖÅr€��}r‹��(h0U�h>j÷��ubahKj ��ubh\Xl��� header. When provided, this value
must be persisted in the system metadata associated with an object. When
r›��ÖÅrfi��}rfl��(h0Xl��� header. When provided, this value
must be persisted in the system metadata associated with an object. When
h>jª��ubj��)År‡��}r·��(h0X ���``charset``h1}r‚��(h3]h;]h7]h4]h<]uh>jª��hS]r„��h\X���charsetr‰��ÖÅrÂ��}rÊ��(h0U�h>j‡��ubahKj ��ubh\XÂ��� is specified in the System Metadata, it overrides a value that
may be present in the Content-Type header. In practice, System Metadata is
retrieved separately from the object, and so such an override will optional
for consumers.rÁ��ÖÅrË��}rÈ��(h0XÂ��� is specified in the System Metadata, it overrides a value that
may be present in the Content-Type header. In practice, System Metadata is
retrieved separately from the object, and so such an override will optional
for consumers.h>jª��ubeubaubh?)ÅrÍ��}rÎ��(h0XÄ��A filename should be provided in a ``Content-Disposition`` header by a
producer and should be preserved in the system metadata associated with the
object. When present in the System Metadata, that value overrides a value in
the ``Content-Disposition`` header. In practice, System Metadata is retrieved
separately from the object, and so such an override will optional for
consumers.
h>hChJh:hKh”h1}rÏ��(h3]h;]h7]h4]h<]uhQNhRhhS]rÌ��h`)ÅrÓ��}rÔ��(h0X~��A filename should be provided in a ``Content-Disposition`` header by a
producer and should be preserved in the system metadata associated with the
object. When present in the System Metadata, that value overrides a value in
the ``Content-Disposition`` header. In practice, System Metadata is retrieved
separately from the object, and so such an override will optional for
consumers.h>jÍ��hJh:hKhch1}r��(h3]h;]h7]h4]h<]uhQKÖhS]rÒ��(h\X#���A filename should be provided in a rÚ��ÖÅrÛ��}rÙ��(h0X#���A filename should be provided in a h>jÓ��ubj��)Årı��}rˆ��(h0X���``Content-Disposition``h1}r˜��(h3]h;]h7]h4]h<]uh>jÓ��hS]r¯��h\X���Content-Dispositionr˘��ÖÅr˙��}r˚��(h0U�h>jı��ubahKj ��ubh\X™��� header by a
producer and should be preserved in the system metadata associated with the
object. When present in the System Metadata, that value overrides a value in
the r¸��ÖÅr˝��}r˛��(h0X™��� header by a
producer and should be preserved in the system metadata associated with the
object. When present in the System Metadata, that value overrides a value in
the h>jÓ��ubj��)Årˇ��}r���(h0X���``Content-Disposition``h1}r��(h3]h;]h7]h4]h<]uh>jÓ��hS]r��h\X���Content-Dispositionr��ÖÅr��}r��(h0U�h>jˇ��ubahKj ��ubh\XÉ��� header. In practice, System Metadata is retrieved
separately from the object, and so such an override will optional for
consumers.r��ÖÅr��}r��(h0XÉ��� header. In practice, System Metadata is retrieved
separately from the object, and so such an override will optional for
consumers.h>jÓ��ubeubaubeubhJh:hKh”h1}r ��(h3]h;]h7]h4]h<]uhQNhRhhS]r
��h`)År ��}r ��(h0X3��The media type as provided by the producer of the object should be specified
and should be preserved as part of the system metadata so that the media type
may be reliably presented to downstream consumers. When specified in the
``Content-Type`` header, the media type overrides the default value present
in the associated objectFormat. When present in System Metadata, that value
overrides a value presented in the ``Content-Type``header. In practice,
System Metadata is retrieved separately from the object, and so such an
override will optional for consumers.h>h@hJh:hKhch1}r
��(h3]h;]h7]h4]h<]uhQKshS]r��(h\X‰���The media type as provided by the producer of the object should be specified
and should be preserved as part of the system metadata so that the media type
may be reliably presented to downstream consumers. When specified in the
r��ÖÅr��}r��(h0X‰���The media type as provided by the producer of the object should be specified
and should be preserved as part of the system metadata so that the media type
may be reliably presented to downstream consumers. When specified in the
h>j ��ubj��)År��}r��(h0X���``Content-Type``h1}r��(h3]h;]h7]h4]h<]uh>j ��hS]r��h\X ���Content-Typer��ÖÅr��}r��(h0U�h>j��ubahKj ��ubh\X≠��� header, the media type overrides the default value present
in the associated objectFormat. When present in System Metadata, that value
overrides a value presented in the r��ÖÅr��}r��(h0X≠��� header, the media type overrides the default value present
in the associated objectFormat. When present in System Metadata, that value
overrides a value presented in the h>j ��ubcdocutils.nodes
problematic
r ��)År ��}r ��(h0X���``h1}r ��(h4]r ��h9ah7]h3]h;]h<]Urefidh6uh>j ��hS]r!��h\X���``r"��ÖÅr#��}r$��(h0U�h>j ��ubahKU problematicr%��ubh\Xê���Content-Type``header. In practice,
System Metadata is retrieved separately from the object, and so such an
override will optional for consumers.r&��ÖÅr'��}r(��(h0Xê���Content-Type``header. In practice,
System Metadata is retrieved separately from the object, and so such an
override will optional for consumers.h>j ��ubeubaubhS]r)��h`)År*��}r+��(h0X/���Inline literal start-string without end-string.h1}r,��(h3]h;]h7]h4]h<]uh>h.hS]r-��h\X/���Inline literal start-string without end-string.r.��ÖÅr/��}r0��(h0U�h>j*��ubahKhcubahKUsystem_messager1��ubaUcurrent_sourcer2��NU
decorationr3��NUautofootnote_startr4��KUnameidsr5��}r6��(hjP��hj�hjr��h j7��h
jH��h j©��h jú��h
jµ��hjŒ��hj¢��hj ��hjy��hjñ��hjä��hjx��hjÃ��hj“��hhÖhj
��hj1��hjl��hj¬��h jÑ��h jÕ��h jº��h j≠��h j~��h!jœ��h"j»��h#j"��h$jØ��h%jÔ��h&jf��h'jg��h(hOuhS]r7��hHah0U�U transformerr8��NU
footnote_refsr9��}r:��Urefnamesr;��}r<��(X���xml]r=��j���aX
���iana_media]r>��(h∂j
��eX���rfc2046]r?��j·��aX���iana]r@��h´aX���rfc2616]rA��(jˆ��j��eX���rfc0020]rB��jL��aX ���spolsky2003]rC��hsaX���rfc6266]rD��j%��aX���rfc4627]rE��j:��aX���unicode]rF��j/��aX���rfc4180]rG��jy��aX
���iana_chars]rH��j��aX���rfc7303]rI��(jZ��jl��j��euUsymbol_footnotesrJ��]rK��Uautofootnote_refsrL��]rM��Usymbol_footnote_refsrN��]rO��U citationsrP��]rQ��hRhU current_linerR��NUtransform_messagesrS��]rT��(h-)ÅrU��}rV��(h0U�h1}rW��(h3]UlevelKh4]h7]Usourceh:h;]h<]UlineM4UtypeUINFOrX��uhS]rY��h`)ÅrZ��}r[��(h0U�h1}r\��(h3]h;]h7]h4]h<]uh>jU��hS]r]��h\X1���Hyperlink target "w3c_headers" is not referenced.r^��ÖÅr_��}r`��(h0U�h>jZ��ubahKhcubahKj1��ubh-)Åra��}rb��(h0U�h1}rc��(h3]UlevelKh4]h7]Usourceh:h;]h<]UlineM<UtypejX��uhS]rd��h`)Åre��}rf��(h0U�h1}rg��(h3]h;]h7]h4]h<]uh>ja��hS]rh��h\X3���Hyperlink target "rfc2616-sec14" is not referenced.ri��ÖÅrj��}rk��(h0U�h>je��ubahKhcubahKj1��ubh-)Årl��}rm��(h0U�h1}rn��(h3]UlevelKh4]h7]Usourceh:h;]h<]UlineM@UtypejX��uhS]ro��h`)Årp��}rq��(h0U�h1}rr��(h3]h;]h7]h4]h<]uh>jl��hS]rs��h\X,���Hyperlink target "xml1.0" is not referenced.rt��ÖÅru��}rv��(h0U�h>jp��ubahKhcubahKj1��ubh-)Årw��}rx��(h0U�h1}ry��(h3]UlevelKh4]h7]Usourceh:h;]h<]UlineMBUtypejX��uhS]rz��h`)År{��}r|��(h0U�h1}r}��(h3]h;]h7]h4]h<]uh>jw��hS]r~��h\X,���Hyperlink target "xml1.1" is not referenced.r��ÖÅrÄ��}rÅ��(h0U�h>j{��ubahKhcubahKj1��ubh-)ÅrÇ��}rÉ��(h0U�h1}rÑ��(h3]UlevelKh4]h7]Usourceh:h;]h<]UlineMPUtypejX��uhS]rÖ��h`)ÅrÜ��}rá��(h0U�h1}rà��(h3]h;]h7]h4]h<]uh>jÇ��hS]râ��h\X-���Hyperlink target "rfc6657" is not referenced.rä��ÖÅrã��}rå��(h0U�h>jÜ��ubahKhcubahKj1��ubeUreporterrç��NUid_startré��KU
autofootnotesr�]r�U
citation_refsr�}r�Uindirect_targetsr�]r�Usettingsr�(cdocutils.frontend
Values
rñ��oró��}rò��(Ufootnote_backlinksrô��KUrecord_dependenciesrö��NU rfc_base_urlrõ��U https://tools.ietf.org/html/rú��U tracebackrù��àUpep_referencesrû��NUstrip_commentsrü��NU
toc_backlinksr†��Uentryr°��U
language_coder¢��Uenr£��U datestampr§��NU report_levelr•��KU _destinationr¶��NU
halt_levelr��KU
strip_classesr®��NhYNU error_encoding_error_handlerr©��Ubackslashreplacer™��Udebugr´��NUembed_stylesheetr¨��âU output_encoding_error_handlerr≠��UstrictrÆ��U
sectnum_xformrØ��KUdump_transformsr∞��NU
docinfo_xformr±��KUwarning_streamr≤��NUpep_file_url_templater≥��Upep-%04dr¥��Uexit_status_levelrµ��KUconfigr∂��NUstrict_visitorr∑��NUcloak_email_addressesr∏��àU trim_footnote_reference_spacerπ��âUenvr∫��NUdump_pseudo_xmlrª��NUexpose_internalsrº��NUsectsubtitle_xformrΩ��âU source_linkræ��NUrfc_referencesrø��NUoutput_encodingr¿��Uutf-8r¡��U
source_urlr¬��NUinput_encodingr√��U utf-8-sigrƒ��U_disable_configr≈��NU id_prefixr∆��U�U tab_widthr«��KUerror_encodingr»��UUTF-8r…��U_sourcer ��h:Ugettext_compactrÀ��àU generatorrÃ��NUdump_internalsrÕ��NU smart_quotesrŒ��âU pep_base_urlrœ��U https://www.python.org/dev/peps/r–��Usyntax_highlightr—��Ulongr“��U input_encoding_error_handlerr”��jÆ��Uauto_id_prefixr‘��Uidr’��Udoctitle_xformr÷��âUstrip_elements_with_classesr◊��NU
_config_filesrÿ��]Ufile_insertion_enabledrŸ��àU raw_enabledr⁄��KU
dump_settingsr€��NubUsymbol_footnote_startr‹��K�Uidsr›��}rfi��(j¢��jû��jr��jn��j
��j ��j©��j§��jú��jò��jñ��jí��jµ��j±��jœ��jÀ��jŒ��j ��j~��jz��j ��j��jä��jÜ��h9j ��h6h.jy��ju��j7��j3��jH��jD��j¬��jæ��j"��j ��hOhHjÑ��jÄ��j≠��j©��jº��j∑��j“��hFjx��jt��jØ��j´��jÔ��jÎ��j1��j-��jÃ��j»��j»��jƒ��jÕ��j«��jf��jb��jg��jc��hÖhÅjP��jL��jl��jh��jê��jå��uUsubstitution_namesrfl��}r‡��hKhRh1}r·��(h3]h4]h7]Usourceh:h;]h<]uU footnotesr‚��]r„��Urefidsr‰��}rÂ��ub.