Ajout de références de service à l'application Web wps.war

Les clients de service et références des services WSRP sont définis dans le descripteur de déploiement web.xml de l'application Web wps.war. Application Web contenue dans l'archive d'application d'entreprise du portailwps.ear. Pour ajouter des références de service, vous devez modifier le descripteur de déploiement web.xml.

Pourquoi et quand exécuter cette tâche

The following excerpt from file web.xml shows the definition of the default WSRP service references:
<service-ref>
    <description>WSRP 1.0 Default Service Reference</description>
    <service-ref-name>service/wsrp/WSRPService</service-ref-name>
    <service-interface>javax.xml.ws.Service</service-interface>
    <service-qname xmlns:pfx="http://www.ibm.com/xmlns/prod/websphere/portal/wsrp/wsdl/v1">
        pfx:WSRPService
    </service-qname>
</service-ref>
<service-ref>
    <description>WSRP 2.0 Default Service Reference</description>
    <service-ref-name>service/wsrp/WSRPService_v2</service-ref-name>
    <service-interface>javax.xml.ws.Service</service-interface>
    <service-qname xmlns:pfx="http://www.ibm.com/xmlns/prod/websphere/portal/wsrp/wsdl/v2">
        pfx:WSRPService_v2
    </service-qname>
</service-ref>
Vous pouvez définir des références de service supplémentaires en ajoutant un ou plusieurs éléments service-ref. La liste suivante contient les sous-éléments qu'un nouvel élément service-ref doit définir :
description
La valeur de ce sous-élément est définie par l'utilisateur. Spécifiez une chaîne de texte de votre choix.
service-ref-name
La valeur de ce sous-élément est partiellement définie par l'utilisateur. Spécifiez service/wsrp/service-ref-id , où le préfixe service/wsrp/ est fixe, et service-ref-id est l'ID défini par l'utilisateur de la référence de service.
service-interface
La valeur de ce sous-élément est fixe. Indiquez javax.xml.ws.Service.
service-qname
Pour la valeur de ce sous-élément, vous pouvez spécifier l'une de ces deux options. Selon vos besoins, indiquez le service QName pour WSRP 1.0 ou 2.0 comme dans l'un des exemples ci-dessous :
<service-qname xmlns:pfx="http://www.ibm.com/xmlns/prod/websphere/portal/wsrp/wsdl/v1">
   pfx:WSRPService
</service-qname>
ou :
<service-qname xmlns:pfx="http://www.ibm.com/xmlns/prod/websphere/portal/wsrp/wsdl/v2">
   pfx:WSRPService_v2
</service-qname>
L'exemple de code suivant montre comment vous pouvez ajouter deux nouvelles références de service au fichier web.xml. Notez que les nouveaux éléments service-ref sont placés juste après les références de service par défaut :
service-ref>
    <description>WSRP 1.0 Default Service Reference</description>
    <service-ref-name>service/wsrp/WSRPService</service-ref-name>
    <service-interface>javax.xml.ws.Service</service-interface>
    <service-qname xmlns:pfx="http://www.ibm.com/xmlns/prod/websphere/portal/wsrp/wsdl/v1">
        pfx:WSRPService
    </service-qname>
</service-ref>
    <service-ref>
    <description>WSRP 2.0 Default Service Reference</description>
    <service-ref-name>service/wsrp/WSRPService_v2</service-ref-name>
    <service-interface>javax.xml.ws.Service</service-interface>
    <service-qname xmlns:pfx="http://www.ibm.com/xmlns/prod/websphere/portal/wsrp/wsdl/v2">
        pfx:WSRPService_v2
    </service-qname>
</service-ref>
    <service-ref>
    <description>WSRP 2.0 Alternative Service Reference 1</description>
    <service-ref-name>service/wsrp/AlternativeWSRPService_v2</service-ref-name>
    <service-interface>javax.xml.ws.Service</service-interface>
    <service-qname xmlns:pfx="http://www.ibm.com/xmlns/prod/websphere/portal/wsrp/wsdl/v2">
        pfx:WSRPService_v2
    </service-qname>
</service-ref>
    <service-ref>
    <description>WSRP 2.0 Alternative Service Reference 2</description>
    <service-ref-name>service/wsrp/WSRPService_v2_Second_Alternative</service-ref-name>
    <service-interface>javax.xml.ws.Service</service-interface>
    <service-qname xmlns:pfx="http://www.ibm.com/xmlns/prod/websphere/portal/wsrp/wsdl/v2">
        pfx:WSRPService_v2
    </service-qname>
</service-ref>
L'exemple définit deux nouvelles références de service : service/wsrp/AlternativeWSRPService_v2 et service/wsrp/WSRPService_v2_Second_Alternative. Après avoir mis à jour l'application de portail, vous pouvez configurer les nouvelles références de service figurant dans un client d'administration WebSphere® Application Server. Une fois que vous redémarrez votre portail, le Consommateur WSRP peut rechercher les références de service. Lorsque vous créez ou éditez une définition de Producteur, vous pouvez attribuer les nouvelles références de service aux ports de Producteur. Pour que le Consommateur WSRP recherche les références de service, vous devez nommer la référence de service conformément à la syntaxe suivante :
service/wsrp/service-ref-id
où le préfixe service/wsrp/ est fixe, et service-ref-id est défini par l'utilisateur.
En tant qu'administrateur du portail Consommateur, vous pouvez affecter une référence de service à un port de Producteur d'une définition de Producteur. Utilisez service-ref-id comme identificateur pour sélectionner cette référence de service. Si le nom d'une nouvelle référence de service ne contient pas le préfixe service/wsrp/, le consommateur WSRP ne trouve pas la référence de service. Lorsque vous affectez une référence de service à un port de Producteur, le portlet Configuration de services Web affiche la liste de toutes les références de service définies. La liste affiche uniquement les ID de référence de service de la référence de service sans le préfixe commun service/wsrp.