/**
* The application selector class.
*
- * Please remember that this include file is being loaded *before* the class
- * loader is loading classes from "exceptions", "interfaces" and "main"!
- *
- * @author Roland Haeder <webmaster@ship-simu.org>
+ * @author Roland Haeder <webmaster@shipsimu.org>
* @version 0.0.0
- * @copyright Copyright (c) 2007, 2008 Roland Haeder, this is free software
+ * @copyright Copyright (c) 2007, 2008 Roland Haeder, 2009 Ship-Simu Developer Team
* @license GNU GPL 3.0 or any newer version
- * @link http://www.ship-simu.org
+ * @link http://www.shipsimu.org
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
*/
private $loadedTemplates = null;
- /**
- * The application selector's own template engine handler
- */
- private $selectorTplEngine = null;
-
/**
* A list of items we shall ignore while reading from directories
*/
// Call parent constructor
parent::__construct(__CLASS__);
- // Set description
- $this->setObjectDescription("Applikationswechsler");
-
- // Create unique ID number
- $this->generateUniqueId();
-
- // Remove system array and thousand seperator
- $this->removeSystemArray();
- $this->removeNumberFormaters();
-
// Initialize the array lists
$this->initializeAppsList();
$this->initializeTemplatesList();
/**
* Create a prepared instance of ApplicationSelector
*
- * @param $langInstance The language sub-system: LanguageSystem
- * @param $fileIOInstance The file I/O instance
- * @return $selInstance An instance of ApplicationSelector
+ * @param $langInstance The language sub-system: LanguageSystem
+ * @param $fileIOInstance The file I/O instance
+ * @return $selInstance An instance of ApplicationSelector
*/
public final static function createApplicationSelector (ManageableLanguage $langInstance, FileIoHandler $fileIOInstance) {
// Get a new instance
}
/**
- * Load the init.php script of an application and append the application
+ * Load the data.php script of an application and append the application
* instance to $foundApps
*
- * @param $initScript The FQFN of init.php
- * @param $appName The application's Uni* name
+ * @param $appData The FQFN of data.php
+ * @param $appName The application's Uni* name
* @return void
*/
- private function loadInitScript ($initScript, $appName) {
+ private function loadApplicationData ($appData, $appName) {
// Is it a file and readable?
- if ((is_file($initScript)) && (is_readable($initScript))) {
+ if ((is_file($appData)) && (is_readable($appData))) {
// Then include it
- include ($initScript);
+ include ($appData);
// Add the current instance to the list
$this->foundApps->append($app);
-
- } // END - if ((is_file(...
- }
-
- /**
- * Setter for the selector's template engine instance
- *
- * @param $tplEngine An instance of TemplateEngine
- */
- private final function setSelectorTemplateEngine (CompileableTemplate $tplEngine) {
- $this->selectorTplEngine = $tplEngine;
- }
-
- /**
- * Getter for the selector's template engine instance
- *
- * @return $selectTplEngine The selector's template engine
- */
- private final function getSelectorTemplateEngine () {
- return $this->selectorTplEngine;
+ } ((is_file(...
}
/**
}
/**
- * Method for compatiblity with prepareTemplateEngine()
+ * Method for compatiblity with prepareTemplateInstance()
*
* @return $shortName This selector's short name
*/
public function getAppShortName() {
- $shortName = $this->getConfigInstance()->readConfig('selector_path');
+ $shortName = $this->getConfigInstance()->getConfigEntry('selector_path');
return $shortName;
}
*/
public function addDirIgnoreList ($ignoreItem) {
// Cast and add it
- $ignoreItem = (string) $ignoreItem;
- $this->dirIgnoreList[] = $ignoreItem;
+ $this->dirIgnoreList[] = (string) $ignoreItem;
}
/**
*/
public function readApplicationDirectory () {
// Generate the base path for all applications
- $appBasePath = sprintf("%s%s/",
- PATH,
- $this->getConfigInstance()->readConfig('application_path')
- );
+ $appBasePath = $this->getConfigInstance()->getConfigEntry('application_path');
// Add the selector path to the ignore list
- $this->addDirIgnoreList($this->getConfigInstance()->readConfig('selector_path'));
+ $this->addDirIgnoreList($this->getConfigInstance()->getConfigEntry('selector_path'));
// Get a directory pointer for the application path
$dirInstance = FrameworkDirectoryPointer::createFrameworkDirectoryPointer($appBasePath);
- // Backup and remove the 'app' from global name space
- /*$appBackup = $app;
- unset($app);*/
-
// Read all directories&files except some parts
while ($appName = $dirInstance->readDirectoryExcept($this->dirIgnoreList)) {
// Generate FQFN for the application name (or better directory name)
// Is this a readable directory? (files will be ignored silently)
if ((is_dir($fqfn)) && (is_readable($fqfn))) {
- // Then get the init.php script for analyzing
- $initScript = sprintf("%s/init%s", $fqfn, $this->getConfigInstance()->readConfig('php_extension'));
+ // Then get the data.php script for analyzing
+ $appData = sprintf("%s/data.php", $fqfn);
- // Load the application's init.php script and append the
+ // Load the application's data.php script and append the
// application to the ArrayObject
- $this->loadInitScript($initScript, $appName);
-
- } // END - if ((is_dir(...
-
+ $this->loadApplicationData($appData, $appName);
+ }
} // END - while
// Close directory pointer
$dirInstance->closeDirectory();
-
- // Restore old 'app' from backup
- //$app = $appBackup;
}
/**
*/
public function loadApplicationTemplates () {
// Iterate through all applications
- for ($idx = $this->foundApps->getIterator(); $idx->valid(); $idx->next()) {
+ for ($iteratorInstance = $this->foundApps->getIterator(); $iteratorInstance->valid(); $iteratorInstance->next()) {
// Get current application
- $appInstance = $idx->current();
+ $appInstance = $iteratorInstance->current();
// Prepare the template engine for the current template
- $tplEngine = $this->prepareTemplateEngine($appInstance);
+ $templateInstance = $this->prepareTemplateInstance($appInstance);
// Try to load the web template
- $tplEngine->loadWebTemplate(sprintf("%s_%s",
- $this->getConfigInstance()->readConfig('tpl_selector_prefix'),
+ $templateInstance->loadHtmlTemplate(sprintf('%s_%s',
+ $this->getConfigInstance()->getConfigEntry('tpl_selector_prefix'),
strtolower($appInstance->getAppShortName())
));
// Remember this template and the application for later usage
$this->loadedTemplates->append(array(
- 'template_class' => $tplEngine,
+ 'web_template_class' => $templateInstance,
'app_instance' => $appInstance
));
}
*/
public function loadSelectorTemplate () {
// Prepare the template engine
- $tplEngine = $this->prepareTemplateEngine($this);
+ $templateInstance = $this->prepareTemplateInstance($this);
// Load the selector's template
- $tplEngine->loadCodeTemplate($this->getConfigInstance()->readConfig('selector_main_tpl'));
+ $templateInstance->loadCodeTemplate($this->getConfigInstance()->getConfigEntry('selector_main_tpl'));
- // Now store it in the class
- $this->setSelectorTemplateEngine($tplEngine);
+ // Now store it in the class, we need this later on final compilation of available applications
+ $this->setTemplateInstance($templateInstance);
}
/**
* Inserts all loaded application templates into the selector's template
*
* @return void
- * @throws NullPointerException If $curr is null
- * @throws NoArrayException If $curr is not an array
- * @throws InvalidArrayCountException If $curr contains an
- * unexpected count of elements
+ * @throws NoArrayException If $curr is not an array
+ * @throws InvalidArrayCountException If $curr contains an
+ * unexpected count of elements
* @throws MissingArrayElementsException If $curr is missing expected
* array elements
+ * @todo Finish handling all applications here
*/
public function insertApplicationTemplates () {
// First prepare the instance
- $tplEngine = $this->prepareTemplateEngine($this);
+ $templateInstance = $this->prepareTemplateInstance($this);
// Load template which shall later hold all application templates
- $tplEngine->loadCodeTemplate($this->getConfigInstance()->readConfig('selector_apps_tpl'));
+ $templateInstance->loadCodeTemplate($this->getConfigInstance()->getConfigEntry('selector_apps_tpl'));
// Add all loaded application templates together
- $dummy = "";
- for ($idx = $this->getLoadedTemplates()->getIterator(); $idx->valid(); $idx->next()) {
+ $dummy = '';
+ for ($iteratorInstance = $this->getLoadedTemplates()->getIterator(); $iteratorInstance->valid(); $iteratorInstance->next()) {
// Get current item from array object
- $curr = $idx->current();
+ $curr = $iteratorInstance->current();
// Do some sanity checks on the loaded item
- if (is_null($curr)) {
- // $curr is null
- throw new NullPointerException($this, self::EXCEPTION_IS_NULL_POINTER);
- } elseif (!is_array($curr)) {
+ if (!is_array($curr)) {
// Not an array
throw new NoArrayException($curr, self::EXCEPTION_IS_NO_ARRAY);
} elseif (count($curr) != 2) {
// Not expected count of entries
- throw new InvalidArrayCountException(array($this, "curr", count($curr), 2), self::EXCEPTION_ARRAY_HAS_INVALID_COUNT);
- } elseif (!isset($curr['template_class']) || (!isset($curr['app_instance']))) {
+ throw new InvalidArrayCountException(array($this, 'curr', count($curr), 2), self::EXCEPTION_ARRAY_HAS_INVALID_COUNT);
+ } elseif (!isset($curr['web_template_class']) || (!isset($curr['app_instance']))) {
// Expected entries missing
- throw new MissingArrayElementsException(array($this, "curr", array("template_class", "app_instance")), self::EXCEPTION_ARRAY_ELEMENTS_MISSING);
+ throw new MissingArrayElementsException(array($this, 'curr', array('template_class', 'app_instance')), self::EXCEPTION_ARRAY_ELEMENTS_MISSING);
}
- die("<pre>".print_r($curr, true)."</pre>");
+ // Debug output
+ die(__METHOD__.'()<pre>'.print_r($curr, true).'</pre>');
} // END - for
}
}
-
-// [EOF]
-?>
projects / shipsimu.git / blobdiff