XML Tutorial/XML Schema/Attribute
Содержание
- 1 A globally defined attribute declaration
- 2 Attribute declarations have the following format
- 3 Attribute declarations may also be defined locally within the complexType element
- 4 Attribute Use: Default and Fixed Values
- 5 Creating a Local/Global Type for Attribute
- 6 Declaring Attributes
- 7 how we declare attributes
- 8 Mark attribute as required
- 9 Predefining an Attribute"s Content with a fixed value or a default value
- 10 Prohibited attributes in the restriction
- 11 Requiring an Attribute
- 12 Restrict the data type by restricting its attributes
- 13 Value Constraints on Attributes
- 14 Value of an attribute is the same as the value we prescribe in the schema, whether or not the attribute is present
A globally defined attribute declaration
<xsd:schema
targetNamespace=
"http://www.wbex.ru/namespace/employees"
xmlns="http://www.wbex.ru/namespace/employees"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
elementFormDefault="qualified">
<xsd:attribute name="int" use="optional"
type="xsd:string"/>
<xsd:element name="employees">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="firstName" type="xsd:string"/>
<xsd:element name="middleName" type="xsd:string"/>
<xsd:element name="lastName" type="xsd:string"/>
</xsd:sequence>
<xsd:attribute ref="int"/>
</xsd:complexType>
</xsd:element>
</xsd:schema>
Attribute declarations have the following format
<attribute name="name of the attribute"
type="global type"
ref="global attribute declaration"
form="qualified or unqualified"
use="optional or prohibited or required"
default="default value"
fixed="fixed value">
There are two primary methods for declaring attributes: creating a local type or using a global type.
Attribute declarations are restricted to simple types.
Complex types are used to define types that contain attributes or elements.
Simple types are used to restrict text-only content.
Because an attribute can contain text only, you can use simple types only to define their allowable content.
You can reuse attributes by referring to global attribute declarations.
Attribute declarations may also be defined locally within the complexType element
<xsd:schema
targetNamespace=
"http://www.wbex.ru/namespace/employees"
xmlns="http://www.wbex.ru/namespace/employees"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
elementFormDefault="qualified">
<xsd:element name="employees">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="firstName" type="xsd:string"/>
<xsd:element name="middleName" type="xsd:string"/>
<xsd:element name="lastName" type="xsd:string"/>
</xsd:sequence>
<xsd:attribute name="int" use="optional" type="xsd:string"/>
</xsd:complexType>
</xsd:element>
</xsd:schema>
Attribute Use: Default and Fixed Values
To specify a default value, simply include the default attribute with the desired value:
<attribute name="kind" type="contacts:KindType" default="Home"/>
Fixed values operate much like default values.
If the attribute is omitted, then the parser inserts the attribute with the fixed value.
<attribute name="version" type="string" fixed="1.0"/>
Attribute with fixed value
<?xml version="1.0"?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
targetNamespace="http://www.wbex.ru" xmlns="http://www.wbex.ru"
elementFormDefault="qualified">
<xsd:element name="source">
<xsd:complexType>
<xsd:complexContent>
<xsd:extension base="xsd:anyType">
<xsd:attribute name="sectionid" type="xsd:string"
use="fixed" value="101" />
<xsd:attribute name="newspaperid" type="xsd:string" />
</xsd:extension>
</xsd:complexContent>
</xsd:complexType>
</xsd:element>
</xsd:schema>
File: Data.xml
<?xml version="1.0"?>
<source xmlns="http://www.wbex.ru"
sectionid="101"
newspaperid="21"/>
Attribute with default value
The fixed attribute only sets the content if the attribute actually appears in the XML.
If it is omitted, no content is set.
If the default attribute is set but the attribute is omitted from the XML, then the attribute"s value is set to the default value.
File: Schema.xsd
<?xml version="1.0"?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
targetNamespace="http://www.wbex.ru" xmlns="http://www.wbex.ru"
elementFormDefault="qualified">
<xsd:element name="source">
<xsd:complexType>
<xsd:complexContent>
<xsd:extension base="xsd:anyType">
<xsd:attribute name="sectionid" type="xsd:string"
use="fixed" value="101" />
<xsd:attribute name="newspaperid" type="xsd:string"
use="default" value="21" />
</xsd:extension>
</xsd:complexContent>
</xsd:complexType>
</xsd:element>
</xsd:schema>
File: Data.xml
<?xml version="1.0"?>
<source sectionid="101" newspaperid="21"/>
Creating a Local/Global Type for Attribute
To create a local type, simply include the type declaration as a child of the <attribute> element:
<attribute name="title">
<simpleType>
<!-- type information -->
</simpleType>
</attribute>
Using a Global Type for Attribute
You can create a global <simpleType> definition.
Within your attribute declarations, you can refer to a global type by name.
This type can be one of the built-in XML Schema datatypes.
Referring to an Existing Global Attribute
<attribute ref="contacts:kind"/>
Declaring Attributes
<attribute name="QName"
ref="QName"
type="QName"
use="optional | prohibited | required"
form="qualified | unqualified"
id="ID"
default="string"
fixed="string"
{any attributes with non-schema namespace}
>
Content: (annotation?, (simpleType?))
</attribute>
An attribute is always of simple type since it contains neither other elements nor other attributes.
An attribute always appears within an element of complex type.
An attribute must be declared at the very end of the complex type to which it belongs.
File: Schema.xsd
<?xml version="1.0"?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
targetNamespace="http://www.wbex.ru" xmlns="http://www.wbex.ru"
elementFormDefault="qualified">
<xsd:element name="source">
<xsd:complexType>
<xsd:complexContent>
<xsd:extension base="xsd:anyType">
<xsd:attribute name="sectionid" type="xsd:string" />
<xsd:attribute name="newspaperid" type="xsd:string" />
</xsd:extension>
</xsd:complexContent>
</xsd:complexType>
</xsd:element>
</xsd:schema>
File: Data.xml
<?xml version="1.0"?>
<source xmlns="http://www.wbex.ru" sectionid="101" newspaperid="21"/>
how we declare attributes
File: Data.xml
<?xml version = "1.0" ?>
<Customer customerID = "24332">
<FirstName>Raymond</FirstName>
<MiddleInitial>G</MiddleInitial>
<LastName>Bayliss</LastName>
</Customer>
File: Schema.xsd
<?xml version = "1.0" ?>
<schema xmlns = "http://www.w3.org/2001/XMLSchema">
<element name = "Customer">
<complexType>
<sequence>
<element name = "FirstName" type = "string" />
<element name = "MiddleInitial" type = "string" />
<element name = "LastName" type = "string" />
</sequence>
<attribute name = "customerID" type = "integer" />
</complexType>
</element>
</schema>
Mark attribute as required
File: Schema.xsd
<?xml version="1.0" encoding="UTF-8"?>
<xs:schema
targetNamespace="http://www.oreilly.ru/xslt"
xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns="http://www.oreilly.ru/xslt">
<xs:element name="part">
<xs:complexType>
<xs:sequence>
<xs:element ref="name" minOccurs="1" maxOccurs="1"/>
</xs:sequence>
<xs:attribute name="part-id" type="xs:ID" use="required"/>
</xs:complexType>
</xs:element>
<xs:element name="name" type="xs:string"/>
<xs:element name="partref">
<xs:complexType>
<xs:attribute name="refid" type="xs:IDREF" use="required"/>
</xs:complexType>
</xs:element>
</xs:schema>
Predefining an Attribute"s Content with a fixed value or a default value
File: Schema.xsd
<?xml version="1.0" ?>
<schema xmlns="http://www.w3.org/2001/10/XMLSchema"
targetNamespace="http://www.wbex.runs/"
xmlns:end="http://www.wbex.ru/">
<xsd:element name="source">
<xsd:complexType>
<xsd:complexContent>
<xsd:extension base="xsd:anyType">
<xsd:attribute name="sectionid" type="xsd:string" use="required"/>
<xsd:attribute name="newspaperid" type="xsd:string"/>
</xsd:extension>
</xsd:complexContent>
</xsd:complexType>
</xsd:element>
</schema>
File: Data.xml
<?xml version="1.0"?>
<source sectionid="101"/>
File: Data.xml
<?xml version="1.0"?>
<source sectionid="101" newspaperid="21"/>
Prohibited attributes in the restriction
<?xml version="1.0"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
targetNamespace="http://www.wbex.ru" xmlns="http://www.wbex.ru"
elementFormDefault="qualified">
<xs:complexType name="tokenWithLangAndNote">
<xs:simpleContent>
<xs:extension base="xs:token">
<xs:attribute name="lang" type="xs:language" />
<xs:attribute name="note" type="xs:token" />
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:element name="title">
<xs:complexType>
<xs:simpleContent>
<xs:restriction base="tokenWithLangAndNote">
<xs:maxLength value="255" />
<xs:attribute name="lang" type="xs:language" />
<xs:attribute name="note" use="prohibited" />
</xs:restriction>
</xs:simpleContent>
</xs:complexType>
</xs:element>
</xs:schema>
Requiring an Attribute
Unless you specify, an attribute is always optional.
You can predefine an attribute"s content with a fixed value or a default value.
File: Schema.xsd
<?xml version="1.0"?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
targetNamespace="http://www.wbex.ru" xmlns="http://www.wbex.ru"
elementFormDefault="qualified">
<xsd:element name="source">
<xsd:complexType>
<xsd:complexContent>
<xsd:extension base="xsd:anyType">
<xsd:attribute name="sectionid" type="xsd:string"
use="required" />
<xsd:attribute name="newspaperid" type="xsd:string" />
</xsd:extension>
</xsd:complexContent>
</xsd:complexType>
</xsd:element>
</xsd:schema>
File: Data.xml
<?xml version="1.0"?>
<source xmlns="http://www.wbex.ru"
sectionid="101"
newspaperid="21"/>
Restrict the data type by restricting its attributes
<?xml version="1.0"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
targetNamespace="http://www.wbex.ru" xmlns="http://www.wbex.ru"
elementFormDefault="qualified">
<xs:complexType name="tokenWithLangAndNote">
<xs:simpleContent>
<xs:extension base="xs:token">
<xs:attribute name="lang" type="xs:language" />
<xs:attribute name="note" type="xs:token" />
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:element name="title">
<xs:complexType>
<xs:simpleContent>
<xs:restriction base="tokenWithLangAndNote">
<xs:maxLength value="255" />
<xs:attribute name="lang">
<xs:simpleType>
<xs:restriction base="xs:language">
<xs:enumeration value="en" />
<xs:enumeration value="es" />
</xs:restriction>
</xs:simpleType>
</xs:attribute>
</xs:restriction>
</xs:simpleContent>
</xs:complexType>
</xs:element>
</xs:schema>
Value Constraints on Attributes
File: Data.xml
<?xml version = "1.0" ?>
<CreditAccount currency = "US$">
<AccountName>Ray Bayliss</AccountName>
<AccountNumber>27012</AccountNumber>
<Amount>200.00</Amount>
</CreditAccount>
File: Schema.xsd
<?xml version = "1.0" ?>
<schema xmlns= "http://www.w3.org/2001/XMLSchema">
<element name = "CreditAccount">
<complexType>
<sequence>
<element name = "AccountName" type = "string" />
<element name = "AccountNumber" type = "integer" />
<element name = "Amount" type = "string" />
</sequence>
<attribute name = "currency" default = "US$" />
</complexType>
</element>
</schema>
Value of an attribute is the same as the value we prescribe in the schema, whether or not the attribute is present
File: Schema.xsd
<?xml version = "1.0" ?>
<schema xmlns= "http://www.w3.org/2001/XMLSchema">
<element name = "CreditAccount">
<complexType>
<sequence>
<element name = "AccountName" type = "string" />
<element name = "AccountNumber" type = "integer" />
<element name = "Amount" type = "string" />
</sequence>
<attribute name = "currency" fixed = "US$" />
</complexType>
</element>
</schema>
File: Data.xml
<?xml version = "1.0" ?>
<CreditAccount currency = "AUS$">
<AccountName>Joe</AccountName>
<AccountNumber>2701 2202</AccountNumber>
<Amount>200.00</Amount>
</CreditAccount>