XML Schema

分类: XML 2005-01-23 22:36 11205人阅读 评论(7) 收藏 举报

1.                  最简单的Schema文档

如何写一个最简单的XML Schema文档呢?

首先,我们写出一个最简单的XML文档。

hello.xml

-------------------

<?xml version="1.0"?> 

<greeting>Hello World!!</greeting>

<!--一个根元素:greeting;且这个元素不含属性,无子元素,内容是字符串。-->

hello.xsd

----------

<?xml version="1.0"?> 

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema">

<xsd:element name="greeting" type="xsd:string"/>
</xsd:schema>

XML Schema文档后缀名是.xsd,完全符合XML语法,根元素是schema,命名空间xmlns:xsd="http://www.w3.org/2001/XMLSchema,用元素<element>定义实例文档中的元素,如greeting。

2.                  含子元素的Schema文档 

假设实例文档是如下的:

customer.xml

-----------

<customer>

<name>teiki</name>

<address>No.237, Road Waitan, Shanghai</address>

</customer>

则可以写出以下的XML Schema文档:

customer.xsd

----------------

<?xml version="1.0"?>

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema">

<xsd:element name="customer">

<xsd:complexType>

<xsd:sequence>

<xsd:element name="name" type="xsd:string"/>

<xsd:element name="address" type="xsd:string" />

</xsd:sequence>

</xsd:complexType>

</xsd:element>

</xsd:schema>

实例文档customer.xml中,<customer>元素含有两个子元素,所以我们在Schema文档中采用ComplexType来定义该元素。sequence表示子元素依次出现的顺序。

3.                  含子元素和孙元素的Schema文档

这次我们给出一个更加复杂一些的文档:

customer.xml

---------------

<customer>

<name>Teiki</name>

<address>

<!-- address追加一个地址子元素 -->

<prefecture>Zhejiang</prefecture>

<city>Hangzhou</city>

<street>Xilu Road, No.121, 7F</street>

</address>

</customer>

 

为此,我们需要一个更加复杂一点的Schema文档:

address.xsd

-----------------

<?xml version="1.0"?>

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema">

<xsd:element name="customer">

<xsd:complexType>

<xsd:sequence>

<xsd:element name="name" type="xsd:string"/>

<!-- 追加子元素address-->

<xsd:element name="address">

<xsd:complexType>

<xsd:sequence>

<xsd:element name="prefecture" type="xsd:string"/>

<xsd:element name="city" type="xsd:string" />

<xsd:element name="street" type="xsd:string" />

</xsd:sequence>

</xsd:complexType>

</xsd:element>

              </xsd:sequence>

</xsd:complexType>

</xsd:element>

</xsd:schema>

不过,我们还可以采用ref元素来重新编写这个Schema文档:

address2.xsd

----------------------

<?xml version="1.0"?>

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema">

<xsd:element name="customer">

<xsd:complexType>

<xsd:sequence>

<xsd:element name="name" type="xsd:string"/>

<xsd:element ref="address"/>

</xsd:sequence>

</xsd:complexType>

</xsd:element>

<xsd:element name="address">

<xsd:complexType>

<xsd:sequence>

<xsd:element name="prefecture" type="xsd:string"/>

<xsd:element name="city" type="xsd:string" />

<xsd:element name="street" type="xsd:string" />

</xsd:sequence>

</xsd:complexType>

</xsd:element>

</xsd:schema>

使用ref元素可以直接将其指向另一个模块,使文档更加具有可读性。

4.                  定义相同子元素的数量

先看这个简单的订购数据实例文档:

order.xml

---------

<order>

<orderItem>Accounting Book</orderItem>

<orderItem>Taxation Book</orderItem>

</order>

假设<orderItem>元素,即每次的订购书目不能超过10种,那该怎么写这个Schema文档呢?这里要用到<element>的maxOccurs属性。

order.xsd

--------------------

<?xml version="1.0"?>

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema">

<xsd:element name="order">

<xsd:complexType>

<xsd:sequence>

<xsd:element name="orderItem"   type="xsd:string"  maxOccurs="10" />

