* @version 0.0.0
* @copyright Copyright (c) 2007, 2008 Roland Haeder, 2009 - 2012 Core Developer Team
* @license GNU GPL 3.0 or any newer version
* @link http://www.ship-simu.org
* @todo This template engine does not make use of setTemplateType()
*
* 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 .
*/
class XmlAnnouncementAnswerTemplateEngine extends BaseTemplateEngine implements CompileableTemplate, Registerable {
/**
* Some XML nodes must be available for later data extraction
*/
const ANNOUNCEMENT_DATA_SESSION_ID = 'my-session-id';
const ANNOUNCEMENT_DATA_NODE_STATUS = 'my-status';
const ANNOUNCEMENT_DATA_EXTERNAL_IP = 'my-external-ip';
const ANNOUNCEMENT_DATA_INTERNAL_IP = 'my-internal-ip';
const ANNOUNCEMENT_DATA_TCP_PORT = 'my-tcp-port';
const ANNOUNCEMENT_DATA_UDP_PORT = 'my-udp-port';
/**
* Main nodes in the XML tree
*/
private $mainNodes = array(
'announcement-answer'
);
/**
* Sub nodes in the XML tree
*/
private $subNodes = array(
// These nodes don't contain any data
'my-data',
'your-data',
// Data from *this* node
'my-external-ip',
'my-internal-ip',
'my-tcp-port',
'my-udp-port',
'my-session-id',
'my-status',
// Data from other node
'your-external-ip',
'your-internal-ip',
'your-session-id',
// Answer status (code)
'answer-status'
);
/**
* Current main node
*/
private $curr = array();
/**
* Protected constructor
*
* @return void
*/
protected function __construct () {
// Call parent constructor
parent::__construct(__CLASS__);
}
/**
* Creates an instance of the class TemplateEngine and prepares it for usage
*
* @return $templateInstance An instance of TemplateEngine
* @throws BasePathIsEmptyException If the provided $templateBasePath is empty
* @throws InvalidBasePathStringException If $templateBasePath is no string
* @throws BasePathIsNoDirectoryException If $templateBasePath is no
* directory or not found
* @throws BasePathReadProtectedException If $templateBasePath is
* read-protected
*/
public static final function createXmlAnnouncementAnswerTemplateEngine () {
// Get a new instance
$templateInstance = new XmlAnnouncementAnswerTemplateEngine();
// Get 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_answer_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_answer_stacker_class');
// Set it
$templateInstance->setStackerInstance($stackerInstance);
// Return the prepared instance
return $templateInstance;
}
/**
* Load a specified announcement-answer template into the engine
*
* @param $template The announcement-answer template we shall load which is
* located in 'announcement_answer' by default
* @return void
*/
public function loadAnnouncementAnswerTemplate ($template = 'announcement_answer') {
// Set template type
$this->setTemplateType($this->getConfigInstance()->getConfigEntry('node_announcement_answer_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 = 'initAnnouncementAnswer';
// Make the element name lower-case
$element = strtolower($element);
// Is the element a main node?
//* DEBUG: */ echo "START: >".$element."<
\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
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: >".$nodeName."<
\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."
\n";
call_user_func_array(array($this, $methodName), array());
}
/**
* Currently not used
*
* @param $resource XML parser resource (currently ignored)
* @param $characters Characters to handle
* @return void
* @todo Find something useful with this!
*/
public function characterHandler ($resource, $characters) {
// Trim all spaces away
$characters = trim($characters);
// Is this string empty?
if (empty($characters)) {
// Then skip it silently
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_answer'), $characters);
}
/**
* Read announcement-answer variables by calling readVariable() with 'general' as
* variable stack.
*
* @param $key Key to read from
* @return $value Value from variable
*/
public function readAnnouncementAnswerData ($key) {
// Read the variable
$value = parent::readVariable($key, 'general');
// Return value
return $value;
}
/**
* Getter for cache file (FQFN)
*
* @return $fqfn Full-qualified file name of the menu cache
*/
public function getAnnouncementAnswerCacheFqfn () {
$this->partialStub('Please implement this method.');
}
/**
* Starts the announcement-answer
*
* @return void
*/
private function startAnnouncementAnswer () {
// Push the node name on the stacker
$this->getStackerInstance()->pushNamed('announcement_answer', 'announcement-answer');
}
/**
* Starts the my-data
*
* @return void
*/
private function startMyData () {
// Push the node name on the stacker
$this->getStackerInstance()->pushNamed('announcement_answer', 'my-data');
}
/**
* Starts the my-external-ip
*
* @return void
*/
private function startMyExternalIp () {
// Push the node name on the stacker
$this->getStackerInstance()->pushNamed('announcement_answer', 'my-external-ip');
}
/**
* Starts the my-internal-ip
*
* @return void
*/
private function startMyInternalIp () {
// Push the node name on the stacker
$this->getStackerInstance()->pushNamed('announcement_answer', 'my-internal-ip');
}
/**
* Starts the my-tcp-port
*
* @return void
*/
private function startMyTcpPort () {
// Push the node name on the stacker
$this->getStackerInstance()->pushNamed('announcement_answer', 'my-tcp-port');
}
/**
* Starts the my-udp-port
*
* @return void
*/
private function startMyUdpPort () {
// Push the node name on the stacker
$this->getStackerInstance()->pushNamed('announcement_answer', 'my-udp-port');
}
/**
* Starts the my-session-id
*
* @return void
*/
private function startMySessionId () {
// Push the node name on the stacker
$this->getStackerInstance()->pushNamed('announcement_answer', 'my-session-id');
}
/**
* Starts the my-status
*
* @return void
*/
private function startMyStatus () {
// Push the node name on the stacker
$this->getStackerInstance()->pushNamed('announcement_answer', 'my-status');
}
/**
* Finishes the my-status
*
* @return void
*/
private function finishMyStatus () {
// Pop the last entry
$this->getStackerInstance()->popNamed('announcement_answer');
}
/**
* Finishes the my-session-id
*
* @return void
*/
private function finishMySessionId () {
// Pop the last entry
$this->getStackerInstance()->popNamed('announcement_answer');
}
/**
* Finishes the my-udp-port
*
* @return void
*/
private function finishMyUdpPort () {
// Pop the last entry
$this->getStackerInstance()->popNamed('announcement_answer');
}
/**
* Finishes the my-tcp-port
*
* @return void
*/
private function finishMyTcpPort () {
// Pop the last entry
$this->getStackerInstance()->popNamed('announcement_answer');
}
/**
* Finishes the my-internal-ip
*
* @return void
*/
private function finishMyInternalIp () {
// Pop the last entry
$this->getStackerInstance()->popNamed('announcement_answer');
}
/**
* Finishes the my-external-ip
*
* @return void
*/
private function finishMyExternalIp () {
// Pop the last entry
$this->getStackerInstance()->popNamed('announcement_answer');
}
/**
* Finishes the my-data
*
* @return void
*/
private function finishMyData () {
// Pop the last entry
$this->getStackerInstance()->popNamed('announcement_answer');
}
/**
* Starts the your-data
*
* @return void
*/
private function startYourData () {
// Push the node name on the stacker
$this->getStackerInstance()->pushNamed('announcement_answer', 'your-data');
}
/**
* Starts the your-external-ip
*
* @return void
*/
private function startYourExternalIp () {
// Push the node name on the stacker
$this->getStackerInstance()->pushNamed('announcement_answer', 'your-external-ip');
}
/**
* Starts the your-internal-ip
*
* @return void
*/
private function startYourInternalIp () {
// Push the node name on the stacker
$this->getStackerInstance()->pushNamed('announcement_answer', 'your-internal-ip');
}
/**
* Starts the your-session-id
*
* @return void
*/
private function startYourSessionId () {
// Push the node name on the stacker
$this->getStackerInstance()->pushNamed('announcement_answer', 'your-session-id');
}
/**
* Finishes the your-session-id
*
* @return void
*/
private function finishYourSessionId () {
// Pop the last entry
$this->getStackerInstance()->popNamed('announcement_answer');
}
/**
* Finishes the your-internal-ip
*
* @return void
*/
private function finishYourInternalIp () {
// Pop the last entry
$this->getStackerInstance()->popNamed('announcement_answer');
}
/**
* Finishes the your-external-ip
*
* @return void
*/
private function finishYourExternalIp () {
// Pop the last entry
$this->getStackerInstance()->popNamed('announcement_answer');
}
/**
* Finishes the your-data
*
* @return void
*/
private function finishYourData () {
// Pop the last entry
$this->getStackerInstance()->popNamed('announcement_answer');
}
/**
* Starts the answer-status
*
* @return void
*/
private function startAnswerStatus () {
// Push the node name on the stacker
$this->getStackerInstance()->pushNamed('announcement_answer', 'answer-status');
}
/**
* Finishes the answer-status
*
* @return void
*/
private function finishAnswerStatus () {
// Pop the last entry
$this->getStackerInstance()->popNamed('announcement_answer');
}
/**
* Finishes the announcement-answer
*
* @return void
*/
private function finishAnnouncementAnswer () {
// Pop the last entry
$this->getStackerInstance()->popNamed('announcement_answer');
}
}
// [EOF]
?>