<?php
// declare(encoding='UTF-8');
/**
 * Classe contenant des méthodes :
 *  - d'intialisation des tests,
 *  - refactorisant le code des tests,
 *  - facilitant les tests.
 *
 * @category	php 5.3
 * @package		Tests/Services
 * @author		Jean-Pascal MILCENT <jpm@tela-botanica.org>
 * @copyright	Copyright (c) 2011, Tela Botanica (accueil@tela-botanica.org)
 * @license		http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL
 * @license		http://www.gnu.org/licenses/gpl.html Licence GNU-GPL
 * @version		$Id$
 */
abstract class ReferentielPhpUnit extends PHPUnit_Framework_TestCase {

	//+------------------------------------------------------------------------------------------------------+
	// Intialisation

	public static function setUpBeforeClass() {
		error_reporting(E_ALL);
		self::chargerFramework();

		// Enregistrement en première position des autoload de la méthode gérant les classes des services
		spl_autoload_register(array(get_class(), 'chargerClasseAuto'));
	}

	public static function chargerClasseAuto($classe) {
		if (class_exists($classe)) {
			return null;
		}
		
		$cheminsTests = __DIR__.'/';
		$cheminControleurs = realpath(__DIR__.'/../interfaces/controleurs').'/';
		$cheminBiblioDao = realpath(__DIR__.'/../bibliotheque/dao').'/';
		$cheminService = realpath(__DIR__.'/../services/modules').'/';
		$chemins = array($cheminsTests,  $cheminBiblioDao, $cheminService);
		foreach ($chemins as $chemin) {
			$cheminCourt = $chemin.$classe.'.php';
			if (file_exists($cheminCourt)) {
				require_once $cheminCourt;
			}
		}
	}

	private static function chargerFramework() {
		$cheminRacine = realpath(dirname(__FILE__).'/..').'/interfaces/';
		$framework =  $cheminRacine.'framework.php';
		if (!file_exists($framework)) {
			$e = "Veuillez paramétrer l'emplacement et la version du Framework dans le fichier $framework";
			trigger_error($e, E_USER_ERROR);
		} else {
			// Inclusion du Framework
			require_once $framework;
		}
	}

	//+------------------------------------------------------------------------------------------------------+
	// Refactorisation
	protected function consulterJson($ressources, $parametres) {
		$retourJson = $this->consulterBrut($ressources, $parametres);
		$retour = json_decode($retourJson, true);
		$this->assertEquals(JSON_ERROR_NONE, json_last_error(), "Le json contient des erreurs qui bloquent le décodage. Voir : $url");
		return $retour;
	}

	protected function consulterBrut($ressources, $parametres) {
		array_unshift($ressources, $this->service);
		array_unshift($ressources, $this->projet);
		$projets = new Projets();
		$retourJson = $projets->consulter($ressources, $parametres);
		return $retourJson;
	}

	protected function creerUrl($ressources, $parametres) {
		$version = '';
		$ressourcesUrl = array();
		foreach ($ressources as $ressource) {
			$ressourcesUrl[] = $ressource;
		}
		$ressourcesUrl = count($ressourcesUrl) > 0 ? '/'.implode('/', $ressourcesUrl) : '';

		$parametresUrl = '';
		if (count($parametres) > 0) {
			foreach ($parametres as $cle => $valeur) {
				$parametresUrl[] = $cle.'='.rawurlencode($valeur);
			}
			$parametresUrl = '?'.implode('&', $parametresUrl);
		}

		$url = 'http://localhost/service:eflore:0.1'.$ressourcesUrl.$parametresUrl;
		return $url;
	}

	//+------------------------------------------------------------------------------------------------------+
	// Méthodes facilitant les tests
	
	/**
	* Récupère un bouchon de classe abstraite.
	* Comment l'utiliser :
	* 	$classeAstraite = $this->getClasseAbstraite('MaClasse', array('param1', 'param2'));
	*   $foo = $classeAstraite->methodeConcretePublique();
	*
	* @param String $classeNom Le nom de la classe
	* @param Array $parametres Les paramètres à passer au constructeur.
	* @return Object Le bouchon de la classe abstraite
	*/
	public function getClasseAbstraite($classeNom, Array $parametres) {
		$efloreScript = $this->getMockForAbstractClass($classeNom, $parametres);
		return $efloreScript;
	}

	/**
	 * Récupère une méthode privée d'une classe pour tester/documenter.
	 * Comment l'utiliser :
	 * 	MyClass->foo():
	 *   $cls = new MyClass();
	 *   $foo = self::getPrivateMethode($cls, 'foo');
	 *   $foo->invoke($cls, $...);
	 *
	 * @param object $objet Une instance de votre classe
	 * @param string $methode Le nom de la méthode private
	 * @return ReflectionMethod La méthode demandée
	 */
	public static function getMethodePrivee($objet, $nomMethode) {
		$classe = new ReflectionClass($objet);
		$methode = $classe->getMethod($nomMethode);
		$methode->setAccessible(true);
		return $methode;
	}

	/**
	* Récupère une méthode protégée d'une classe pour tester/documenter.
	* Comment l'utiliser :
	* 	MyClass->foo():
	*   $cls = new MyClass();
	*   $foo = self::getProtectedMethode($cls, 'foo');
	*   $foo->invoke($cls, $...);
	* @param object $objet Une instance de votre classe
	* @param string $methode Le nom de la méthode protected
	* @return ReflectionMethod La méthode demandée
	*/
	public static function getMethodeProtegee($objet, $nomMethode) {
		return self::getMethodePrivee($objet, $nomMethode);
	}
}
?>