Initiation au service de conversion de graphiques

Ce document représente le point de départ de découverte du service de conversion de graphiques. Les rubriques suivantes sont traitées :

vue d'ensemble

Le service de conversion des graphiques fournit une ressource JAX-RS côté serveur qui prend en charge la mise à l'échelle et les conversions d'un grand nombre de formats de graphiques. Voir le graphique de conversion pour plus de détails.

De/En GIF JPEG PDF PNG TIFF GFX
GIF Oui Oui[1] Non Oui[1] Non Non
JPEG Oui[1] Oui Non Oui Non Non
PDF --- --- --- --- --- ---
PNG Oui[1] Oui Non Oui Non Non
SVG Non Oui Oui Oui Oui Oui[2]
TIFF --- --- --- --- --- ---

[1] Pris en charge uniquement avec Java SDK Version 6.0 ou supérieure.

[2] Il existe actuellement des limitations dans la portée de la fonction SVG en GFX. Voir la section Limitations.

Un exemple d'application client, fourni via l'exemple Mobile Showcase sur WebSphere Application Server, illustre un appel Ajax simple du service de conversion de graphiques. Le client autorise les utilisateurs à spécifier une URL pour le fichier de graphique nécessitant une conversion, le format d'image vers lequel convertir l'image existante et des longueur et largeur maximales facultatives pour l'image générée (en cas de mise à l'échelle). Le service renvoie une URL au fichier converti, ou à l'image binaire, à utiliser au format le plus approprié pour l'application client. Etant donné que les options sont des paramètres de requêtes d'URL, les utilisateurs peuvent également créer l'URL avec les paramètres nécessaires. Leur navigateur affiche l'image convertie.

Remarque :
  • L'exemple d'application Graphics Conversion sert uniquement à illustrer une utilisation possible de ce service et à illustrer comment utiliser les appels AJAX pour faire la requête REST.
  • A cause des limitations de certains navigateurs à l'égard de l'affichage du contenu SVG dans les balises img et iframe html, des solutions sont parfois utilisées, qui permettant l'affichage d'image non SVG lors de la sélection de l'image SVG. Toutefois, seul l'affichage de la sélection est concerné, et l'intérieur du document html n'est pas modifié. Lorsque la requête AJAX est envoyée au service, l'image SVG réelle est toujours envoyée pour conversion. Dans la vue des résultats, vous voyez toujours l'image convertie réelle, qui peut être sauvegardée si nécessaire.

Prérequis :

Prérequis produit Version
Java Technology Edition 5.0 et version ultérieure
Java Platform, Enterprise Edition 5
serveur d'application et version ultérieure

WebSphere Application Server Version 6.1.0.x et ultérieure

WebSphere Application Server Community Edition Version 2.X.

Navigateur Web Tout navigateur Web moderne, tel que : Internet Explorer 7 et version ultérieure Mozilla Firefox 3.x et version ultérieure Google Chrome Safari Opera

Limitations

Considérations concernant la sécurité

Utilisation du service de conversion de graphiques

  1. Pour utiliser le service de conversion de graphiques, déployez le fichier .ear sur un serveur d'application. Consultez la rubrique concernant l'Installation du service de conversion des graphiques.

  2. Une fois que le service est déployé, vous pouvez utiliser la démo client fournie. Elle est disponible à l'adresse :

    http://<server>:<port>/appsvcs-graphics/
    
  3. Essayez différentes valeurs dans les zones d'entrée pour voir les images converties.

  4. Pour générer directement les conversions d'images dynamiques dans votre navigateur, vous pouvez également entrer une URL avec les paramètres spécifiés, par exemple :

    http://<server>:<port>/appsvcs-graphics/rest/graphics/convert/binaryResponse?sourceUrl=<graphic_file_url>&desiredFormat=<new_format>&maxWidth=<optional_width>&maxHeight=<optional_height>
    

Installation du service de conversion des graphiques

Reportez-vous aux instructions d'installation spécifiques à chaque version :

Instructions d'installation WebSphere Application Server

Cette section décrit la procédure d'installation du service de conversion des graphiques dans la Version 6.1.0.X et ultérieure d'IBM WebSphere Application Server. Vous devez avoir des bonnes connaissances sur l'administration et l'installation de l'application pour le serveur d'application.

Avant de commencer