</xsd:sequence>

</xsd:complexType>

</xsd:element>

</xsd:schema>

第7行中的maxOccurs属性为10,代表orderItem元素可以最大有10个。如果,不设定元素个数,则可以用maxOccurs="unbounded"来定义。

类似,如果要定义最小值,可以使用minOccurs,比如下面这句:

<xsd:element name="orderItem" type="xsd:string" minOccurs="5" maxOccurs="10"/>

这两个属性缺省值都是1

5.                  定义可选项的子元素

假如上面的订书数据中,可以用书名或者书号任一一种订购,则实例文档可能如下:

order2.xml

-----------------

<order>

<orderItem>

<!--书名订购-->

<name>Accounting Book</name>

</orderItem>

<orderItem>

<!--书号订购-->

<id>7-5058-3496-7</id>

</orderItem>

</order>

这时书写Schema文档还需要使用choice元素。

order2.xsd

-------------------------

<?xml version="1.0"?>

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema">

<xsd:element name="order">

<xsd:complexType>

<xsd:sequence>

<xsd:element ref="orderItem" maxOccurs="10" />

</xsd:sequence>

</xsd:complexType>

</xsd:element>

<xsd:element name="orderItem">

<xsd:complexType>

<xsd:choice>

<xsd:element name="name" type="xsd:string"/>

<xsd:element name="id" type="xsd:string"/>

</xsd:choice>

</xsd:complexType>

</xsd:element>

</xsd:schema>

稍微更复杂的可选项子元素

再稍微修改一下订书数据的实例文档:

order3.xml

-----------------

<order>

<orderItem>

<name>Accounting Book</name>

<quantity>2</quantity>

</orderItem>

<orderItem>

<id>7-5058-3496-7</id>

</orderItem>

</order>

这里假定<quantity>值为1时,缺省。

如何修改Schema文档呢?

order3.xsd

-----------------

<?xml version="1.0"?>

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema">

<xsd:element name="order">

<xsd:complexType>

<xsd:sequence>

<xsd:element ref="orderItem" maxOccurs="10"/>

</xsd:sequence>

</xsd:complexType>

</xsd:element>

<xsd:element name="orderItem">

<xsd:complexType>

<xsd:sequence>

<xsd:choice>

<xsd:element name="name" type="xsd:string"/>

<xsd:element name="id" type="xsd:string"/>

</xsd:choice>

<xsd:element name="quantity" type="xsd:string" minOccurs="0"/>

</xsd:sequence>

</xsd:complexType>

</xsd:element>

</xsd:schema>

19行中的quantity最少出现值为0,也就是可以有,也可以没有。
当然,也可以直接在<choice>元素中,包含quantity,然后定义它的minOccurs。

6.                  内置简单类型

图省略

7.                  自定义简单类型

如果内置简单类型的44种还不能满足要求,怎么办呢?下面学习自定义简单类型。(XML的扩展性充分体现在这里)

例如这个实例文档:

order4.xml

-----------------

<order>

<orderItem>

<id>7-5058-3496-7</id>

<quantity>5</quantity>

</orderItem>

</order>

ID是一个标准的ISBN编码,我们怎么定义这个ISBN编码呢?

<xsd:simpleType name="idType">

<xsd:restriction base="xsd:string">

<xsd:pattern value="/d{1}-/d{4}-/d{4}-/d{1}"/>

</xsd:restriction>

</xsd:simpleType>

idType是一个自定义的简单类型。

我们对它做了限制:

<xsd:restriction base="xsd:string">代表它是基于一个字符串类型。再用pattern元素来描述该字符串的形式。

value="/d{1}-/d{4}-/d{4}-/d{1}"这是一个正则表达式,关于正则表达式,以后再介绍。嘻嘻!

利用这个自定义的简单类型,我们可以重新写Schema文档:

order4.xsd

---------------

<?xml version="1.0"?>

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema">

<xsd:element name="order">

<xsd:complexType>

<xsd:sequence>

<xsd:element ref="orderItem" maxOccurs="10"/>

