跳转至

XML-choice all sequence 讲解

XML Schema 中 Order 指示器 choice all sequence 和 Occurrence 指示器 minOccurs maxOccurs 的用法解释

1 Order 指示器

1.1 all

  • <all> 指示器规定子元素可以按照任意顺序出现

1.1.1 myXsd.xsd 文件

<?xml version="1.0" encoding="UTF-8"?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="www.shuhaiwen.com" targetNamespace="www.shuhaiwen.com" elementFormDefault="qualified">
    <xsd:complexType name="Student">
        <xsd:all minOccurs="1" maxOccurs="1">
            <xsd:element name="Name" type="xsd:string" minOccurs="0" maxOccurs="1"/>
            <xsd:element name="ID" type="xsd:string" minOccurs="1" maxOccurs="1"/>
            <xsd:element name="Hobby" type="xsd:string" minOccurs="0" maxOccurs="1"/>
        </xsd:all>
    </xsd:complexType>
    <xsd:element name="student" type="Student"/>
</xsd:schema>

1.1.2 myXml.xml 文件

<?xml version="1.0" encoding="UTF-8"?>
<student xmlns="www.shuhaiwen.com" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="www.shuhaiwen.com myXsd.xsd">
    <Name>shu haiwen</Name> 
    <Hobby> football</Hobby>
    <ID>1342566</ID>
</student>

1.1.3 分析

  • <all> 元素和子元素中必须设 maxOccrus="1" ,minOccrus="0" 或 "1"
  • <Hobby> 元素可以在<ID> 元素之前,元素出现顺序无关

1.1.4 错误示例 xml依据上面的 xsd 代码

误用 1:子元素出现多次

<?xml version="1.0" encoding="UTF-8"?>
<student xmlns="www.shuhaiwen.com" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="www.shuhaiwen.com myXsd.xsd">
    <Name>shu haiwen</Name> 
    <Hobby>football</Hobby>
    <Hobby>ready</Hobby>
    <ID>1342566</ID>
</student>

error:<Hobby> 出现 2 次

1.2 choice

  • <choice> 指示器规定元素只能出现一次

1.2.1 myXsd.xsd 文件

<?xml version="1.0" encoding="UTF-8"?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="www.shuhaiwen.com" targetNamespace="www.shuhaiwen.com" elementFormDefault="qualified">
    <xsd:complexType name="Student">
        <xsd:choice minOccurs="1" maxOccurs="1">
            <xsd:element name="Name" type="xsd:string" minOccurs="0" maxOccurs="1"/>
            <xsd:element name="ID" type="xsd:string" minOccurs="1" maxOccurs="1"/>
            <xsd:element name="Hobby" type="xsd:string" minOccurs="0" maxOccurs="unbounded"/>
        </xsd:choice>
    </xsd:complexType>
    <xsd:element name="student" type="Student"/>
</xsd:schema>

1.2.2 myXml.xml 文件

<?xml version="1.0" encoding="UTF-8"?>
<student xmlns="www.shuhaiwen.com" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="www.shuhaiwen.com myXsd.xsd">
    <Hobby> football</Hobby>
    <Hobby>ready</Hobby>
</student>

1.2.3 分析

  • sequence 内元素有且只执行一次,由 minOccurs="1" maxOccurs="1" 决定,当 minOccurs="0" 时,可以不执行,当 maxOccurs="2" or 3 or unbounded 时,可以执行指定次数
  • 只能出现 Name ID Hobby 中一中元素类型,可出现次数取决于 元素中 minOccurs maxOccurs 属性
  • <student> 可以不包含元素,因为 Name 元素的 minOccurs="0" ,即当我选择 Name 元素作为<Student> 的子元素时,<Name> 可以执行 0 次,即不执行
  • 当选择 ID 元素作为 Student 子元素时,必须执行一次
  • 当选择 Hobby 元素作为 Student 子元素时,可执行任意次,对应 xml 文件中 <Hobby> football</Hobby><Hobby>ready</Hobby>

