| Line 12... |
Line 12... |
| 12 |
* @author Jean-Pascal MILCENT <jpm@tela-botanica.org>
|
12 |
* @author Jean-Pascal MILCENT <jpm@tela-botanica.org>
|
| 13 |
* @copyright Copyright (c) 2010, Tela Botanica (accueil@tela-botanica.org)
|
13 |
* @copyright Copyright (c) 2010, Tela Botanica (accueil@tela-botanica.org)
|
| 14 |
* @license GPL v3 <http://www.gnu.org/licenses/gpl.txt>
|
14 |
* @license GPL v3 <http://www.gnu.org/licenses/gpl.txt>
|
| 15 |
* @license CECILL v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt>
|
15 |
* @license CECILL v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt>
|
| 16 |
* @since 0.3
|
16 |
* @since 0.3
|
| 17 |
* @version $Id: RestService.php 362 2011-09-01 13:43:23Z jpm $
|
17 |
* @version $Id: RestService.php 366 2011-09-30 08:20:45Z jpm $
|
| 18 |
* @link /doc/framework/
|
18 |
* @link /doc/framework/
|
| 19 |
*/
|
19 |
*/
|
| 20 |
abstract class RestService {
|
20 |
abstract class RestService {
|
| Line 21... |
Line 21... |
| 21 |
|
21 |
|
| Line 89... |
Line 89... |
| 89 |
/**
|
89 |
/**
|
| 90 |
* Méthode appelée lors d'une requête HTTP de type PUT.
|
90 |
* Méthode appelée lors d'une requête HTTP de type PUT.
|
| 91 |
*
|
91 |
*
|
| 92 |
* L'identifiant de la ressource à ajouter est indiqué via l'url si on le connait par avance. Sinon, il doit être créé par
|
92 |
* L'identifiant de la ressource à ajouter est indiqué via l'url si on le connait par avance. Sinon, il doit être créé par
|
| 93 |
* le service. Dans ce dernier cas, le nouvel identifiant devrait être renvoyé dans le corps de la réponse.
|
93 |
* le service. Dans ce dernier cas, le nouvel identifiant devrait être renvoyé dans le corps de la réponse.
|
| 94 |
* Si l'ajout est un succès, la méthode devra retourner "true" et le code statut HTTP retourné sera 201.
|
94 |
* Si l'ajout est un succès, la méthode devra retourner "true" ou l'identifiant.
|
| - |
|
95 |
* Le code statut HTTP retourné sera 201 en cas de succès.
|
| - |
|
96 |
* Dans le cas contraire, la méthode devra retourner false.
|
| 95 |
*
|
97 |
*
|
| 96 |
* @param array Morceaux de l'url servant à préciser la ressource concerné pour le service demandé.
|
98 |
* @param array Morceaux de l'url servant à préciser la ressource concerné pour le service demandé.
|
| 97 |
* @param array les données transférées dans le corps de la requête devant servir à l'ajout.
|
99 |
* @param array les données transférées dans le corps de la requête devant servir à l'ajout.
|
| 98 |
* @return string l'identifiant créé.
|
100 |
* @return string l'identifiant créé.
|
| 99 |
*/
|
101 |
*/
|