Subversion Repositories Applications.framework

Rev

Rev 464 | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
464 jpm 1
<!DOCTYPE html>
2
<html>
3
<head>
4
	<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
5
	<meta name="generator" content="ApiGen 2.8.0">
6
 
465 jpm 7
	<title>Class RestService</title>
464 jpm 8
 
9
	<script type="text/javascript" src="resources/combined.js?4205936287"></script>
465 jpm 10
	<script type="text/javascript" src="elementlist.js?4111837732"></script>
464 jpm 11
	<link rel="stylesheet" type="text/css" media="all" href="resources/style.css?3505392360">
12
 
13
</head>
14
 
15
<body>
16
<div id="left">
17
	<div id="menu">
18
		<a href="index.html" title="Overview"><span>Overview</span></a>
19
 
20
 
21
		<div id="groups">
22
			<h3>Packages</h3>
23
			<ul>
24
				<li class="active"><a href="package-Framework.html">Framework</a>
25
						</li>
26
				<li><a href="package-None.html">None</a>
27
						</li>
28
				<li><a href="package-PHP.html">PHP</a>
29
						</li>
30
				<li><a href="package-Utilitaire.html">Utilitaire</a>
31
						</li>
32
			</ul>
33
		</div>
34
 
35
		<hr>
36
 
37
 
38
		<div id="elements">
39
			<h3>Classes</h3>
40
			<ul>
41
				<li><a href="class-Bdd.html">Bdd</a></li>
42
				<li><a href="class-Cache.html">Cache</a></li>
43
				<li><a href="class-CacheSimple.html">CacheSimple</a></li>
44
				<li><a href="class-Chronometre.html">Chronometre</a></li>
45
				<li><a href="class-Cli.html">Cli</a></li>
46
				<li><a href="class-Config.html">Config</a></li>
47
				<li><a href="class-Controleur.html">Controleur</a></li>
48
				<li><a href="class-Debug.html">Debug</a></li>
49
				<li><a href="class-Framework.html">Framework</a></li>
50
				<li><a href="class-GestionnaireException.html">GestionnaireException</a></li>
51
				<li><a href="class-I18n.html">I18n</a></li>
52
				<li><a href="class-Log.html">Log</a></li>
53
				<li><a href="class-Registre.html">Registre</a></li>
54
				<li><a href="class-RestClient.html">RestClient</a></li>
55
				<li><a href="class-RestServeur.html">RestServeur</a></li>
56
				<li class="active"><a href="class-RestService.html">RestService</a></li>
57
				<li><a href="class-Script.html">Script</a></li>
58
				<li><a href="class-SquelettePhp.html">SquelettePhp</a></li>
59
				<li><a href="class-Url.html">Url</a></li>
60
			</ul>
61
 
62
 
63
 
64
 
65
 
66
		</div>
67
	</div>
68
</div>
69
 
70
<div id="splitter"></div>
71
 
72
<div id="right">
73
<div id="rightInner">
74
	<form id="search">
75
		<input type="hidden" name="cx" value="">
76
		<input type="hidden" name="ie" value="UTF-8">
77
		<input type="text" name="q" class="text">
78
		<input type="submit" value="Search">
79
	</form>
80
 
81
	<div id="navigation">
82
		<ul>
83
			<li>
84
				<a href="index.html" title="Overview"><span>Overview</span></a>
85
			</li>
86
			<li>
87
				<a href="package-Framework.html" title="Summary of Framework"><span>Package</span></a>
88
			</li>
89
			<li class="active">
90
<span>Class</span>			</li>
91
		</ul>
92
		<ul>
93
			<li>
94
				<a href="tree.html" title="Tree view of classes, interfaces, traits and exceptions"><span>Tree</span></a>
95
			</li>
96
			<li>
97
				<a href="deprecated.html" title="List of deprecated elements"><span>Deprecated</span></a>
98
			</li>
99
			<li>
100
				<a href="todo.html" title="Todo list"><span>Todo</span></a>
101
			</li>
102
		</ul>
103
		<ul>
104
		</ul>
105
	</div>
106
 
107
<div id="content" class="class">
108
	<h1>Class RestService</h1>
109
 
110
 
111
	<div class="description">
112
 
113
<p>Classe principale gérant les services. Paramètres liés dans config.ini : -
114
serveur.baseURL</p>
115
 
