Red Hat Summit Red Hat SummitSupportConsoleDéveloppeursCommencer un essaiContact

13.13.3. Configurer les jobs asynchrones avec RESTEasy

Résumé

Cette section couvre des exemples de paramètres de recherche de jobs asynchrones avec RESTEasy.

Avertissement

La sécurité basée rôle ne fonctionne pas dans le Service de jobs asynchrones car il ne fonctionne pas de manière portable. Si le Service de jobs asynchrones est utilisé, la sécurité d'application doit être effectuée via des déclarations XML par le fichier web.xml à la place.

Important

Bien que les méthodes GET, DELETE, et PUT soient invoquées de manière asynchrones, cela rompt le contrat HTTP 1.1 de ces méthodes. Bien que ces invocations ne changent sans doute pas l'état de la ressource en cas d'invocations multiples, elles changent d'état du serveur en nouvelles entrées de Job pour chaque invocation.

Exemple 13.18. Le paramètre Asynch

Le paramètre de requête asynch est utilisé pour exécuter des invocations en arrière-plan. Une réponse 202 Accepted est retournée, ainsi que d'un en-tête d'emplacement avec un URL pointant vers la réponse de la méthode de base. 
POST http://example.com/myservice?asynch=true
Copy to Clipboard Toggle word wrap
L'exemple ci-dessus retournera une réponse Accepted 202. Il retournera également un en-tête d'emplacement avec un URL pointant vers la réponse de la méthode de base. Voici un exemple de l'en-tête d'emplacement : 
HTTP/1.1 202 Accepted
Location: http://example.com/asynch/jobs/3332334
Copy to Clipboard Toggle word wrap
L'URI prendra la forme suivante : 
/asynch/jobs/{job-id}?wait={millisconds}|nowait=true
Copy to Clipboard Toggle word wrap
Les opérations GET, POST et DELETE peuvent être effectuées sur cet URL.
  • GET renvoie la méthode de ressources JAX-RS invoquée comme réponse si le job est complété. Si le job n'a pas été complété, ce GET renverra un code de réponse 202 Accepted. L'invocation de GET ne supprime pas le job; peut être appelé à plusieurs reprises.
  • POST procède à une lecture de la réponse du job et supprime le job s'il est terminé.
  • DELETE est appelé pour nettoyer manuellement la file d'attente du job.

    Note

    Quand la file d'attente du job est pleine, il expulsera job le plus ancien de la mémoire automatiquement, sans avoir besoin d'appeler DELETE.

Exemple 13.19. Wait / Nowait

Les opérations GET et POST permettent de définir une durée d'attente maximum, par les paramètres de demande wait et nowait. Si le paramètre wait n'est pas spécifié, l'opération aura par défaut nowait=true, et n'attendra pas si le job n'est pas terminé. Le paramètre wait est défini en millisecondes. 
POST http://example.com/asynch/jobs/122?wait=3000
Copy to Clipboard Toggle word wrap

Exemple 13.20. Le Paramètre Oneway

RESTEasy supporte «fire and forget jobs» (abandonner les jobs) avec le paramètre de requête oneway. 
POST http://example.com/myservice?oneway=true
Copy to Clipboard Toggle word wrap
L'exemple ci-dessus retournera la réponse 202 Accepted, mais aucun job ne sera créé.
Rapporter un bogue
Retour au début
Red Hat logoGithubredditYoutubeTwitter

Apprendre

Essayez, achetez et vendez

Communautés

À propos de la documentation Red Hat

Nous aidons les utilisateurs de Red Hat à innover et à atteindre leurs objectifs grâce à nos produits et services avec un contenu auquel ils peuvent faire confiance. Découvrez nos récentes mises à jour.

Rendre l’open source plus inclusif

Red Hat s'engage à remplacer le langage problématique dans notre code, notre documentation et nos propriétés Web. Pour plus de détails, consultez le Blog Red Hat.

À propos de Red Hat

Nous proposons des solutions renforcées qui facilitent le travail des entreprises sur plusieurs plates-formes et environnements, du centre de données central à la périphérie du réseau.

Theme

© 2025 Red Hat