]> git.mxchange.org Git - city.git/blobdiff - application/city/class_ApplicationHelper.php
Continued:
[city.git] / application / city / class_ApplicationHelper.php
index fa8d88d87e8bbe51028083160f4e6860eea8d45f..3d9c194a25253fe45a2a9f4cdb3a3a71defa6538 100644 (file)
@@ -1,4 +1,17 @@
 <?php
+// Must be this namespace, else the launcher cannot find the class.
+namespace Org\Mxchange\CoreFramework\Helper\Application;
+
+// Import framework stuff
+use Org\Mxchange\CoreFramework\Application\BaseApplication;
+use Org\Mxchange\CoreFramework\Bootstrap\FrameworkBootstrap;
+use Org\Mxchange\CoreFramework\Factory\Object\ObjectFactory;
+use Org\Mxchange\CoreFramework\Loader\ClassLoader;
+use Org\Mxchange\CoreFramework\Manager\ManageableApplication;
+use Org\Mxchange\CoreFramework\Registry\Registerable;
+use Org\Mxchange\CoreFramework\Template\CompileableTemplate;
+use Org\Mxchange\CoreFramework\Utils\Strings\StringUtils;
+
 /**
  * A class holding general data about the application and some methods for
  * the management including the entry point.
@@ -22,7 +35,7 @@
  *
  * @author             Roland Haeder <webmaster@shipsimu.org>
  * @version            0.0
- * @copyright  Copyright (c) 2015, 2016 City Developer Team
+ * @copyright  Copyright (c) 2007, 2008 Roland Haeder, 2009 - 2017 City Developer Team
  * @license            GNU GPL 3.0 or any newer version
  *
  * This program is free software: you can redistribute it and/or modify
  * 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 ApplicationHelper extends BaseFrameworkSystem implements ManageableApplication, Registerable {
-       /**
-        * The version number of this application
-        */
-       private $appVersion = '';
-
-       /**
-        * The human-readable name for this application
-        */
-       private $appName = '';
-
-       /**
-        * The short uni*-like name for this application
-        */
-       private $shortName = '';
-
-       /**
-        * An instance of this class
-        */
-       private static $selfInstance = NULL;
-
+class ApplicationHelper extends BaseApplication implements ManageableApplication, Registerable {
        /**
         * Private constructor
         *
@@ -76,105 +69,52 @@ class ApplicationHelper extends BaseFrameworkSystem implements ManageableApplica
         */
        public static final function getSelfInstance () {
                // Is the instance there?
-               if (is_null(self::$selfInstance)) {
-                       self::$selfInstance = new ApplicationHelper();
-               } // END - if
+               if (is_null(self::getApplicationInstance())) {
+                       // Set it
+                       self::setApplicationInstance(new ApplicationHelper());
+               }
 
                // Return the instance
-               return self::$selfInstance;
+               return self::getApplicationInstance();
        }
 
        /**
-        * Getter for the version number
+        * 1) Setups application data
         *
-        * @return      $appVersion     The application's version number
-        */
-       public final function getAppVersion () {
-               return $this->appVersion;
-       }
-       /**
-        * Setter for the version number
-        *
-        * @param       $appVersion     The application's version number
         * @return      void
         */
-       public final function setAppVersion ($appVersion) {
-               // Cast and set it
-               $this->appVersion = (string) $appVersion;
-       }
-
-       /**
-        * Getter for human-readable name
-        *
-        * @return      $appName        The application's human-readable name
-        */
-       public final function getAppName () {
-               return $this->appName;
+       public function setupApplicationData () {
+               // Set all application data
+               $this->setAppName('City Growth Simulation');
+               $this->setAppVersion('0.0.0');
+               $this->setAppShortName('city');
        }
 
        /**
-        * Setter for human-readable name
+        * 2) Does initial stuff before starting the application
         *
-        * @param       $appName        The application's human-readable name
         * @return      void
         */
-       public final function setAppName ($appName) {
-               // Cast and set it
-               $this->appName = (string) $appName;;
-       }
+       public function initApplication () {
+               // Initialize output system
+               ApplicationHelper::createDebugInstance('ApplicationHelper');
 
-       /**
-        * Getter for short uni*-like name
-        *
-        * @return      $shortName      The application's short uni*-like name
-        */
-       public final function getAppShortName () {
-               return $this->shortName;
+               /*
+                * This application needs a database connection then simply call init
+                * method.
+                */
+               FrameworkBootstrap::initDatabaseInstance();
        }
 
        /**
-        * Setter for short uni*-like name
+        * 3) Launches the application
         *
-        * @param       $shortName      The application's short uni*-like name
         * @return      void
         */
-       public final function setAppShortName ($shortName) {
-               // Cast and set it
-               $this->shortName = (string) $shortName;
-       }
-
-       /**
-        * Launches the test suite
-        *
-        * @return      void
-        */
-       public final function entryPoint () {
-               // Set this application in registry
-               Registry::getRegistry()->addInstance('app', $this);
-
-               // Default response is console
-               $response = self::getResponseTypeFromSystem();
-               $responseType = self::getResponseTypeFromSystem();
-
-               // Create a new request object
-               $requestInstance = ObjectFactory::createObjectByName(self::convertToClassName($response) . 'Request');
-
-               // Remember request instance here
-               $this->setRequestInstance($requestInstance);
-
-               // Do we have another response?
-               if ($requestInstance->isRequestElementSet('request')) {
-                       // Then use it
-                       $response = strtolower($requestInstance->getRequestElement('request'));
-                       $responseType = $response;
-               } // END - if
-
-               // ... and a new response object
-               $responseClass = sprintf('%sResponse', self::convertToClassName($response));
-               $responseInstance = ObjectFactory::createObjectByName($responseClass, array($this));
-
-               // Remember response instance here
-               $this->setResponseInstance($responseInstance);
+       public function launchApplication () {
+               // Get request/response instances
+               $requestInstance  = FrameworkBootstrap::getRequestInstance();
+               $responseInstance = FrameworkBootstrap::getResponseInstance();
 
                // Get the parameter from the request
                $commandName = $requestInstance->getRequestElement('command');
@@ -186,11 +126,18 @@ class ApplicationHelper extends BaseFrameworkSystem implements ManageableApplica
 
                        // Set it in request
                        $requestInstance->setRequestElement('command', $commandName);
-               } // END - if
+               }
 
                // Get a controller resolver
-               $resolverClass = self::convertToClassName($this->getAppShortName() . '_' . $responseType . '_controller_resolver');
-               $resolverInstance = ObjectFactory::createObjectByName($resolverClass, array($commandName, $this));
+               $resolverClass = sprintf(
+                       'Org\Mxchange\City\Resolver\Controller\%s',
+                       StringUtils::convertToClassName(sprintf(
+                               '%s_%s_controller_resolver',
+                               $this->getAppShortName(),
+                               FrameworkBootstrap::getRequestTypeFromSystem()
+                       ))
+               );
+               $resolverInstance = ObjectFactory::createObjectByName($resolverClass, array($commandName));
 
                // Get a controller instance as well
                $this->setControllerInstance($resolverInstance->resolveController());
@@ -199,23 +146,24 @@ class ApplicationHelper extends BaseFrameworkSystem implements ManageableApplica
                $languageInstance = ObjectFactory::createObjectByConfiguredName('language_system_class');
 
                // And set it here
-               $this->setLanguageInstance($languageInstance);
+               FrameworkBootstrap::setLanguageInstance($languageInstance);
 
-               // Launch the game here
-               $this->getControllerInstance()->handleRequest($requestInstance, $responseInstance);
+               // Is html request?
+               if (FrameworkBootstrap::getRequestTypeFromSystem() == 'html') {
+                       // Init web output instance
+                       $this->initWebOutputInstance();
+               }
 
-               // -------------------------- Shutdown phase --------------------------
-               $this->getControllerInstance()->executeShutdownFilters($requestInstance, $responseInstance);
-       }
+               // Launch the application here
+               $this->getControllerInstance()->handleRequest($requestInstance, $responseInstance);
 
-       /**
-        * Assigns extra application-depending data
-        *
-        * @param       $templateInstance       An instance of a CompileableTemplate
-        * @return      void
-        * @todo        Nothing to add?
-        */
-       public function assignExtraTemplateData (CompileableTemplate $templateInstance) {
+               // Is console request?
+               if (FrameworkBootstrap::getRequestTypeFromSystem() == 'console') {
+                       // -------------------------- Shutdown phase --------------------------
+                       self::createDebugInstance(__CLASS__, __LINE__)->debugOutput('MAIN: Shutdown in progress ...');
+                       $this->getControllerInstance()->executeShutdownFilters($requestInstance, $responseInstance);
+                       self::createDebugInstance(__CLASS__, __LINE__)->debugOutput('MAIN: Shutdown completed. (This is the last line.)');
+               }
        }
 
        /**
@@ -229,7 +177,7 @@ class ApplicationHelper extends BaseFrameworkSystem implements ManageableApplica
                // Walk through all messages
                foreach ($messageList as $message) {
                        exit(__METHOD__ . ':MSG:' . $message);
-               } // END - foreach
+               }
        }
 
        /**
@@ -240,7 +188,16 @@ class ApplicationHelper extends BaseFrameworkSystem implements ManageableApplica
        public function buildMasterTemplateName () {
                return 'city_main';
        }
-}
 
-// [EOF]
-?>
+       /**
+        * Assigns extra application-depending data
+        *
+        * @param       $templateInstance       An instance of a CompileableTemplate
+        * @return      void
+        * @todo        Nothing to add?
+        */
+       public function assignExtraTemplateData (CompileableTemplate $templateInstance) {
+               $this->partialStub('Unfinished method. templateInstance=' . $templateInstance->__toString());
+       }
+
+}