diff options
Diffstat (limited to 'files/fr/glossary/idempotent/index.md')
| -rw-r--r-- | files/fr/glossary/idempotent/index.md | 50 |
1 files changed, 22 insertions, 28 deletions
diff --git a/files/fr/glossary/idempotent/index.md b/files/fr/glossary/idempotent/index.md index 0e6367fe26..d0b0559eed 100644 --- a/files/fr/glossary/idempotent/index.md +++ b/files/fr/glossary/idempotent/index.md @@ -8,44 +8,38 @@ tags: translation_of: Glossary/Idempotent original_slug: Glossaire/Idempotent --- -<p>Une méthode HTTP est <strong>idempotente</strong> si une requête identique peut être faite une ou plusieurs fois de suite avec le même effet, tout en laissant le serveur dans le même état. En d'autres termes, une méthode idempotente ne doit pas avoir d'effets secondaires (sauf dans la tenue de statistiques). Implémentées correctement, les méthodes {{HTTPMethod("GET")}}, {{HTTPMethod("HEAD")}}, {{HTTPMethod("PUT")}} et {{HTTPMethod("DELETE")}} sont idempotentes, mais pas la méthode {{HTTPMethod("POST")}}. Toutes les méthodes {{glossary("Safe","sécurisées")}} sont également idempotentes.</p> +Une méthode HTTP est **idempotente** si une requête identique peut être faite une ou plusieurs fois de suite avec le même effet, tout en laissant le serveur dans le même état. En d'autres termes, une méthode idempotente ne doit pas avoir d'effets secondaires (sauf dans la tenue de statistiques). Implémentées correctement, les méthodes {{HTTPMethod("GET")}}, {{HTTPMethod("HEAD")}}, {{HTTPMethod("PUT")}} et {{HTTPMethod("DELETE")}} sont idempotentes, mais pas la méthode {{HTTPMethod("POST")}}. Toutes les méthodes {{glossary("Safe","sécurisées")}} sont également idempotentes. -<p>L'idempotence implique que seul l'état réel du serveur est pris en compte et le code d'état renvoyé par chaque requête peut différer : le premier appel d'un {{HTTPMethod("DELETE")}} retournera probablement un code {{HTTPStatus("200")}}, tandis que les lancements successifs retourneront probablement un code {{HTTPStatus("404")}}. Une autre implication, {{HTTPMethod("DELETE")}} étant idempotente, les développeurs ne doivent pas implémenter d'API RESTful avec une fonctionnalité de suppression de la dernière entrée utilisant la méthode DELETE.</p> +L'idempotence implique que seul l'état réel du serveur est pris en compte et le code d'état renvoyé par chaque requête peut différer : le premier appel d'un {{HTTPMethod("DELETE")}} retournera probablement un code {{HTTPStatus("200")}}, tandis que les lancements successifs retourneront probablement un code {{HTTPStatus("404")}}. Une autre implication, {{HTTPMethod("DELETE")}} étant idempotente, les développeurs ne doivent pas implémenter d'API RESTful avec une fonctionnalité de suppression de la dernière entrée utilisant la méthode DELETE. -<p>À noter : l'idempotence d'une méthode n'est pas garantie par le serveur et certaines applications peuvent incorrectement rompre la contrainte d'idempotence.</p> +À noter : l'idempotence d'une méthode n'est pas garantie par le serveur et certaines applications peuvent incorrectement rompre la contrainte d'idempotence. -<p><code>GET /pageX HTTP/1.1</code> est idempotente. Appelée plusieurs fois de suite, le client obtient les mêmes résultats :</p> +`GET /pageX HTTP/1.1` est idempotente. Appelée plusieurs fois de suite, le client obtient les mêmes résultats : -<pre>GET /pageX HTTP/1.1 -GET /pageX HTTP/1.1 -GET /pageX HTTP/1.1 -GET /pageX HTTP/1.1 -</pre> + GET /pageX HTTP/1.1 + GET /pageX HTTP/1.1 + GET /pageX HTTP/1.1 + GET /pageX HTTP/1.1 -<p><code>POST /add_row HTTP/1.1</code> n'est pas idempotente ; si elle est appelée plusieurs fois, elle ajoute plusieurs lignes :</p> +`POST /add_row HTTP/1.1` n'est pas idempotente ; si elle est appelée plusieurs fois, elle ajoute plusieurs lignes : -<pre>POST /add_row HTTP/1.1 -POST /add_row HTTP/1.1 -> ajoute une 2nde ligne -POST /add_row HTTP/1.1 -> ajoute une 3ème ligne -</pre> + POST /add_row HTTP/1.1 + POST /add_row HTTP/1.1 -> ajoute une 2nde ligne + POST /add_row HTTP/1.1 -> ajoute une 3ème ligne -<p><code>DELETE /idX/delete HTTP/1.1</code> est idempotente, même si le code d'état renvoyé peut changer entre les demandes :</p> +`DELETE /idX/delete HTTP/1.1` est idempotente, même si le code d'état renvoyé peut changer entre les demandes : -<pre>DELETE /idX/delete HTTP/1.1 -> Retourne 200 si idX existe -DELETE /idX/delete HTTP/1.1 -> Retourne 404 comme il vient d'être supprimé -DELETE /idX/delete HTTP/1.1 -> Retourne 404</pre> + DELETE /idX/delete HTTP/1.1 -> Retourne 200 si idX existe + DELETE /idX/delete HTTP/1.1 -> Retourne 404 comme il vient d'être supprimé + DELETE /idX/delete HTTP/1.1 -> Retourne 404 -<h2 id="En_apprendre_plus">En apprendre plus</h2> +## En apprendre plus -<h3 id="Culture_générale">Culture générale</h3> +### Culture générale -<ul> - <li>Définition d'<a href="https://tools.ietf.org/html/rfc7231#section-4.2.2">idempotent</a> dans la spécification HTTP (en).</li> -</ul> +- Définition d'[idempotent](https://tools.ietf.org/html/rfc7231#section-4.2.2) dans la spécification HTTP (en). -<h3 id="Savoir_technique">Savoir technique</h3> +### Savoir technique -<ul> - <li>Description de méthodes idempotentes courantes : {{HTTPMethod("GET")}}, {{HTTPMethod("HEAD")}}, {{HTTPMethod("PUT")}}, {{HTTPMethod("DELETE")}}, {{HTTPMethod("OPTIONS")}}</li> - <li>Description d'une méthode non idempotente courante : {{HTTPMethod("POST")}}</li> -</ul> +- Description de méthodes idempotentes courantes : {{HTTPMethod("GET")}}, {{HTTPMethod("HEAD")}}, {{HTTPMethod("PUT")}}, {{HTTPMethod("DELETE")}}, {{HTTPMethod("OPTIONS")}} +- Description d'une méthode non idempotente courante : {{HTTPMethod("POST")}} |