</xsd:sequence>

</xsd:complexType>

</xsd:element>

<xsd:element name="orderItem">

<xsd:complexType>

<xsd:sequence>

<xsd:element name="id" type="idType"/>

<xsd:element name="quantity" type="xsd:integer"/>

</xsd:sequence>

</xsd:complexType>

</xsd:element>

<xsd:simpleType name="idType">

<xsd:restriction base="xsd:string">

<xsd:pattern value="/d{1}-/d{4}-/d{4}-/d{1}"/>

</xsd:restriction>

</xsd:simpleType>

</xsd:schema>

 

假如我们事先确定好ID只有3个,即只有3个ISBN是可选的,那怎么办?我们可以用enumeration元素来进行列举。

<xsd:simpleType name="idType">

<xsd:restriction base="xsd:string">

<xsd:enumeration value="7-5058-3496-7"/>

<xsd:enumeration value="7-5005-6450-3"/>

<xsd:enumeration value="7-3020-6069-7"/>

</xsd:restriction>

</xsd:simpleType>

 

再来看订购量quantity的值,如果我们设定其值必须在1-10之间,该怎么办呢?可以这些自定义一个简单类型。

<xsd:simpleType name="quantityType">

<xsd:restriction base="xsd:integer">

<xsd:minInclusive value="1"/>

<xsd:maxInclusive value="10"/>

</xsd:restriction>

</xsd:simpleType>

其中,minInclusive,maxInclusive分别代表该类型的取值范围。

所以最终修改后的Schema文档如下:

order4-1.xsd

----------------------

<?xml version="1.0"?>

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema">

<xsd:element name="order">

<xsd:complexType>

<xsd:sequence>

<xsd:element ref="orderItem" maxOccurs="10"/>

</xsd:sequence>

</xsd:complexType>

</xsd:element>

<xsd:element name="orderItem">

<xsd:complexType>

<xsd:sequence>

<xsd:element name="id" type="idType"/>

<xsd:element name="quantity" type="quantityType"/>

</xsd:sequence>

</xsd:complexType>

</xsd:element>

<xsd:simpleType name="idType">

<xsd:restriction base="xsd:string">

<xsd:enumeration value="7-5058-3496-7"/>

<xsd:enumeration value="7-5005-6450-3"/>

<xsd:enumeration value="7-3020-6069-7"/>

</xsd:restriction>

</xsd:simpleType>

<xsd:simpleType name="quantityType">

<xsd:restriction base="xsd:integer">

<xsd:minInclusive value="1"/>

<xsd:maxInclusive value="10"/>

</xsd:restriction>

</xsd:simpleType>

</xsd:schema>

8.                  定义属性

最后,我们再来讲讲元素的属性如何在Schema文档中定义。

比如上面的order.xml实例文档中:

<order>

  <orderItem id="7-5058-3496-7" />

</order>

对此,我们在Schema文档中采用一个attribute来定义:

order.xsd

---------

<xsd:element name="orderItem">

<xsd:complexType>

<xsd:sequence>  ←空元素

</xsd:sequence>  

<!--定义该元素属性-->

<xsd:attribute name="id" type="xsd:string"/>

</xsd:complexType>

</xsd:element>

那么,实例文档中该属性值是必须的还是可有可无的呢?我们可以这样限制:

<xsd:attribute name="id" type="idType" use="required"/>

这里我们讲id属性类型作为一种自定义数据类型idType。

而且,用attribute元素的use属性来定义是否是必须的属性。

required是必须值,optional是可选值,prohibited是无属性值。

 

那么对于属性的缺省值,我们怎么定义呢?
比如:

<order>

  <orderItem id="4-8443-1780-6" quantity="3"/>

</order>

我们还可以用attribute元素的另一个属性default来定义:

<xsd:attribute name="quantity" type="xsd:integer" default="1"/>

所以,我们可以重新写出一个Schema文档:

order2.xsd

--------------

<xsd:element name="orderItem">

<xsd:complexType>

<xsd:sequence></xsd:sequence>

<xsd:attribute name="id" type="idType" use="required"/>

