9. HTTP Methods for Distributed Authoring (Méthodes HTTP pour la création distribuée)
Ce chapitre décrit les méthodes HTTP définies par WebDAV et les extensions aux méthodes HTTP existantes.
Aperçu des méthodes WebDAV
| Méthode | But | Cible |
|---|---|---|
| PROPFIND | Récupérer les propriétés | Ressource ou collection |
| PROPPATCH | Modifier les propriétés | Ressource |
| MKCOL | Créer une collection | URL non mappée |
| COPY | Copier une ressource | Source et destination |
| MOVE | Déplacer/renommer | Source et destination |
| LOCK | Verrouiller une ressource | Ressource ou collection |
| UNLOCK | Déverrouiller une ressource | Ressource verrouillée |
9.1 Méthode PROPFIND
PROPFIND récupère les propriétés définies sur la ressource identifiée par le Request-URI.
Types de requête : propname, allprop, prop, allprop + include
9.2 Méthode PROPPATCH
PROPPATCH modifie les propriétés d'une ressource.
Opérations : set (créer/mettre à jour), remove (supprimer)
Atomicité : Toutes les opérations doivent (MUST) réussir ou échouer ensemble.
9.3 Méthode MKCOL
MKCOL crée une nouvelle ressource de collection au Request-URI.
9.4 GET, HEAD pour les collections
GET et HEAD appliqués à une collection peuvent (MAY) retourner une liste de répertoires HTML.
9.5 POST pour les collections
POST ajoute des membres à une collection. Le serveur détermine l'URL du nouveau membre.
9.6 Méthode DELETE
DELETE supprime la ressource identifiée par le Request-URI.
Pour les collections : Supprime la collection et tous les membres récursivement.
9.7 Méthode PUT
PUT crée ou met à jour une ressource.
9.8 Méthode COPY
COPY crée un duplicata de la ressource source à la destination.
En-têtes : Destination (requis), Depth, Overwrite
Comportement : Les verrous ne sont PAS copiés.
9.9 Méthode MOVE
MOVE est logiquement équivalent à COPY + DELETE.
Atomicité : Les opérations MOVE doivent (MUST) être atomiques.
9.10 Méthode LOCK
LOCK obtient un verrou sur une ressource.
Types de verrous : Verrou d'écriture exclusif, Verrou d'écriture partagé
9.11 Méthode UNLOCK
UNLOCK supprime le verrou identifié par le jeton de verrou.
Pour les spécifications complètes des méthodes, consultez RFC 4918 Sections 9.1-9.11.