<?php

/**
 * 
 * @author pizar
 * @copyright Copyright &copy; 2008, pizar
 * 
 * version 1.0
 * Required PHP 5.0
 * 
 * The class is build to read from the xml structure define from the sun.
 * 
 * <!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd">
 * <?xml version="1.0" encoding="iso-8859-1"?>
 * <properties> 
 *     ...
 *     <entry key="invio"><![CDATA[invio]]></entry>
 *     ...
 * </properties>
 *  
 */
class XMLResourceBoundle{

    /**
     * A private variable, who maintain the reference on the xml file
     * @access private
     * @var string
     */
	private $doc="";
	
	
	
    /**
     * Constructor sets up the source file xml to read, and the language from where read.
     * The structure bust be: ${path}/${language}/{$filename}
     * @param string $path
     * @param string $filename
     * @param string $languageCode, the default is ""
     */
	function XMLResourceBoundle(string $path,string $filename, string $languageCode=""){
		$complete_path="";
		
		$this->doc = new DomDocument;
		$this->doc->preserveWhiteSpace = false;
		
		if ($languageCode!=""){
			$complete_path=$path."/".$languageCode."/".$filename;
		}else{
			$complete_path=$path."/".$filename;
		}
		
		$this->doc->load($complete_path);
		$this->xpath = new DOMXPath($this->doc);
	}
	
	/**
     * Constructor sets up the source file xml to read, and the language from where read.
     * The structure bust be: ${path}/${language}/{$filename}
     * @param string the id of the key to get
     * @return string the value of the key in the xml node, if the key is not found, 
     * return the key with ??? before and after. 
     */
	function get(string $keyId){
		$query = "//entry[@key='".$keyId."']";
		$entries = $this->xpath->evaluate($query, $this->doc);
		
		if ($entries->item(0)->nodeValue!=""){
			return($entries->item(0)->nodeValue);
		}else{
			return("???".$keyId."???");
		}
	}
}
?>