Création d'assistants personnalisés pour le serveur proxy
Effectuez les opérations ci-après pour créer et déployer un assistant personnalisé pour un serveur proxy. Les règles d'assistant personnalisé permettent une identification plus efficace de la disponibilité du serveur d'applications cible. Les assistants personnalisés sont des modules de code écrits en Java™ fonctionnant au sein d'un serveur proxy afin de fournir des informations sur la disponibilité du serveur d'applications au code de sélection du serveur proxy.
Pourquoi et quand exécuter cette tâche
Procédure
- Créez le code d'assistant personnalisé. Les assistants personnalisés sont écrits en langage Java. Un assistant personnalisé étend la classe com.ibm.wsspi.advisor.AbstractCustomAdvisor dans le fichier proxy.jar inclus dans WebSphere Application Server. Les assistants personnalisés utilisent les méthodes définies de la classe AbstractCustomAdvisor pour obtenir les informations à propos de l'assistant. Un assistant personnalisé comprend aussi les éléments suivants :
- Une méthode de construction qui prend un objet CustomAdvisorConfigObject et
appelle la méthode super(caConfigObject), par exemple
public AbstractHttpProxyCustomAdvisor(CustomAdvisorConfigObject caConfigObject) { super(caConfigObject); }
- Une méthode isUsable() qui prend un objet AdvisableServer, par exemple
public boolean isUsable(AdvisableServer aServer) throws CustomAdvisorException;
Pour plus d'informations concernant les routines obligatoires et autres méthodes à la disposition d'un assistant personnalisé, consultez la section Référence de l'API dans le centre de documentation. Dans la vue du centre de documentation, faites défiler jusqu'à la section Référence et cliquez sur API (interface de programmation d'applications). Une liste des spécifications de l'API du produit s'affiche en ordre alphabétique.protected void initialize() { super.initialize(); }
Lors de la création d'un assistant personnalisé, vous devez prendre deux classes d'exceptions en considération :- La méthode isUsable de l'assistant personnalisé peut créer l'exception CustomAdvisorException pour dire à l'assistant AbstractCustomAdvisor de ne pas l'appeler à nouveau avant le prochain cycle de l'assistant.
- L'assistant AbstractCustomAdvisor crée l'exception NoLogConfiguredException si le fichier de non-consignation a été configuré pour l'assistant personnalisé, mais si la consignation est activée.
Le fichier httpcustomadvisor.jar peut servir d'exemple d'assistant personnalisé. Ce fichier contient une classe AbstractHttpProxycustomAdvisor.java qui étend com.ibm.wsspi.advisor.AbstractCustomAdvisor et implémente isUsable() ainsi que les méthodes initialize().
Exemple de fichier httpcustomadvisor.jar :<advisor-context> <description>Webbsphere Proxy Demo HTTP Advisor Context</description> <display-name>Webbsphere Proxy Demo HTTP Advisor Context</display-name> ? <advisor> <advisor-name>WebsphereProxyDemoHttpAdvisor</advisor-name> ? <advisor-class> com.ibm.ws.proxy.demo.customadvisor.http.HttpProxyCustomAdvisor </advisor-class> <description>Demo Websphere Proxy Http Advisor Implementation</description> <display-name>Demo Websphere Proxy Http Advisor</display-name> </advisor> </advisor-context>
- Une méthode de construction qui prend un objet CustomAdvisorConfigObject et
appelle la méthode super(caConfigObject), par exemple
- Compilez le code d'assistant personnalisé. Après la création du code source Java pour l'assistant personnalisé, vous devez le compiler en utilisant le code AbstractCustomAdvisor inclus dans WebSphere Application Server. Pour accéder aux classes de l'assistant personnalisé abstrait dans le modulecom.ibm.wsspi.advisor, ajoutez le fichier proxy.jar au chemin d'accès Java. Le fichier proxy.jar se trouve dans le répertoire ${WAS_INSTALL_ROOT|/plugins.
- Créez le fichier advisor-context.xml.
Après la compilation du code d'assistant personnalisé, vous devrez créer le fichier advisor-context.xml. Ce ficher permet d'identifier le code comme fichier d'archive Java (JAR) d'assistant personnalisé lors de son importation comme actif et de son ajout comme unité de compilation à une application de niveau métier (BLA). Lorsque l'actif JAR d'assistant personnalisé est ajouté à un BLA, puis ciblé vers un serveur proxy, le support du fichier de description des composants (CDF) distribue et copie tous les artefacts du BLA depuis l'assistant personnalisé vers les informations de configuration appropriées sur les cibles indiquées.
Le fichier advisor-context.xml contient le nom de classe pour l'assistant personnalisé à exécuter et le nom de ce dernier. Dans le fichier proxy.jar, le format du fichier advisor-context.xml doit suivre le schéma advisor-contex.xsd. Vous pouvez utiliser un outil de schéma XML comme assistant à la création et à la configuration des informations. Les informations de configuration obligatoires sont les suivantes :<advisor-name> SomeCustomAdvisor </advisor-name> <advisor-class> com.ibm.wlm.test.customadvisor.SomeCustomAdvisor </advisor-class> <description> Some Custom Advisor Description </description> <display-name> Some display name </display-name>
- Créez le BLA d'assistant personnalisé. Faites un module avec les fichiers de classe d'assistant personnalisé compilés et le fichier advisor-context.xml dans un fichier JAR. Ce fichier JAR servira lors de la création du BLA d'assistant personnalisé à installer et déployer sur le serveur proxy. L'exemple suivant montre les commandes à utiliser pour installer un assistant personnalisé comme BLA.
$AdminTask importAsset {-source C:/proxy/testadvisor.jar -storageType FULL} $AdminTask createEmptyBLA {-name myBLA} $AdminTask addCompUnit {-blaID myBLA -cuSourceID assetname=testadvisor.jar,assetversion=1.0 -MapTargets {{.* ProxyServer}} -CustomAdvisorCUOptions {{"type=Cluster,cellName=yourCellName,clusterName=yourClusterName ,applicationName=myBLA" default default default 1000}}} $AdminConfig save
- Configurez votre assistant personnalisé déployé. Pour plus de détails, voir Administration d'assistants personnalisés pour le serveur proxy.


http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tjpx_custadv_create
Nom du fichier : tjpx_custadv_create.html