1.2.4 错误示例 xml依据上面的 xsd 代码

误用 1:选择多个子元素

<?xml version="1.0" encoding="UTF-8"?>
<student xmlns="www.shuhaiwen.com" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="www.shuhaiwen.com myXsd.xsd">
    <Name>shu haiwen</Name> 
    <ID>1342566</ID>
    <Hobby> football</Hobby>
    <Hobby>ready</Hobby>
</student>

error:<Name> <ID> <Hobby> 只能出现其中一类

误用 2:同一元素使用超过 maxOccurs 所规定的数量

<?xml version="1.0" encoding="UTF-8"?>
<student xmlns="www.shuhaiwen.com" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="www.shuhaiwen.com myXsd.xsd">
    <ID>1342566</ID>
    <ID>5464565</ID>
</student>

error:<ID> 只能出现一次

1.3 sequence

  • <sequence> 指示器规定元素按顺序出现
  • 元素是否出现或出现多少次由 minOccurs 和 maxOccurs 属性限制
  • Example

1.3.1 myXsd.xsd 文件

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="www.shuhaiwen.com" targetNamespace="www.shuhaiwen.com" elementFormDefault="qualified">
    <xsd:complexType name="Student">
        <xsd:sequence minOccurs="1" maxOccurs="1">
            <xsd:element name="Name" type="xsd:string" minOccurs="0" maxOccurs="1"/>
            <xsd:element name="ID" type="xsd:string" minOccurs="1" maxOccurs="1"/>
            <xsd:element name="Hobby" type="xsd:string" minOccurs="0" maxOccurs="unbounded"/>
        </xsd:sequence>
    </xsd:complexType>
    <xsd:element name="student" type="Student"/>
</xsd:schema>

1.3.2 myXml.xml 文件

<?xml version="1.0" encoding="UTF-8"?>
<student xmlns="www.shuhaiwen.com" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="www.shuhaiwen.com myXsd.xsd">
    <Name>shu haiwen</Name> 
    <ID>1342566</ID>
    <Hobby> football</Hobby>
    <Hobby>ready</Hobby>
</student>

1.3.3 分析

  • sequence 内元素有且只执行一次,由 minOccurs="1" maxOccurs="1" 决定,当 minOccurs="0" 时,可以不执行,当 maxOccurs="2" or 3 or unbounded 时,可以执行指定次数
  • Name 可以执行一次或不执行,对应 xml 文件中 <Name>shu haiwen</Name> 可以不写或只能出现一次
  • ID 必须执行一次,必须在 Hobby 之前执行,对应 xml 文件中 <ID>1342566</ID>
  • Hobby 可执行任意次,对应 xml 文件中 <Hobby> football</Hobby><Hobby>ready</Hobby>

1.3.4 错误示例 xml依据上面的 xsd 代码

误用 1: ID 元素不能少

<?xml version="1.0" encoding="UTF-8"?>
<student xmlns="www.shuhaiwen.com" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="www.shuhaiwen.com myXsd.xsd">
    <Name>shu haiwen</Name>
    <Hobby> football</Hobby>
    <Hobby>ready</Hobby>
</student>

error: 缺少<ID> 元素

  • 误用 2:元素顺序错误 *
<?xml version="1.0" encoding="UTF-8"?>
<student xmlns="www.shuhaiwen.com" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="www.shuhaiwen.com myXsd.xsd">
    <ID>1342566</ID>
    <Name>shu haiwen</Name> 
    <Hobby> football</Hobby>
    <Hobby>ready</Hobby>
</student>

error:<ID> 元素不能在<Name> 元素之前或<Hobby> 元素之后

1.3.5 注意:以上都是在 <sequence> 中 maxOccurs="1" 的情况下满足,当 maxOccurs="2" or unbounded 时,不适用

2 Occurrence 指示器

2.1 minOccurs

  • 限定元素出现的最少次数,可为任意数值

2.2 maxOccurs

  • 限定元素出现的最大次数,可为任意数值或 unbounded

2.3 注意:minOccurs 只能小于 maxOccurs