[XML-DEV Mailing List Archive Home] [By Thread] [By Date] [Recent Entries] [Reply To This Message]

Re: Style, Substance and Typing in Schemas

  • From: Michael Kay <mike@saxonica.com>
  • To: xml-dev@lists.xml.org
  • Date: Wed, 12 Oct 2011 10:39:38 +0100

Re:  Style
If you're only using a schema for validation, then the type hierarchy makes very little difference (except perhaps for some maintainability benefits if you get it right - but even then, not much).

If you're using the schema to define types that are then used for processing, then the details of what works well may depend on your processing environment - for example optimizing the schema for processing in schema-aware XSLT and XQuery may not be the same as optimizing for JAXB (union types, for example, might or might not be well supported). However, in all cases, getting the type hierarchy to match the conceptual object model in the real world is a good aim. This requires judgement; the designers of XSD decided, for example, that anyURI was not a subtype of string, and they have never been able to give me a convincing reason why, but it was based on some kind of subjective analysis of the real-world semantics.

Michael Kay
Saxonica

On 11/10/2011 15:29, Toby Considine wrote:
011c01cc8822$317fb3a0$947f1ae0$@gmail.com" type="cite">

I have a question of Style and Substance in XSD

 

I have a number of top-level elements that are variants of one another. Each of these appears in multiple Types (worthy of top-lelvelness).

 

Let’s say we have uid as a simple base type.

 

<xs:element name="uid" type="UidType"/>

<xs:simpleType name="UidType">

                <xs:annotation>

                                <xs:documentation>Unique Identifier</xs:documentation>

                </xs:annotation>

                <xs:restriction base="xs:string"/>

</xs:simpleType>

 

A)           One approach has me fully typing each derived element

 

<xs:element name="fooID" type="FooType"/>

<xs:simpleType name="FooType">

                <xs:annotation>

                                <xs:documentation>Identification of foo. </xs:documentation>

                </xs:annotation>

                <xs:restriction base="UidType"/>

</xs:simpleType>

<xs:element name="feeID" type="FeeIDType"/>

<xs:simpleType name="FeeIDType">

                <xs:annotation>

                                <xs:documentation>Identification of fee </xs:documentation>

                </xs:annotation>

                <xs:restriction base="UidType"/>

</xs:simpleType>

<xs:element name="fieID" type="FieIDType"/>

<xs:simpleType name="FieIDType">

                <xs:annotation>

                                <xs:documentation>Identification of fie </xs:documentation>

                </xs:annotation>

                <xs:restriction base="UidType"/>

</xs:simpleType>

<xs:element name="fumID" type="FumIDType"/>

<xs:simpleType name="FumIDType">

                <xs:annotation>

                                <xs:documentation>Identification of Fum </xs:documentation>

                </xs:annotation>

                <xs:restriction base="UidType"/>

</xs:simpleType>

 

B)            The other approach has me simply declaring each element.

 

<xs:element name="fooID" type="UidType">

                <xs:annotation>

                                <xs:documentation>Identification of foo. </xs:documentation>

                </xs:annotation>

</xs:element>

<xs:element name="feeID" type="UidType">

                <xs:annotation>

                                <xs:documentation>Identification of fee </xs:documentation>

                </xs:annotation>

</xs:element>

<xs:element name="fieID" type="UidType">

                <xs:annotation>

                                <xs:documentation>Identification of fie </xs:documentation>

                </xs:annotation>

</xs:element>

<xs:element name="fumID" "UidType">

                <xs:annotation>

                                <xs:documentation>Identification of Fum </xs:documentation>

                </xs:annotation>

</xs:element>

 

Question: Why would I choose (A) or (B)?

 

SO far, I can find that in many code bases, in the first, I can’t say

 

this.FooID = that.FeeID

 

but must instead say something like

 

this.FooID = cast(that.FeeID ).to FooIDType

(varies on language, implementation, of course)

 

This may be god if a FooId should never be a FeeId but may be bad in other cicumstances.

 

Is this more than a style concern?Are there deeper concerns I am overlooking?

 

Thanks

 

tc

 


“The single biggest problem in communication is the illusion that it has taken place.”
– George Bernard Shaw.


Toby Considine
TC9, Inc

TC Chair: oBIX & WS-Calendar

TC Editor: EMIX, EnergyInterop

U.S. National Inst. of Standards and Tech. Smart Grid Architecture Committee

  

Email: Toby.Considine@gmail.com
Phone: (919)619-2104

http://www.tcnine.com/
blog: http://www.NewDaedalus.com

 

 




[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index]


PURCHASE STYLUS STUDIO ONLINE TODAY!

Purchasing Stylus Studio from our online shop is Easy, Secure and Value Priced!

Buy Stylus Studio Now

Download The World's Best XML IDE!

Accelerate XML development with our award-winning XML IDE - Download a free trial today!

Don't miss another message! Subscribe to this list today.
Email
First Name
Last Name
Company
Subscribe in XML format
RSS 2.0
Atom 0.3
 

Stylus Studio has published XML-DEV in RSS and ATOM formats, enabling users to easily subcribe to the list from their preferred news reader application.


Stylus Studio Sponsored Links are added links designed to provide related and additional information to the visitors of this website. they were not included by the author in the initial post. To view the content without the Sponsor Links please click here.

Site Map | Privacy Policy | Terms of Use | Trademarks
Free Stylus Studio XML Training:
W3C Member
Stylus Studio® and DataDirect XQuery ™are products from DataDirect Technologies, is a registered trademark of Progress Software Corporation, in the U.S. and other countries. © 2004-2013 All Rights Reserved.