* Please remember that this include file is being loaded *before* the class
* loader is loading classes from "exceptions", "interfaces" and "main"!
*
- * @todo Extend a later BaseFrameworkApplication class
+ * @author Roland Haeder <webmaster@ship-simu.org>
+ * @version 0.0.0
+ * @copyright Copyright(c) 2007, 2008 Roland Haeder, this is free software
+ * @license GNU GPL 3.0 or any newer version
+ * @link http://www.ship-simu.org
*
- * @author Roland Haeder <roland __NOSPAM__ [at] __REMOVE_ME__ mxchange [dot] org>
- * @version 0.1
+ * 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
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
*/
class ApplicationSelector extends BaseFrameworkSystem {
/**
);
/**
- * The language instance for the template loader
- */
- private $langInstance = null;
-
- /**
- * The file I/O instance for the template loader
- */
- private $fileIOInstance = null;
-
- /**
- * The private constructor. No direct instances can be created from this.
+ * The protected constructor. No direct instances can be created from this.
*
* @return void
*/
- private function __construct() {
+ protected function __construct() {
// Call parent constructor
- parent::constructor(__CLASS__);
+ parent::__construct(__CLASS__);
// Set description
- $this->setPartDescr("Applikationswechsler");
+ $this->setObjectDescription("Applikationswechsler");
// Create unique ID number
$this->createUniqueID();
* @param $fileIOInstance The file I/O instance
* @return $selInstance An instance of ApplicationSelector
*/
- public static function createApplicationSelector (ManageableLanguage $langInstance, FileIOHandler $fileIOInstance) {
+ public final static function createApplicationSelector (ManageableLanguage $langInstance, FileIoHandler $fileIOInstance) {
// Get a new instance
$selInstance = new ApplicationSelector();
// Set language and file I/O instances
$selInstance->setLanguageInstance($langInstance);
- $selInstance->setFileIOInstance($fileIOInstance);
+ $selInstance->setFileIoInstance($fileIOInstance);
// Return the prepared instance
return $selInstance;
* @return void
*/
private function initializeAppsList () {
- $this->foundApps = new FrameworkArrayObject();
+ $this->foundApps = new FrameworkArrayObject("FakedFoundApplications");
}
/**
* @return void
*/
private function initializeTemplatesList () {
- $this->loadedTemplates = new FrameworkArrayObject();
- }
-
- /**
- * Private getter for language instance
- *
- * @return $langInstance An instance to the language sub-system
- */
- private function getLanguageInstance () {
- return $this->langInstance;
- }
-
- /**
- * Private getter for file IO instance
- *
- * @return $fileIOInstance An instance to the file I/O sub-system
- */
- private function getFileIOInstance () {
- return $this->fileIOInstance;
- }
-
- /**
- * Prepare the template engine (TemplateEngine by default) for a give
- * application helper instance (ApplicationHelper by default).
- *
- * @param $appInstance An application helper instance
- * @return $tplEngine The template engine instance
- * @throws NullPointerException If the template engine could not
- * be initialized
- * @throws NoObjectException If $tplEngine is not an object
- * @throws MissingMethodException If $tplEngine misses a required
- * method 'loadWebTemplate()'
- */
- private function prepareTemplateEngine (BaseFrameworkSystem $appInstance) {
- // Generate FQFN for all application templates
- $fqfn = sprintf("%s%s/%s/%s",
- PATH,
- $this->getConfigInstance()->readConfig("application_path"),
- strtolower($appInstance->getAppShortName()),
- $this->getConfigInstance()->readConfig("tpl_base_path")
- );
-
- // Initialize the template engine
- $tplEngine = null;
- $eval = sprintf("\$tplEngine = %s::create%s(
- \"%s\",
- \$this->getLanguageInstance(),
- \$this->getFileIOInstance()
-);",
- $this->getConfigInstance()->readConfig("tpl_engine"),
- $this->getConfigInstance()->readConfig("tpl_engine"),
- $fqfn
- );
-
- // Debug message
- if ((!is_null($this->getDebugInstance())) && (defined('DEBUG_EVAL'))) {
- $this->getDebugInstance()->output(sprintf("[%s:] Konstruierte PHP-Anweisung: <pre><em>%s</em></pre><br />\n",
- $this->__toString(),
- htmlentities($eval)
- ));
- }
-
- // Run the command
- @eval($eval);
-
- // Is it a valid instance?
- if (is_null($tplEngine)) {
- // No class returned
- throw new NullPointerException($this, self::EXCEPTION_IS_NULL_POINTER);
- } elseif (!is_object($tplEngine)) {
- // Not an object! ;-(
- throw new NoObjectException($tplEngine, self::EXCEPTION_IS_NO_OBJECT);
- } elseif (!method_exists($tplEngine, 'loadWebTemplate')) {
- // Nope, so throw exception
- throw new MissingMethodException(array($tplEngine, 'loadWebTemplate'), self::EXCEPTION_MISSING_METHOD);
- }
-
- // Return the prepared instance
- return $tplEngine;
+ $this->loadedTemplates = new FrameworkArrayObject("FakedLoadedTemplates");
}
/**
} elseif (!is_object($app)) {
// Not an object
throw new NoObjectException($app, self::EXCEPTION_IS_NO_OBJECT);
- } elseif (!method_exists($app, $this->getConfigInstance()->readConfig("entry_method"))) {
+ } elseif (!method_exists($app, $this->getConfigInstance()->readConfig('entry_method'))) {
// Method not found!
- throw new MissingMethodException(array($app, $this->getConfigInstance()->readConfig("entry_method")), self::EXCEPTION_MISSING_METHOD);
+ throw new MissingMethodException(array($app, $this->getConfigInstance()->readConfig('entry_method')), self::EXCEPTION_MISSING_METHOD);
}
// Add the current instance to the list
*
* @param $tplEngine An instance of TemplateEngine
*/
- private function setSelectorTemplateEngine (CompileableTemplate $tplEngine) {
+ private final function setSelectorTemplateEngine (CompileableTemplate $tplEngine) {
$this->selectorTplEngine = $tplEngine;
}
*
* @return $selectTplEngine The selector's template engine
*/
- private function getSelectorTemplateEngine () {
+ private final function getSelectorTemplateEngine () {
return $this->selectorTplEngine;
}
* @return $loadedTemplates An array object holding all loaded
* application templates
*/
- private function getLoadedTemplates () {
+ private final function getLoadedTemplates () {
return $this->loadedTemplates;
}
*
* @return $shortName This selector's short name
*/
- private function getAppShortName() {
- $shortName = $this->getConfigInstance()->readConfig("selector_path");
+ public function getAppShortName() {
+ $shortName = $this->getConfigInstance()->readConfig('selector_path');
return $shortName;
}
$this->dirIgnoreList[] = $ignoreItem;
}
- /**
- * Setter for language instance
- *
- * @param $langInstance An instance to the language sub-system
- * @return void
- * @see LanguageSystem
- */
- public function setLanguageInstance (ManageableLanguage $langInstance) {
- $this->langInstance = $langInstance;
- }
-
- /**
- * Setter for file I/O instance
- *
- * @param $fileIOInstance An instance to the file I/O sub-system
- * @return void
- */
- public function setFileIOInstance (FileIOHandler $fileIOInstance) {
- $this->fileIOInstance = $fileIOInstance;
- }
-
/**
* Read the base path for all applications (application/) and create a
* list of all found applications
// Generate the base path for all applications
$appBasePath = sprintf("%s%s/",
PATH,
- $this->getConfigInstance()->readConfig("application_path")
+ $this->getConfigInstance()->readConfig('application_path')
);
// Add the selector path to the ignore list
- $this->addDirIgnoreList($this->getConfigInstance()->readConfig("selector_path"));
+ $this->addDirIgnoreList($this->getConfigInstance()->readConfig('selector_path'));
// Get a directory pointer for the application path
$dirInstance = FrameworkDirectoryPointer::createFrameworkDirectoryPointer($appBasePath);
// 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"));
+ $initScript = sprintf("%s/init%s", $fqfn, $this->getConfigInstance()->readConfig('php_extension'));
// Load the application's init.php script and append the
// application to the ArrayObject
// Try to load the web template
$tplEngine->loadWebTemplate(sprintf("%s_%s",
- $this->getConfigInstance()->readConfig("tpl_selector_prefix"),
+ $this->getConfigInstance()->readConfig('tpl_selector_prefix'),
strtolower($appInstance->getAppShortName())
));
*
* @return void
*/
- public function removeDirIgnoreList () {
+ public final function removeDirIgnoreList () {
unset($this->dirIgnoreList);
}
$tplEngine = $this->prepareTemplateEngine($this);
// Load the selector's template
- $tplEngine->loadCodeTemplate($this->getConfigInstance()->readConfig("selector_main_tpl"));
+ $tplEngine->loadCodeTemplate($this->getConfigInstance()->readConfig('selector_main_tpl'));
// Now store it in the class
$this->setSelectorTemplateEngine($tplEngine);
$tplEngine = $this->prepareTemplateEngine($this);
// Load template which shall later hold all application templates
- $tplEngine->loadCodeTemplate($this->getConfigInstance()->readConfig("selector_apps_tpl"));
+ $tplEngine->loadCodeTemplate($this->getConfigInstance()->readConfig('selector_apps_tpl'));
// Add all loaded application templates together
$dummy = "";
} // END - for
}
-
- /**
- * Stub!
- */
- public function saveObjectToDatabase () {
- $this->getDebugInstance()->output(sprintf("[%s:] Stub <strong>%s</strong> erreicht.",
- $this->__toString(),
- __FUNCTION__
- ));
- }
}
// [EOF]