116
<p>Encodage en entrée : utf8 Encodage en sortie : utf8</p>
117
 
118
	</div>
119
 
120
 
121
 
122
 
123
 
124
 
125
 
126
 
127
 
128
	<div class="info">
129
		<b>Abstract</b><br>
130
 
131
 
132
		<b>Package:</b> <a href="package-Framework.html">Framework</a><br>
133
 
134
				<b>Category:</b>
135
				Php 5.2<br>
136
				<b>Copyright:</b>
137
				Copyright (c) 2010, Tela Botanica (<a
138
href="mailto:accueil&#64;tela-botanica.org">accueil&#64;<!-- -->tela-botanica.org</a>)<br>
139
				<b>License:</b>
140
				<a href="GPL">v3 &lt;http://www.gnu.org/licenses/gpl.txt&gt;</a><br>
141
				<b>License:</b>
142
				<a href="CECILL">v2 &lt;http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt&gt;</a><br>
143
				<b>Author:</b>
144
				Jean-Pascal MILCENT &lt;<a
145
href="mailto:jpm&#64;tela-botanica.org">jpm&#64;<!-- -->tela-botanica.org</a>&gt;<br>
146
				<b>Version:</b>
147
				$Id: RestService.php 417 2012-05-15 09:24:12Z jpm $<br>
148
				<b>Since:</b>
149
				0.3<br>
150
				<b>Link:</b>
151
				/doc/framework/<br>
465 jpm 152
		<b>Located at</b> <a href="source-class-RestService.html#2-150" title="Go to source code">RestService.php</a><br>
464 jpm 153
	</div>
154
 
155
 
156
 
157
	<table class="summary" id="methods">
158
	<caption>Methods summary</caption>
159
	<tr data-order="__construct" id="___construct">
160
 
161
		<td class="attributes"><code>
162
			 public
163
 
164
 
165
			</code>
166
		</td>
167
 
168
		<td class="name"><div>
169
		<a class="anchor" href="#___construct">#</a>
170
		<code><a href="source-class-RestService.html#34-37" title="Go to source code">__construct</a>( <span>mixed <var>$config</var></span> )</code>
171
 
172
		<div class="description short">
173
 
174
		</div>
175
 
176
		<div class="description detailed hidden">
177
 
178
 
179
 
180
 
181
 
182
 
183
 
184
 
185
		</div>
186
		</div></td>
187
	</tr>
188
	<tr data-order="initialiser" id="_initialiser">
189
 
190
		<td class="attributes"><code>
191
			 public
192
 
193
 
194
			</code>
195
		</td>
196
 
197
		<td class="name"><div>
198
		<a class="anchor" href="#_initialiser">#</a>
199
		<code><a href="source-class-RestService.html#39-41" title="Go to source code">initialiser</a>( )</code>
200
 
201
		<div class="description short">
202
 
203
		</div>
204
 
205
		<div class="description detailed hidden">
206
 
207
 
208
 
209
 
210
 
211
 
212
 
213
 
214
		</div>
215
		</div></td>
216
	</tr>
217
	<tr data-order="getBdd" id="_getBdd">
218
 
219
		<td class="attributes"><code>
220
			 protected
221
 
222
 
223
			</code>
224
		</td>
225
 
226
		<td class="name"><div>
227
		<a class="anchor" href="#_getBdd">#</a>
228
		<code><a href="source-class-RestService.html#43-52" title="Go to source code">getBdd</a>( )</code>
229
 
230
		<div class="description short">
231
 
232
<p>Méthode de connection à la base de données sur demande. Tous les services
233
web n'ont pas besoin de s'y connecter.</p>
234
 
235
		</div>
236
 
237
		<div class="description detailed hidden">
238
 
239
<p>Méthode de connection à la base de données sur demande. Tous les services
240
web n'ont pas besoin de s'y connecter.</p>
241
 
242
 
243
 
244
 
245
 
246
 
247
 
248
 
249
		</div>
250
		</div></td>
251
	</tr>
252
	<tr data-order="getRestClient" id="_getRestClient">
253
 
254
		<td class="attributes"><code>
255
			 protected
256
 
257
 
258
			</code>
259
		</td>
260
 
261
		<td class="name"><div>
262
		<a class="anchor" href="#_getRestClient">#</a>
263
		<code><a href="source-class-RestService.html#54-62" title="Go to source code">getRestClient</a>( )</code>
264
 
265
		<div class="description short">
266
 
267
<p>Méthode permettant de faire appel à un client REST en fonction des besoins
268
du service.</p>
269
 
270
		</div>
271
 
272
		<div class="description detailed hidden">
273
 
274
<p>Méthode permettant de faire appel à un client REST en fonction des besoins
275
du service.</p>
276
 
277
 
278
 
279
 
280
 
281
 
282
 
283
 
284
		</div>
285
		</div></td>
286
	</tr>
287
	<tr data-order="utiliserParametresBruts" id="_utiliserParametresBruts">
288
 
289
		<td class="attributes"><code>
290
			 public
291
 
292
 
293
			</code>
294
		</td>
295
 
296
		<td class="name"><div>
297
		<a class="anchor" href="#_utiliserParametresBruts">#</a>
298
		<code><a href="source-class-RestService.html#64-70" title="Go to source code">utiliserParametresBruts</a>( )</code>
299
 
300
		<div class="description short">
301
 
302
<p>Méthode permettant de savoir si le service veut utiliser des paramètres
303
bruts (issu de la QueryString) ou pas (issu de $_GET).</p>
304
 
305
		</div>
306
 
307
		<div class="description detailed hidden">
308
 
309
<p>Méthode permettant de savoir si le service veut utiliser des paramètres
310
bruts (issu de la QueryString) ou pas (issu de $_GET).</p>
311
 
312
 
313
 
314
 
315
 
316
 
317
 
318
 
319
		</div>
320
		</div></td>
321
	</tr>
322
	<tr data-order="ajouterMessage" id="_ajouterMessage">
323
 
324
		<td class="attributes"><code>
325
			 protected
326
 
327
 
328
			</code>
329
		</td>
330
 
331
		<td class="name"><div>
332
		<a class="anchor" href="#_ajouterMessage">#</a>
333
		<code><a href="source-class-RestService.html#72-79" title="Go to source code">ajouterMessage</a>( <span>string <var>$message</var></span> )</code>
334
 
335
		<div class="description short">
336
 
337
<p>Permet d'ajouter un message d'erreur ou d'avertissement qui sera envoyé au
338
client. Le message doit être au format texte et en UTF-8.</p>
339
 
340
		</div>
341
 
342
		<div class="description detailed hidden">
343
 
344
<p>Permet d'ajouter un message d'erreur ou d'avertissement qui sera envoyé au
345
client. Le message doit être au format texte et en UTF-8.</p>
346
 
347
 
348
 
349
				<h4>Parameters</h4>
350
				<div class="list"><dl>
351
					<dt><var>$message</var></dt>
352
					<dd><code>string</code><br>$message le message à envoyer.</dd>
353
				</dl></div>
354
 
355
 
356
 
357
 
358
 
359
		</div>
360
		</div></td>
361
	</tr>
362
	<tr data-order="consulter" id="_consulter">
363
 
364
		<td class="attributes"><code>
365
			 public
366
			string
367
 
368
			</code>
369
		</td>
370
 
371
		<td class="name"><div>
372
		<a class="anchor" href="#_consulter">#</a>
373
		<code><a href="source-class-RestService.html#81-94" title="Go to source code">consulter</a>( <span>array <var>$ressources</var></span>, <span>array <var>$parametres</var></span> )</code>
374
 
375
		<div class="description short">
376
 
377
<p>Méthode appelée lors d'une requête HTTP de type GET.</p>
378
 
379
		</div>
380
 
381
		<div class="description detailed hidden">
382
 
383
<p>Méthode appelée lors d'une requête HTTP de type GET.</p>
384
 
385
<p>Si la consultation est un succès, le code statut HTTP retourné sera 200.
386
Dans tous les autres cas, la méthode devra retourner le code statut HTTP
387
adéquate.</p>
388
 
389
 
390
 
391
				<h4>Parameters</h4>
392
				<div class="list"><dl>
393
					<dt><var>$ressources</var></dt>
394
					<dd><code>array</code><br>Morceaux de l'url servant à préciser la ressource concerné pour le service
395
demandé.</dd>
396
					<dt><var>$parametres</var></dt>
397
					<dd><code>array</code><br>Partie de l'url situé après le '?' servant à paramétrer le service demandé.</dd>
398
				</dl></div>
399
 
400
				<h4>Returns</h4>
401
				<div class="list">
402
					<code>string</code><br>une chaine indiquant le succès de l'opération et les données demandées.<br>
403
				</div>
404
 
405
 
406
 
407
 
408
		</div>
409
		</div></td>
410
	</tr>
411
	<tr data-order="modifier" id="_modifier">
412
 
413
		<td class="attributes"><code>
414
			 public
415
			mixed
416
 
417
			</code>
418
		</td>
419
 
420
		<td class="name"><div>
421
		<a class="anchor" href="#_modifier">#</a>
422
		<code><a href="source-class-RestService.html#96-111" title="Go to source code">modifier</a>( <span>array <var>$ressources</var></span>, <span>array <var>$requeteDonnees</var></span> )</code>
423
 
424
		<div class="description short">
425
 
426
<p>Méthode appelée lors d'une requête HTTP de type POST.</p>
427
 
428
		</div>
429
 
430
		<div class="description detailed hidden">
431
 
432
<p>Méthode appelée lors d'une requête HTTP de type POST.</p>
433
 
434
<p>La ressource à modifier est indiquée via l'url. Les données devant servir
435
à la mise à jours sont passées dans le corps de la requête. Si la
436
modification est un succès, la méthode devra retourner "true" et le code
437
statut HTTP retourné sera 201.</p>
438
 
439
 
440
 
441
				<h4>Parameters</h4>
442
				<div class="list"><dl>
443
					<dt><var>$ressources</var></dt>
444
					<dd><code>array</code><br>Morceaux de l'url servant à préciser la ressource concerné pour le service
445
demandé.</dd>
446
					<dt><var>$requeteDonnees</var></dt>
447
					<dd><code>array</code><br>les données transférées dans le corps de la requête devant servir à la
448
modification.</dd>
449
				</dl></div>
450
 
451
				<h4>Returns</h4>
452
				<div class="list">
453
					<code>mixed</code><br>une chaine indiquant le succès de l'opération ou rien.<br>
454
				</div>
455
 
456
 
457
 
458
 
459
		</div>
460
		</div></td>
461
	</tr>
462
	<tr data-order="ajouter" id="_ajouter">
463
 
464
		<td class="attributes"><code>
465
			 public
466
			string
467
 
468
			</code>
469
		</td>
470
 
471
		<td class="name"><div>
472
		<a class="anchor" href="#_ajouter">#</a>
473
		<code><a href="source-class-RestService.html#113-130" title="Go to source code">ajouter</a>( <span>array <var>$ressources</var></span>, <span>array <var>$requeteDonnees</var></span> )</code>
474
 
475
		<div class="description short">
476
 
477
<p>Méthode appelée lors d'une requête HTTP de type PUT.</p>
478
 
479
		</div>
480
 
481
		<div class="description detailed hidden">
482
 
483
<p>Méthode appelée lors d'une requête HTTP de type PUT.</p>
484
 
485
<p>L'identifiant de la ressource à ajouter est indiqué via l'url si on le
486
connait par avance. Sinon, il doit être créé par le service. Dans ce dernier
487
cas, le nouvel identifiant devrait être renvoyé dans le corps de la réponse.
488
Si l'ajout est un succès, la méthode devra retourner "true" ou l'identifiant.
489
Le code statut HTTP retourné sera 201 en cas de succès. Dans le cas contraire,
490
la méthode devra retourner false.</p>
491
 
492
 
493
 
494
				<h4>Parameters</h4>
495
				<div class="list"><dl>
496
					<dt><var>$ressources</var></dt>
497
					<dd><code>array</code><br>Morceaux de l'url servant à préciser la ressource concerné pour le service
498
demandé.</dd>
499
					<dt><var>$requeteDonnees</var></dt>
500
					<dd><code>array</code><br>les données transférées dans le corps de la requête devant servir à
501
l'ajout.</dd>
502
				</dl></div>
503
 
504
				<h4>Returns</h4>
505
				<div class="list">
506
					<code>string</code><br>l'identifiant créé.<br>
507
				</div>
508
 
509
 
510
 
511
 
512
		</div>
513
		</div></td>
514
	</tr>
515
	<tr data-order="supprimer" id="_supprimer">
516
 
517
		<td class="attributes"><code>
518
			 public
519
			mixed
520
 
521
			</code>
522
		</td>
523
 
524
		<td class="name"><div>
525
		<a class="anchor" href="#_supprimer">#</a>
526
		<code><a href="source-class-RestService.html#132-149" title="Go to source code">supprimer</a>( <span>array <var>$ressources</var></span> )</code>
527
 
528
		<div class="description short">
529
 
530
<p>Méthode appelée lors d'une requête HTTP de type DELETE (ou POST avec
531
action=DELETE dans le corps de la requete).</p>
532
 
