Démonstrations de la bibliothèque OpenSearch
Le répertoire ibm_opensearch/data/demos utilise les fonctionnalités de recherche compatibles OpenSearch
présentes sur plusieurs sites Web distants, énumérés ci-dessous.
- http://intertwingly.net/
- http://www.shutterpoint.com/
- http://technorati.com/
- http://en.wasalive.com/
Pour que ces fichiers puissent fonctionner correctement, une procédure préalable de configuration doit être effectuée :
-
Le document de description OpenSearch de ces sites doit résider dans le répertoire ibm_opensearch/data/demos/resources. Cliquez avec le bouton droit de la souris sur chacun des liens ci-dessous et sélectionnez Enregistrer le lien sous... ou Enregistrer la cible sous... (selon le navigateur utilisé), puis enregistrez le fichier sous le nom et à l'emplacement indiqués. Veillez à bien sélectionner Tous les fichiers ou Fichier XML comme type des fichiers, faute de quoi ils ne seraient pas enregistrés correctement.
-
Configurez un proxy qui permette aux pages de démo (s'exécutant dans un navigateur côté client) d'accéder à des services distants. Le navigateur côté client
restreint les demandes XHR au même domaine que la page d'où ils proviennent (l'on appelle cela la règle de même origine ou same-origin policy),
ce qui signifie que l'accès aux services distants de recherche doit être acheminé via un proxy. La fonction AjaxProxy du
WebSphere Featurepack for Web 2.0 est la meilleure option ; la procédure suivante permet de configurer ces démonstrations avec AjaxProxy :
- Dans Eclipse, cliquez sur Fichier->Importer. Dans le dossier Web, cliquez sur Fichier WAR, puis sur Suivant.
-
Dans l'écran qui apparaît alors, pour le fichier WAR, recherchez le fichier AjaxProxy.war qui a été installé dans le cadre du Feature Pack. Indiquez le nom de votre projet dans la zone suivante. Pour Environnement d'exécution cible, sélectionnez Aucun. Cochez la case située en regard d'Ajouter un projet à EAR. Cliquez sur
Terminer. Un nouveau projet va être créé sous le nom que vous avez indiqué avec les fichiers AjaxProxy déjà configurés.
-
Copiez la totalité des dossiers dojo/, dojox/, dijit/ et ibm_opensearch/ dans le dossier WebContent que vous venez de créer dans le cadre du nouveau projet de proxy.
-
Modifiez les documents de description OpenSearch précédemment téléchargés afin de forcer les noeuds finals de la recherche à utiliser le proxy local.
Par exemple, lorsqu'un noeud final de recherche était www.intertwingly.net/blog/?q={searchTerms}, modifiez la valeur en
/<projectName>/proxy/http/www.intertwingly.net/blog/?q={searchTerms}. Les noeuds finals de recherche sont décrits par des éléments <URL> dans le document de description OpenSearch.
-
Avec le bouton droit de la souris, cliquez sur le projet EAR qui a été créé (normalement, <nom_projet>EAR) et cliquez sur Exporter... Sous J2EE, sélectionnez Fichier EAR.
Sélectionnez le fichier de destination et cliquez sur Terminer. Ce fichier EAR peut à présent être déployé sur votre serveur d'applications.
Une fois cette procédure appliquée et après avoir déployé le fichier EAR sur un serveur WebSphere Application Server, les fichiers de démo peuvent être affichés et utilisés.