Déploiement d'une application J2C en tant que service Web

Vous pouvez déployer votre application J2C en tant que service Web.

Avant de commencer

Après avoir créé une application J2C, vous pouvez la déployer en créant un service Web pour votre application J2C.

Procédure

  1. Ouvrez l'assistant Page Web, service Web ou EJB issu d'un bean J2C.
    • Si le bean J2C pour lequel vous créez un service Web existe dans votre espace de travail, procédez comme suit :
      1. Sur la barre de menus, sélectionnez Fichier > Nouveau > Autre > J2C > Page Web, service Web ou EJB issu d'un bean J2C et cliquez sur Suivant.
      2. Sur la page de sélection du bean J2C, cliquez sur Parcourir afin de localiser votre bean J2C. Si vous savez par quelle lettre commence le nom de votre bean J2C, tapez-la dans la zone Sélectionnez les entrées, ou bien tapez ? pour obtenir la liste de tous les beans J2C. Mettez en évidence votre sélection et cliquez sur OK.
        Restriction : Caractères non conformes à XML dans les fichiers IMS :

        Dans le but d'optimiser les performances, les applications IMS peuvent remplacer les espaces de fin dans les types de données chaîne. Les caractères les plus courants sont x'3F', x'00'. Ils sont parfaitement valides dans des données destinées à un terminal 3270 ou transitant sur un couplage MSC ou ISC, ou dans d'autres applications avec conversion des caractères EBCDIC en ASCII. En revanche, ils ne sont pas valides selon la spécification XML.

        x'3F' est l'exemple le plus courant, car si cette séquence a une signification particulière pour IMS, elle est la cause de problèmes pour XML. En code ASCII, x'3F' devient un point d'interrogation (?), lequel est un caractère réservé en UTF-8, sauf s'il est correctement géré dans le cadre d'une chaîne. L'adaptateur IMS/TM traite ce caractère comme un délimiteur XML et rapporte une erreur à l'exécution.

        Veillez à ce que votre fichier ne contienne pas ces caractères non autorisés, sous peine d'erreurs à l'exécution. Pour contourner le problème, vous pouvez modifier le code d'implémentation du bean Java J2C. Dans votre méthode métier, après l'appel de la méthode invoke, ajoutez un programme de conversion de la sortie avant de la retourner à l'application client. Par exemple :
          ...   invoke(cs, is, input, output);
           //ajoutez votre propre utilitaire de conversion ici
          output = convert(output);
          return output; 
      3. Cliquez sur Next.
    • Si vous avez suivi les étapes de l'assistant de création d'un bean J2C jusqu'à la fin, sélectionnez l'option Créer une page Web, un service Web ou un EJB issu du bean J2C.
  2. Dans la zone Type de ressource Java EE, sélectionnez Service Web et cliquez sur Suivant.
  3. Vérifiez que le nom correct de votre projet J2C apparaît dans la zone Projet de service Web. S'il n'y figure pas, ou si le nom affiché n'est pas le bon, tapez le nom de projet correct. Si vous voulez que le code soit généré dans un nouveau projet, cliquez sur Nouveau.
  4. Cliquez sur Options avancées si vous souhaitez définir des propriétés avancées.
  5. Dans la zone Référence de ressource, fournissez un nom pour la référence de la ressource. Cette référence servira à établir le lien entre le nom utilisé dans l'application et le vrai nom JNDI de la ressource spécifié sur le serveur d'exécution. La création d'une référence de ressource est la technique à privilégier pour gérer les connexions, car elle rend le code de votre application moins dépendant du serveur. Ainsi, si vous décidez plus tard d'utiliser un serveur différent pour exécuter votre application, vous aurez simplement à créer une référence de ressource établissant un lien au nouveau serveur, sans avoir besoin de changer le code source de votre application. Une fois que vous avez fourni un nom de référence de ressource, l'assistant vérifie que le nom JNDI existe bien dans le serveur.
  6. Vérifiez que le nom correct de votre recherche JNDI apparaît dans la zone Nom de recherche JNDI. S'il n'y figure pas, ou si le nom affiché n'est pas le bon, tapez le nom de recherche JNDI correct.
  7. Si vous avez sélectionné Configuration du déploiement de l'adaptateur de ressources sur la page Informations de déploiement, cliquez sur Suivant pour passer à la page de spécification des paramètres RAR. Cette option est proposée uniquement lorsque la connexion au système d'information d'entreprise n'est pas purement gérée. Si la connexion est gérée, le déploiement du fichier RAR sur le serveur est implicite.
  8. Si vous n'avez pas sélectionné Configuration du déploiement de l'adaptateur de ressources sur la page Informations de déploiement, cliquez sur Terminer.
  9. Pour en savoir plus sur la création d'un service Web, consultez la documentation des services Web.

Commentaires