Subversion Repositories eFlore/Applications.del

Rev

Details | Last modification | View Log | RSS feed

Rev Author Line No. Line
1 aurelien 1 
<?php
2 
/**
3 
 * Service Exemple pour apprendre à utiliser les classes JRest
4 
 * Encodage en entrée : utf8
5 
 * Encodage en sortie : utf8
6 
 *
7 
 * @author Aurélien PERONNET <aurelien@tela-botanica.org>
8 
 * @license GPL v3 <http://www.gnu.org/licenses/gpl.txt>
9 
 * @license CECILL v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt>
10 
 * @version $Id$
11 
 */
12 
class ExempleService extends Del {
13 
 
14 
	/**
15 
	* Méthode appelée avec une requête de type GET avec une url de la forme
16 
	* http://localhost/jrest/ExempleService/
17 
	*
18 
	* Sert normalement à renvoyer la description des possibilités du service
19 
	*
20 
	*/
21 
	public function getRessource() {
22 
		$chaine = '<div>'.
23 
					'<p> Bonjour, je suis un service web </p>'.
24 
					'<p> Vous pouvez m\'appeler avec les méthodes GET, POST, PUT et DELETE </p>'.
25 
				  '</div>';
26 
 
27 
		$this->envoyer($chaine);
28 
	}
29 
 
30 
	/**
31 
	* Méthode appelée avec une requête de type GET avec une url de la forme
32 
	* http://localhost/jrest/ExempleService/uid[0]/$uid[1]/ etc...
33 
	*
34 
	* Sert normalement à ramener un élément précis indiqué par un identifiant
35 
	* qui se situe dans l'url après le nom du service
36 
	* Le filtrage, le format de retour, les paramètres optionnels ... sont normalement indiqués
37 
	* dans le tableau $_GET
38 
	* Pour obtenir l'élément 2501 dans le format HTML cela pourrait donner
39 
	* http://localhost/jrest/ExempleService/2501?format=HTML
40 
	*
41 
	* @param $uid un tableau contenant les élements passés dans l'url après le nom du service
42 
	*
43 
	*/
44 
	public function getElement($uid)
3 aurelien 45 
	{
46 
		$format = 'html';
47 
 
48 
		if(isset($_GET['format'])) {
49 
			$format = strtolower($_GET['format']);
50 
		}
51 
 
52 
		switch ($format) {
53 
 
54 
			case 'html':
55 
				$retour = '<div id="element_'.$uid[0].'">'.
56 
							'<p> Bonjour, je suis l\'élément '.$uid[0].' </p>'.
57 
							'<span> Les filtres demandés sont : </span>'.
58 
							'<ul>';
59 
				foreach($_GET as $cle => $valeur) {
60 
					$retour .= '<li>'.$cle.' = '.$valeur.'</li>';
61 
				}
62 
				$retour .= '</ul>'.
63 
						  '</div>';
64 
 
65 
				$mime = 'text/html';
66 
			break;
67 
 
68 
			case 'json':
69 
				$retour = array('id' => $uid[0],
70 
								'message' => 'Bonjour, je suis l\'élément '.$uid[0],
71 
								'filtres' => $_GET);
72 
				$retour = json_encode($retour);
73 
				$mime = 'application/json';
74 
			break;
75 
 
76 
			case 'xml':
77 
 
78 
				$retour = '<?xml version="1.0" encoding="utf-8"?>';
79 
				$retour .= '<element id="element_'.$uid[0].'"> '.
80 
							'<message> Bonjour, je suis l\'élément '.$uid[0].' </message>'.
81 
							'<filtres> Les filtres demandés sont : ';
82 
				foreach($_GET as $cle => $valeur) {
83 
					$retour .= '<filtre>'.$cle.' = '.$valeur.'</filtre>';
84 
				}
85 
				$retour .= '</filtres>'.
86 
						  '</element>';
87 
 
88 
				$mime = 'text/xml';
89 
			break;
90 
		}
1 aurelien 91 
 
3 aurelien 92 
		$this->envoyer($retour,$mime);
1 aurelien 93 
	}
94 
 
95 
	/**
96 
	 * Méthode appelée avec une requête de type PUT, ou bien un POST sans identifiant après le nom
97 
	 * du service, donc une url de la forme :
98 
	 * http://localhost/jrest/ExempleService/ + du contenu dans le post
99 
	 * Cette méthode sert normalement a créer un nouvel élément avec les données fournies en post
100 
	 *
101 
	 * @param array $pairs Un tableau contenant les valeurs passées dans le post qui permettront de créer l'élement
102 
	*/
103 
	function createElement($pairs)
104 
	{
105 
		$chaine = '<div>'.
106 
					'<p> Bonjour, vous venez de créer un nouvel élément </p>'.
107 
					'<span> Les données suivantes ont été utilisées : </span>'.
108 
					'<ul>';
109 
		foreach($pairs as $cle => $valeur) {
110 
			$chaine .= '<li>'.$cle.' = '.$valeur.'</li>';
111 
		}
112 
		$chaine .= '</ul>'.
113 
				  '</div>';
114 
 
115 
		$this->envoyer($chaine);
116 
	}
117 
 
118 
	/**
119 
	 * Méthode appelée avec une requête de type PUT, ou bien un POST avec un identifiant après le nom
120 
	 * du service, donc une url de la forme :
121 
	 * http://localhost/jrest/ExempleService/$uid[0] + du contenu dans le post
122 
	 * Cette méthode sert normalement a modifier un élément existant avec les données fournies
123 
	 * en post
124 
	 *
125 
	 * @param array $pairs Un tableau contenant les valeurs passées dans le post qui permettront
126 
	 * de modifier l'élement indiqué par ce qui suit le nom du service dans l'url
127 
	*/
128 
	public function updateElement($uid,$pairs)
129 
	{
130 
		$chaine = '<div>'.
131 
					'<p> Bonjour, l\'élément '.$uid[0].' a été modifié </p>'.
132 
					'<span> Les données suivantes ont été utilisées : </span>'.
133 
					'<ul>';
134 
		foreach($pairs as $cle => $valeur) {
135 
			$chaine .= '<li>'.$cle.' = '.$valeur.'</li>';
136 
		}
137 
		$chaine .= '</ul>'.
138 
				  '</div>';
139 
 
140 
		$this->envoyer($chaine);
141 
	}
142 
 
143 
	/**
144 
	 * Méthode appelée avec une requête de type DELETE, en indiquant l'identifiant de l'élément à supprimer
145 
	 * ce qui donne une url de la forme :
146 
	 * http://localhost/jrest/ExempleService/$uid[0]
147 
	 *
148 
	 * ATTENTION : Safari ne sais pas envoyer les DELETE donc on triche en faisant un post qui contient
149 
	 * action=DELETE (les majuscules sont importantes)
150 
	 * On a donc http://localhost/jrest/ExempleService/$uid[0] + action=DELETE dans le post
151 
	 *
152 
	 * @param $uid un tableau contenant les élements passés dans l'url après le nom du service
153 
	*/
154 
	function deleteElement($uid){
155 
 
156 
		$chaine = '<div>'.
157 
					'<p> Bonjour, l\'élément '.$uid[0].' a été supprimé </p>'.
158 
				  '</div>';
159 
 
160 
		$this->envoyer($chaine);
161 
	}
162 
}
163 
?>