Portail Producteur WSRP

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

Vous pouvez configurer des gestionnaires pour le Producteur WSRP dans 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 l'application de portail. Pour plus d'informations, lisez les informations contenues dans une section suivante.

Utilisation d'un gestionnaire sur un portail Producteur 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. Export the wps.ear portal application.
    Le fichier wps.ear exporté contient un wps.war. Le répertoire WEB-INF/classes dans le fichier wps.war contient deux fichiers wp.wsrp.producer-v1-handlerchain.xml et wp.wsrp.producer-v2-handlerchain.xml.
  4. Modifiez soit le fichier wp.wsrp.producer-v1-handlerchain.xml ou le fichier wp.wsrp.producer-v2-handlerchain.xml.
    Mettez à jour l'élément handler-chains par défaut en ajoutant un ou plusieurs éléments handler.
  5. Update the wps.ear portal application.
  6. Redémarrez votre portail Producteur WSRP.

Résultats

Vous pouvez à présent utiliser le gestionnaire dans votre portail Producteur

Exemple

The following samples show excerpts from the file wp.wsrp.producer-v2-handlerchain.xml. Les exemples contiennent une définition de gestionnaire pour le producteur WSRP.
Avant le groupe de correctifs CF 05 :
<?xml version="1.0" encoding="UTF-8"?>
<ns:handler-chains xmlns:ns="http://java.sun.com/xml/ns/javaee">
    <ns:handler-chain name="wp.wsrp.producer-v2-handlerchain">
        <ns:handler>
            <ns:handler-class>sample.handler.ProducerHandler</ns:handler-class>
        </ns:handler>
    </ns:handler-chain>
</ns:handler-chains>
A compter du groupe de correctifs CF 05, vous devez modifier la définition de gestionnaire par défaut pour la classe de gestionnaire com.ibm.wps.wsrp.producer.handler.ProducerHandlerChain. Vous pouvez ajouter des gestionnaires, comme illustré dans l'exemple suivant :
<?xml version="1.0" encoding="UTF-8"?>
<ns:handler-chains xmlns:ns="http://java.sun.com/xml/ns/javaee">
    <ns:handler-chain name="wp.wsrp.producer-v2-handlerchain">
        <ns:handler>
            <ns:handler-class>com.ibm.wps.wsrp.producer.handler.ProducerHandlerChain</ns:handler-class>
        </ns:handler>
        <ns:handler>
            <ns:handler-class>sample.handler.ProducerHandler</ns:handler-class>
        </ns:handler>
    </ns:handler-chain>
</ns:handler-chains>

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 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.producer.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.producer.SOAPHandler" id="SampleProducerHandler1">
        <impl class="com.ibm.wps.wsrp.test.handler.ProducerHandler1" weight="100"/>
    </extension>
    <extension point=" com.ibm.portal.wsrp.producer.SOAPHandler" id="SampleProducerHandler2">
        <impl class="com.ibm.wps.wsrp.test.handler.ProducerHandler2" weight="110"/>
    </extension>
</plugin>