Line 103... |
Line 103... |
103 |
<p class="short-description">Classe principale gérant les services web de type (@link(REST, http://fr.wikipedia.org/wiki/Rest).</p>
|
103 |
<p class="short-description">Classe principale gérant les services web de type (@link(REST, http://fr.wikipedia.org/wiki/Rest).</p>
|
104 |
<p class="description"><p>Elle contient : <ul><li>les constantes indiquant les différentes (@link(méthode HTTP, http://fr.wikipedia.org/wiki/Http) prises en compte.</li><li>les @link(codes HTTP des réponses, http://fr.wikipedia.org/wiki/Liste_des_codes_HTTP)</li></ul> Ce serveur REST accepte 4 types de méthodes HTTP : GET, PUT, POST, DELETE. GET et POST ne pose généralement pas de problème pour les clients HTTP mais ce n'est pas forcément le cas pour PUT et DELETE. Vous pouvez donc pour réaliser : <ul><li>DELETE : utiliser la méthode POST avec action=DELETE dans le corps de la requête.</li><li>PUT : utiliser la méthode POST avec une url ne contenant aucune indication de ressource.</li></ul> Une autre solution consiste à utiliser n'importe quelle méthode et à ajouter l'entête "X_HTTP_METHOD_OVERRIDE" avec pour valeur le nom de la méthode que vous souhaitez utiliser. Exemple d'entête : "X_HTTP_METHOD_OVERRIDE: PUT". Exemple : <div class="src-code"><ol><li><div class="src-line"><span class="src-id">curl </span>-<span class="src-id">v </span>-<span class="src-id">v </span>-<span class="src-id">H </span><span class="src-str">"X_HTTP_METHOD_OVERRIDE: DELETE" "http://www.mondomaine.org/services/apiVersion/[mon-service]/"</span></div></li>
|
104 |
<p class="description"><p>Elle contient : <ul><li>les constantes indiquant les différentes (@link(méthode HTTP, http://fr.wikipedia.org/wiki/Http) prises en compte.</li><li>les @link(codes HTTP des réponses, http://fr.wikipedia.org/wiki/Liste_des_codes_HTTP)</li></ul> Ce serveur REST accepte 4 types de méthodes HTTP : GET, PUT, POST, DELETE. GET et POST ne pose généralement pas de problème pour les clients HTTP mais ce n'est pas forcément le cas pour PUT et DELETE. Vous pouvez donc pour réaliser : <ul><li>DELETE : utiliser la méthode POST avec action=DELETE dans le corps de la requête.</li><li>PUT : utiliser la méthode POST avec une url ne contenant aucune indication de ressource.</li></ul> Une autre solution consiste à utiliser n'importe quelle méthode et à ajouter l'entête "X_HTTP_METHOD_OVERRIDE" avec pour valeur le nom de la méthode que vous souhaitez utiliser. Exemple d'entête : "X_HTTP_METHOD_OVERRIDE: PUT". Exemple : <div class="src-code"><ol><li><div class="src-line"><span class="src-id">curl </span>-<span class="src-id">v </span>-<span class="src-id">v </span>-<span class="src-id">H </span><span class="src-str">"X_HTTP_METHOD_OVERRIDE: DELETE" "http://www.mondomaine.org/services/apiVersion/[mon-service]/"</span></div></li>
|
105 |
</ol></div> Cela fonctionne avec Apache.</p><p>Les classes des services web doivent avoir un nom au format ChatMot "MonService" et être appelée dans l'url par le même nom en minuscule où les mots sont séparés par des tirets "mon-service".</p><p>Paramètres liés dans config.ini : <ul><li>serveur.baseURL : morceau de l'url pour appeler le serveur relative au domaine. Exemple : pour http://www.tela-botanica.org/mon_serveur/</li></ul> mettre : "/mon_serveur/" <ul><li>serveur.baseAlternativeURL : sur le même principe que ci-dessus permet d'affecter une deuxième url (pour gérer des raccourci via htaccess)</li></ul> Encodage en entrée : utf8 Encodage en sortie : utf8</p></p>
|
105 |
</ol></div> Cela fonctionne avec Apache.</p><p>Les classes des services web doivent avoir un nom au format ChatMot "MonService" et être appelée dans l'url par le même nom en minuscule où les mots sont séparés par des tirets "mon-service".</p><p>Paramètres liés dans config.ini : <ul><li>serveur.baseURL : morceau de l'url pour appeler le serveur relative au domaine. Exemple : pour http://www.tela-botanica.org/mon_serveur/</li></ul> mettre : "/mon_serveur/" <ul><li>serveur.baseAlternativeURL : sur le même principe que ci-dessus permet d'affecter une deuxième url (pour gérer des raccourci via htaccess)</li></ul> Encodage en entrée : utf8 Encodage en sortie : utf8</p></p>
|
106 |
<ul class="tags">
|
106 |
<ul class="tags">
|
107 |
<li><span class="field">author:</span> Jean-Pascal MILCENT <<a href="mailto:jpm@tela-botanica.org">jpm@tela-botanica.org</a>></li>
|
107 |
<li><span class="field">author:</span> Jean-Pascal MILCENT <<a href="mailto:jpm@tela-botanica.org">jpm@tela-botanica.org</a>></li>
|
108 |
<li><span class="field">version:</span> $Id$</li>
|
108 |
<li><span class="field">version:</span> $Id: RestServeur.php 299 2011-01-18 14:03:46Z jpm $</li>
|
109 |
<li><span class="field">copyright:</span> Copyright (c) 2010, Tela Botanica (accueil@tela-botanica.org)</li>
|
109 |
<li><span class="field">copyright:</span> Copyright (c) 2010, Tela Botanica (accueil@tela-botanica.org)</li>
|
110 |
<li><span class="field">link:</span> /doc/framework/</li>
|
110 |
<li><span class="field">link:</span> /doc/framework/</li>
|
111 |
<li><span class="field">since:</span> 0.3</li>
|
111 |
<li><span class="field">since:</span> 0.3</li>
|
112 |
<li><span class="field">license:</span> GPL</li>
|
112 |
<li><span class="field">license:</span> GPL</li>
|
113 |
<li><span class="field">license:</span> CECILL</li>
|
113 |
<li><span class="field">license:</span> CECILL</li>
|
Line 664... |
Line 664... |
664 |
|
664 |
|
665 |
</div>
|
665 |
</div>
|
Line 666... |
Line 666... |
666 |
</div>
|
666 |
</div>
|
667 |
|
667 |
|
668 |
<p class="notes" id="credit">
|
668 |
<p class="notes" id="credit">
|
669 |
Documentation generated on Tue, 18 Jan 2011 15:01:41 +0100 by <a href="http://www.phpdoc.org" target="_blank">phpDocumentor 1.4.3</a>
|
669 |
Documentation generated on Tue, 18 Jan 2011 15:13:24 +0100 by <a href="http://www.phpdoc.org" target="_blank">phpDocumentor 1.4.3</a>
|
670 |
</p>
|
670 |
</p>
|
671 |
</div></body>
|
671 |
</div></body>
|