533
		</div>
534
 
535
		<div class="description detailed hidden">
536
 
537
<p>Méthode appelée lors d'une requête HTTP de type DELETE (ou POST avec
538
action=DELETE dans le corps de la requete).</p>
539
 
540
<p>Si la suppression est un succès, la méthode devra retourner "true" et le
541
code statut HTTP retourné par RestServeur sera 204. Si la ressource à
542
supprimer est introuvable, la méthode devra retourner "false" et le code statut
543
HTTP retourné par RestServeur sera 404. Dans les autres cas de figure ou si
544
vous souhaitez gérer vos propres codes de retour erreur, retourner la valeur
545
null ou rien.</p>
546
 
547
 
548
 
549
				<h4>Parameters</h4>
550
				<div class="list"><dl>
551
					<dt><var>$ressources</var></dt>
552
					<dd><code>array</code><br>Morceaux de l'url servant à préciser la ressource concerné pour le service
553
demandé.</dd>
554
				</dl></div>
555
 
556
				<h4>Returns</h4>
557
				<div class="list">
558
					<code>mixed</code><br>une chaine indiquant le succès de l'opération ou rien.<br>
559
				</div>
560
 
561
 
562
 
563
 
564
		</div>
565
		</div></td>
566
	</tr>
567
	</table>
