SMMP/manager/ModuleRequest.php

<?php 

	namespace manager;
	

	// FORMAT: 
	// 
	// path:  "nomModule/nomMethode"
	// data1: {donnee1}
	// data2: {donnee2}
	// ...
	// 
	// 
	// 
	// 

	class ModuleRequest{

		// Constantes
		public static $config_path = '/f/json/modules/conf';


		// Attributs prives utiles (initialisation)
		private $path;
		private $data;






		/* CONSTRUCTEUR D'UNE REQUETE DE MODULE
		*
		* @path<String>				Chemin de delegation ("module/methode")
		* @data<Array>				Tableau contenant les parametres utiles au traitement
		*
		* @return status<Boolean>	Retourne si oui ou non tout s'est bien passe
		*
		*/
		public function __construct($path=null, $data=null){
			// Si pas parametre manquant, on quitte
			if( $path == null ) return false;

			/* [0] On met a jour la configuration
			=========================================================*/
			// Modules specifies
			$this->modules = json_decode( ResourcesDispatcher::getResource(self::$config_path), true );
			
			// Gestion de l'erreur de parsage
			if( $this->modules == null ) return false;



			/* [1] Verification des types des parametres
			=========================================================*/
			// Type de @path
			if( !is_string($path) ) // Si le type est incorrect
				return false; // On retourne FALSE, si erreur

			// Type de @data (optionnel)
			$data = (is_array($data)) ? $data : array(); 


			/* [2] Verification du chemin (existence module+methode)
			=========================================================*/
			if( !$this->checkPath($path) ) // Verification de la coherence du chemin + attribution
				return false; // On retourne FALSE, si erreur



			/* [3] Construction de l'objet
			=========================================================*/
			$this->data = $data;
			
			return true; // On retourne que tout s'est bien passe

		}





		/* VERIFICATION DU FORMAT ET DE LA COHERENCE DU CHEMIN SPECIFIE
		*
		* @path<String> 									String correspondant au chemin de delegation ("module/methode")
		*
		* @return validity<Boolean> 						Retourne si oui ou non l'objet est correct
		*
		*/
		private function checkPath($path){
			/* [1] Verification format general
			=========================================================*/
			if( !preg_match('#^([\w_-]+)/([\w_-]+)$#i', $path, $matches) ) // Si mauvais format
				return false;

			// On recupere les donnes de la regex
			$module = $matches[1];
			$method = $matches[2];

			/* [2] Verification de l'existence du module (conf)
			=========================================================*/
			if( !array_key_exists($module, $this->modules) ) // Si le module n'est pas specifie dans la conf
				return false; // On retourne FALSE, si erreur
			

			/* [3] Verification de l'existence de la methode (conf)
			=========================================================*/
			if( array_search($method, $this->modules[$module]) === false ) // Si la methode n'est pas specifie dans la conf
				return false; // On retourne FALSE, si erreur
			


			/* [4] Enregistrement du chemin et renvoi de SUCCESS
			=========================================================*/
			$this->path = array(
				'module' => $module,
				'method' => $method
			);

			return true;
		}





		/* DESERIALISATION ET CREATION D'UN OBJET
		*
		* @jsonString<String> 									Json au format string contenant les donnees
		*
		* @return instance<ModuleRequest> 						Retourne un objet de type <ModuleRequest>
		*
		*/
		public static function fromString($jsonString){
			$json = json_decode( $jsonString, true );

			// Verification du parsage
			if( $json == null )
				return new ModuleRequest();

			// Verification des parametres
			if( !isset($json['path']) )
				return new ModuleRequest();

			// On definit $data au cas ou il soit vide
			$data = (isset($json['data'])) ? $json['data'] : array();

			return new ModuleRequest($json['path'], $data);
		}



	}

?>