- From: Anish.Karmarkar <akarmark@dev.w3.org>
- Date: Tue, 14 Sep 2004 06:24:53 +0000
- To: public-ws-desc-eds@w3.org
Update of /sources/public/2002/ws/desc/media-types
In directory hutz:/tmp/cvs-serv21621
Modified Files:
xml-media-types.xml xml-media-types.html
Log Message:
included issue resolutions from London F2F
Index: xml-media-types.xml
===================================================================
RCS file: /sources/public/2002/ws/desc/media-types/xml-media-types.xml,v
retrieving revision 1.17
retrieving revision 1.18
diff -C2 -d -r1.17 -r1.18
*** xml-media-types.xml 4 Jun 2004 15:28:04 -0000 1.17
--- xml-media-types.xml 14 Sep 2004 06:24:50 -0000 1.18
***************
*** 71,75 ****
This is the <loc
href="http://www.w3.org/2004/02/Process-20040205/tr.html#RecsWD">
! First Public Working Draft</loc> of the Assigning Media Types to
Binary Data in XML document. It has been produced jointly by the
<loc xmlns:xlink="http://www.w3.org/1999/xlink" xlink:type="simple"
--- 71,75 ----
This is the <loc
href="http://www.w3.org/2004/02/Process-20040205/tr.html#RecsWD">
! Second Public Working Draft</loc> of the Assigning Media Types to
Binary Data in XML document. It has been produced jointly by the
<loc xmlns:xlink="http://www.w3.org/1999/xlink" xlink:type="simple"
***************
*** 186,195 ****
<ulist>
<item><p>a mechanism to indicate the media type of an
! XML element content whose type is <emph>xs:base64Binary</emph>.
</p>
</item>
<item><p> a mechanism to indicate in XML Schema the
expected media type(s) for an element content whose type is
! <emph>xs:base64Binary</emph>.
</p>
</item>
--- 186,196 ----
<ulist>
<item><p>a mechanism to indicate the media type of an
! XML element content whose type is <emph>xs:base64Binary</emph> or
! <emph>xs:hexBinary</emph>.
</p>
</item>
<item><p> a mechanism to indicate in XML Schema the
expected media type(s) for an element content whose type is
! <emph>xs:base64Binary</emph> or <emph>xs:hexBinary</emph>.
</p>
</item>
***************
*** 261,279 ****
<ulist>
! <item><p>
! Define how to indicate the media type of an XML element content whose type is
! <emph>xs:base64Binary</emph>. This is meta-data that may be, but not required
! to, used by tools to infer the specific media type of binary data.
</p>
</item>
! <item><p>
! Define how to indicate the expected media type(s) of XML element content whose
! type is <emph>xs:baseB4Binary</emph> in XML Schema. This information is needed
! to define the set of media types that a binary data may have. For example, a
! Web services application may be willing to indicate that binary data
! represents an image, but leaves it to a document to further specify whether it
! is "jpeg", "gif", etc. This meta-data is used to indicate the set of media types
! the binary data may have and is not required to be present.
</p>
</item>
--- 262,284 ----
<ulist>
! <item>
! <p> Define how to indicate the media type of an XML element
! content whose type is <emph>xs:base64Binary</emph> or
! <emph>xs:hexBinary</emph>. This is meta-data that may be, but not
! required to, used by tools to infer the specific media type of binary
! data.
</p>
</item>
! <item>
! <p> Define how to indicate the expected media type(s) of
! XML element content whose type is <emph>xs:baseB4Binary</emph> or
! <emph>xs:hexBinary</emph> in XML Schema. This information is needed to
! define the set of media types that a binary data may have. For
! example, a Web services application may be willing to indicate that
! binary data represents an image, but leaves it to a document to
! further specify whether it is "jpeg", "gif", etc. This meta-data is
! used to indicate the set of media types the binary data may have and
! is not required to be present.
</p>
</item>
***************
*** 296,300 ****
<head>Attributes for Declaring Media Types</head>
! <p>This section defines a global &AII; and an &EII; for
declaring the media type of binary data in XML Schema to address the
requirements (1) and (2) above. Their usage is addressed in Section <specref
--- 301,305 ----
<head>Attributes for Declaring Media Types</head>
! <p>This section defines two global &AII;s for
declaring the media type of binary data in XML Schema to address the
requirements (1) and (2) above. Their usage is addressed in Section <specref
***************
*** 306,310 ****
<p>
! The <att>contentType</att> &AII; has the following Infoset properties:
</p>
--- 311,315 ----
<p>
! The <att>contentType</att> &AII; has the following Infoset properties:
</p>
***************
*** 314,321 ****
</ulist>
! <p>The type of the <att>contentType</att> &AII; is
<emph>xs:string</emph>.</p>
! <p>The [normalized value] of the <att>contentType</att> &AII; MUST be the
name of a IANA media type token, e.g., "image/png", "text/xml; charset=utf-16".
</p>
--- 319,326 ----
</ulist>
! <p>The type of the <att>contentType</att> &AII; is
<emph>xs:string</emph>.</p>
! <p>The [normalized value] of the <att>contentType</att> &AII; MUST be the
name of a IANA media type token, e.g., "image/png", "text/xml; charset=utf-16".
</p>
***************
*** 324,330 ****
<div2 id="expectedMediaType">
! <head>expectedMediaType element </head>
! <p> <el>expectedMediaType</el> &EII; has the following Infoset properties:
</p>
--- 329,335 ----
<div2 id="expectedMediaType">
! <head>expectedMediaType attribute </head>
! <p> The <att>expectedMediaType</att> &AII; has the following Infoset properties:
</p>
***************
*** 334,351 ****
</ulist>
! <p>The type of the <att>expectedMediaType</att> &EII; is
<emph>xs:string</emph>.</p>
! <p>The value of the <el>expectedMediaType</el> element is similar to the
! value allowed for the 'Accept' header defined by HTTP 1.1
specification, Section 14.1 <bibref ref="rfc2616"/>.
</p>
<p>The value of the <att>contentType</att> attribute SHOULD be
! allowed by the <el>expectedMediaType</el>, if specified in the schema, as
specified by <specref ref="usage"/>.
</p>
! <p>The <el>expectedMediaType</el> element is intended to be used
as part of a Schema annotation for a &BEII; declaration (see <specref
ref="usage"/>).
--- 339,357 ----
</ulist>
! <p>The type of the <att>expectedMediaType</att> &AII; is
<emph>xs:string</emph>.</p>
! <p>The value and the meaning of the
! <att>expectedMediaType</att> attribute is similar to the value
! allowed for the 'Accept' header defined by HTTP 1.1
specification, Section 14.1 <bibref ref="rfc2616"/>.
</p>
<p>The value of the <att>contentType</att> attribute SHOULD be
! allowed by the <att>expectedMediaType</att>, if specified in the schema, as
specified by <specref ref="usage"/>.
</p>
! <p>The <att>expectedMediaType</att> attribute is intended to be used
as part of a Schema annotation for a &BEII; declaration (see <specref
ref="usage"/>).
***************
*** 368,372 ****
</item>
<item><p>A type of the &BEII; must be a type derived from or equal to
! <emph>xs:base64Binary</emph>.</p>
</item>
</ulist>
--- 374,378 ----
</item>
<item><p>A type of the &BEII; must be a type derived from or equal to
! <emph>xs:base64Binary</emph> or <emph>xs:hexBinary</emph>.</p>
</item>
</ulist>
***************
*** 404,421 ****
<div2 id="role">
! <head>Role of expectedMediaType Schema annotation element</head>
! <p>The <el>expectedMediaType</el> element is used for annotating
the schema to indicate the expected range of values for
<att>contentType</att> attribute only. The
! <el>expectedMediaType</el> element addresses Requirement (2).
</p>
! <p>Applications that need to specify expected media types SHOULD use
! the schema annotation element to declare the range of expected values.
! The annotation should be considered only as a hint.
! <att>expectedMediaType</att> is used in conjunction with the
! declaration of &BEII;s in the schema. If <el>expectedMediaType</el>
! attribute is not used, the value "*/*" SHOULD be assumed.
</p>
--- 410,433 ----
<div2 id="role">
! <head>Role of expectedMediaType Schema annotation attribute</head>
! <p>The <att>expectedMediaType</att> attribute is used for annotating
the schema to indicate the expected range of values for
<att>contentType</att> attribute only. The
! <att>expectedMediaType</att> attribute addresses Requirement (2).
</p>
! <p>Applications that need to specify expected media types SHOULD
! use the schema annotation to declare the range of expected
! values. The annotation should be considered only as a hint.
! <att>expectedMediaType</att> annotation attribute MAY be used in
! conjunction with the declaration of &BEII;s or with complex type
! definitions that are derived from <emph>xs:base64Binary</emph>
! or <emph>xs:hexBinary</emph> in XML Schema. If the
! <att>expectedMediaType</att> annotation attribute is used in
! both: the &BEII; declaration as well as definition of the complex type
! which the &BEII; belongs to, then the expected range of values defined
! for the &BEII; MUST be a subset of the expected range of values defined
! for the complex type.
</p>
***************
*** 441,453 ****
</xs:complexType>
<xs:element name="companyPicture" type="tns:Picture"
! <xs:annotation>
! <xs:documentation>This element designates the range of values
! that the declared binary type will accept
! </xs:documentation>
! <xs:appInfo>
! <xmlmime:expectedMediaType>image/*</xmlmime:expectedMediaType>
! </xs:appInfo>
! </xs:annotation>
</xs:element>
--- 453,460 ----
</xs:complexType>
+ <!-- This element designates the range of values
+ that the declared binary type will accept -->
<xs:element name="companyPicture" type="tns:Picture"
! xmlmime:expectedMediaType="image/*"/>
</xs:element>
***************
*** 456,459 ****
--- 463,555 ----
</eg>
+
+ </div2>
+
+ </div1>
+
+ <div1 id="more-ex">
+ <head>Examples</head>
+ <div2 id="static">
+ <head>Using a statically known media-type</head>
+
+ <p> Below is an
+ example for using binary data whose media type is known in
+ advance to be "image/jpeg".
+ </p>
+
+ <p>In this example, the application fixes the media type by
+ declaring it with an annotation in conjunction with the complex
+ type declaration that specifies the specific binary data. Since
+ the content is expected to adhere to the
+ <att>expectedMediaType</att> annotation value and its value is
+ static, the application does not utilize the optional <att>contentType</att>
+ attribute.
+ </p>
+
+ <eg xml:space="preserve">
+
+ <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
+ xmlns:tns="http://example.com/thisexample"
+ xmlns:xmlmime="&xmlmimens;"
+ targetNamespace="http://example.com/thisexample">
+
+ <xs:import namespace="&xmlmimens;"
+ schemaLocation="&xmlmimens;"/>
+
+
+ <xs:complexType name="Picture">
+ xmlmime:expectedMediaType="image/jpeg"/>
+ <xs:simpleContent>
+ <xs:extension base="xs:base64Binary"/>
+ </xs:simpleContent>
+ </xs:complexType>
+
+ <xs:element name="myPicture" type="tns:Picture"/>
+
+ </xs:schema>
+
+ </eg>
+
+ </div2>
+
+ <div2 id="anythinggoes">
+ <head>Unknown media type</head>
+
+ <p>This example illustrates that the media type of binary data
+ is not known in advance but will be designated by the
+ document.
+ </p>
+
+ <p>In this case, the Schema annotation
+ <att>expectedMediaType</att> is not utilized in the schema, but
+ the <att>contentType</att> attribute, whose value in the document will designate
+ the actual content in the document, is declared.
+ </p>
+
+ <eg xml:space="preserve">
+
+ <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
+ xmlns:tns="http://example.com/thisexample"
+ xmlns:xmlmime="&xmlmimens;"
+ targetNamespace="http://example.com/thisexample">
+
+ <xs:import namespace="&xmlmimens;"
+ schemaLocation="&xmlmimens;"/>
+
+
+ <xs:complexType name="Picture">
+ <xs:simpleContent>
+ <xs:extension base="xs:base64Binary" >
+ <xs:attribute ref="xmlmime:contentType" use="optional" />
+ </xs:extension>
+ </xs:simpleContent>
+ </xs:complexType>
+
+ <xs:element name="groupPicture" type="tns:Picture"/>
+
+ </xs:schema>
+
+ </eg>
+
<ednote>
<name>ASK</name>
***************
*** 469,474 ****
--- 565,573 ----
</edtext>
</ednote>
+
</div2>
+
+
</div1>
Index: xml-media-types.html
===================================================================
RCS file: /sources/public/2002/ws/desc/media-types/xml-media-types.html,v
retrieving revision 1.9
retrieving revision 1.10
diff -C2 -d -r1.9 -r1.10
*** xml-media-types.html 8 Jun 2004 12:45:48 -0000 1.9
--- xml-media-types.html 14 Sep 2004 06:24:50 -0000 1.10
***************
*** 1,610 ****
! <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
! "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
! <html lang="en" xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
! <head>
! <meta name="generator" content=
! "HTML Tidy for Linux/x86 (vers 1st March 2004), see www.w3.org" />
! <meta http-equiv="Content-Type" content=
! "text/html; charset=utf-8" />
! <title>Assigning Media Types to Binary Data in XML</title>
!
[...1016 lines suppressed...]
! </xs:simpleType>
! </xs:attribute>
!
! <xs:element name="expectedMediaType" >
! <xs:simpleType>
! <xs:list itemType="tns:expectedMediaTypeItem" />
! </xs:simpleType>
! </xs:element>
!
! <xs:simpleType name="expectedMediaTypeItem" >
! <xs:restriction base="xs:string" >
! <xs:pattern value="(text|application|image|audio|video|model|x-[-.a-z0-9]+)/
! (([a-z0-9][-.+a-z0-9]+)|\*)" />
! </xs:restriction>
! </xs:simpleType>
!
! </xs:schema>
!
! </pre></div></div></div></body></html>
\ No newline at end of file
Received on Thursday, 16 September 2004 18:14:57 UTC