]> git.mxchange.org Git - hub.git/blobdiff - application/hub/main/template/announcement/class_XmlAnnouncementTemplateEngine.php
Rewrites, some more methods:
[hub.git] / application / hub / main / template / announcement / class_XmlAnnouncementTemplateEngine.php
index 935ddb64ff4a029c508f437211c000c3823bfc5a..684e6dafc8991caf75ec35f954ecbb7965be1508 100644 (file)
  * 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
         */
        const ANNOUNCEMENT_DATA_SESSION_ID  = 'session-id';
        const ANNOUNCEMENT_DATA_NODE_STATUS = 'node-status';
+       const ANNOUNCEMENT_DATA_NODE_MODE   = 'node-mode';
        const ANNOUNCEMENT_DATA_EXTERNAL_IP = 'external-ip';
-       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();
+       const ANNOUNCEMENT_DATA_INTERNAL_IP = 'internal-ip';
+       const ANNOUNCEMENT_DATA_LISTEN_PORT = 'listen-port';
 
        /**
         * Protected constructor
@@ -68,10 +47,11 @@ class XmlAnnouncementTemplateEngine extends BaseTemplateEngine implements Compil
                        'announcement-data',
                        'listener',
                        self::ANNOUNCEMENT_DATA_NODE_STATUS,
-                       self::ANNOUNCEMENT_DATA_TCP_PORT,
-                       self::ANNOUNCEMENT_DATA_UDP_PORT,
+                       self::ANNOUNCEMENT_DATA_NODE_MODE,
+                       self::ANNOUNCEMENT_DATA_LISTEN_PORT,
                        self::ANNOUNCEMENT_DATA_SESSION_ID,
                        self::ANNOUNCEMENT_DATA_EXTERNAL_IP,
+                       self::ANNOUNCEMENT_DATA_INTERNAL_IP,
                        'object-type-list',
                );
        }
@@ -91,163 +71,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_announcement_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
         *
@@ -265,48 +95,11 @@ class XmlAnnouncementTemplateEngine extends BaseTemplateEngine implements Compil
                        return false;
                } // END - if
 
-               // 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;
+               /*
+                * Assign the found characters to variable and use the last entry from
+                * stack as the name.
+                */
+               parent::assignVariable($this->getStackerInstance()->getNamed('node_announcement'), $characters);
        }
 
        /**
@@ -323,9 +116,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');
        }
 
        /**
@@ -333,9 +126,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');
        }
 
        /**
@@ -343,39 +136,39 @@ 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);
        }
 
        /**
-        * Starts the listener
+        * Starts the node-mode
         *
         * @return      void
         */
-       private function startListener () {
+       protected function startNodeMode () {
                // Push the node name on the stacker
-               $this->getStackerInstance()->pushNamed('announcement', 'listener');
+               $this->getStackerInstance()->pushNamed('node_announcement', self::ANNOUNCEMENT_DATA_NODE_MODE);
        }
 
        /**
-        * Starts the TCP port
+        * Starts the listener
         *
         * @return      void
         */
-       private function startTcpPort () {
+       protected function startListener () {
                // Push the node name on the stacker
-               $this->getStackerInstance()->pushNamed('announcement', self::ANNOUNCEMENT_DATA_TCP_PORT);
+               $this->getStackerInstance()->pushNamed('node_announcement', 'listener');
        }
 
        /**
-        * Starts the UDP port
+        * Starts the TCP/UDP listen port
         *
         * @return      void
         */
-       private function startUdpPort () {
+       protected function startListenPort () {
                // Push the node name on the stacker
-               $this->getStackerInstance()->pushNamed('announcement', self::ANNOUNCEMENT_DATA_UDP_PORT);
+               $this->getStackerInstance()->pushNamed('node_announcement', self::ANNOUNCEMENT_DATA_LISTEN_PORT);
        }
 
        /**
@@ -383,9 +176,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);
        }
 
        /**
@@ -393,9 +186,19 @@ class XmlAnnouncementTemplateEngine extends BaseTemplateEngine implements Compil
         *
         * @return      void
         */
-       private function startExternalIp () {
+       protected function startExternalIp () {
+               // Push the node name on the stacker
+               $this->getStackerInstance()->pushNamed('node_announcement', self::ANNOUNCEMENT_DATA_EXTERNAL_IP);
+       }
+
+       /**
+        * Starts the private ip
+        *
+        * @return      void
+        */
+       protected function startInternalIp () {
                // Push the node name on the stacker
-               $this->getStackerInstance()->pushNamed('announcement', self::ANNOUNCEMENT_DATA_EXTERNAL_IP);
+               $this->getStackerInstance()->pushNamed('node_announcement', self::ANNOUNCEMENT_DATA_INTERNAL_IP);
        }
 
        /**
@@ -403,9 +206,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');
        }
 
        /**
@@ -413,9 +216,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');
        }
 
        /**
@@ -423,9 +226,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');
        }
 
        /**
@@ -433,9 +236,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');
        }
 
        /**
@@ -443,39 +246,39 @@ 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');
        }
 
        /**
-        * Finishes the public ip
+        * Finishes the private ip
         *
         * @return      void
         */
-       private function finishExternalIp () {
+       protected function finishInternalIp () {
                // Pop the last entry
-               $this->getStackerInstance()->popNamed('announcement');
+               $this->getStackerInstance()->popNamed('node_announcement');
        }
 
        /**
-        * Finishes the UDP port
+        * Finishes the public ip
         *
         * @return      void
         */
-       private function finishUdpPort () {
+       protected function finishExternalIp () {
                // Pop the last entry
-               $this->getStackerInstance()->popNamed('announcement');
+               $this->getStackerInstance()->popNamed('node_announcement');
        }
 
        /**
-        * Finishes the TCP port
+        * Finishes the TCP/UDP listen port
         *
         * @return      void
         */
-       private function finishTcpPort () {
+       protected function finishListenPort () {
                // Pop the last entry
-               $this->getStackerInstance()->popNamed('announcement');
+               $this->getStackerInstance()->popNamed('node_announcement');
        }
 
        /**
@@ -483,9 +286,19 @@ class XmlAnnouncementTemplateEngine extends BaseTemplateEngine implements Compil
         *
         * @return      void
         */
-       private function finishListener () {
+       protected function finishListener () {
+               // Pop the last entry
+               $this->getStackerInstance()->popNamed('node_announcement');
+       }
+
+       /**
+        * Finishes the node mode
+        *
+        * @return      void
+        */
+       protected function finishNodeMode () {
                // Pop the last entry
-               $this->getStackerInstance()->popNamed('announcement');
+               $this->getStackerInstance()->popNamed('node_announcement');
        }
 
        /**
@@ -493,9 +306,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');
        }
 
        /**
@@ -503,9 +316,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');
        }
 
        /**
@@ -513,9 +326,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');
        }
 }