568
 
569
 
570
 
571
 
572
 
573
 
574
 
575
 
576
 
577
 
578
 
579
 
580
	<table class="summary" id="properties">
581
	<caption>Properties summary</caption>
582
	<tr data-order="bdd" id="$bdd">
583
		<td class="attributes"><code>
584
			protected
585
			mixed
586
		</code></td>
587
 
588
		<td class="name">
589
				<a href="source-class-RestService.html#22-26" title="Go to source code"><var>$bdd</var></a>
590
		</td>
591
		<td class="value"><code><span class="php-keyword1">null</span></code></td>
592
		<td class="description"><div>
593
			<a href="#$bdd" class="anchor">#</a>
594
 
595
			<div class="description short">
596
 
597
<p>Objet de connection à la base de données.</p>
598
 
599
			</div>
600
 
601
			<div class="description detailed hidden">
602
 
603
<p>Objet de connection à la base de données.</p>
604
 
605
 
606
					<h4>Deprecated</h4>
607
					<div class="list">
608
							Utiliser la methode getBdd().<br>
609
					</div>
610
					<h4>See</h4>
611
					<div class="list">
612
							<code><code><a href="class-RestService.html#_getBdd">RestService::getBdd()</a></code></code><br>
613
					</div>
614
			</div>
615
		</div></td>
