| 297 |
jpm |
1 |
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
|
2 |
<html xmlns="http://www.w3.org/1999/xhtml">
|
|
|
3 |
<head>
|
|
|
4 |
<!-- template designed by Marco Von Ballmoos -->
|
|
|
5 |
<title>Docs For Class RestService</title>
|
|
|
6 |
<meta http-equiv='Content-Type' content='text/html; charset=UTF-8'/>
|
|
|
7 |
<link rel="stylesheet" href="../media/stylesheet.css" />
|
|
|
8 |
<script src="../media/lib/classTree.js"></script>
|
|
|
9 |
<script language="javascript" type="text/javascript">
|
|
|
10 |
var imgPlus = new Image();
|
|
|
11 |
var imgMinus = new Image();
|
|
|
12 |
imgPlus.src = "../media/images/plus.png";
|
|
|
13 |
imgMinus.src = "../media/images/minus.png";
|
|
|
14 |
|
|
|
15 |
function showNode(Node){
|
|
|
16 |
switch(navigator.family){
|
|
|
17 |
case 'nn4':
|
|
|
18 |
// Nav 4.x code fork...
|
|
|
19 |
var oTable = document.layers["span" + Node];
|
|
|
20 |
var oImg = document.layers["img" + Node];
|
|
|
21 |
break;
|
|
|
22 |
case 'ie4':
|
|
|
23 |
// IE 4/5 code fork...
|
|
|
24 |
var oTable = document.all["span" + Node];
|
|
|
25 |
var oImg = document.all["img" + Node];
|
|
|
26 |
break;
|
|
|
27 |
case 'gecko':
|
|
|
28 |
// Standards Compliant code fork...
|
|
|
29 |
var oTable = document.getElementById("span" + Node);
|
|
|
30 |
var oImg = document.getElementById("img" + Node);
|
|
|
31 |
break;
|
|
|
32 |
}
|
|
|
33 |
oImg.src = imgMinus.src;
|
|
|
34 |
oTable.style.display = "block";
|
|
|
35 |
}
|
|
|
36 |
|
|
|
37 |
function hideNode(Node){
|
|
|
38 |
switch(navigator.family){
|
|
|
39 |
case 'nn4':
|
|
|
40 |
// Nav 4.x code fork...
|
|
|
41 |
var oTable = document.layers["span" + Node];
|
|
|
42 |
var oImg = document.layers["img" + Node];
|
|
|
43 |
break;
|
|
|
44 |
case 'ie4':
|
|
|
45 |
// IE 4/5 code fork...
|
|
|
46 |
var oTable = document.all["span" + Node];
|
|
|
47 |
var oImg = document.all["img" + Node];
|
|
|
48 |
break;
|
|
|
49 |
case 'gecko':
|
|
|
50 |
// Standards Compliant code fork...
|
|
|
51 |
var oTable = document.getElementById("span" + Node);
|
|
|
52 |
var oImg = document.getElementById("img" + Node);
|
|
|
53 |
break;
|
|
|
54 |
}
|
|
|
55 |
oImg.src = imgPlus.src;
|
|
|
56 |
oTable.style.display = "none";
|
|
|
57 |
}
|
|
|
58 |
|
|
|
59 |
function nodeIsVisible(Node){
|
|
|
60 |
switch(navigator.family){
|
|
|
61 |
case 'nn4':
|
|
|
62 |
// Nav 4.x code fork...
|
|
|
63 |
var oTable = document.layers["span" + Node];
|
|
|
64 |
break;
|
|
|
65 |
case 'ie4':
|
|
|
66 |
// IE 4/5 code fork...
|
|
|
67 |
var oTable = document.all["span" + Node];
|
|
|
68 |
break;
|
|
|
69 |
case 'gecko':
|
|
|
70 |
// Standards Compliant code fork...
|
|
|
71 |
var oTable = document.getElementById("span" + Node);
|
|
|
72 |
break;
|
|
|
73 |
}
|
|
|
74 |
return (oTable && oTable.style.display == "block");
|
|
|
75 |
}
|
|
|
76 |
|
|
|
77 |
function toggleNodeVisibility(Node){
|
|
|
78 |
if (nodeIsVisible(Node)){
|
|
|
79 |
hideNode(Node);
|
|
|
80 |
}else{
|
|
|
81 |
showNode(Node);
|
|
|
82 |
}
|
|
|
83 |
}
|
|
|
84 |
</script>
|
|
|
85 |
</head>
|
|
|
86 |
<body>
|
|
|
87 |
<div class="page-body">
|
|
|
88 |
<h2 class="class-name">Class RestService</h2>
|
|
|
89 |
|
|
|
90 |
<a name="sec-description"></a>
|
|
|
91 |
<div class="info-box">
|
|
|
92 |
<div class="info-box-title">Description</div>
|
|
|
93 |
<div class="nav-bar">
|
|
|
94 |
<span class="disabled">Description</span> |
|
|
|
95 |
<a href="#sec-var-summary">Vars</a> (<a href="#sec-vars">details</a>)
|
|
|
96 |
| <a href="#sec-method-summary">Methods</a> (<a href="#sec-methods">details</a>)
|
|
|
97 |
|
|
|
98 |
</div>
|
|
|
99 |
<div class="info-box-body">
|
|
|
100 |
<!-- ========== Info from phpDoc block ========= -->
|
|
|
101 |
<p class="short-description">Classe principale gérant les services.</p>
|
|
|
102 |
<p class="description"><p>Paramètres liés dans config.ini : <ul><li>serveur.baseURL</li></ul> Encodage en entrée : utf8 Encodage en sortie : utf8</p></p>
|
|
|
103 |
<ul class="tags">
|
|
|
104 |
<li><span class="field">author:</span> Jean-Pascal MILCENT <<a href="mailto:jpm@tela-botanica.org">jpm@tela-botanica.org</a>></li>
|
| 300 |
jpm |
105 |
<li><span class="field">version:</span> $Id: RestService.php 299 2011-01-18 14:03:46Z jpm $</li>
|
| 297 |
jpm |
106 |
<li><span class="field">copyright:</span> Copyright (c) 2010, Tela Botanica (accueil@tela-botanica.org)</li>
|
|
|
107 |
<li><span class="field">link:</span> /doc/framework/</li>
|
|
|
108 |
<li><span class="field">abstract:</span> </li>
|
|
|
109 |
<li><span class="field">since:</span> 0.3</li>
|
|
|
110 |
<li><span class="field">license:</span> GPL</li>
|
|
|
111 |
<li><span class="field">license:</span> CECILL</li>
|
|
|
112 |
</ul>
|
|
|
113 |
<p class="notes">
|
|
|
114 |
Located in <a class="field" href="_RestService.php.html">/RestService.php</a> (line <span class="field"><a href="../__filesource/fsource_Framework__RestService.php.html#a20">20</a></span>)
|
|
|
115 |
</p>
|
|
|
116 |
|
|
|
117 |
|
|
|
118 |
<pre></pre>
|
|
|
119 |
|
|
|
120 |
</div>
|
|
|
121 |
</div>
|
|
|
122 |
|
|
|
123 |
|
|
|
124 |
|
|
|
125 |
<a name="sec-var-summary"></a>
|
|
|
126 |
<div class="info-box">
|
|
|
127 |
<div class="info-box-title">Variable Summary</span></div>
|
|
|
128 |
<div class="nav-bar">
|
|
|
129 |
<a href="#sec-description">Description</a> |
|
|
|
130 |
<span class="disabled">Vars</span> (<a href="#sec-vars">details</a>)
|
|
|
131 |
|
|
|
|
132 |
<a href="#sec-method-summary">Methods</a> (<a href="#sec-methods">details</a>)
|
|
|
133 |
|
|
|
134 |
</div>
|
|
|
135 |
<div class="info-box-body">
|
|
|
136 |
<div class="var-summary">
|
|
|
137 |
<div class="var-title">
|
|
|
138 |
<span class="var-type">mixed</span>
|
|
|
139 |
<a href="#$bdd" title="details" class="var-name">$bdd</a>
|
|
|
140 |
</div>
|
|
|
141 |
</div>
|
|
|
142 |
</div>
|
|
|
143 |
</div>
|
|
|
144 |
|
|
|
145 |
<a name="sec-method-summary"></a>
|
|
|
146 |
<div class="info-box">
|
|
|
147 |
<div class="info-box-title">Method Summary</span></div>
|
|
|
148 |
<div class="nav-bar">
|
|
|
149 |
<a href="#sec-description">Description</a> |
|
|
|
150 |
<a href="#sec-var-summary">Vars</a> (<a href="#sec-vars">details</a>)
|
|
|
151 |
|
|
|
152 |
|
|
|
|
153 |
<span class="disabled">Methods</span> (<a href="#sec-methods">details</a>)
|
|
|
154 |
</div>
|
|
|
155 |
<div class="info-box-body">
|
|
|
156 |
<div class="method-summary">
|
|
|
157 |
|
|
|
158 |
<div class="method-definition">
|
|
|
159 |
<span class="method-result">RestService</span>
|
|
|
160 |
<a href="#__construct" title="details" class="method-name">__construct</a>
|
|
|
161 |
(<span class="var-type"></span> <span class="var-name">$config</span>)
|
|
|
162 |
</div>
|
|
|
163 |
|
|
|
164 |
<div class="method-definition">
|
|
|
165 |
<span class="method-result">string</span>
|
|
|
166 |
<a href="#ajouter" title="details" class="method-name">ajouter</a>
|
|
|
167 |
(<span class="var-type">array</span> <span class="var-name">$ressources</span>, <span class="var-type">array</span> <span class="var-name">$requeteDonnees</span>)
|
|
|
168 |
</div>
|
|
|
169 |
|
|
|
170 |
<div class="method-definition">
|
|
|
171 |
<span class="method-result">string</span>
|
|
|
172 |
<a href="#consulter" title="details" class="method-name">consulter</a>
|
|
|
173 |
(<span class="var-type">array</span> <span class="var-name">$ressources</span>, <span class="var-type">array</span> <span class="var-name">$parametres</span>)
|
|
|
174 |
</div>
|
|
|
175 |
|
|
|
176 |
<div class="method-definition">
|
|
|
177 |
<span class="method-result">mixed</span>
|
|
|
178 |
<a href="#modifier" title="details" class="method-name">modifier</a>
|
|
|
179 |
(<span class="var-type">array</span> <span class="var-name">$ressources</span>, <span class="var-type">array</span> <span class="var-name">$requeteDonnees</span>)
|
|
|
180 |
</div>
|
|
|
181 |
|
|
|
182 |
<div class="method-definition">
|
|
|
183 |
<span class="method-result">mixed</span>
|
|
|
184 |
<a href="#supprimer" title="details" class="method-name">supprimer</a>
|
|
|
185 |
(<span class="var-type">array</span> <span class="var-name">$ressources</span>)
|
|
|
186 |
</div>
|
|
|
187 |
</div>
|
|
|
188 |
</div>
|
|
|
189 |
</div>
|
|
|
190 |
|
|
|
191 |
<a name="sec-vars"></a>
|
|
|
192 |
<div class="info-box">
|
|
|
193 |
<div class="info-box-title">Variables</div>
|
|
|
194 |
<div class="nav-bar">
|
|
|
195 |
<a href="#sec-description">Description</a> |
|
|
|
196 |
<a href="#sec-var-summary">Vars</a> (<span class="disabled">details</span>)
|
|
|
197 |
|
|
|
198 |
|
|
|
199 |
|
|
|
|
200 |
<a href="#sec-method-summary">Methods</a> (<a href="#sec-methods">details</a>)
|
|
|
201 |
|
|
|
202 |
</div>
|
|
|
203 |
<div class="info-box-body">
|
|
|
204 |
|
|
|
205 |
<a name="var$bdd" id="$bdd"><!-- --></A>
|
|
|
206 |
<div class="evenrow">
|
|
|
207 |
|
|
|
208 |
<div class="var-header">
|
|
|
209 |
<span class="var-title">
|
|
|
210 |
<span class="var-type">mixed</span>
|
|
|
211 |
<span class="var-name">$bdd</span>
|
|
|
212 |
(line <span class="line-number"><a href="../__filesource/fsource_Framework__RestService.php.html#a23">23</a></span>)
|
|
|
213 |
</span>
|
|
|
214 |
</div>
|
|
|
215 |
|
|
|
216 |
<!-- ========== Info from phpDoc block ========= -->
|
|
|
217 |
<p class="short-description">Objet de connection à la base de données.</p>
|
|
|
218 |
<ul class="tags">
|
|
|
219 |
<li><span class="field">access:</span> protected</li>
|
|
|
220 |
</ul>
|
|
|
221 |
|
|
|
222 |
|
|
|
223 |
|
|
|
224 |
|
|
|
225 |
|
|
|
226 |
</div>
|
|
|
227 |
|
|
|
228 |
</div>
|
|
|
229 |
</div>
|
|
|
230 |
|
|
|
231 |
<a name="sec-methods"></a>
|
|
|
232 |
<div class="info-box">
|
|
|
233 |
<div class="info-box-title">Methods</div>
|
|
|
234 |
<div class="nav-bar">
|
|
|
235 |
<a href="#sec-description">Description</a> |
|
|
|
236 |
<a href="#sec-var-summary">Vars</a> (<a href="#sec-vars">details</a>)
|
|
|
237 |
<a href="#sec-method-summary">Methods</a> (<span class="disabled">details</span>)
|
|
|
238 |
|
|
|
239 |
</div>
|
|
|
240 |
<div class="info-box-body">
|
|
|
241 |
<A NAME='method_detail'></A>
|
|
|
242 |
<a name="method__construct" id="__construct"><!-- --></a>
|
|
|
243 |
<div class="oddrow">
|
|
|
244 |
|
|
|
245 |
<div class="method-header">
|
|
|
246 |
<span class="method-title">Constructor __construct</span> (line <span class="line-number"><a href="../__filesource/fsource_Framework__RestService.php.html#a25">25</a></span>)
|
|
|
247 |
</div>
|
|
|
248 |
|
|
|
249 |
<!-- ========== Info from phpDoc block ========= -->
|
|
|
250 |
<ul class="tags">
|
|
|
251 |
<li><span class="field">access:</span> public</li>
|
|
|
252 |
</ul>
|
|
|
253 |
|
|
|
254 |
<div class="method-signature">
|
|
|
255 |
<span class="method-result">RestService</span>
|
|
|
256 |
<span class="method-name">
|
|
|
257 |
__construct
|
|
|
258 |
</span>
|
|
|
259 |
(<span class="var-type"></span> <span class="var-name">$config</span>)
|
|
|
260 |
</div>
|
|
|
261 |
|
|
|
262 |
<ul class="parameters">
|
|
|
263 |
<li>
|
|
|
264 |
<span class="var-type"></span>
|
|
|
265 |
<span class="var-name">$config</span> </li>
|
|
|
266 |
</ul>
|
|
|
267 |
|
|
|
268 |
|
|
|
269 |
</div>
|
|
|
270 |
<a name="methodajouter" id="ajouter"><!-- --></a>
|
|
|
271 |
<div class="evenrow">
|
|
|
272 |
|
|
|
273 |
<div class="method-header">
|
|
|
274 |
<span class="method-title">ajouter</span> (line <span class="line-number"><a href="../__filesource/fsource_Framework__RestService.php.html#a73">73</a></span>)
|
|
|
275 |
</div>
|
|
|
276 |
|
|
|
277 |
<!-- ========== Info from phpDoc block ========= -->
|
|
|
278 |
<p class="short-description">Méthode appelée lors d'une requête HTTP de type PUT.</p>
|
|
|
279 |
<p class="description"><p>L'identifiant de la ressource à ajouter est indiqué via l'url si on le connait par avance. Sinon, il doit être créé par le service. Dans ce dernier cas, le nouvel identifiant devrait être renvoyé dans le corps de la réponse. Si l'ajout est un succès, le code statut HTTP retourné devrait être 201.</p></p>
|
|
|
280 |
<ul class="tags">
|
|
|
281 |
<li><span class="field">return:</span> l'identifiant créé.</li>
|
|
|
282 |
<li><span class="field">access:</span> public</li>
|
|
|
283 |
</ul>
|
|
|
284 |
|
|
|
285 |
<div class="method-signature">
|
|
|
286 |
<span class="method-result">string</span>
|
|
|
287 |
<span class="method-name">
|
|
|
288 |
ajouter
|
|
|
289 |
</span>
|
|
|
290 |
(<span class="var-type">array</span> <span class="var-name">$ressources</span>, <span class="var-type">array</span> <span class="var-name">$requeteDonnees</span>)
|
|
|
291 |
</div>
|
|
|
292 |
|
|
|
293 |
<ul class="parameters">
|
|
|
294 |
<li>
|
|
|
295 |
<span class="var-type">array</span>
|
|
|
296 |
<span class="var-name">$ressources</span><span class="var-description">: Morceaux de l'url servant à préciser la ressource concerné pour le service demandé.</span> </li>
|
|
|
297 |
<li>
|
|
|
298 |
<span class="var-type">array</span>
|
|
|
299 |
<span class="var-name">$requeteDonnees</span><span class="var-description">: les données transférées dans le corps de la requête devant servir à l'ajout.</span> </li>
|
|
|
300 |
</ul>
|
|
|
301 |
|
|
|
302 |
|
|
|
303 |
</div>
|
|
|
304 |
<a name="methodconsulter" id="consulter"><!-- --></a>
|
|
|
305 |
<div class="oddrow">
|
|
|
306 |
|
|
|
307 |
<div class="method-header">
|
|
|
308 |
<span class="method-title">consulter</span> (line <span class="line-number"><a href="../__filesource/fsource_Framework__RestService.php.html#a41">41</a></span>)
|
|
|
309 |
</div>
|
|
|
310 |
|
|
|
311 |
<!-- ========== Info from phpDoc block ========= -->
|
|
|
312 |
<p class="short-description">Méthode appelée lors d'une requête HTTP de type GET.</p>
|
|
|
313 |
<p class="description"><p>Si la consultation est un succès, le code statut HTTP retourné devrait être 200.</p></p>
|
|
|
314 |
<ul class="tags">
|
|
|
315 |
<li><span class="field">return:</span> une chaine indiquant le succès de l'opération et les données demandées.</li>
|
|
|
316 |
<li><span class="field">access:</span> public</li>
|
|
|
317 |
</ul>
|
|
|
318 |
|
|
|
319 |
<div class="method-signature">
|
|
|
320 |
<span class="method-result">string</span>
|
|
|
321 |
<span class="method-name">
|
|
|
322 |
consulter
|
|
|
323 |
</span>
|
|
|
324 |
(<span class="var-type">array</span> <span class="var-name">$ressources</span>, <span class="var-type">array</span> <span class="var-name">$parametres</span>)
|
|
|
325 |
</div>
|
|
|
326 |
|
|
|
327 |
<ul class="parameters">
|
|
|
328 |
<li>
|
|
|
329 |
<span class="var-type">array</span>
|
|
|
330 |
<span class="var-name">$ressources</span><span class="var-description">: Morceaux de l'url servant à préciser la ressource concerné pour le service demandé.</span> </li>
|
|
|
331 |
<li>
|
|
|
332 |
<span class="var-type">array</span>
|
|
|
333 |
<span class="var-name">$parametres</span><span class="var-description">: Partie de l'url situé après le '?' servant à paramétrer le service demandé.</span> </li>
|
|
|
334 |
</ul>
|
|
|
335 |
|
|
|
336 |
|
|
|
337 |
</div>
|
|
|
338 |
<a name="methodmodifier" id="modifier"><!-- --></a>
|
|
|
339 |
<div class="evenrow">
|
|
|
340 |
|
|
|
341 |
<div class="method-header">
|
|
|
342 |
<span class="method-title">modifier</span> (line <span class="line-number"><a href="../__filesource/fsource_Framework__RestService.php.html#a57">57</a></span>)
|
|
|
343 |
</div>
|
|
|
344 |
|
|
|
345 |
<!-- ========== Info from phpDoc block ========= -->
|
|
|
346 |
<p class="short-description">Méthode appelée lors d'une requête HTTP de type POST.</p>
|
|
|
347 |
<p class="description"><p>La ressource à modifier est indiquée via l'url. Les données devant servir à la mise à jours sont passées dans le corps de la requête. Si la modification est un succès, le code statut HTTP retourné devrait être 201.</p></p>
|
|
|
348 |
<ul class="tags">
|
|
|
349 |
<li><span class="field">return:</span> une chaine indiquant le succès de l'opération ou rien.</li>
|
|
|
350 |
<li><span class="field">access:</span> public</li>
|
|
|
351 |
</ul>
|
|
|
352 |
|
|
|
353 |
<div class="method-signature">
|
|
|
354 |
<span class="method-result">mixed</span>
|
|
|
355 |
<span class="method-name">
|
|
|
356 |
modifier
|
|
|
357 |
</span>
|
|
|
358 |
(<span class="var-type">array</span> <span class="var-name">$ressources</span>, <span class="var-type">array</span> <span class="var-name">$requeteDonnees</span>)
|
|
|
359 |
</div>
|
|
|
360 |
|
|
|
361 |
<ul class="parameters">
|
|
|
362 |
<li>
|
|
|
363 |
<span class="var-type">array</span>
|
|
|
364 |
<span class="var-name">$ressources</span><span class="var-description">: Morceaux de l'url servant à préciser la ressource concerné pour le service demandé.</span> </li>
|
|
|
365 |
<li>
|
|
|
366 |
<span class="var-type">array</span>
|
|
|
367 |
<span class="var-name">$requeteDonnees</span><span class="var-description">: les données transférées dans le corps de la requête devant servir à la modification.</span> </li>
|
|
|
368 |
</ul>
|
|
|
369 |
|
|
|
370 |
|
|
|
371 |
</div>
|
|
|
372 |
<a name="methodsupprimer" id="supprimer"><!-- --></a>
|
|
|
373 |
<div class="oddrow">
|
|
|
374 |
|
|
|
375 |
<div class="method-header">
|
|
|
376 |
<span class="method-title">supprimer</span> (line <span class="line-number"><a href="../__filesource/fsource_Framework__RestService.php.html#a86">86</a></span>)
|
|
|
377 |
</div>
|
|
|
378 |
|
|
|
379 |
<!-- ========== Info from phpDoc block ========= -->
|
|
|
380 |
<p class="short-description">Méthode appelée lors d'une requête HTTP de type DELETE (ou POST avec action=DELETE dans le corps de la requete).</p>
|
|
|
381 |
<p class="description"><p>Si la suppression est un succès, le code statut HTTP retourné devrait être 204.</p></p>
|
|
|
382 |
<ul class="tags">
|
|
|
383 |
<li><span class="field">return:</span> une chaine indiquant le succès de l'opération ou rien.</li>
|
|
|
384 |
<li><span class="field">access:</span> public</li>
|
|
|
385 |
</ul>
|
|
|
386 |
|
|
|
387 |
<div class="method-signature">
|
|
|
388 |
<span class="method-result">mixed</span>
|
|
|
389 |
<span class="method-name">
|
|
|
390 |
supprimer
|
|
|
391 |
</span>
|
|
|
392 |
(<span class="var-type">array</span> <span class="var-name">$ressources</span>)
|
|
|
393 |
</div>
|
|
|
394 |
|
|
|
395 |
<ul class="parameters">
|
|
|
396 |
<li>
|
|
|
397 |
<span class="var-type">array</span>
|
|
|
398 |
<span class="var-name">$ressources</span><span class="var-description">: Morceaux de l'url servant à préciser la ressource concerné pour le service demandé.</span> </li>
|
|
|
399 |
</ul>
|
|
|
400 |
|
|
|
401 |
|
|
|
402 |
</div>
|
|
|
403 |
|
|
|
404 |
</div>
|
|
|
405 |
</div>
|
|
|
406 |
|
|
|
407 |
|
|
|
408 |
<p class="notes" id="credit">
|
| 302 |
jpm |
409 |
Documentation generated on Tue, 18 Jan 2011 15:30:58 +0100 by <a href="http://www.phpdoc.org" target="_blank">phpDocumentor 1.4.3</a>
|
| 297 |
jpm |
410 |
</p>
|
|
|
411 |
</div></body>
|
|
|
412 |
</html>
|