Spécifications HTTP courantes (ADO.NET Data Services Framework)

Les spécifications décrites dans cette section s'appliquent aux données transportées dans tous les formats pris en charge par ADO.NET Data Services.

Le format de sérialisation utilisé pour une demande envoyée depuis un client vers ADO.NET Data Services est spécifié par l'en-tête HTTP ContentType de la demande. Le format d'une réponse renvoyée par un service de données est spécifié par l'en-tête HTTP Accept de la demande. Comme spécifié dans la RFC 2616, l'en-tête Accept indique que la réponse à la demande est limitée à un ensemble spécifique de types MIME.

Traitement de l'en-tête ACCEPT

Les règles suivantes sont utilisées par ADO.NET Data Services pour déterminer le format de la réponse :

• Si la demande inclut un en-tête Accept, analysez l'en-tête Accept à l'aide des règles définies dans la section 14.1 de la RFC 2616.

• ADO.NET Data Services ignore toute règle de valeur ‘q’ spécifiée dans l'en-tête.

• Le type MIME retourné suite à l'analyse de l'en-tête Accept est ensuite utilisé comme format de réponse en fonction des tableaux qui suivent.

Une fois que le type MIME de format a été déterminé à l'aide des règles de traitement d'en-tête Accept, le type MIME spécifique de la réponse est déterminé en appliquant les règles décrites dans les tableaux suivants.

Le type MIME défini dans un en-tête Accept peut ne pas déterminer un type MIME unique par lui-même. Par exemple, application/* ne définit pas un sous-type unique. Si le serveur ne peut envoyer une réponse acceptable selon la valeur d'en-tête Accept, alors, conformément à la RFC 2616, il envoie un code de réponse 406 indiquant que la demande est inacceptable.

Types de supports de groupement

Type MIME demandé	Type MIME de réponse	Format de sérialisation
*/*	application/atom+xml	ATOM/APP
text/*	Non pris en charge	Non pris en charge
application/*	Non pris en charge	Non pris en charge

Types de supports individuels

Type MIME demandé	Type MIME de réponse	Format de sérialisation
text/xml	text/xml	ATOM/APP
application/xml	application/xml	ATOM/APP
application/atom+xml	application/atom+xml	ATOM/APP
application/json	application/json	JSON

Codes de réponse

Le tableau suivant illustre les codes de réponse utilisés lorsque ADO.NET Data Services ne peut traiter une demande :

Code de réponse	Description
400 – Demande incorrecte	La charge utile fournie dans une demande est mise en forme d'une manière qui ne satisfait pas aux règles de sérialisation définies dans cette spécification.
404 – Introuvable	Une demande qui utilise l'un des verbes HTTP pris en charge par le service de données est envoyée à un URI qui ne mappe pas à une ressource adressable.
406 – Non acceptable	Le serveur ne peut pas envoyer de réponse acceptable selon la directive de chaîne de requête ou l'en-tête Accept dans une demande.
422 – Impossible de traiter l'entité	L'exécution d'une demande HTTP ayant pour but de modifier l'état d'une ressource ADO.NET Data Services entraînerait une violation du schéma ADO.NET Data Services, tel que défini par les règles dans PUT, POST et DELETE (ADO.NET Data Services Framework).
405 – Méthode non prise en charge	Une demande envoyée à l'URI ADO.NET Data Services utilise une méthode qui n'est pas prise en charge par la ressource identifiée par l'URI.
500 – Code de réponse du serveur interne	Une erreur inattendue s'est produite lors de l'exécution d'une demande HTTP.

Voir aussi

Concepts

Format d'URI pour l'adressage des ressources (ADO.NET Data Services Framework)
Spécifications d'ADO.NET Data Service