[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: Proposed XRD schema
Getting a draft out seems to be constantly slipping so below you will find the proposed schema for XRD 1.0 with most elements explained. Please comments, refine, redefine, etc. I will use this thread (and a wiki page if someone supplements my laziness) and copy suggested text into the XRD 1.0 draft. EHL --- <XRD> <Expires> (unchanged) <Subject> (was CanonicalID) <Alias> (was EquivID) <SubectType required> (new) <Link priority> (was Service) <Rel> (new) <ResourceType> (was Type) <MediaType> <URI priority> <TemplateURI priority> (new) <LocalID priority> * <XRD> The document root element. * <XRD:Expires> 0 or 1 per <XRD> element with type xs:dateTime. The date and time without fractional seconds in UTC "Z" time zone, after which the XRD descriptor MUST NOT be used. If the XRD was obtained via HTTP, and the HTTP headers specified an expiry time per section 13.2 of [RFC2616], the XRD descriptor MUST NOT be used after the earlier of the two values passed. * <XRD:Subject> 0 or 1 per <XRD> with type xs:anyURI and must be an absolute URI. The canonical identifier. The subject of the XRD which is described by the other elements. * <XRD:Alias> 0 or more per <XRD> with type xs:anyURI and must be an absolute URI. Provide aliases for the resource described by the XRD. Not allowed if no <XRD:Subject> is defined. * <XRD:SubjectType required> 0 or more per <XRD> with type xs:anyURI. The <XRD:SubjectType> element declares an attribute associated with the resource described by the XRD. The value of the <XRD:SubjectType> element is a URI-formatted attribute-identifier. The meaning of the <XRD:SubjectType> value is application-specific, and is used by the XRD provider to describe the resource to consuming applications familiar with the attribute-identifier. The attribute-identifier is used in a similar manner to XML namespace-identifiers. The <XRD:SubjectType> element supports the 'required' attribute with allowed values 'true' and 'false'. If not present, the attribute default value is 'false'. If the 'required' attribute is omitted or explicitly set to 'false', a consuming application SHOULD ignore any <XRD:SubjectType> with values it does not recognize, and interact with the resource based on the values it does recognize. However, if the 'required' attribute is set to 'true', a consuming application MUST NOT interact with the resource if it does not recognize the element value. The 'required' attribute is used to indicate to a consuming application that some predefined knowledge is required in order to interact with the resource, without which undefined or potentially harmful side-effects can occur. The 'required' attribute SHOULD NOT be used unless such harmful side-effects are likely. * <XRD:Link priority> 0 or more per <XRD> and with no text, only child elements. The <XRD:Link> element declares a relationship between the resource described by the XRD and other resources. The <XRD:Link> element uses the typed-link framework defined by [Link-Header] and carries a similar semantic meaning as the HTML <LINK> element [HTML-Link], the ATOM <Link> element [ATOM], and the HTTP Link header [Link-Header]. For example, the Link header: Link: <http://example.com/author>; rel=²author²; type=²text/plain² Maps to the following XRD fragment: <Link> <URI>http://example.com/author</URI> <Rel>author</Rel> <MediaType>text/plain</MediaType> </Link> It is important to note that unlike the HTML <LINK> element [HTML-Link], the ATOM <Link> element [ATOM], and the HTTP Link header [Link-Header], the link relationships described by the <XRD:Link> element are between the resource described by the XRD and the linked resources, and not between the XRD resource itself. * <XRD:Link:Rel> 0 or more per <XRD> with type xs:anyURI. The <XRD:Link:Rel> element defines the relationship between the resource described by the XRD and the resources listed using the <XRD:Link:URI> and <XRD:Link:TemplateURI> elements. * <XRD:Link:ResourceType> 0 or more per <XRD> with type xs:anyURI. The <XRD:Link:ResourceType> element provides hints as to the attributes of the linked resource(s) identified using the <XRD:Link:URI> or <XRD:Link:TemplateURI>. * <XRD:Link:MediaType> * <XRD:Link:URI priority> * <XRD:Link:TemplateURI priority> * <XRD:Link:LocalID priority>
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]