7. XML forrásának megtekintése

__TOC__
==7.1. Általános==

* jól formált
* opcionális fejléc, gyökérelem, nyitó-záró tag
* valid: megfelel a sémának (DTD/XSD)

==7.2. XSD==
===gyökérelem===

* &lt;xs:schema&gt;...&lt;/xs:schema&gt;
* xmlns:xs="http://www.w3.org/2001/XMLSchema" adattípusok definíciójának névtere
* targetNamespace="http://www.w3schools.com" elemek névtere
* xmlns="http://www.w3schools.com" alapértelmezett névtér
* elementFormDefault="qualified" kötelező a névteret kiírni

===általános szerkezet===

<pre>
<!-- beépített típusok -->
xs:string, xs:decimal, xs:integer, xs:boolean, xs:date, xs:time

<!-- egyszerű elem -->
<xs:element name="xxx" type="xs:string" [default="zzz" | fix="qqq"]/>

<!-- attribútum -->
<xs:attribute name="xxx" type="xs:string" [default="zzz" | fix="qqq"] [use="required"]/>

<!-- egyszerű típusdefiníció -->
<xs:simpleType>
  <xs:restriction base="xs:string">
	 <xs:length value="8"/>
  </xs:restriction>
</xs:simpleType>
megkötések: totalDigits, fractionDigits, enumeration, length, minLength, maxLength, pattern...

<!-- összetett típusdefiníció -->
<xs:complexType name="personinfo">
  <xs:sequence>
	 <xs:element name="firstname" type="xs:string"/>
	 <xs:element name="lastname" type="xs:string"/>
  </xs:sequence>
</xs:complexType>

<!-- öröklés -->
<xs:complexType name="fullpersoninfo">
  <xs:complexContent>
	 <xs:extension base="personinfo">
		<xs:sequence>
		  ... <!-- új elemek -->
		</xs:sequence>
	 </xs:extension>
  </xs:complexContent>
</xs:complexType>
</pre>

===Indikátorok===

* Sorrend: all, choice, sequence
* Gyakoriság: maxOccurs, minOccurs
* Csoportosítás: &lt;group&gt;, &lt;attributeGroup&gt; (pár element/attribute összefogása, de nem típusként)

===helyettesítés===

* használhatjuk az eredeti és az új nevet is
<pre>
<xs:element name="name" type="xs:string"/>
<xs:element name="név" substitutionGroup="name"/>
</pre>

===hivatkozás XML-ből XSD-re===

<pre>
<note xmlns=http://www.w3schools.com
		xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance
		xsi:schemaLocation="http://www.w3schools.com note.xsd">
<!-- XML adatok -->
</note>
</pre>

==7.3. XPath==
* adott nevű csomópont gyerekei: csomópontnév
* gyökérelem: /
* az aktuális elemtől választ, mindegy, hogy milyen mélyen: //node
* aktuális elem: . 
* az aktuális elem szülője: ..
* attribútum: @attr 
* bármely elem: *
* bármely attribútum: @*
* index, vagy feltétel elemre, attribútumra, vagy függvény: [feltétel]
** csomópont kiválasztás: node()
** szöveg csomópont kiválasztás: text()

===ágak (hosszú név)===

* self
* attribute
* parent
* child
* ancestor / ancestor-or-self - összes ős
* descendant / descendant-or-self - összes leszármazott
* following / preceding - minden utána/előtte lévő elem
* following-sibling / preceding-sibling - minden utána/előtte lévő testvérelem
* namespace - elem összes névtere

===rövidítés (kettő megegyezik)===

* child::A/descendant-orself::node()/child::B[position()=1]
* A//B/*[1]

===operátorok===

* aritmetikai: + - / * div mod
* logikai: and or
* relációs: = != &lt; &lt;= &gt; &gt;=
* únió: |
|}

===függvények (csak pl)===

* fn:round(num)
* fn:substring(string,start,len)
* fn:current-time()

==7.4. XSLT sablon==

<pre>
<!-- XSLT hozzárendelése XML-hez -->
<?xml-stylesheet type="text/xsl" href="test1.xsl"?>

<!-- gyökérelemre illesztés -->
<xsl:template match="/">
  ...
  <!-- felsorolás -->
  <xsl:for-each select="neptun/student[average>'3.0']">
	 <!-- rendezés -->
	 <xsl:sort select="name"/>
	 ...
	 <!-- elem érték -->
	 <xsl:value-of select="name"/>
	 <xsl:value-of select="id"/>
  </xsl:for-each>

  <!-- feltétel (nincs else ág)-->
  <xsl:if test="average<2.0">...</xsl:if>

  <!-- többszörös elágazás -->
  <xsl:choose>
	 <xsl:when test="...">...</xsl:when>
	 <xsl:when test="...">...</xsl:when>
	 <xsl:otherwise>...</xsl:otherwise>
  </xsl:choose>
</xsl:template>

<!-- sablon alkalmazása (előzőleg definiálni kell!) -->
<xsl:apply-templates select="id"/> 

</pre>

==7.5. Simple API for XML (SAX)==

* parser alapú, soros feldolgozással
* állapotfüggetlen
* eseményvezérelt (Callback pattern!)

===org.xml.sax.ContentHandler interfész===

* throws [[SAXException]]
* void startDocument() -&gt; void endDocument()
* void startElement(String namespaceURI, String sName, String qName, Attributes attrs) -&gt; void endElement()
* void startPrefixMapping(...) -&gt; void endPrefixMapping(...)
* void characters(char[] ch, int start, int length)
* void ignorableWhiteSpace(...)
* void processingInstruction(...)
* void skippedEntity(...)
* void setDocumentLocator(...)
* üres megvalósítás: org.xml.sax.helpers.DefaultHandler

===Locator===

* lekérdezhető vele a parser aktuális pozíciója (sor/oszlop)

===hibakezelés===

* fatal error: nem jólformált XML (syntax error)
* error: nem valid (nem illeszkedik a sémára)
* warning: egyéb gányság (kétszeres típus)

==7.6. Document Object Model (DOM)==
===7.6.1. DOM általánosan===
====Document====

* dokumentumot reprezentáló node
* lekérdezhető adatok: doctype, verzió, kódolás, stb
* elemeket tud gyártani

====Node====

* egy elemet reprezentál
* lekérdezhető, módosítható adatok: érték, típus, attribútumok
* navigálás: lefelé (gyerekek), felfelé (szülők), oldalra (testvérek)
* gyerekeket módosíthatjuk, hozzáadhatunk, elvehetünk
	 * lekérdezéskor [[NodeList]] kollekcióban kapjuk vissza őket

====NamedNodeMap====

* Node elérésében segít
* NamedNodeMap Node.getAttributes()
* Node get/set/removeNamedItem(String name)
* Node get/set/removeNamedItemNS(String namespaceURI, String localName)

===7.6.2. JDOM===

* Java-s szemléletű DOM API
* List-et használ NamedNodeMap, [[NodeList]] helyett
* szűrők: org.jdom.filter.Filter
* XSL támogatás: org.jdom.transform.XSLTranformer
* XPath: org.jdom.xpath.XPath
* beolvasás külső segítséggel: [[DOMBuilder]] vagy [[SAXBuilder]]

-- [[MeszegetoBalazsIstvan|MeszegetoBalazsIstvan]] - 2008.05.27.

-- [[PallosTamas|Velias]] - 2009.05.27.


[[Category:Infoszak]]