Services Web (J2EE 1.3 vers J2EE 1.4)

Via la nouvelle API JAX-RPC 1.0, la spécification J2EE 1.4 comporte une prise en charge pour les services Web.

L'API JAX-RPC API prend en charge les noeuds finaux de service à l'aide des : La spécification J2EE 1.4 prend en charge les services Web pour la spécification J2EE (JSR 109). JSR 109 définit la configuration de déploiement requise pour les services Web et utilise le modèle de programmation JAX-RPC.
Les arterfacts des services Web suivants sont migrés à l'aide de l'assistant de migration J2EE :
  • Descripteur de services Web
  • Descripteur client de services Web
  • Descripteur de mappage JAX-RPC

Migration des descripteurs de déploiement des services Web

Tout descripteur de déploiement de services Web se trouvant dans les projets J2EE 1.3 migrés vers le niveau de spécification J2EE 1.4 sera migré à partir de JSR-109 V1.0 (pour J2EE 1.3) vers J2EE 1.4.

Les descripteurs de déploiement de services Web, tels qu'ils sont définis par JSR-109 V1.0, sont composés des fichiers webservices.xml, webservicesclient.xml et de tous les descripteurs de déploiement de mappage référencés par les fichiers webservices.xml et webservicesclient.xml. De la même façon qu'avec les autres descripteurs de déploiement J2EE, la migration modifie la structure des informations se trouvant dans les descripteurs afin qu'elles soient compatibles avec la spécification J2EE 1.4. La modification apportée au mode de représentation des noms qualifiés est une modification structurelle propre aux descripteurs de déploiement de service Web. Dans JSR-109 V1.0, les noms qualifiés sont représentés à l'aide d'une séquence de deux éléments, <namespaceURI> et <localpart>, qui contient l'URI espace de nom et la partie locale du nom, respectivement. Les noms qualifiés dans J2EE 1.4 dépendent du type XMLSchema QName qui utilise des espaces de nom.

Des informations supplémentaires sur la migration de chaque descripteur de déploiement Web sont disponibles ci-dessous.
  • Descripteur de services Web (webservices.xml)

    Le descripteur de déploiement webservices.xml se trouve dans des projets Web et dans des projets EJB qui contiennent des services Web J2EE. Les éléments <wsdl-port> et <soap-header> contiennent tous deux des noms qualifiés et leur contenu sera migré vers le format J2EE 1.4.

    Le descripteur de déploiement webservices.xml se trouve dans les projets Web qui contiennent des services Web J2EE. Les éléments <wsdl-port> et <soap-header> contiennent tous deux des noms qualifiés et leur contenu sera migré vers le format J2EE 1.4.

    Par exemple, si <wsdl-port> est représenté de la manière suivante avant la migration,

    <wsdl-port>
      <namespaceURI>http://addressbook.webservice</namespaceURI>
      <localpart>AddressBook</localpart>
    </wsdl-port>

    après la migration <wsdl-port> aura l'aspect suivant :

    <wsdl-port xmlns:pfx="http://addressbook.webservice">pfx:AddressBook</wsdl-port>

    Le préfixe "pfx" est utilisé comme préfixe d'espace de nom pour tous les noms qualifiés migrés.

  • Descripteur client de services Web (webservicesclient.xml)
    Le descripteur de déploiement webservicesclient.xml se trouve dans les projets Web J2EE 1.3, dans les projets EJB et les projets client d'application qui contiennent des clients de service Web J2EE. Lors de la migration de J2EE 1.3 vers 1.4, le contenu de webservicesclient.xml est migré et déplacé vers le descripteur de déploiement pour le projet. Le processus qui se produit est le suivant :
    • Pour les projets Web, tous les éléments <service-ref> du fichier webserivcesclient.xml sont déplacés sous l'élément <web-app> dans web.xml.
    • Pour les projets client d'application, tous les éléments <service-ref> du fichier webservicesclient.xml sont déplacés sous l'élément <application-client> dans application-client.xml.
    • Pour les projets EJB, tous les éléments <service-ref> au sein d'un élément<component-scoped-refs> du fichier webserviceclient.xml sont déplacés sous l'élément <enterprise-bean> correspondant dans ejb-jar.xml.
    • Le fichier webservicesclient.xml est supprimé.
    Le descripteur de déploiement webservicesclient.xml se trouve dans les projets Web J2EE 1.3 et dans les projets client d'application qui contiennent des clients de service Web J2EE. Lors de la migration de J2EE 1.3 vers 1.4, le contenu de webservicesclient.xml est migré et déplacé vers le descripteur de déploiement pour le projet. Le processus qui se produit est le suivant :
    • Pour les projets Web, tous les éléments <service-ref> du fichier webserivcesclient.xml sont déplacés sous l'élément <web-app> dans web.xml.
    • Pour les projets client d'application, tous les éléments <service-ref> du fichier webservicesclient.xml sont déplacés sous l'élément <application-client> dans application-client.xml.
    • Le fichier Webservicesclient.xml est supprimé.

    Les éléments <service-qname> et <soap-header> contiennent tous deux des noms qualifiés et leur contenu sera migré vers le format J2EE 1.4. Par exemple, si <service-qname> est représenté de la manière suivante avant la migration,

    <service-qname>
      <namespaceURI>http://addressbook.webservice</namespaceURI>
      <localpart>AddressBookService</localpart>
    </service-qname>

    après la migration <service-qname> aura l'aspect suivant :

    <service-qname xmlns:pfx="http://addressbook.webservice">pfx:AddressBookService</service-qname>

    Le préfixe "pfx" est utilisé comme préfixe d'espace de nom pour tous les noms qualifiés migrés.

  • Descripteur de mappage JAX-RPC

    Les descripteurs de déploiement webservices.xml et webservicesclient.xml peuvent tous deux faire référence à un ou plusieurs descripteurs de déploiement de mappage JAX-RPC.

    Dans le fichier webservices.xml, ces références se trouvent dans l'élément <jaxrpc-mapping-file> sous chaque élément <webservice-description>. Dans le fichier webservicesclient.xml, ces références se trouvent dans l'élément <jaxrpc-mapping-file> sous chaque élément <service-ref>.

    Lors de la migration de J2EE 1.3 vers 1.4, tous les descripteurs de déploiement référencés dans webservices.xml et webservicesclient.xml sont migrés. La migration inclut la migration de tous les noms qualifiés vers le format J2EE 1.4 (pour obtenir des exemples de noms qualifiés après la migration, reportez-vous aux section relatives aux fichiers webservices.xml et webservicesclient.xml).

Tâches associées
Migration des services Web sécurisés
Référence associée
Projets EJB (EJB 2.0 à EJB 2.1)
Projets Web (niveau de servlet 2.3 vers niveau de servlet 2.4)
Projets du connecteur (JCA 1.0 à JCA 1.5)
Migration du niveau de spécification J2EE 1.3 vers 1.4