]> git.mxchange.org Git - hub.git/blob - application/hub/class_ApplicationHelper.php
Moved some code to BaseListener and called it + updated 'core'.
[hub.git] / application / hub / class_ApplicationHelper.php
1 <?php
2 /**
3  * A class holding general data about the application and some methods for
4  * the management including the entry point.
5  *
6  * E.g.:
7  *
8  * index.php?app=my_app
9  *
10  * You need to create a folder in the folder "application" named "my_app"
11  * (without the quotes) and create a include file called
12  * class_ApplicationHelper.php. You have to write the same class for your
13  * application and implement the same interface called ManageableApplication
14  * because this class include file will be searched for.
15  *
16  * It is good when you avoid more GET parameters to keep URLs short and sweet.
17  * But sometimes you need some GET paramerers e.g. for your imprint or info page
18  * or other linked pages which you have to create and state some informations.
19  *
20  * Please remember that this include file is being loaded *before* the class
21  * loader is loading classes from "exceptions", "interfaces" and "main"!
22  *
23  * @author              Roland Haeder <webmaster@shipsimu.org>
24  * @version             0.0
25  * @copyright   Copyright (c) 2007 - 2008 Roland Haeder, 2009 - 2015 Hub Developer Team
26  * @license             GNU GPL 3.0 or any newer version
27  *
28  * This program is free software: you can redistribute it and/or modify
29  * it under the terms of the GNU General Public License as published by
30  * the Free Software Foundation, either version 3 of the License, or
31  * (at your option) any later version.
32  *
33  * This program is distributed in the hope that it will be useful,
34  * but WITHOUT ANY WARRANTY; without even the implied warranty of
35  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
36  * GNU General Public License for more details.
37  *
38  * You should have received a copy of the GNU General Public License
39  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
40  */
41 class ApplicationHelper extends BaseFrameworkSystem implements ManageableApplication, Registerable {
42         /**
43          * The version number of this application
44          */
45         private $appVersion = '';
46
47         /**
48          * The human-readable name for this application
49          */
50         private $appName = '';
51
52         /**
53          * The short uni*-like name for this application
54          */
55         private $shortName = '';
56
57         /**
58          * An instance of this class
59          */
60         private static $selfInstance = NULL;
61
62         /**
63          * Private constructor
64          *
65          * @return      void
66          */
67         protected function __construct () {
68                 // Call parent constructor
69                 parent::__construct(__CLASS__);
70         }
71
72         /**
73          * Getter for an instance of this class
74          *
75          * @return      $selfInstance   An instance of this class
76          */
77         public static final function getSelfInstance () {
78                 // Is the instance there?
79                 if (is_null(self::$selfInstance)) {
80                         self::$selfInstance = new ApplicationHelper();
81                 } // END - if
82
83                 // Return the instance
84                 return self::$selfInstance;
85         }
86
87         /**
88          * Getter for the version number
89          *
90          * @return      $appVersion     The application's version number
91          */
92         public final function getAppVersion () {
93                 return $this->appVersion;
94         }
95         /**
96          * Setter for the version number
97          *
98          * @param       $appVersion     The application's version number
99          * @return      void
100          */
101         public final function setAppVersion ($appVersion) {
102                 // Cast and set it
103                 $this->appVersion = (string) $appVersion;
104         }
105
106         /**
107          * Getter for human-readable name
108          *
109          * @return      $appName        The application's human-readable name
110          */
111         public final function getAppName () {
112                 return $this->appName;
113         }
114
115         /**
116          * Setter for human-readable name
117          *
118          * @param       $appName        The application's human-readable name
119          * @return      void
120          */
121         public final function setAppName ($appName) {
122                 // Cast and set it
123                 $this->appName = (string) $appName;;
124         }
125
126         /**
127          * Getter for short uni*-like name
128          *
129          * @return      $shortName      The application's short uni*-like name
130          */
131         public final function getAppShortName () {
132                 return $this->shortName;
133         }
134
135         /**
136          * Setter for short uni*-like name
137          *
138          * @param       $shortName      The application's short uni*-like name
139          * @return      void
140          */
141         public final function setAppShortName ($shortName) {
142                 // Cast and set it
143                 $this->shortName = (string) $shortName;
144         }
145
146         /**
147          * Launches the hub system
148          *
149          * @return      void
150          */
151         public final function entryPoint () {
152                 // Set this application in registry
153                 Registry::getRegistry()->addInstance('app', $this);
154
155                 // Is no external address set?
156                 if ($this->getConfigInstance()->getConfigEntry('external_address') == '') {
157                         // Determine external address
158                         $this->getConfigInstance()->setConfigEntry('external_address', HubTools::determineOwnExternalAddress());
159                 } // END - if
160
161                 // Default response is console
162                 $response = self::getResponseTypeFromSystem();
163                 $responseType = self::getResponseTypeFromSystem();
164
165                 // Create a new request object
166                 $requestInstance = ObjectFactory::createObjectByName(self::convertToClassName($response) . 'Request');
167
168                 // Remember request instance here
169                 $this->setRequestInstance($requestInstance);
170
171                 // Do we have another response?
172                 if ($requestInstance->isRequestElementSet('request')) {
173                         // Then use it
174                         $response = strtolower($requestInstance->getRequestElement('request'));
175                         $responseType = $response;
176                 } // END - if
177
178                 // ... and a new response object
179                 $responseClass = sprintf('%sResponse', self::convertToClassName($response));
180                 $responseInstance = ObjectFactory::createObjectByName($responseClass, array($this));
181
182                 // Remember response instance here
183                 $this->setResponseInstance($responseInstance);
184
185                 // Get the parameter from the request
186                 $commandName = $requestInstance->getRequestElement('command');
187
188                 // If it is null then get default command
189                 if (is_null($commandName)) {
190                         // Get default command
191                         $commandName = $responseInstance->determineDefaultCommand();
192
193                         // Set it in request
194                         $requestInstance->setRequestElement('command', $commandName);
195                 } // END - if
196
197                 // Is the responseType 'html' ?
198                 if ($responseType == 'html') {
199                         // The language system is needed for this
200                         $languageInstance = ObjectFactory::createObjectByConfiguredName('language_system_class');
201
202                         // And set it here
203                         $this->setLanguageInstance($languageInstance);
204                 } // END - if
205
206                 // Get a controller resolver
207                 $resolverClass = self::convertToClassName($this->getAppShortName() . '_' . $responseType . '_controller_resolver');
208                 $resolverInstance = ObjectFactory::createObjectByName($resolverClass, array($commandName, $this));
209
210                 // Get a controller instance as well
211                 $this->setControllerInstance($resolverInstance->resolveController());
212
213                 // Launch the hub main routine here
214                 $this->getControllerInstance()->handleRequest($requestInstance, $responseInstance);
215
216                 // Only for console requests as this is the actual daemon
217                 if ($responseType == 'console') {
218                         // -------------------------- Shutdown phase --------------------------
219                         // Shutting down the hub by saying "good bye" to all connected peers
220                         // and other hubs, flushing all queues and caches.
221                         self::createDebugInstance(__CLASS__)->debugOutput('MAIN: Shutdown in progress, main loop exited.');
222                         $this->getControllerInstance()->executeShutdownFilters($requestInstance, $responseInstance);
223                         self::createDebugInstance(__CLASS__)->debugOutput('MAIN: Shutdown completed. (This is the last line.)');
224                 } // END - if
225         }
226
227         /**
228          * Assigns extra application-depending data
229          *
230          * @param       $templateInstance       An instance of a CompileableTemplate
231          * @return      void
232          * @todo        Nothing to add?
233          */
234         public function assignExtraTemplateData (CompileableTemplate $templateInstance) {
235         }
236
237         /**
238          * Handle the indexed array of fatal messages and puts them out in an
239          * acceptable fasion
240          *
241          * @param       $messageList    An array of fatal messages
242          * @return      void
243          */
244         public function handleFatalMessages (array $messageList) {
245                 // Walk through all messages
246                 foreach ($messageList as $message) {
247                         exit(__METHOD__ . ':MSG:' . $message);
248                 } // END - foreach
249         }
250
251         /**
252          * Builds the master template's name
253          *
254          * @return      $masterTemplateName             Name of the master template
255          */
256         public function buildMasterTemplateName () {
257                 return 'node_main';
258         }
259 }
260
261 // [EOF]
262 ?>