eTutor XQuery und Datalog - Data & Knowledge Engineering

30 Kapitel 3. Lösungsansatz
initialisieren. Das zweite Objekt, das bei dieser Initialisierung benötigt wird, ist
ein Objekt vom Typ etutor.modules.xquery.analysis.XQAnalysis, das das Ergebnis
einer Analyse eines XQuery-Ausdruckes darstellt.
3.2.3. Feedback
Die Klassen, die für die Aufbereitung von Analyse- und Bewertungsergebnissen
verwendet werden, befinden sich im Java-Package etutor.modules.xquery.report.
Die Informationen, die der Benutzer über die Analyse und Bewertung eines
XQuery-Ausdruckes erhält, werden von Methoden der Klasse
etutor.modules.xquery.report.XQReport geliefert. Ebenso wie im Datalog-Modul
wird das Ausmaß der Information über einen Parameter bestimmt, der Werte
annehmen kann, die in Feldern der Klasse vordefiniert sind. Die wichtigsten
Methoden werden in Tabelle 3.2 zusammengefasst.
Methode
getRenderedResult
getRawResult
getSyntaxError
getWellformednessError
s
Beschreibung
Das Ergebnis, das vom Prozessor geliefert wurde,
sofern die Musterlösung gültig und die Abgabe
syntaktisch korrekt ist und ausgewertet werden konnte;
In dieser Form wird das Ergebnis HTML-konform
formatiert, wodurch strukturelle Elemente im Ergebnis
hervorgehoben werden. Auf höchstem Diagnose-Level
werden außerdem alle Fehler direkt in diesem Ergebnis
angezeigt und als solche gekennzeichnet, was zum
Beispiel auch fehlende XML-Elemente oder –Attribute
umfasst, die an sich nicht im Ergebnis enthalten sind.
Im Gegensatz zur Methode getRenderedResult wird
hier das Ergebnis ohne Formatierungen und ohne
Kennzeichnung von fehlerhaften Stellen geliefert. Für
Hinweise auf Fehler ist man hier somit auf textuelle
Beschreibungen angewiesen.
Fehlermeldungen zu syntaktischen Fehlern im
übermittelten XQuery-Ausdruck, zu Problemen mit der
Wohlgeformtheit des Auswertungsergebnisses und zu
ungültigen Referenzen auf XML-Dokumente in doc-
Funktionen;