Utilisation d'objets de contexte JAX-RS pour obtenir plus d'informations sur les demandes
Java API for RESTful Web Services (JAX-RS) 2.0 fournit différents types de contexte aux sous-classes d'application, aux classes de ressource racine et aux fournisseurs. Vous pouvez utiliser l'annotation @Context pour injecter des objets contextuels, tels que HttpHeaders, UriInfo, HttpServletRequest, dans le paramètre class field ou method des sous-classes d'application, classes de ressource racine et fournisseurs.
Pourquoi et quand exécuter cette tâche
Vous pouvez utiliser les objets contextuels suivants qui
sont disponibles pour les fournisseurs (client et serveur), les
classes de ressource
(serveur uniquement) et les sous-classes d'application (serveur
uniquement) :
Objet contextuel | Type | Description |
---|---|---|
Application | Classe | L'instance de la sous-classe
Application fournie par une application
peut être injectée dans un paramètre class field ou
method à l'aide de l'annotation
@Context. L'accès à l'instance de sous-classe Application permet de
centraliser les informations de configuration dans cette
classe. Remarque : Cette sous-classe
Application ne peut pas être
injectée dans la sous-classe
Application elle-même car cela créerait une
dépendance en boucle.
|
UriInfo | Interface | L'interface UriInfo fournit des informations statiques et dynamiques, à la demande, sur les composants d'une URI de demande. |
HttpHeaders | Interface | L'interface HttpHeaders fournit l'accès aux informations d'en-tête de demande sous la forme d'un mappage ou via des méthodes de simplification fortement typées. |
Request | Interface | L'interface Request permet à un appelant de déterminer la meilleure variante de représentation correspondante et d'évaluer si l'état actuel de la ressource correspond aux préconditions figurant dans la demande. |
SecurityContext | Interface | L'interface SecurityContext fournit un accès aux informations concernant le contexte de sécurité de la demande en cours. |
Providers | Interface | L'interface Providers permet la recherche d'instances de fournisseur en fonction de critères de recherche. |
ResourceContext | Interface | L'interface ResourceContext fournit un accès à l'instanciation et à l'initialisation de classes de ressources ou de sous-ressources dans la portée de pré-demande par défaut. |
Configuration | Interface | Les configurations d'exécution client et serveur sont disponibles pour injection via l'élément @Context. Ces configurations sont disponibles pour injection dans les classes de fournisseurs (client ou serveur) et les classes de ressource (serveur uniquement). |