Localisez le fichier d'archive (EAR) du service de conversion des graphiques qui est fourni avec l'installation de votre produit. Vous le trouverez dans votre arborescence d'installation où vous avez installé IBM WebSphere Application Server Feature Pack for Web 2.0 and Mobile. Par exemple, si vous avez installé le module de fonctions à l'emplacement suivant :

Linux et UNIX : /opt/WebSphere/AppServer
point de montage z/OS : <install_root>
Windows : c:\WebSphere\AppServer

Vous trouverez alors le fichier EAR à l'emplacement suivant :

Linux et UNIX : /opt/WebSphere/AppServer/web2mobilefep_1.1/installableApps/application_services/graphics/appsvcs-graphics.ear
z/OS : <install_root>/web2mobilefep_1.1/installableApps/application_services/graphics/appsvcs-graphics.ear
Windows : c:\WebSphere\AppServer\web2mobilefep_1.1\installableApps\application_services\graphics\appsvcs-graphics.ear

Installation du service de conversion des graphiques à l'aide de la console administrative

  1. Connectez-vous à la console administrative pour le serveur d'application.
  2. Naviguez jusqu'à Applications > Nouvelle application. (Note : dans WebSphere Application Server Version 6.1, sélectionnez Installation d'une nouvelle application)
  3. Sélectionnez New Enterprise Application. (Note : dans WebSphere Application Server Version 6.1, ignorez cette étape)
  4. Parcourez votre système de fichiers et sélectionnez le fichier appsvcs-graphics.ear localisé précédemment. Cliquez sur Suivant.
  5. Cliquez sur Suivant pour préparer l'installation d'application. (Note : dans WebSphere Application Server Version 6.1, ignorez cette étape)
  6. Cliquez sur Suivant pour accepter les options d'installation par défaut.
  7. Cliquez sur Suivant pour accepter les options par défaut pour le mappage des modules vers les serveurs.
  8. Cliquez sur Suivant pour accepter les options par défaut pour les métadonnées des modules. (Note : dans WebSphere Application Server Versions 6.1 et 7, ignorez cette étape)
  9. Cliquez sur Suivant pour accepter les options par défaut pour le mappage des hôtes virtuels pour les modules Web.
  10. Consultez le récapitulatif des options d'installation.
  11. Cliquez sur Terminer.
  12. Cliquez sur Sauvegarder dans la configuration principale.
  13. Naviguez jusqu'à Applications > Types d'application > WebSphere Enterprise Applications. (Note : dans WebSphere Application Server Version 6.1, naviguez jusqu'à Applications > Enterprise Applications)
  14. Sélectionnez IBM WebSphere Application Server - Graphics Conversion service, et cliquez sur Démarrer.

Instructions d'installation WebSphere Application Server Community Edition Version 2.X

Cette section décrit la procédure d'installation du service de conversion des graphiques dans la Version 2.X d'IBM WebSphere Application Server Community Edition. Vous devez avoir des bonnes connaissances sur l'administration et l'installation de l'application pour le serveur d'application.

Avant de commencer

Localisez le fichier d'archive (EAR) du service de conversion des graphiques qui est fourni avec l'installation de votre produit. Vous le trouverez dans votre arborescence d'installation où vous avez installé IBM WebSphere Application Server Feature Pack for Web 2.0 and Mobile. Par exemple, si vous avez installé le module de fonctions à l'emplacement suivant :

Linux et UNIX : /opt/WebSphere/AppServerCommunityEdition
Windows : c:\WebSphere\AppServerCommunityEdition

Vous trouverez alors les fichiers de bibliothèque et EAR à l'emplacement suivant :

Linux et UNIX : /opt/WebSphere/AppServerCommunityEdition/web2mobilefep_1.1/AppServices/installableApps/graphics/appsvcs-graphics.ear
Windows : c:\WebSphere\AppServerCommunityEdition\web2mobilefep_1.1\AppServices\installableApps\graphics\appsvcs-graphics.ear

Installation à l'aide de la console administrative

Connectez-vous à la console administrative pour le serveur d'application.

  1. Cliquez sur Applications > Deployer dans le menu de gauche. (Note : dans WebSphere Application Server Community Edition Version 2.0, cliquez sur Applications > Déployer)
  2. Dans la zone Archive, parcourez votre système de fichiers et sélectionnez le fichier appsvcs-graphics.ear localisé précédemment. Laissez la zone Plan vide et les options par défaut sélectionnées. Cliquez alors sur Installer.

L'application démarre automatiquement ; l'installation est terminée.