跳至主要内容

XSD Tutorial (2): Problem Lists

In last blog, we scan on some difficult part of XSD, in this tutorial, we continue with a problem lists to assist search.

Problem Lists

The following is the problems I met when working on it, and most answers are come from SO.

Define Element With Optinal Body?

<xs:element name="query" minOccurs="0" />

Define Enum?

<xs:simpleType name="dialects" final="restriction">
    <xs:restriction base="xs:string">
        <xs:enumeration value="oracle" />
        <xs:enumeration value="inceptor" />
    </xs:restriction>
</xs:simpleType>

Define Attributes Like maxOccurs

We can notice that the value of macOccurs can be a non-negative number or a string – unbounded. How does it defined?
The following is its definition:

<xs:simpleType name="allNNI">
 <xs:union memberTypes="xs:nonNegativeInteger">
  <xs:simpleType>
   <xs:restriction base="xs:NMTOKEN">
    <xs:enumeration value="unbounded"/>
   </xs:restriction>
  </xs:simpleType>
 </xs:union>
</xs:simpleType>

Here it use union to combine the range of non-negative integer and a string enumeration, which is easy to mimic by ourselves.

Allow elements in any order any number of times?

<xs:choice minOccurs="0" maxOccurs="unbounded">
   <xs:element name="a" type="A"/>
   <xs:element name="b" type="B"/>
</xs:choice>

Notice that the occurs limitation should be at choice level, otherwise we just let any one of them to appear many times, which waste us some time.

unbounded Not Recognized

You can not use unbounded in xs:all, so you have to choose sequence or choice depend on whether your want element in order.

Inheritance

Using inheritance in xsd is not so straightforward and we came across many problems.

What we should notice is that what we want to achieve here is to limit father’s attribute, content/element definition in father, or to extend it.

Minimize the Range of Type – restriction

Restrictions are used to define acceptable values for XML elements or attributes

The following is a normal usage of restriction, in which we constrain the range of string:

<xs:complexType name="parentType">
    <xs:sequence>
        <xs:element name="name" type="xs:string"/>
    </xs:sequence>
</xs:complexType>

<xs:complexType name="childType">
    <xs:complexContent>
        <xs:restriction base="parentType">
            <xs:sequence>
                <xs:element name="name" type="specialStr"/>
            </xs:sequence>
        </xs:restriction>
    </xs:complexContent>
</xs:complexType>
Class and Object

In some special case of using it, we can do some thing like defining an object (new type) of a class (old type) like following:

<xs:complexType name="A">
    <xs:attribute name="p" type="xs:float" default="0.5"/>
</xs:complexType>

<xs:complexType name="B">
    <xs:complexContent>
        <xs:restriction base="A">
            <xs:attribute name="p" fixed="1"/>
        </xs:restriction>
    </xs:complexContent>
</xs:complexType>

In this case, we actually remove an attribute from father type by change it use property. But we should notice that restriction can only remove attributes that were optional in the original type.

Add New Member to Type – extension

Unlike restriction, extension always adds things and cannot remove things (elements and attributes). It is used to extend original type. The following example shows that:

<xs:complexType name="A">
    <xs:choice>
        <xs:element name="c" type="C"/>
    </xs:choice>
</xs:complexType>
<xs:complexType name="B">
    <xs:complexContent>
        <!-- error to using xs:restriction here-->
        <xs:extension base="A">
            <xs:choice>
                <!-- adding a new element -->
                <xs:element name="d" type="d"/>
            </xs:choice>
        </xs:extension>
    </xs:complexContent>
</xs:complexType>
Relation Between Super’s Elements and Sub’s Elements

We sometimes may wonder, if we add some new elements by extension, what the relationship between newly added elements and father type’s elements?
I didn’t find related reference, but we can test by some examples:

<xs:complexType name="A">
    <xs:choice>
        <xs:element name="a" type="xs:int"/>
    </xs:choice>
</xs:complexType>
<xs:complexType name="B">
    <xs:complexContent>
        <xs:extension base="A">
            <xs:choice >
                    <xs:element name="b" type="xs:string"/>
                    <xs:element name="c" type="xs:double"/>
            </xs:choice>
        </xs:extension>
    </xs:complexContent>
</xs:complexType>

valid one:

<B>
    <a>1</a>
    <b>AS</b>
</B>

invalid one:

<B>
    <b>AS</b>
    <a>1</a>
</B>

This shows that they are in order, which almost proves that they are organized by sequence like following:

<xs:sequence>
    <xs:choice>
        <xs:element name="a"/>
    </xs:choice>
    <xs:choice>
        <xs:element name="b"/>
        <xs:element name="c"/>
    </xs:choice>
</xs:sequence>

Or in more abstract way:

<xs:sequence>
    // father element definition
    // child element definition
</xs:sequence>

Ref

Written with StackEdit.

评论

发表评论

此博客中的热门博文

Spring Boot: Customize Environment

Spring Boot: Customize Environment Environment variable is a very commonly used feature in daily programming: used in init script used in startup configuration used by logging etc In Spring Boot, all environment variables are a part of properties in Spring context and managed by Environment abstraction. Because Spring Boot can handle the parse of configuration files, when we want to implement a project which uses yml file as a separate config file, we choose the Spring Boot. The following is the problems we met when we implementing the parse of yml file and it is recorded for future reader. Bind to Class Property values can be injected directly into your beans using the @Value annotation, accessed via Spring’s Environment abstraction or bound to structured objects via @ConfigurationProperties. As the document says, there exists three ways to access properties in *.properties or *.yml : @Value : access single value Environment : can access multi...
5 条评论
阅读全文

Elasticsearch: Join and SubQuery

Elasticsearch: Join and SubQuery Tony was bothered by the recent change of search engine requirement: they want the functionality of SQL-like join in Elasticsearch! “They are crazy! How can they think like that. Didn’t they understand that Elasticsearch is kind-of NoSQL 1 in which every index should be independent and self-contained? In this way, every index can work independently and scale as they like without considering other indexes, so the performance can boost. Following this design principle, Elasticsearch has little related supports.” Tony thought, after listening their requirements. Leader notice tony’s unwillingness and said, “Maybe it is hard to do, but the requirement is reasonable. We need to search person by his friends, didn’t we? What’s more, the harder to implement, the more you can learn from it, right?” Tony thought leader’s word does make sense so he set out to do the related implementations Application-Side Join “The first implementation ...
发表评论
阅读全文

Learn Spring Expression Language

When reading the source code of some Spring based projects, we can see some code like following: @Value( "${env}" ) private int value ; and like following: @Autowired public void configure (MovieFinder movieFinder, @ Value ("#{ systemProperties[ 'user.region' ] } ") String defaultLocale) { this.movieFinder = movieFinder; this.defaultLocale = defaultLocale; } In this way, we can inject values from different sources very conveniently, and this is the features of Spring EL. What is Spring EL? How to use this handy feature to assist our developments? Today, we are going to learn some basics of Spring EL. Features The full name of Spring EL is Spring Expression Language, which exists in form of Java string and evaluated by Spring. It supports many syntax, from simple property access to complex safe navigation – method invocation when object is not null. And the following is the feature list from Spring EL document : ...
发表评论
阅读全文