Subversion Repositories Applications.framework

Rev

Rev 297 | Go to most recent revision | Show entire file | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed

Rev 297 Rev 300
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 &quot;X_HTTP_METHOD_OVERRIDE&quot; avec pour  valeur le nom de la méthode que vous souhaitez utiliser. Exemple d'entête : &quot;X_HTTP_METHOD_OVERRIDE: PUT&quot;.  Exemple : <div class="src-code"><ol><li><div class="src-line"><span class="src-id">curl&nbsp;</span>-<span class="src-id">v&nbsp;</span>-<span class="src-id">v&nbsp;</span>-<span class="src-id">H&nbsp;</span><span class="src-str">&quot;X_HTTP_METHOD_OVERRIDE:&nbsp;DELETE&quot;&nbsp;&quot;http://www.mondomaine.org/services/apiVersion/[mon-service]/&quot;</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 &quot;X_HTTP_METHOD_OVERRIDE&quot; avec pour  valeur le nom de la méthode que vous souhaitez utiliser. Exemple d'entête : &quot;X_HTTP_METHOD_OVERRIDE: PUT&quot;.  Exemple : <div class="src-code"><ol><li><div class="src-line"><span class="src-id">curl&nbsp;</span>-<span class="src-id">v&nbsp;</span>-<span class="src-id">v&nbsp;</span>-<span class="src-id">H&nbsp;</span><span class="src-str">&quot;X_HTTP_METHOD_OVERRIDE:&nbsp;DELETE&quot;&nbsp;&quot;http://www.mondomaine.org/services/apiVersion/[mon-service]/&quot;</span></div></li>
105
</ol></div>  Cela fonctionne avec Apache.</p><p>Les classes des services web doivent avoir un nom au format ChatMot &quot;MonService&quot; et être appelée dans l'url par le même nom  en minuscule où les mots sont séparés par des tirets &quot;mon-service&quot;.</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 : &quot;/mon_serveur/&quot; <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 &quot;MonService&quot; et être appelée dans l'url par le même nom  en minuscule où les mots sont séparés par des tirets &quot;mon-service&quot;.</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 : &quot;/mon_serveur/&quot; <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 &lt;<a href="mailto:jpm@tela-botanica.org">jpm@tela-botanica.org</a>&gt;</li>
107
				<li><span class="field">author:</span> Jean-Pascal MILCENT &lt;<a href="mailto:jpm@tela-botanica.org">jpm@tela-botanica.org</a>&gt;</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>