Définition des en-têtes HTTP et des codes de réponse des applications RESTful
Les en-têtes HTTP et les codes d'état permettent aux programmes client et intermédiaires de comprendre les informations sur les requêtes et les réponses des applications. Les en-têtes HTTP contiennent des informations de métadonnées. Les code d'état HTTP fournissent les informations d'état de la réponse.
Avant de commencer
Voir la spécification HTTP 1.1 pour vous familiariser avec les en-têtes HTTP et les codes d'état HTTP.
Pourquoi et quand exécuter cette tâche
Les en-têtes HTTP contiennent des informations de métadonnées, telles que des informations d'authentification de sécurité, l'agent utilisateur utilisé et les métadonnées de contrôle de cache. Les en-têtes HTTP standard sont définis dans la spécification HTTP. Toutefois, vous pouvez utiliser des en-têtes HTTP personnalisés, si nécessaire.
Vous pouvez lire les en-têtes HTP dans la demande et définir les en-têtes dans la réponse. Il existe un groupe d'en-têtes de demande et de réponse communs, mais également des en-têtes de demande et de réponse uniques. JAX-RS fournit l'interface injectable HttpHeaders et l'annotation de paramètre @HeaderParam pour lire les en-têtes HTTP. Si un objet javax.ws.rs.core.Response est retourné par une méthode de ressource, vous pouvez définir les en-têtes HTTP dans la réponse. En outre, vous pouvez définir des en-têtes HTTP lorsqu'une entité est écrite en utilisant l'interface MessageBodyWriter.
Vous pouvez définir des codes d'état de réponse HTTP pour permettre aux programmes client de comprendre la réponse. Bien que les réponses puissent contenir un code d'erreur dans le format XML ou dans un autre format, les programmes client peut comprendre rapidement et plus aisément un code d'état de réponse HTTP. La spécification HTTP définit plusieurs codes d'état généralement compris par les clients.
Procédure
Résultats
Vous avez utilisé des en-têtes HTTP pour lire des en-têtes de demande et définir des codes d'état et des en-têtes de réponse pour les applications Web JAX-RS.