Engine

Neue Instanz erstellen

Setzt den Prefix

Um Kollisionen mit anderen Attributen zu vermeiden, kann man statt des Standard-Attributes data- einen eigenen Prefix z.B. data-my- setzen.

CacheManager setzen

Standardmässig werden die Markups-Attribute entfernt. Über diese Methode kann das Verhalten geändert werden.

wird die removeMarkup auf false gesetzt bleiben die Attribute erhalten.

Diese Methode liefert die Einstellung der Engine in Bezug auf das Entfernen von Attributen zurück.

Aufgetretenen Fehler melden

Fehlermeldungen der Engine

Der Prefix, der in der HTML-Datei für die Markup-Operationen verwendet wird.

Dataset setzen

Verwendetes Dataset

Elemente bearbeiten

Hinweis Die Klassennamen der Operations dürfen nicht CamelCase sein, da diese sonst auf Unix-Systemen nicht gefunden werden.

Diese Methode liefert je nach Typ des Parameters eine Liste mit Nodes oder eine Node zurück.

Im Fall eines Objektes vom Typ Document, Fragment oder bei einer Zeichenkette wird eine NodeList zurückgegeben. In dem Fall in dem der Parameter vom Type Node ist, wird auch nur eine Node und keine Nodelist zurückgegeben.

Zum Zwecke des Cachings wird der MD5 des Parameters md5((string)$html) gebildet. Liegt im Cache bereits eine Nodestruktur vor, so wird diese genommen und nicht eine neue Struktur aufgebaut. Diese Funktion benötigt einen gesetzten Cachmanager.

Diese Methode holt über die Methode Engine::getNodes() die Node-Struktur des Parameters und wendet auf diese das gesetzte Dataset an. Die Node-Struktur wird dabei gecached (siehe Engine::getNodes()).

Es findet kein gesondertes Caching des Ergebnisses wie bei Engine::getHTML() statt. Soll das Ergebnis gecachet werden, so muss dies zum Beispiel über folgende Struktur erfolgen.

``` $fullCached=null; try { $cacheObject=new \Alvine\Markup\Html\CacheObject((string) $html.(string) $dataset); $nodes=$cacheManager->getObjectByID($cacheObject->getID())->getPayload(); } catch(\Alvine\Persistence\ObjectNotFoundException $e) { $nodes=$engine->getProcessedNodes($html); $cacheObject->setPayload($nodes); $cacheManager->writeObject($cacheObject); }

Debugnode setzen

HTML parsen und das Ergebnis als Zeichenkette zurückgeben. Diese Methode ruft Engine::getProcessedNodes() auf.

WICHTIG: Bei der Verwendung des Cachemanagers muss darauf geachtet werden, dass das Dataset keine veränderlichen Daten wie Session-ID oder Datumsangaben enthält! Diese Daten erlauben kein Caching.