<xsd:attribute name="quantity" type="xsd:integer" default="1"/>

</xsd:complexType>

</xsd:element>

上面的属性我们定义我们还可以采用属性组的办法来重新改写Schema文档。

order3.xsd

----------------

<xsd:element name="orderItem">

<xsd:complexType>

<xsd:sequence></xsd:sequence>

<xsd:attributeGroup ref="orderItemAttributes"/>

</xsd:complexType>

</xsd:element>

<xsd:attributeGroup name="orderItemAttributes">

<xsd:attribute name="id" type="idType" use="required"/>

<xsd:attribute name="quantity" type="xsd:integer" default="1"/>

</xsd:attributeGroup>

这个属性组就不详细解释了,不过,大家一看就清楚了吧。

最后,我们写一个完整的订书order.xml的Schema文档。

<?xml version="1.0"?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema">

<xsd:element name="order">

<xsd:complexType>

<xsd:sequence>

<xsd:element ref="orderItem" maxOccurs="10"/>

</xsd:sequence>

</xsd:complexType>

</xsd:element>

<xsd:element name="orderItem">

<xsd:complexType>

<xsd:sequence></xsd:sequence>

<xsd:attributeGroup ref="orderItemAttributes"/>

</xsd:complexType>

</xsd:element>

<xsd:attributeGroup name="orderItemAttributes">

<xsd:attribute name="id" type="idType" use="required"/>

<xsd:attribute name="quantity" type="xsd:integer" default="1"/>

</xsd:attributeGroup>

<xsd:simpleType name="idType">

<xsd:restriction base="xsd:string">

<xsd:pattern value="/d{1}-/d{4}-/d{4}-/d{1}"/>

</xsd:restriction>

</xsd:simpleType>

</xsd:schema>

 

其他xml中引用xsd

<?xml version="1.0" encoding="utf-8" standalone="no"?>

<Envlope xmlns="gmip" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="gmip_appraise_rep.xsd">

Xsd中对应为:

<?xml version="1.0"?>

<xsd:schema targetNamespace="gmip" xmlns:xsd="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" attributeFormDefault="qualified">

 

ElementFormDefault=qualified意思是要求element使用的namespacetargetNamespace,它的作用是对元素起"限定与非限定"使用,意思是在文档范例中要求采用命名空间前缀。

