330 likes | 537 Views
Geoinformatics. XML – Part III. The < complexType > Element …. This type of element either has the element content or the mixed content (child element and data) The attributes of the < complexType > element include: ‘ id ’, which provides a unique id for the element
E N D
Geoinformatics XML – Part III
The <complexType> Element … • This type of element either has the element content or the mixed content (child element and data) The attributes of the <complexType> element include: ‘id’, which provides a unique id for the element ‘mixed’, a Boolean that indicates whether the element has a mixed content or not (the default value is false), and ‘name’, which gives a name to the element
complexType’s children elements • The children elements of the <complexType> element can be: <simpleContent><complexContent><all><group><sequence>
simpleContent … • The simpleContent allows the complexType element to have leaf nodes of character data, without any child element • The content of a simpleContent element must either be:extension or restriction of an existing built in or derived datatypes • As an example for using extension, we can make a complexType element called RockName by extending the built in string datatype in the simpleContent element • The RockName element (next slide) can only have character data as its value
complexType by simpleContent by extension <xs:element name="RockName"> <xs:complexType><xs:simpleContent><xs:extension base="xs:string"/> </xs:simpleContent> </xs:complexType></xs:element>
complextype by simpleContent by restriction • As an example for using a restriction in the simpleContent of a complexType, we can define the complexType called CelciusTemperatureby restricting the xs:decimal number to have a minimum value of -273.15 oC <xs:element name="CelciusTemperature"> <xs:complexType><xs:simpleContent><xs:restriction base="xs:decimal"/> <minInclusive value="-273.15"/> </xs:simpleContent> </xs:complexType></xs:element>
complexType with complexContent • The complexType element with complexContent can be built by adding element content, or a combination of child elements and character data, i.e., mixed content • This is done by defining a list of elements and attributes • The following is an example of a complexType element called MineralInfowith an element content, using the <xs:sequence> which defines the order that the child element should appear • Note that in this example, there is no need to have the <xs:complexContent> element at all. We can just put the <xs:sequence> in the <xs:compleType>
complexType w/ element content <?xml version="1.0" encoding="UTF-8"?><xs:schemaxmlns:xs="http://www.w3.org/2001/XMLSchema"> <xs:element name="MineralInfo"><xs:complextype> < !-- <xs:complexContent> --><xs:sequence> <xs:element name="name"/> <xs:element name="type"/> <xs:element name="composition"/> <xs:element name="hardness"/> <!-- other physical and chem. properties --> </xs:sequence> < !-- </xs:complexContent> --> </xs:complextype> </xs:element></xs:schema>
Mixed content • We can now build a mineralogy element whose type is MineralInfo. <xs:elementname=”Mineralogy” type=”MineralInfo”/> • To build a mixed content <complexType> element we set the ‘mixed’ attribute of the <complexType> element to ‘true’ • This allows us to add text nodes before, between, and after the child nodes • In the following, we define a Rock element that allows writing the description of the rock in text, anywhere in the document
Example of mixed content <xs:element name="Rock"><xs:complexTypemixed=”true”> <xs:sequence> < !-- assume MineralInfo is already declared --> <xs:element name="Mineralogy" type="MineralInfo"/> <xs:element name="type"/> </xs:sequence> </xs:complexType></xs:element>
<xs:sequence> • The <xs:sequence> element provides a mandatory order to the sequence of elements in a complex type. • For example, to force the dip to follow the strike of a planar structure, we can use the sequence element to do just that <xs:element name="PlanarAttitude"> <xs:complexType><xs:sequence> <xs:element name="Strike" type="xs:string"/> <xs:element name="Dip" type="xs:string"/></xs:sequence> </xs:complexType></xs:element>
Let’s say that some geologists provide dip direction and dip amount, instead of strike and dip for a planar feature, and we want to give them this option to enter their data. We do it as follows: <xs:element name="PlanarAttitude"> <xs:complexType> <xs:group> <xs:sequence> <! -- defines a group containing a choice of two sequences-- ><xs:group><xs:choice><xs:sequence> <xs:element name="Strike" type="xs:string"/> <xs:element name="Dip" type="xs:string"/> </xs:sequence><xs:sequence> <xs:element name="DipDirection" type="xs:string"/> <xs:element name="DipAmount" type="xs:string"/> </xs:sequence></xs:choice> </xs:group> </xs:sequence> </xs:group> </xs:complexType></xs:element>
XML instance document • Because of the choice, we may have either one of the following in an instance document: <PlanarAttitude> <Strike> N30E </Strike> <Dip> 65SE </Dip></PlanarAttitude> or <PlanarAttitude> <DipDirection> S60E </DipDirection> <DipAmount> 65 </DipAmount></PlanarAttitude>
<xs:all> • In contrast to the <xs:sequence> element, the <xs:all> element does not put any restriction on the ordering of its sub-elements • However, the <xs:all> element must be at the top-level, and cannot contain, or be part of, a sequence or a choice • For example, we can define the ‘Structure’ element to have a set of elements in any order • This means that an instance document can have any of the Name, Type, and Attitude listed in any order
Example for <xs:all> <?xml version="1.0" encoding="UTF-8"?><xs:schemaxmlns:xs="http://www.w3.org/2001/XMLSchema"><xs:element name=“Structure"><xs:complexType><xs:all> <xs:element name="Name"/> <xs:element name="Type"/> <xs:element name="Attitude"/></xs:all> </xs:complexType></xs:element></xs:schema>
Attributes • In W3C XSD schema, the attributes are declared with the <xs:attribute> element, which has its own attributes • Local attributes can be declared within a certain element, as opposed to those that have a global scope, which are declared in the <schema> element, and that could be used by any element or attribute group • For example, we can define the local ‘TemperatureType’ attribute for the Temperature element, to indicate the type of the temperature system (Celcius, Farenheit, etc.) • This attribute can only be referenced by instances of the Temperature element
Local attribute <?xml version="1.0" encoding="UTF-8"?><xs:schemaxmlns:xs="http://www.w3.org/2001/XMLSchema"><xs:element name="Temperature"> <xs:complexType><xs:attribute name="TemperatureType"/> </xs:complexType></xs:element></xs:schema>
Attributes of the <xs:attribute> • The attribute element has several attributes of its own, and include name, type, default, fixed, id, ref, and use: • The ‘name’ attribute of the <attribute> element specifies the name for the attribute, which needs to be a valid XML name, e.g., <attribute name=”color” type=”xs:string”/> • Notice that the type for the attribute is given by the W3C XSD string datatype • We can have two attributes with the same name only if their type is different, and defined in different content (one for an element, and the other as an attribute)
The ‘type’ attribute specifies the simple built-in or derived (i.e., restriction of simple types) datatype for the attribute in the instance document • These datatypes include (there are many more): boolean, integer, decimal, float, date, time, and string. • Contrary to the elements, attributes cannot have complex types
The ‘default’ attribute of the <attribute> element assigns a preset value to the attribute if no value is given in the instance document • For example, we can define an attribute for kink bands to specify their straight limb and angular hinge as follows: <xs:attribute name="style" default="straight limb, angular hinge"/> • Or, we can define the sample attribute with a default value of ‘rock’ as follows: <xs:attribute name=”sample” default=”rock” type=”xs:string”/> • In this case, if not specified, the sample type will be assigned to ‘rock’. Note: there might be other sample types: water, soil, etc.
If we want the value of an attribute not to change, we use the ‘fixed’ attribute • For example, if we want the formula for quartz to always be SiO2, we can fix it as follows: <xs:attribute name=”quartzFormula” fixed=”SiO2”/>
The id attribute specifies a unique identifier for the attribute • The id can then be referenced by other elements • Notice that an attribute can also be referenced by its name • The ref attributes allows referencing another attribute • For example, let’s say we have a complexType aquifer element, which has two types: confined and unconfined, each with its own set of attributes that are of type ref, which reference the porosity and permeability attributes • Notice that the references to the porosity and permeability attributes are global because they are declared in the schema element before the porosity and permeability are declared
<?xml version="1.0" encoding="UTF-8"?><xs:schemaxmlns:xs="http://www.w3.org/2001/XMLSchema"> <xs:element name="Aquifer"> <xs:complexType> <xs:sequence> <xs:element name="ConfinedAquifer"> <xs:complexType mixed="true"> <xs:attributeref="porosity"/> <xs:attributeref="permeability"/> </xs:complexType> </xs:element> <xs:element name="UnConfinedAquifer"> <xs:complexType mixed="true"> <xs:attributeref="porosity"/> <xs:attributeref="permeability"/> </xs:complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:element> <!- - These attributes are global; defined in the schema - - > <xs:attribute name=“porosity" type="xs:string"/> <xs:attribute name=“permeability" type="xs:string"/></xs:schema>
The ‘use’ attribute specifies the usage of the <xs:attribute> with its own ‘optional’, ‘prohibited’, and ‘required’ attributes • The default value for the ‘use’ attribute, when none of these is defined, is ‘optional’ • Contrary to the ‘required’ value, which specifies that the attribute must be present, the prohibited value indicates that the attributes should not be used at all • In addition to the ref attribute which allows referencing and reuse of attributes, we can structure and reference a group of attributes by the <attributeGroup> • For example, we can structure information about folds in a group called FoldInfo, and then reference it with the name of the group in an element called Measurement
<?xml version="1.0" encoding="UTF-8"?><xs:schemaxmlns:xs="http://www.w3.org/2001/XMLSchema"><xs:attributeGroup name="FoldfInfo"> <xs:attribute name="hingeline" use="optional" type="xs:string"/> <xs:attribute name="axis" use="optional" type="xs:string"/> <xs:attribute name="axialPlane" type="xs:string"/> <xs:attribute name="limb1" use="required" type="xs:string"/> <xs:attribute name="limb2" use="required" type="xs:string"/> <xs:attribute name="limb3" use="optional" type="xs:string"/> <xs:attribute name="limb4" use="optional" type="xs:string"/> <xs:attribute name="axialTrace" type="xs:string"/> </xs:attributeGroup> <xs:element name="Measurement"> <xs:complexType> <xs:sequence> <xs:element name="Fold"> <xs:complexType><xs:attributeGroupref="FoldfInfo"/> </xs:complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:element></xs:schema>
Enumerations • Enumeration is a list of options that a user can select from • For example, we can enumerate the exhaustive list of the types for minerals • We define an attribute called mineralType that has an enumeration of the mineral types • We then reference this attribute in the Mineral element • Notice that enumeration is a restriction of a simpleType
<?xml version="1.0" encoding="UTF-8"?><xs:schemaxmlns:xs="http://www.w3.org/2001/XMLSchema"><xs:attribute name="mineralType"> <xs:simpleType> <xs:restriction base="xs:string"><xs:enumeration value="silicate"/> <xs:enumeration value="carbonte"/> <xs:enumeration value="oxide"/> <xs:enumeration value="hydroxide"/> <!-- other types of minerals --> </xs:restriction> </xs:simpleType> </xs:attribute> <xs:element name="Mineral"> <xs:complexType><xs:attributeref="mineralType"/> </xs:complexType> </xs:element></xs:schema>
Linking XSD schemas with instance documents • The XML processor that manipulates an instance documents uses a special namespace that carries information on identifying the location and type of the associated schema • The namespace URI for the instance document:http://www.w3.org/2001/XMLSchema-instance • This has the xsi prefix (Note: ‘i’ stands for ‘instance’). • The xsi namespace has four attributes: • xsi:type, xsi:nil, xsi:schemaLocation, and xsi:noNamespaceSchemaLocation
The xsi:type attribute assigns a type to the instance of specific elements in the document • The xsi:nil takes a Boolean value to indicate that an empty element is valid • The xsi:schemaLocation specifies the location of the XSD schema for the document, with two URIs: • the targetNamespace for the schema • the URI that points to the location of the schema • The xsi:noNamespaceSchemaLocation is used to locate schemas (similar to the xsi:schemaLocation) that have no namespace
For example, assume that we want to make an instance document from the following schema which has a Structure root element, with three elements of string type <?xml version="1.0" encoding="UTF-8"?> <xs:schemaxmlns:xs="http://www.w3.org/2001/XMLSchema"xmlns="http://www.gsu.edu/xml/struc/structure"> <xs:element name=“Structure"> <xs:complexType> <xs:all> <xs:element name="Name" type="xs:string"/> <xs:element name="Type" type="xs:string"/> <xs:element name="Attitude" type="xs:string"/> </xs:all> </xs:complexType> </xs:element> </xs:schema>
A valid instance document based on the schema on the previous slide would look like the following: <?xml version="1.0" encoding="UTF-8"?><Structure xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:noNamespaceSchemaLocation="file:/C:/Users/HAB/Desktop /Structure.xsd"> <Name> Brevard </Name> <Type> Fault </Type> <Attitude> 045, 30NW </Attitude></Structure>
XSL Transformation • Well-formed XML documents (i.e., those having a valid XML syntax) can be viewed with an XML document reader, such as the Internet Explorer (by double-clicking the file in the Windows Explorer) • Although, very useful, rendering the XML document in a browser shows all the tags, and looks very cluttered. • Because XML concentrates on document structure and not presentation, it has the XSL (XML Stylesheet Language) standard which allows manipulation of the XML documents, and their controlled display on XML browsers or editors
XSL allows rendering the XML content into HTML, or tabular and other formats. • XSL is a more sophisticated XML styling language, using a scripting language XSLT), compared to CSS (Cascading Style Sheets) which was originally designed for HTML • Both have rules for say font size and color that are applied or associated to an XML document.