Controller: Modul-Views #

Diese Seite richtet sich an Entwickler, die Controller schreiben. In Exponential ist die Einheit, die eine Adresse bearbeitet, eine View eines Moduls. Klassische Views sind PHP-Skripte, die der Kernel mit gesetztem $Params und $Module einbindet; seit 6.0.15 schreiben Sie eine View am besten als Klasse, die Exponential\Runnable\ModuleView erweitert, mit einem einzeiligen Skript, das sie aufruft (Befehle, Cronjob-Teile und Modul-Views als Klassen).

Inhalt #

1. Controller und View nebeneinander
2. Die Skriptform
3. Die Klassenform
4. Schlank bleiben
5. Vor und nach der View
6. Eine Kernel-View ändern

Controller und View nebeneinander #

Die Skriptform #

<?php
// extension/expdemo/modules/expdemo/item.php
$Module = $Params['Module'];
$item = expDemoItem::fetch( (int)$Params['ItemID'] );
if ( !$item )
    return $Module->handleError( eZError::KERNEL_NOT_FOUND, 'kernel' );

$tpl = eZTemplate::factory();
$tpl->setVariable( 'item', $item );

$Result = array();
$Result['content'] = $tpl->fetch( 'design:expdemo/item.tpl' );
$Result['path'] = array( array( 'text' => 'Items', 'url' => 'expdemo/list' ),
                         array( 'text' => $item->attribute( 'title' ), 'url' => false ) );

expDemoItem::fetch() steht für eine statische Methode Ihrer eigenen Persistent-Object-Klasse (ORM: eZPersistentObject). Die Schlüssel des Ergebnisses werden unter Responses, Weiterleitungen, Fehler und JSON erklärt.

Die Klassenform #

Aus Eine Modul-View:

<?php
// extension/myext/classes/runnable/views/report/show.php
namespace Exponential\View\Extension\Myext\Report;

class Show extends \Exponential\Runnable\ModuleView
{
    public function run( array $scope )
    {
        $Module = $scope['Params']['Module'];
        $tpl = \eZTemplate::factory();
        $tpl->setVariable( 'report', \myReportService::build( $scope['Params']['Month'] ) );
        return array( 'content' => $tpl->fetch( 'design:report/show.tpl' ),
                      'path' => array( array( 'text' => 'Report', 'url' => false ) ) );
    }
}

<?php
// extension/myext/modules/report/show.php (named in module.php ViewList as before)
return \Exponential\View\Extension\Myext\Report\Show::main( __FILE__, get_defined_vars() );

Die Klasse lässt sich mit Unit-Tests prüfen, durch Ereignisse umschließen und über Einstellungen neu implementieren. Denken Sie daran, nach dem Hinzufügen der Klasse die Autoloads der Erweiterungen neu zu erzeugen (php bin/php/ezpgenerateautoloads.php -e).

Schlank bleiben #

Der Kernel selbst legt Arbeit, die sich eine View, ein Befehl und ein Cronjob-Teil teilen, in Dienstklassen ab, zum Beispiel Exponential\Service\Trash für die Papierkorb-View, bin/php/trashpurge.php und den Cronjob-Teil trashpurge (Dienste). Machen Sie es genauso: Eingaben in der View einlesen und prüfen, für die eigentliche Arbeit eine einfache Klasse aufrufen, das Ergebnis rendern. Diese einfache Klasse testen Sie ohne Datenbank (Testen).

Vor und nach der View #

Jede klassenbasierte View läuft zwischen zwei Ereignissen: runnable/view/before (Benachrichtigung) und runnable/view/after (ein Filter, der das Ergebnis erhält und zurückgeben muss). Registrieren Sie Listener in site.ini [RunnableSettings] Listeners[]. Das kommt Interceptors auf Controller-Ebene wie dem HandlerInterceptor von Spring oder einem Symfony-Listener für kernel.controller am nächsten (Ereignisse und Listener).

Eine Kernel-View ändern #

# settings/override/site.ini.append.php, or an extension's settings/site.ini.append.php
[RunnableSettings]
Implementation[Exponential\View\Kernel\Content\History]=myHistoryView

Keine Kernel-Datei wird kopiert, sodass das nächste Release das Original unter Ihrer Unterklasse aktualisiert.

Verwandte Seiten #

• Eigene Module und Views
• Routing: Module, Views und Parameter
• Templates für Modul-Views
• Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.