Génération d'un client JAX-RS 2.0 à partir d'un fichier de définition d'API REST

Vous pouvez générer un client JAX-RS (Java API for RESTful Web Services) 2.0 dans un projet Web Java EE (Java™ Platform, Enterprise Edition) 7. Ce client JAX-RS 2.0 repose sur un fichier de définition d'API REST nommé swagger.json.

Pourquoi et quand exécuter cette tâche

Important : Applicable à Liberty

Procédure

  1. Ouvrez l'assistant Générer un client JAX-RS en suivant l'une des options ci-dessous :
    • Cliquez avec le bouton droit sur un fichier swagger.json de votre espace de travail et sélectionnez Services RESTful > Générer un client JAX-RS.

      Les outils affichent la fenêtre Générer un client JAX-RS.

    • Pour ouvrir l'assistant Générer un client JAX-RS à partir de la fenêtre Assistant de nouvel élément, procédez comme suit :
      1. A partir du plan de travail Eclipse, sélectionnez Fichier > Nouveau > Autre....

        Les outils affichent la fenêtre Assistant de nouvel élément.

      2. Sélectionnez Services RESTful > Générer un client JAX-RS.
      3. Cliquez sur Suivant.

        Les outils affichent la fenêtre Générer un client JAX-RS.

  2. Si la zone Swagger Definition est vide, entrez l'emplacement du fichier swagger.json.

    Le fichier swagger.json peut se trouver dans l'espace de travail ou dans le système de fichiers. Vous pouvez fournir une référence HTTP ou file://. Si vous avez cliqué sur le fichier swagger.json à l'étape précédente, l'emplacement est déjà entré. Vous pouvez également faire glisser le fichier swagger.json d'un système de fichiers externe vers cette zone.

  3. Sélectionnez le projet Web cible Java EE 7 dans le menu déroulant Projet.
    Conseil : Sélectionnez un autre projet que le projet de service contenant le fichier swagger.json. Assurez-vous que la facette JAX-RS 2.0 est activée pour le projet cible Java EE 7.
  4. Dans la zone Dossier source, entrez le dossier source cible qui est défini dans le projet.
  5. Dans la zone Package, entrez le package Java du code client généré.
  6. Cliquez sur Terminer.

Résultats

Vous avez généré un client JAX-RS 2.0 dans le projet Web ciblé. L'assistant Générer un client JAX-RS crée quatre packages, dont un avec le suffixe .api. Vous pouvez utiliser les classes API de ce package pour appeler les services REST.
Icon that indicates the type of topic Task topic
Timestamp icon Last updated: last_date

File name: t_restapi_jaxrs.html