XSD如何定义一个有属性的简单元素

在XSD中定义含文本和属性的元素须用simpleContent with extension:先声明complexType含simpleContent,再用extension扩展简单类型并添加attribute;支持具名复用、内联定义、枚举约束及default/fixed属性值。

如果需要在XSD中定义一个既包含文本内容又拥有属性的元素,则该元素不能是纯粹的简单类型,而必须采用“带属性的简单内容”(simpleContent with extension)方式。以下是实现此需求的具体步骤:

一、使用simpleContent与extension声明带属性的简单元素

XML Schema不允许直接为简单类型元素添加属性,必须通过将简单类型嵌入complexType中,并以simpleContent为内容模型,再通过extension扩展属性。该方式保持元素主体为文本值,同时支持附加属性。

1、定义complexType,其内容模型为simpleContent。

2、在simpleContent内使用extension元素,指定base为所需简单类型(如xs:string、xs:integer等)。

3、在extension内部添加attribute子元素,声明所需属性名、类型及是否必需。

4、将该complexType赋予目标元素的type属性或通过匿名定义绑定到element上。

二、定义具名简单类型并扩展为带属性的复合类型

可先声明一个命名的简单类型(如xs:token或自定义restriction),再基于它构建带属性的complexType,提升类型复用性与可维护性。

1、使用xs:simpleType定义名称为myTextType的类型,可附加pattern、maxLength等约束。

2、新建xs:complexType,名称为myElementWithAttr,内部使用xs:simpleContent和xs:extension,base引用myTextType。

3、在xs:extension中添加xs:attribute,设置name为"lang",type为xs:language,use为"optional"。

4、声明xs:element name="title" type="myElementWithAttr"。

三、在元素声明中内联定义带属性的简单内容类型

适用于仅在单处使用的场景,避免全局类型污染,直接在element标签内嵌套complexType定义,结构紧凑且作用域明确。

1、编写xs:element,指定name为"price"。

2、在element内嵌入xs:complexType,不设name属性。

3、在complexType中添加xs:simpleContent,其下嵌套xs:extension,base设为"xs:decimal"。

4、在extension中添加xs:attribute,name为"currency",type为"xs:string",use为"required"。

四、限制属性取值范围并绑定枚举值

当属性需限定为固定集合时,可在attribute内部嵌套xs:simpleType与xs:restriction,并使用xs:enumeration约束合法值,增强数据校验能力。

1、在xs:extension中添加xs:attribute name="status"。

2、在attribute内嵌套xs:simpleType,再嵌套xs:restriction base="xs:string"。

3、添加多个xs:enumeration,value分别设为"active""inactive""pending"

4、确保该attribute的use属性设为"optional"或"required"以匹配业务语义。

五、为属性设置默认值或固定值

当希望未显式提供属性时自动赋予特定值,可使用default或fixed属性。default在实例中未出现该属性时生效;fixed则强制要求值一致且不可覆盖。

1、在xs:attribute中添加default="en",使19.99等效于19.99

2、若使用fixed="USD",则所有实例中的currency属性值必须为"USD",否则校验失败。

3、注意:default与fixed不可同时存在,且仅对use="optional"或use="prohibited"的属性有效。