]> git.mxchange.org Git - hub.git/blobdiff - application/hub/main/template/announcement/class_XmlAnnouncementTemplateEngine.php
Introduced experimental apt-proxy sub project (a connector for apt-proxy usage into...
[hub.git] / application / hub / main / template / announcement / class_XmlAnnouncementTemplateEngine.php
index 0f56e9bcfd7ecf1f897e1865a7c17607df324d1b..e0fdbd70a990244bd43728fabf35f4836c09ee6c 100644 (file)
@@ -22,7 +22,7 @@
  * 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 XmlAnnouncementTemplateEngine extends BaseTemplateEngine implements CompileableTemplate, Registerable {
+class XmlAnnouncementTemplateEngine extends BaseXmlTemplateEngine implements CompileableTemplate, Registerable {
        /**
         * Some XML nodes must be available for later data extraction
         */
@@ -34,28 +34,6 @@ class XmlAnnouncementTemplateEngine extends BaseTemplateEngine implements Compil
        const ANNOUNCEMENT_DATA_TCP_PORT    = 'tcp-port';
        const ANNOUNCEMENT_DATA_UDP_PORT    = 'udp-port';
 
-       /**
-        * Main nodes in the XML tree
-        */
-       private $mainNodes = array(
-               'announcement',
-       );
-
-       /**
-        * Sub nodes in the XML tree
-        */
-       private $subNodes = array();
-
-       /**
-        * Current main node
-        */
-       private $curr = array();
-
-       /**
-        * Content from dependency
-        */
-       private $dependencyContent = array();
-
        /**
         * Protected constructor
         *
@@ -70,6 +48,7 @@ class XmlAnnouncementTemplateEngine extends BaseTemplateEngine implements Compil
                        'announcement-data',
                        'listener',
                        self::ANNOUNCEMENT_DATA_NODE_STATUS,
+                       self::ANNOUNCEMENT_DATA_NODE_MODE,
                        self::ANNOUNCEMENT_DATA_TCP_PORT,
                        self::ANNOUNCEMENT_DATA_UDP_PORT,
                        self::ANNOUNCEMENT_DATA_SESSION_ID,
@@ -94,163 +73,13 @@ class XmlAnnouncementTemplateEngine extends BaseTemplateEngine implements Compil
                // Get a new instance
                $templateInstance = new XmlAnnouncementTemplateEngine();
 
-               // Get the application instance from registry
-               $applicationInstance = Registry::getRegistry()->getInstance('app');
-
-               // Determine base path
-               $templateBasePath = $templateInstance->getConfigInstance()->getConfigEntry('application_base_path') . $applicationInstance->getRequestInstance()->getRequestElement('app') . '/';
-
-               // Is the base path valid?
-               if (empty($templateBasePath)) {
-                       // Base path is empty
-                       throw new BasePathIsEmptyException($templateInstance, self::EXCEPTION_UNEXPECTED_EMPTY_STRING);
-               } elseif (!is_string($templateBasePath)) {
-                       // Is not a string
-                       throw new InvalidBasePathStringException(array($templateInstance, $templateBasePath), self::EXCEPTION_INVALID_STRING);
-               } elseif (!is_dir($templateBasePath)) {
-                       // Is not a path
-                       throw new BasePathIsNoDirectoryException(array($templateInstance, $templateBasePath), self::EXCEPTION_INVALID_PATH_NAME);
-               } elseif (!is_readable($templateBasePath)) {
-                       // Is not readable
-                       throw new BasePathReadProtectedException(array($templateInstance, $templateBasePath), self::EXCEPTION_READ_PROTECED_PATH);
-               }
-
-               // Set the base path
-               $templateInstance->setTemplateBasePath($templateBasePath);
-
-               // Set template extensions
-               $templateInstance->setRawTemplateExtension($templateInstance->getConfigInstance()->getConfigEntry('raw_template_extension'));
-               $templateInstance->setCodeTemplateExtension($templateInstance->getConfigInstance()->getConfigEntry('node_message_template_extension'));
-
-               // Absolute output path for compiled templates
-               $templateInstance->setCompileOutputPath($templateInstance->getConfigInstance()->getConfigEntry('base_path') . $templateInstance->getConfigInstance()->getConfigEntry('compile_output_path'));
-
-               // Init a variable stacker
-               $stackerInstance = ObjectFactory::createObjectByConfiguredName('node_announcement_stacker_class');
-
-               // Set it
-               $templateInstance->setStackerInstance($stackerInstance);
+               // Init template instance
+               $templateInstance->initXmlTemplateEngine('node', 'announcement');
 
                // Return the prepared instance
                return $templateInstance;
        }
 
-       /**
-        * Load a specified announcement template into the engine
-        *
-        * @param       $template       The announcement template we shall load which is
-        *                                              located in 'announcement' by default
-        * @return      void
-        */
-       public function loadAnnouncementTemplate ($template = 'self_announcement') {
-               // Set template type
-               $this->setTemplateType($this->getConfigInstance()->getConfigEntry('node_announcement_template_type'));
-
-               // Load the special template
-               $this->loadTemplate($template);
-       }
-
-       /**
-        * Getter for current main node
-        *
-        * @return      $currMainNode   Current main node
-        */
-       public final function getCurrMainNode () {
-               return $this->curr['main_node'];
-       }
-
-       /**
-        * Setter for current main node
-        *
-        * @param       $element                Element name to set as current main node
-        * @return      $currMainNode   Current main node
-        */
-       private final function setCurrMainNode ($element) {
-               $this->curr['main_node'] = (string) $element;
-       }
-
-       /**
-        * Getter for main node array
-        *
-        * @return      $mainNodes      Array with valid main node names
-        */
-       public final function getMainNodes () {
-               return $this->mainNodes;
-       }
-
-       /**
-        * Getter for sub node array
-        *
-        * @return      $subNodes       Array with valid sub node names
-        */
-       public final function getSubNodes () {
-               return $this->subNodes;
-       }
-
-       /**
-        * Handles the start element of an XML resource
-        *
-        * @param       $resource               XML parser resource (currently ignored)
-        * @param       $element                The element we shall handle
-        * @param       $attributes             All attributes
-        * @return      void
-        * @throws      InvalidXmlNodeException         If an unknown/invalid XML node name was found
-        */
-       public function startElement ($resource, $element, array $attributes) {
-               // Initial method name which will never be called...
-               $methodName = 'initAnnouncement';
-
-               // Make the element name lower-case
-               $element = strtolower($element);
-
-               // Is the element a main node?
-               //* DEBUG: */ echo "START: &gt;".$element."&lt;<br />\n";
-               if (in_array($element, $this->getMainNodes())) {
-                       // Okay, main node found!
-                       $methodName = 'start' . $this->convertToClassName($element);
-
-                       // Set it
-                       $this->setCurrMainNode($element);
-               } elseif (in_array($element, $this->getSubNodes())) {
-                       // Sub node found
-                       $methodName = 'start' . $this->convertToClassName($element);
-               } else {
-                       // Invalid node name found
-                       throw new InvalidXmlNodeException(array($this, $element, $attributes), XmlParser::EXCEPTION_XML_NODE_UNKNOWN);
-               }
-
-               // Call method
-               //* DEBUG: */ echo "call: ".$methodName."<br />\n";
-               call_user_func_array(array($this, $methodName), $attributes);
-       }
-
-       /**
-        * Ends the main or sub node by sending out the gathered data
-        *
-        * @param       $resource       An XML resource pointer (currently ignored)
-        * @param       $nodeName       Name of the node we want to finish
-        * @return      void
-        * @throws      XmlNodeMismatchException        If current main node mismatches the closing one
-        */
-       public function endElement ($resource, $nodeName) {
-               // Make all lower-case
-               $nodeName = strtolower($nodeName);
-
-               // Does this match with current main node?
-               //* DEBUG: */ echo "END: &gt;".$nodeName."&lt;<br />\n";
-               if (($nodeName != $this->getCurrMainNode()) && (in_array($nodeName, $this->getMainNodes()))) {
-                       // Did not match!
-                       throw new XmlNodeMismatchException (array($this, $nodeName, $this->getCurrMainNode()), XmlParser::EXCEPTION_XML_NODE_MISMATCH);
-               } // END - if
-
-               // Construct method name
-               $methodName = 'finish' . $this->convertToClassName($nodeName);
-
-               // Call the corresponding method
-               //* DEBUG: */ echo "call: ".$methodName."<br />\n";
-               call_user_func_array(array($this, $methodName), array());
-       }
-
        /**
         * Currently not used
         *
@@ -272,46 +101,7 @@ class XmlAnnouncementTemplateEngine extends BaseTemplateEngine implements Compil
                 * Assign the found characters to variable and use the last entry from
                 * stack as the name.
                 */
-               parent::assignVariable($this->getStackerInstance()->getNamed('announcement'), $characters);
-       }
-
-       /**
-        * Handles the template dependency for given node
-        *
-        * @param       $node                                   The node we should load a dependency template
-        * @param       $templateDependency             A template to load to satisfy dependencies
-        * @return      void
-        */
-       private function handleTemplateDependency ($node, $templateDependency) {
-               // Is the template dependency set?
-               if ((!empty($templateDependency)) && (!isset($this->dependencyContent[$node]))) {
-                       // Get a temporay template instance
-                       $templateInstance = XmlTemplateEngineFactory::createXmlTemplateEngineInstance('node_announcement_template_class');
-
-                       // Then load it
-                       $templateInstance->loadAnnouncementTemplate($templateDependency);
-
-                       // Parse the XML content
-                       $templateInstance->renderXmlContent();
-
-                       // Save the parsed raw content in our dependency array
-                       $this->dependencyContent[$node] = $templateInstance->getRawTemplateData();
-               } // END - if
-       }
-
-       /**
-        * Read announcement variables by calling readVariable() with 'general' as
-        * variable stack.
-        *
-        * @param       $key    Key to read from
-        * @return      $value  Value from variable
-        */
-       public function readAnnouncementData ($key) {
-               // Read the variable
-               $value = parent::readVariable($key, 'general');
-
-               // Return value
-               return $value;
+               parent::assignVariable($this->getStackerInstance()->getNamed('node_announcement'), $characters);
        }
 
        /**
@@ -328,9 +118,9 @@ class XmlAnnouncementTemplateEngine extends BaseTemplateEngine implements Compil
         *
         * @return      void
         */
-       private function startAnnouncement () {
+       protected function startAnnouncement () {
                // Push the node name on the stacker
-               $this->getStackerInstance()->pushNamed('announcement', 'announcement');
+               $this->getStackerInstance()->pushNamed('node_announcement', 'node_announcement');
        }
 
        /**
@@ -338,9 +128,9 @@ class XmlAnnouncementTemplateEngine extends BaseTemplateEngine implements Compil
         *
         * @return      void
         */
-       private function startAnnouncementData () {
+       protected function startAnnouncementData () {
                // Push the node name on the stacker
-               $this->getStackerInstance()->pushNamed('announcement', 'announcement-data');
+               $this->getStackerInstance()->pushNamed('node_announcement', 'announcement-data');
        }
 
        /**
@@ -348,9 +138,9 @@ class XmlAnnouncementTemplateEngine extends BaseTemplateEngine implements Compil
         *
         * @return      void
         */
-       private function startNodeStatus () {
+       protected function startNodeStatus () {
                // Push the node name on the stacker
-               $this->getStackerInstance()->pushNamed('announcement', self::ANNOUNCEMENT_DATA_NODE_STATUS);
+               $this->getStackerInstance()->pushNamed('node_announcement', self::ANNOUNCEMENT_DATA_NODE_STATUS);
        }
 
        /**
@@ -358,9 +148,9 @@ class XmlAnnouncementTemplateEngine extends BaseTemplateEngine implements Compil
         *
         * @return      void
         */
-       private function startNodeMode () {
+       protected function startNodeMode () {
                // Push the node name on the stacker
-               $this->getStackerInstance()->pushNamed('announcement', self::ANNOUNCEMENT_DATA_NODE_MODE);
+               $this->getStackerInstance()->pushNamed('node_announcement', self::ANNOUNCEMENT_DATA_NODE_MODE);
        }
 
        /**
@@ -368,9 +158,9 @@ class XmlAnnouncementTemplateEngine extends BaseTemplateEngine implements Compil
         *
         * @return      void
         */
-       private function startListener () {
+       protected function startListener () {
                // Push the node name on the stacker
-               $this->getStackerInstance()->pushNamed('announcement', 'listener');
+               $this->getStackerInstance()->pushNamed('node_announcement', 'listener');
        }
 
        /**
@@ -378,9 +168,9 @@ class XmlAnnouncementTemplateEngine extends BaseTemplateEngine implements Compil
         *
         * @return      void
         */
-       private function startTcpPort () {
+       protected function startTcpPort () {
                // Push the node name on the stacker
-               $this->getStackerInstance()->pushNamed('announcement', self::ANNOUNCEMENT_DATA_TCP_PORT);
+               $this->getStackerInstance()->pushNamed('node_announcement', self::ANNOUNCEMENT_DATA_TCP_PORT);
        }
 
        /**
@@ -388,9 +178,9 @@ class XmlAnnouncementTemplateEngine extends BaseTemplateEngine implements Compil
         *
         * @return      void
         */
-       private function startUdpPort () {
+       protected function startUdpPort () {
                // Push the node name on the stacker
-               $this->getStackerInstance()->pushNamed('announcement', self::ANNOUNCEMENT_DATA_UDP_PORT);
+               $this->getStackerInstance()->pushNamed('node_announcement', self::ANNOUNCEMENT_DATA_UDP_PORT);
        }
 
        /**
@@ -398,9 +188,9 @@ class XmlAnnouncementTemplateEngine extends BaseTemplateEngine implements Compil
         *
         * @return      void
         */
-       private function startSessionId () {
+       protected function startSessionId () {
                // Push the node name on the stacker
-               $this->getStackerInstance()->pushNamed('announcement', self::ANNOUNCEMENT_DATA_SESSION_ID);
+               $this->getStackerInstance()->pushNamed('node_announcement', self::ANNOUNCEMENT_DATA_SESSION_ID);
        }
 
        /**
@@ -408,9 +198,9 @@ class XmlAnnouncementTemplateEngine extends BaseTemplateEngine implements Compil
         *
         * @return      void
         */
-       private function startExternalIp () {
+       protected function startExternalIp () {
                // Push the node name on the stacker
-               $this->getStackerInstance()->pushNamed('announcement', self::ANNOUNCEMENT_DATA_EXTERNAL_IP);
+               $this->getStackerInstance()->pushNamed('node_announcement', self::ANNOUNCEMENT_DATA_EXTERNAL_IP);
        }
 
        /**
@@ -418,9 +208,9 @@ class XmlAnnouncementTemplateEngine extends BaseTemplateEngine implements Compil
         *
         * @return      void
         */
-       private function startInternalIp () {
+       protected function startInternalIp () {
                // Push the node name on the stacker
-               $this->getStackerInstance()->pushNamed('announcement', self::ANNOUNCEMENT_DATA_INTERNAL_IP);
+               $this->getStackerInstance()->pushNamed('node_announcement', self::ANNOUNCEMENT_DATA_INTERNAL_IP);
        }
 
        /**
@@ -428,9 +218,9 @@ class XmlAnnouncementTemplateEngine extends BaseTemplateEngine implements Compil
         *
         * @return      void
         */
-       private function startObjectTypeList () {
+       protected function startObjectTypeList () {
                // Push the node name on the stacker
-               $this->getStackerInstance()->pushNamed('announcement', 'object-type-list');
+               $this->getStackerInstance()->pushNamed('node_announcement', 'object-type-list');
        }
 
        /**
@@ -438,9 +228,9 @@ class XmlAnnouncementTemplateEngine extends BaseTemplateEngine implements Compil
         *
         * @return      void
         */
-       private function startObjectType () {
+       protected function startObjectType () {
                // Push the node name on the stacker
-               $this->getStackerInstance()->pushNamed('announcement', 'object-type');
+               $this->getStackerInstance()->pushNamed('node_announcement', 'object-type');
        }
 
        /**
@@ -448,9 +238,9 @@ class XmlAnnouncementTemplateEngine extends BaseTemplateEngine implements Compil
         *
         * @return      void
         */
-       private function finishObjectType () {
+       protected function finishObjectType () {
                // Pop the last entry
-               $this->getStackerInstance()->popNamed('announcement');
+               $this->getStackerInstance()->popNamed('node_announcement');
        }
 
        /**
@@ -458,9 +248,9 @@ class XmlAnnouncementTemplateEngine extends BaseTemplateEngine implements Compil
         *
         * @return      void
         */
-       private function finishObjectTypeList () {
+       protected function finishObjectTypeList () {
                // Pop the last entry
-               $this->getStackerInstance()->popNamed('announcement');
+               $this->getStackerInstance()->popNamed('node_announcement');
        }
 
        /**
@@ -468,9 +258,9 @@ class XmlAnnouncementTemplateEngine extends BaseTemplateEngine implements Compil
         *
         * @return      void
         */
-       private function finishSessionId () {
+       protected function finishSessionId () {
                // Pop the last entry
-               $this->getStackerInstance()->popNamed('announcement');
+               $this->getStackerInstance()->popNamed('node_announcement');
        }
 
        /**
@@ -478,9 +268,9 @@ class XmlAnnouncementTemplateEngine extends BaseTemplateEngine implements Compil
         *
         * @return      void
         */
-       private function finishInternalIp () {
+       protected function finishInternalIp () {
                // Pop the last entry
-               $this->getStackerInstance()->popNamed('announcement');
+               $this->getStackerInstance()->popNamed('node_announcement');
        }
 
        /**
@@ -488,9 +278,9 @@ class XmlAnnouncementTemplateEngine extends BaseTemplateEngine implements Compil
         *
         * @return      void
         */
-       private function finishExternalIp () {
+       protected function finishExternalIp () {
                // Pop the last entry
-               $this->getStackerInstance()->popNamed('announcement');
+               $this->getStackerInstance()->popNamed('node_announcement');
        }
 
        /**
@@ -498,9 +288,9 @@ class XmlAnnouncementTemplateEngine extends BaseTemplateEngine implements Compil
         *
         * @return      void
         */
-       private function finishUdpPort () {
+       protected function finishUdpPort () {
                // Pop the last entry
-               $this->getStackerInstance()->popNamed('announcement');
+               $this->getStackerInstance()->popNamed('node_announcement');
        }
 
        /**
@@ -508,9 +298,9 @@ class XmlAnnouncementTemplateEngine extends BaseTemplateEngine implements Compil
         *
         * @return      void
         */
-       private function finishTcpPort () {
+       protected function finishTcpPort () {
                // Pop the last entry
-               $this->getStackerInstance()->popNamed('announcement');
+               $this->getStackerInstance()->popNamed('node_announcement');
        }
 
        /**
@@ -518,9 +308,9 @@ class XmlAnnouncementTemplateEngine extends BaseTemplateEngine implements Compil
         *
         * @return      void
         */
-       private function finishListener () {
+       protected function finishListener () {
                // Pop the last entry
-               $this->getStackerInstance()->popNamed('announcement');
+               $this->getStackerInstance()->popNamed('node_announcement');
        }
 
        /**
@@ -528,9 +318,9 @@ class XmlAnnouncementTemplateEngine extends BaseTemplateEngine implements Compil
         *
         * @return      void
         */
-       private function finishNodeMode () {
+       protected function finishNodeMode () {
                // Pop the last entry
-               $this->getStackerInstance()->popNamed('announcement');
+               $this->getStackerInstance()->popNamed('node_announcement');
        }
 
        /**
@@ -538,9 +328,9 @@ class XmlAnnouncementTemplateEngine extends BaseTemplateEngine implements Compil
         *
         * @return      void
         */
-       private function finishNodeStatus () {
+       protected function finishNodeStatus () {
                // Pop the last entry
-               $this->getStackerInstance()->popNamed('announcement');
+               $this->getStackerInstance()->popNamed('node_announcement');
        }
 
        /**
@@ -548,9 +338,9 @@ class XmlAnnouncementTemplateEngine extends BaseTemplateEngine implements Compil
         *
         * @return      void
         */
-       private function finishAnnouncementData () {
+       protected function finishAnnouncementData () {
                // Pop the last entry
-               $this->getStackerInstance()->popNamed('announcement');
+               $this->getStackerInstance()->popNamed('node_announcement');
        }
 
        /**
@@ -558,9 +348,9 @@ class XmlAnnouncementTemplateEngine extends BaseTemplateEngine implements Compil
         *
         * @return      void
         */
-       private function finishAnnouncement () {
+       protected function finishAnnouncement () {
                // Pop the last entry
-               $this->getStackerInstance()->popNamed('announcement');
+               $this->getStackerInstance()->popNamed('node_announcement');
        }
 }