<think>我们正在处理一个ODL文件解析错误。错误信息显示: "syntax error, unexpected invalid token, expecting GLOBAL or STRING or TEXT or '}'@/etc/amx/tr181-snmpv3/tr181-snmpv3.odl:line 1" 这意味着在ODL文件的第一行出现了语法错误,解析器期望遇到GLOBAL、STRING、TEXT或'}',但遇到了无效的标记。 可能的原因及解决方案: 1. **文件起始位置有不可见字符**(如UTF-8 BOM): - 使用`hexdump -C /etc/amx/tr181-snmpv3/tr181-snmpv3.odl | head -n1`检查文件头。 - 若发现EF BB BF,则为BOM,需删除:`sed -i '1s/^\xEF\xBB\xBF//' /etc/amx/tr181-snmpv3/tr181-snmpv3.odl` 2. **第一行存在非法字符或格式错误**: - 检查第一行内容:`head -1 /etc/amx/tr181-snmpv3/tr181-snmpv3.odl` - 正常ODL文件应以`GLOBAL { ... }`或`STRING { ... }`等结构开头。常见错误: - 首字符为空格/制表符(ODL可能不允许在开头有空白) - 缺少大括号`{`或`}` - 使用了注释但在首行(ODL注释为`//`或`/* */`),但解析器在期望关键字时遇到注释也会报错。 3. **文件为空或只有空白行**: - 确保文件非空:`stat -c %s /etc/amx/tr181-snmpv3/tr181-snmpv3.odl` 应大于0。 4. **ODL版本不兼容**: - 确认使用的`amxrt`版本与ODL语法匹配。通过`amxrt -v`查看版本并对照文档。 ### 解决步骤: 1. **备份文件**: ```bash cp /etc/amx/tr181-snmpv3/tr181-snmpv3.odl /etc/amx/tr181-snmpv3/tr181-snmpv3.odl.bak ``` 2. **检查第一行内容**: ```bash head -n5 /etc/amx/tr181-snmpv3/tr181-snmpv3.odl ``` 3. **尝试修复常见问题**: - 如果第一行是注释,将其移到关键字后面或删除(除非确认允许首行注释)。 - 确保第一行是合法的ODL结构,例如: ```odl GLOBAL { // ... 全局配置 } ``` 或 ```odl STRING myString { // ... 字符串定义 } ``` 4. **使用工具验证**: - 如果有ODL schema校验工具,使用它检查文件。 5. **重新加载**: ```bash amxrt -D tr181-snmpv3.odl ``` ### 示例修复: 假设原始文件第一行是: ``` // Configuration for tr181-snmpv3 ``` 将其改为在关键字后注释: ``` GLOBAL { // Configuration for tr181-snmpv3 // ... } ``` 或删除首行空白: 原内容(开头有空格): ``` GLOBAL { ``` 改为: ``` GLOBAL { ``` §§相关问题§§ 1. 如何在Linux系统中检测和移除UTF-8 BOM标记? 2. ODL文件的基本语法结构包含哪些关键元素? 3. 当遇到解析器报错“unexpected token”时应如何逐步排查? 4. 如何验证ODL文件是否符合特定的schema规范? 5. 在嵌入式系统中管理配置文件时如何避免格式错误? </think>### 错误分析与解决方案 #### 错误诊断: 该错误表明 ODL 文件(`tr181-snmpv3.odl`)的第一行存在语法问题: ``` ERROR : syntax error, unexpected invalid token, expecting GLOBAL or STRING or TEXT or '}'@/etc/amx/tr181-snmpv3/tr181-snmpv3.odl:line 1 ``` 核心问题: 1. **语法解析失败**:ODL 解析器在文件首行遇到非法标记 2. **预期关键词缺失**:解析器期望出现 `GLOBAL`、`STRING`、`TEXT` 或 `}` 等关键词 3. **常见触发原因**: - 配置文件首行存在非法字符(如不可见控制字符) - 关键词拼写错误(如 `GLOBAL` 写成 `GLBAL`) - 大括号 `{}` 未正确闭合 - UTF-8 BOM 头等特殊编码问题 #### 解决步骤: ##### 1. 检查首行内容 ```bash # 查看文件首行内容 head -n1 /etc/amx/tr181-snmpv3/tr181-snmpv3.odl # 检查特殊字符(显示不可打印字符) cat -v /etc/amx/tr181-snmpv3/tr181-snmpv3.odl | head -n1 ``` ##### 2. 验证基本语法结构 合法 ODL 文件应以以下任一结构开头: ```odl // 示例1:全局配置块 GLOBAL { // 参数配置 } // 示例2:字符串定义 STRING myString { value = "Hello" } // 示例3:文本块 TEXT myText { content = "Multiline\ntext" } ``` ##### 3. 修复方案 - **删除非法字符**: ```bash # 删除可能的BOM头 sed -i '1s/^\xEF\xBB\xBF//' /etc/amx/tr181-snmpv3/tr181-snmpv3.odl ``` - **修正关键词拼写**: ```diff - GLBAL { + GLOBAL { ``` - **补全结构闭合**: ```diff GLOBAL { param = value + } // 添加缺失的闭合大括号 ``` ##### 4. 使用 ODL 验证工具 ```bash # 语法检查(如果提供) amxrt --syntax-check tr181-snmpv3.odl # 或使用标准XML工具验证(若为XML格式) xmllint /etc/amx/tr181-snmpv3/tr181-snmpv3.odl ``` ##### 5. 测试加载 ```bash amxrt -D tr181-snmpv3.odl ``` ### 典型修复案例 **错误文件内容**: ```odl PARAMETERS { // 首含不可见BOM字符 timeout = 30 ``` **修正后**: ```odl GLOBAL { timeout = 30 } // 添加闭合大括号 ```
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值