616
	</tr>
617
	<tr data-order="utilisationParametresBruts" id="$utilisationParametresBruts">
618
		<td class="attributes"><code>
619
			protected
620
			boolean
621
		</code></td>
622
 
623
		<td class="name">
624
				<a href="source-class-RestService.html#31-32" title="Go to source code"><var>$utilisationParametresBruts</var></a>
625
		</td>
626
		<td class="value"><code><span class="php-keyword1">false</span></code></td>
627
		<td class="description"><div>
628
			<a href="#$utilisationParametresBruts" class="anchor">#</a>
629
 
630
			<div class="description short">
631
 
632
<p>Indique si oui (true) ou non (false), on veut utiliser les paramètres
633
brutes.</p>
634
 
635
			</div>
636
 
637
			<div class="description detailed hidden">
638
 
639
<p>Indique si oui (true) ou non (false), on veut utiliser les paramètres
640
brutes.</p>
641
 
642
 
643
			</div>
644
		</div></td>
645
	</tr>
646
	</table>
647
 
648
 
649
 
650
 
651
 
652
 
653
</div>
654
 
655
	<div id="footer">
465 jpm 656
		 API documentation generated by <a href="http://apigen.org">ApiGen 2.8.0</a>
464 jpm 657
	</div>
658
</div>
659
</div>
660
</body>
661
</html>