Portail Consommateur WSRP

Découvrez comment configurer et utiliser un gestionnaire (handler) sur un portail consommateur WSRP.

Vous pouvez configurer des gestionnaires pour le Consommateur WSRP dans le fichier web.xml de l'application de portail wps.ear.

A compte du groupe de correctifs CF05, vous pouvez enregistrer des gestionnaires qui implémentent l'interface SOAPHandler comme une extension d'un point d'extension WSRP. Dans ce cas, vous n'avez pas besoin de modifier le fichier web.xml de l'application de portail. Pour plus d'informations, lisez les informations contenues dans une section suivante.

Utilisation d'un gestionnaire sur un portail Consommateur WSRP

Procédure

  1. Créez une implémentation de gestionnaire conforme à la spécification JAX-WS.
    Pour plus d'informations sur l'infrastructure du gestionnaire, voir la spécification JAX-WS. Pour plus d'informations sur l'utilisation des gestionnaires avec les services Web JAX-WS, lisez les informations appropriées dans la documentation de WebSphere® Application Server.
  2. Indiquez l'implémentation du gestionnaire dans le chemin de classes de l'application de portail wps.ear, par exemple dans le répertoire d'application partagé du portail.
  3. Exportez l'application de portail wps.ear.
    Le fichier wps.ear exporté contient un fichier wps.war, lequel contient un fichier nommé web.xml.
  4. Modifiez le fichier web.xml en ajoutant un élément handler-chains à la référence de service pour laquelle vous souhaitez déployer le gestionnaire.
  5. Mettez à jour l'application de portail wps.ear.
  6. Redémarrez votre portail Consommateur WSRP.

Résultats

Vous pouvez à présent utiliser votre portail Consommateur

Exemple

Les exemples suivants illustrent des extraits du fichier web.xml. Les exemples contiennent une définition de gestionnaire pour le client WSRP.
Avant le groupe de correctifs CF 05 :
<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>
   <handler-chains>
      <handler-chain>
         <handler>
            <handler-name>sample handler</handler-name>
            <handler-class>sample.handler.ConsumerHandler</handler-class>
         </handler>
      </handler-chain>
   </handler-chains>
</service-ref>
A compter du groupe de correctifs CF 05, vous ne devez pas modifier la définition de gestionnaire par défaut nommée WSRP 2.0 Default Consumer Handler. Vous pouvez ajouter des gestionnaires, comme illustré dans l'exemple suivant :
<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>
   <handler-chains>
      <handler-chain>
         <handler>
            <handler-name>WSRP 2.0 Default Consumer Handler</handler-name>
            <handler-class>com.ibm.wps.wsrp.consumer.handler.ConsumerHandlerChain</handler-class>
         </handler>
         <handler>
            <handler-name>sample handler</handler-name>
            <handler-class>sample.handler.ConsumerHandler</handler-class>
         </handler>
      </handler-chain>
   </handler-chains>
</service-ref>

Enregistrement d'un élément SOAPHandler en tant qu'extension WSRP

Pour enregistrer un gestionnaire qui implémente l'interface SOAPHandler, vous pouvez utiliser un point d'extension WSRP. Dans ce cas, vous n'avez pas besoin de modifier le fichier web.xml de l'application de portail. Pour ce faire, indiquez un fichier JAR qui contient l'implémentation de gestionnaire et un fichier plugin.xml qui définit une extension de point d'extension com.ibm.portal.wsrp.consumer.SOAPHandler. Vous pouvez également définir plusieurs gestionnaires dans un fichier plugin.xml, comme illustré dans l'exemple ci-après. L'attribut de classe doit spécifier la classe d'implémentation de gestionnaire.

Pourquoi et quand exécuter cette tâche

<?xml version="1.0" encoding="UTF-8"?>
<plugin
   id="sample.handler"
   name="Sample WSRP Handlers"
   version="1.0.0">
	
   <extension point="com.ibm.portal.wsrp.consumer.SOAPHandler" id="SampleConsumerHandler1">
      <impl class="com.ibm.wps.wsrp.test.handler.ConsumerHandler1" weight="100"/>
   </extension>
   <extension point=" com.ibm.portal.wsrp.consumer.SOAPHandler" id="SampleConsumerHandler2">
      <impl class="com.ibm.wps.wsrp.test.handler.ConsumerHandler2" weight="110/>
   </extension>
</plugin>