DummyConsole
class DummyConsole extends Console
Testklasse für Unit-Tests
Constants
UUID |
Default UUID dieser Klasse |
DEFAULTSTORAGEHANDLER |
Klassenname des Default-Handlers |
LOCATIONS_CLASS |
Klasse in der die Locations definiert sind Diese Konstante kann von abgeleiteten Klassen überschrieben werden. |
DEFAULTSTORAGEINDEXHANDLER |
Klassenname des Default-Handlers dex Indexers |
DEFAULT_NAME |
Name der Default-Konfigurationsdatei |
PLACEHOLDER_CONFIGPATH |
Mapping der Methode Alvine\Application\Assembly::getPlaceholderMap |
PLACEHOLDER_DEFAULTPATH |
Mapping der Methode Alvine\Application\Assembly::getPlaceholderMap |
PLACEHOLDER_ASSETSPATH |
Mapping der Methode Alvine\Application\Assembly::getPlaceholderMap |
PLACEHOLDER_BASEPATH |
Mapping der Methode Alvine\Application\Assembly::getPlaceholderMap |
PLACEHOLDER_LICENCEPATH |
Mapping der Methode Alvine\Application\Assembly::getPlaceholderMap |
PLACEHOLDER_DATAPATH |
Mapping der Methode Alvine\Application\Assembly::getPlaceholderMap |
PLACEHOLDER_CUSTOMISATIONPATH |
Mapping der Methode Alvine\Application\Assembly::getPlaceholderMap |
PLACEHOLDER_REPOSITORYPATH |
Mapping der Methode Alvine\Application\Assembly::getPlaceholderMap |
PLACEHOLDER_VENDORPATH |
Mapping der Methode Alvine\Application\Assembly::getPlaceholderMap |
PLACEHOLDER_RESOURCEPATH |
Mapping der Methode Alvine\Application\Assembly::getPlaceholderMap |
PLACEHOLDER_LOGPATH |
Mapping der Methode Alvine\Application\Assembly::getPlaceholderMap |
PLACEHOLDER_TEMPPATH |
Mapping der Methode Alvine\Application\Assembly::getPlaceholderMap |
PLACEHOLDER_APPLICATIONID |
Mapping der Methode Alvine\Application\Assembly::getPlaceholderMap |
PLACEHOLDER_LANGUAGE |
Mapping der Methode Alvine\Application\Assembly::getPlaceholderMap |
EXIT_OK |
Anwendung normal beendet |
EXIT_ERROR |
Allgemeiner Fehler |
EXIT_EXCEPTION |
Fehler beim Parsen |
EXIT_PARSEEXCEPTION |
Fehler beim Parsen |
EXIT_MISSINGOPTION |
Fehlende Option |
EXIT_UNSUPPORTED |
Nicht unterstützt |
EXIT_LIMITEXCEPTION |
Zuviel Optionen |
EXIT_DATASOURCEEXCEPTION |
Datenbank-Ausnahme |
Properties
protected Facility | $facility | from Assembly | |
protected Node | $configuration | from Assembly | |
static protected ObjectMap | $instance | Einzige Objektinstanz (singelton) der Anwendung | from Assembly |
protected Locations | $locations | from Assembly | |
static protected CacheManager | $cacheManager | from Assembly | |
protected View | $view | from Assembly | |
protected Examiner | $cacheExaminer | from Assembly | |
protected EventQueue> | $volatileEventQueues | from Assembly | |
protected Locale | $locale | from Assembly | |
protected Manager | $storageManager | from Assembly | |
protected SMTPClient | $defaultSmtpClient | from Assembly | |
protected ArgumentParser | $parser | from Console | |
protected Terminal | $terminal | from Console | |
protected integer | $exitCode | from Console | |
protected PropertyText | $resourceText | from Console | |
protected array | $hints | from Console |
Methods
Eventqueue für Event holen und wenn noch nicht vorhanden anlegen
Instanz ermitteln. Wird keine Instanzklasse angegeben, so wird das aktuelle Objekt in der Instanz-Map verwendet.
Kein Caching beim Testen
Standardplatzhalter der Anwendung
Diese Methode liest einen Konfigurationswert aus.
Instanz des Storage-Manager holen und Referenz in der Anwendung speichern
Ein Storageobjekt registrieren.
Handler für den entsprechenden Speichertyp
Diese Methode berechnet einen eindeutigen Wert für eine Anwendung. Da jede Anwendung nur eine Instanz haben kann, muss dieser Wert nur zu Klasse hin eindeutig sein.
Finalize deaktiviert, da die Klasse sonst nicht zu testen. Ggf besser Lösung erarbeiten
Text Zeilenweise Ausgeben
Internationalisierung
Lokalisierten Text holen
Ressourcentexte initialisieren
Details
in Console at line 128
protected
__construct(Facility $facility)
Neues Anwendugs-Objekt erstellen.
Der Konstruktor erstellt ein neues Objekt und initialisiert die Systeminstanzen für Environment, Encoding, System und Math. Außerdem wird der Anwendung ein SystemLogger und ein Mailserver zugewiesen.
in Assembly at line 257
__destruct()
Anwendung beenden
in Assembly at line 284
protected EventQueue
getEventQueue(Event $class)
Eventqueue für Event holen und wenn noch nicht vorhanden anlegen
in Assembly at line 307
Assembly
subscribeEvent(Subscriber $subscriber, string $eventClass)
Event abonnieren
in Assembly at line 320
Assembly
unsubscribeEvent(Subscriber $subscriber, string $eventClass)
Abmelden
in Assembly at line 342
bool
shouldBeCached()
Soll die Anwendung cachen
in Assembly at line 351
Locale
getLocale()
Lokale der Anwendung
in Assembly at line 386
static Assembly
execute(Facility $facility)
Programm ausführen
Die execute-Methode sucht nach der gewünschten Anwendung, erstellt ein Objekt der Anwendung, initiert dadurch die Konfiguration und ruft im Anschluß den Taskhandler auf.
Über die optinalen Parameter $namespace und $path können im ersten Aufruf die Anwendungsklassen inititalisiert werden. Bei weiteren Aufrufen, muss dies nicht mehr erfolgen. Der Namespace kann aber auch normal im AutoLoader registriert werden.
Der Task-Handler sorgt dafür, das die in der Konfiguration aufgeführten Task der Reihe nach ausgeführt werden. Durch die Flexibilität der Tasks, können in der konkreten Anwendung unterschiedliche Szenarien implementiert werden.
application.task=init
application.task=render
Über den Anwendungsmodus können bestimmte Regeln definiert werden. So wird der Anwendungscache nur im Produktivsystem aktiviert.
in Assembly at line 467
static protected Assembly
checkCompatibility(Throwable $e)
Prüpft ob die Kompatibilität eingehalten wurde.
in Assembly at line 507
static Assembly|null
getInstance(string $assemblyClass = null)
Instanz ermitteln. Wird keine Instanzklasse angegeben, so wird das aktuelle Objekt in der Instanz-Map verwendet.
Wird kein Assembly gefunden, so wird null zurückgegeben.
in Assembly at line 527
boolean|Assembly
validateInstanceCache()
Meßwerte überprüfen
Mit dieser Methode kann die Anwendung prüfen, ob die zwischengespeicherte Anwendung noch aktuell ist. Abgeleitetet Anwendungen müssen die Methode Application::initCacheExaminer() um die Werte erweitern, die für einen aktuelle Anwendung wichtig sind.
in Assembly at line 548
protected Assembly
initCacheExaminer()
Instanzprüfung inititalisieren
Abgeleitetet Anwendungen müssen diese Methode um die wichtigen Meßwerte erweitern. In dieser Implementierung wird die Konfigurationsdatei als Meßwert verwendet. Ändert sich die Konfigurationdatei, so wird der Cache für ungültig erklärt.
in Assembly at line 574
boolean
isInstanceValide()
Gültigkeit prüfen
Prüfen ob die Daten der Instanz noch gültig sind.
in Assembly at line 593
static void
refresh(string $assemblyClass)
Anwendungsklasse aktualisieren
Mit dieser Methode wird der Zwischenspeicher der Anwendungsklasse geleert. Beim nächsten Aufruf von Assembly::execute wird das Objekt für diese Klasse neu erstellt.
at line 52
static CacheManager
getCacheManager()
Kein Caching beim Testen
in Assembly at line 662
protected Assembly
loadConfig()
Konfiguration laden
Diese Methode lädt die Konfiguration der Anwendung. Je nach Dateierweiterung wird eine von \Alvine\Types\Properties abgeleitete Klasse geladen. Für die Erweiterung .properties wird ein Objekt der Klasse \Alvine\Application\Configuration\Properties erstellt, für eine Endung .txt würde die Klasse \Alvine\Application\Configuration\Text initiert werden.
in Assembly at line 718
Map
getPlaceholderMap()
Standardplatzhalter der Anwendung
Pfade {CONFIGPATH} Pfad zu den Konfigurationsdateien {DEFAULTPATH} Pfad zu den Standardwerten der Konfiguration {DATAPATH} Pfad zu den Dateien des Projekts {CUSTOMISATIONPATH} Pfad zu Anpassungen {ASSETSPATH} Pfad zu den Assets {BASEPATH} Pfad zu Hauptverzeichnis der Anwendung (muss nicht das Webroot sein) {LICENCEPATH} Pfad zu den Lizenzen {REPOSITORYPATH} Pfad zum Repository {VENDORPATH} Pfad zu Systembibliotheken {RESOURCEPATH} Pfad zu den Resourcen {TEMPPATH} Temporäres Verzeichnis des Systems {LOGPATH} Pfad zum Logverzeichnis
Anwendung {LANGUAGE} Sprache {APPLICATIONID} UUID der Anwendung
Environment {ENV:KEY} Environmentvariable $_ENV['KEY']
in Assembly at line 762
string
replaceEnvironmentPlaceholder(string $string)
Standardplatzhalter der Anwendung
in Assembly at line 784
protected string
getLocationsClass()
in Assembly at line 823
protected
initDirectories()
in Assembly at line 841
protected Assembly
initSMTPClient()
Mailclient initialisieren
Initialisierung des Standard-Mail-Clients. Die Konfiguration erfolgt über die Eigenschaften application.mail.delivery.** (siehe auch assembly.config)
application.mail.delivery.default.class Klasse, die den Versand übernimmt (von SMTPClient abgeleitet) application.mail.delivery.default.server IP, oder Hostname des Mailservers (Standard ist localhost) application.mail.delivery.default.port IP-Port des SMTP-Servers (Standard ist 25)
in Assembly at line 891
SMTPClient|null
getDefaultSmtpClient()
SMTP-Client
in Assembly at line 905
protected Assembly
initLogger()
Logging initialisieren
Inititalisierung des Standardloggers für das Logging. Die Konfiguration erfolgt über die Eigenschaften application.logging.**. Der Logger muß von der Klasse \Alvine\Util\Logging\Logger abgeleitet sein. Für die Verarbeitung können die Handler über die Konfigurationsschlüssel
in Assembly at line 958
Properties
getConfiguration()
Konfiguration zurückgeben
Liefert eine Kopie der Konfigurations. Änderungen in dem Objekt haben keine Auswirkungen auf die Anwenndung.
in Assembly at line 975
string
getConfigurationValue(string $key, string $default = null)
Diese Methode liest einen Konfigurationswert aus.
Ist der Schlüssel nicht angegeben, so wird der Default-Wert zurückgegeben.
Wird ein Teilschlüssel angegeben, so wird ebenfalls der Defaultwert zurückgegeben.
in Assembly at line 1018
protected $this
initPersistenceManager()
Instanz des Storage-Manager holen und Referenz in der Anwendung speichern
in Console at line 506
protected Assembly
initStorage()
Initialisiert die Struktur für den Objektspeicher.
in Assembly at line 1060
Assembly
initStorageIndex()
Initialisiert die Struktur für den StorageIndex.
in Assembly at line 1092
Assembly
registerStorage(string $className, ObjectStorage $storage)
Ein Storageobjekt registrieren.
in Assembly at line 1104
Assembly
unregisterStorage(string $className)
Registrierung für eine Klasse aufheben
in Assembly at line 1125
Alvine
getObject(string $className, string $id)
Objekt aus dem Storage auslesen
Diese Methode liest ein Objekt aus dem in der Konfiguration definierten Speicher aus. Der Klassenname muss mit führendem \ und vollem Namensraum angegeben werden.
in Assembly at line 1145
Subset
findObject(string $className, Query $query)
Nach einem Objekt suchen
Die Suche erfolgt in dem in der Konfiguration definierten Indexer. Der Indexer gibt eine Ergebnismenge zurück. Diese Methode holt sich die ID des Ergebnisses und verwendet die Methode getObject um das echte Objekt zu laden.
in Assembly at line 1159
protected ObjectStorage
getPersistenceHandler(string $className, string $mode)
Handler für den entsprechenden Speichertyp
in Assembly at line 1168
Manager
getStorageManager()
Storage-Manager
in Assembly at line 1182
Assembly
deleteObject(Alvine $object)
Objekt aus dem Storage löschen
Diese Methode löscht ein Objekt aus dem in der Konfiguration definierten Speicher.
in Assembly at line 1197
Assembly
writeObject(Alvine $object)
Objekt in den definierten Speicher schreiben
Das übergebene Objekt wird serialisierten und in den angegebenen Speicher geschrieben.
in Assembly at line 1212
string
getHashCode()
Diese Methode berechnet einen eindeutigen Wert für eine Anwendung. Da jede Anwendung nur eine Instanz haben kann, muss dieser Wert nur zu Klasse hin eindeutig sein.
Der Anwendungscache verwendet die ID um die Instanz der Anwendung zwischenzuspeichern. Diese Methode sollte deshalb von abgeleiteten Klassen nicht überschrieben werden.
at line 43
protected Assembly
finalize()
Finalize deaktiviert, da die Klasse sonst nicht zu testen. Ggf besser Lösung erarbeiten
in Console at line 579
protected Application
handleTasks()
Abarbeiten der in der Config definierten Tasks
in Assembly at line 1306
Directory
getCustomisationPath()
deprecated
deprecated
CustomisationPath
in Assembly at line 1317
Directory
getDataPath()
deprecated
deprecated
Daten
in Assembly at line 1328
Directory
getRepositoyPath()
deprecated
deprecated
Speicherort für Daten
in Assembly at line 1339
Directory
getVendorPath()
deprecated
deprecated
Verzeichnis für Fremdanbieterdateien aus dem Backend
in Assembly at line 1350
Directory
getLicensePath()
deprecated
deprecated
Verzeichnis mit Lizenzen
in Assembly at line 1361
Directory
getDefaultPath()
deprecated
deprecated
Verzeichnis der Konfigurationsdateien
in Assembly at line 1372
Directory
getConfigPath()
deprecated
deprecated
Verzeichnis der Konfigurationsdateien
in Assembly at line 1383
Directory
getAssetPath()
deprecated
deprecated
Assets-Verzeichnis
in Assembly at line 1394
Directory
getBasePath()
deprecated
deprecated
Basisverzeichnis
in Assembly at line 1405
Directory
getClassPath()
deprecated
deprecated
Code-Verzeichnis
in Assembly at line 1416
Directory
getLogPath()
deprecated
deprecated
Verzeichnis für Logdateien
in Assembly at line 1427
Directory
getResourcePath()
deprecated
deprecated
Verzeichnis mit Resourcen
in Assembly at line 1454
File
getResourceFile(string $filename)
Resourcen-Datei-Objekt zurückgeben
Die Methode sucht entweder im Resourcen-Verzeichnis der Anwendung oder im Absoluten-Pfad nach der Resourcen-Datei. Ist der Dateiname eine http-Resource so wird die Datei geladen und in eine temporäre Datei gespeichert. Dieses Dateiobjekt wird zurückgegeben.
// Temporäre Datei mit dme Inhalt von www.example.com
$this->getResourceFile('http://www.example.com/');
// Absolute Datei auf einem Windows-System
$this->getResourceFile('file://c:\temp\myfile.txt');
// Absolute Datei auf einem Unix-System (ohne file://)
$this->getResourceFile('/tmp/myfile.txt');
// Absolute Datei auf einem Unix-System (mit file://)
$this->getResourceFile('file:///tmp/myfile.txt');
in Console at line 220
integer
getExitCode()
Exitcode
in Console at line 230
static ArrayHelper
getCallArguments()
in Console at line 265
Console
writeLine(string $text, Color $foreground = null, Color $background = null)
Text Zeilenweise Ausgeben
in Console at line 445
string
replaceI18N(string $content, string $quoteCharList = null)
Internationalisierung
Die Platzhalter müssen mit i18n anfangen:
i18n{mykeytoreplace}
Die Eigenschaft muss dann mit dem Schlüssel angelegt werden:
mykeytoreplace=Text
In der Anwendungskonfiguration kann der Schlüssel application.web.i18n.showkeys auf true gesetzt werden.
Wird die Zeichenkette $quoteCharList übergeben, so werden alle Zeichen die darin enthalten sind mit einem Backslash versehen. Diese Funktion verwendet die PHP Version \addcslashes
in Console at line 493
string
getText(string $text, string $default = null, string $pluralKey = null)
Lokalisierten Text holen
Beispiele wenn der Schlüssel nicht gefunden wird:
// Lokalisierung mit Default-Wert
Presenter::getText('my.key::name=Hans', 'Hallo!');
-> Hallo!
// Wird kein Default übergeben wird der Schlüssel ausgegeben
Presenter::getText('my.key::name=Hans');
-> my.key::name=Hans
in Console at line 525
DefaultPresenter
initResourceText(string $resource = null, Directory $basepath = null)
Ressourcentexte initialisieren
in Console at line 568
ArgumentParser
getParser()
in Console at line 647
Console
run()
Anwendung ausführen
Werden keine oder die falschen Argumente übergeben, so gibt die Methode den Hilfstext, der durch die Befehle definiert wurde zurück.