3 * An SelfConnect template engine class for XML templates
5 * @author Roland Haeder <webmaster@ship-simu.org>
7 * @copyright Copyright (c) 2007, 2008 Roland Haeder, 2009 - 2011 Core Developer Team
8 * @license GNU GPL 3.0 or any newer version
9 * @link http://www.ship-simu.org
10 * @todo This template engine does not make use of setTemplateType()
12 * This program is free software: you can redistribute it and/or modify
13 * it under the terms of the GNU General Public License as published by
14 * the Free Software Foundation, either version 3 of the License, or
15 * (at your option) any later version.
17 * This program is distributed in the hope that it will be useful,
18 * but WITHOUT ANY WARRANTY; without even the implied warranty of
19 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
20 * GNU General Public License for more details.
22 * You should have received a copy of the GNU General Public License
23 * along with this program. If not, see <http://www.gnu.org/licenses/>.
25 class XmlSelfConnectTemplateEngine extends BaseTemplateEngine implements CompileableTemplate {
27 * Main nodes in the XML tree
29 private $mainNodes = array(
34 * Sub nodes in the XML tree
36 private $subNodes = array(
45 private $curr = array();
48 * Content from dependency
50 private $dependencyContent = array();
53 * Protected constructor
57 protected function __construct () {
58 // Call parent constructor
59 parent::__construct(__CLASS__);
63 * Creates an instance of the class TemplateEngine and prepares it for usage
65 * @return $templateInstance An instance of TemplateEngine
66 * @throws BasePathIsEmptyException If the provided $templateBasePath is empty
67 * @throws InvalidBasePathStringException If $templateBasePath is no string
68 * @throws BasePathIsNoDirectoryException If $templateBasePath is no
69 * directory or not found
70 * @throws BasePathReadProtectedException If $templateBasePath is
73 public static final function createXmlSelfConnectTemplateEngine () {
75 $templateInstance = new XmlSelfConnectTemplateEngine();
77 // Get the application instance from registry
78 $applicationInstance = Registry::getRegistry()->getInstance('app');
80 // Determine base path
81 $templateBasePath = $templateInstance->getConfigInstance()->getConfigEntry('application_base_path') . $applicationInstance->getRequestInstance()->getRequestElement('app') . '/';
83 // Is the base path valid?
84 if (empty($templateBasePath)) {
86 throw new BasePathIsEmptyException($templateInstance, self::EXCEPTION_UNEXPECTED_EMPTY_STRING);
87 } elseif (!is_string($templateBasePath)) {
89 throw new InvalidBasePathStringException(array($templateInstance, $templateBasePath), self::EXCEPTION_INVALID_STRING);
90 } elseif (!is_dir($templateBasePath)) {
92 throw new BasePathIsNoDirectoryException(array($templateInstance, $templateBasePath), self::EXCEPTION_INVALID_PATH_NAME);
93 } elseif (!is_readable($templateBasePath)) {
95 throw new BasePathReadProtectedException(array($templateInstance, $templateBasePath), self::EXCEPTION_READ_PROTECED_PATH);
99 $templateInstance->setTemplateBasePath($templateBasePath);
101 // Set template extensions
102 $templateInstance->setRawTemplateExtension($templateInstance->getConfigInstance()->getConfigEntry('raw_template_extension'));
103 $templateInstance->setCodeTemplateExtension($templateInstance->getConfigInstance()->getConfigEntry('node_self_connect_template_extension'));
105 // Absolute output path for compiled templates
106 $templateInstance->setCompileOutputPath($templateInstance->getConfigInstance()->getConfigEntry('base_path') . $templateInstance->getConfigInstance()->getConfigEntry('compile_output_path'));
108 // Init a variable stacker
109 $stackerInstance = ObjectFactory::createObjectByConfiguredName('node_self_connect_stacker_class');
112 $templateInstance->setStackerInstance($stackerInstance);
114 // Return the prepared instance
115 return $templateInstance;
119 * Load a specified self-connect template into the engine
121 * @param $template The self-connect template we shall load which is
122 * located in 'self_connect' by default
125 public function loadSelfConnectTemplate ($template = 'self_connect') {
127 $this->setTemplateType($this->getConfigInstance()->getConfigEntry('node_self_connect_template_type'));
129 // Load the special template
130 $this->loadTemplate($template);
134 * Getter for current main node
136 * @return $currMainNode Current main node
138 public final function getCurrMainNode () {
139 return $this->curr['main_node'];
143 * Setter for current main node
145 * @param $element Element name to set as current main node
146 * @return $currMainNode Current main node
148 private final function setCurrMainNode ($element) {
149 $this->curr['main_node'] = (string) $element;
153 * Getter for main node array
155 * @return $mainNodes Array with valid main node names
157 public final function getMainNodes () {
158 return $this->mainNodes;
162 * Getter for sub node array
164 * @return $subNodes Array with valid sub node names
166 public final function getSubNodes () {
167 return $this->subNodes;
171 * Handles the start element of an XML resource
173 * @param $resource XML parser resource (currently ignored)
174 * @param $element The element we shall handle
175 * @param $attributes All attributes
177 * @throws InvalidXmlNodeException If an unknown/invalid XML node name was found
179 public function startElement ($resource, $element, array $attributes) {
180 // Initial method name which will never be called...
181 $methodName = 'initSelfConnect';
183 // Make the element name lower-case
184 $element = strtolower($element);
186 // Is the element a main node?
187 //* DEBUG: */ echo "START: >".$element."<<br />\n";
188 if (in_array($element, $this->getMainNodes())) {
189 // Okay, main node found!
190 $methodName = 'start' . $this->convertToClassName($element);
193 $this->setCurrMainNode($element);
194 } elseif (in_array($element, $this->getSubNodes())) {
196 $methodName = 'start' . $this->convertToClassName($element);
198 // Invalid node name found
199 throw new InvalidXmlNodeException(array($this, $element, $attributes), XmlParser::EXCEPTION_XML_NODE_UNKNOWN);
203 //* DEBUG: */ echo "call: ".$methodName."<br />\n";
204 call_user_func_array(array($this, $methodName), $attributes);
208 * Ends the main or sub node by sending out the gathered data
210 * @param $resource An XML resource pointer (currently ignored)
211 * @param $nodeName Name of the node we want to finish
213 * @throws XmlNodeMismatchException If current main node mismatches the closing one
215 public function endElement ($resource, $nodeName) {
216 // Make all lower-case
217 $nodeName = strtolower($nodeName);
219 // Does this match with current main node?
220 //* DEBUG: */ echo "END: >".$nodeName."<<br />\n";
221 if (($nodeName != $this->getCurrMainNode()) && (in_array($nodeName, $this->getMainNodes()))) {
223 throw new XmlNodeMismatchException (array($this, $nodeName, $this->getCurrMainNode()), XmlParser::EXCEPTION_XML_NODE_MISMATCH);
226 // Construct method name
227 $methodName = 'finish' . $this->convertToClassName($nodeName);
229 // Call the corresponding method
230 //* DEBUG: */ echo "call: ".$methodName."<br />\n";
231 call_user_func_array(array($this, $methodName), array());
237 * @param $resource XML parser resource (currently ignored)
238 * @param $characters Characters to handle
240 * @todo Find something useful with this!
242 public function characterHandler ($resource, $characters) {
243 // Trim all spaces away
244 $characters = trim($characters);
246 // Is this string empty?
247 if (empty($characters)) {
248 // Then skip it silently
252 // Assign the found characters to variable and use the last entry from
254 parent::assignVariable($this->getStackerInstance()->getNamed('self_connect'), $characters);
258 * Handles the template dependency for given node
260 * @param $node The node we should load a dependency template
261 * @param $templateDependency A template to load to satisfy dependencies
264 private function handleTemplateDependency ($node, $templateDependency) {
265 // Is the template dependency set?
266 if ((!empty($templateDependency)) && (!isset($this->dependencyContent[$node]))) {
267 // Get a temporay template instance
268 $templateInstance = ObjectFactory::createObjectByConfiguredName('node_self_connect_template_class');
271 $templateInstance->loadSelfConnectTemplate($templateDependency);
273 // Parse the XML content
274 $templateInstance->renderXmlContent();
276 // Save the parsed raw content in our dependency array
277 $this->dependencyContent[$node] = $templateInstance->getRawTemplateData();
282 * Getter for cache file (FQFN)
284 * @return $fqfn Full-qualified file name of the menu cache
286 public function getMenuCacheFqfn () {
287 $this->partialStub('Please implement this method.');
291 * Starts the self_connect
295 private function startSelfConnect () {
296 // Push the node name on the stacker
297 $this->getStackerInstance()->pushNamed('self_connect', 'self-connect');
301 * Starts the self_connect data
305 private function startSelfConnectData () {
306 // Push the node name on the stacker
307 $this->getStackerInstance()->pushNamed('self_connect', 'self-connect-data');
315 private function startNodeId () {
316 // Push the node name on the stacker
317 $this->getStackerInstance()->pushNamed('self_connect', 'node-id');
321 * Starts the session id
325 private function startSessionId () {
326 // Push the node name on the stacker
327 $this->getStackerInstance()->pushNamed('self_connect', 'session-id');
331 * Finishes the session id
335 private function finishSessionId () {
336 // Pop the last entry
337 $this->getStackerInstance()->popNamed('self_connect');
341 * Finishes the node id
345 private function finishNodeId () {
346 // Pop the last entry
347 $this->getStackerInstance()->popNamed('self_connect');
351 * Finishes the self_connect data
355 private function finishSelfConnectData () {
356 // Pop the last entry
357 $this->getStackerInstance()->popNamed('self_connect');
361 * Finishes the self_connect
365 private function finishSelfConnect () {
366 // Pop the last entry
367 $this->getStackerInstance()->popNamed('self_connect');