Ce document représente le point de départ de découverte du service de conversion de graphiques. Les rubriques suivantes sont traitées :
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 PNG TIFF GFX GIF Oui Oui[1] Non Oui[1] Non Non JPEG Oui[1] Oui Non Oui Non Non --- --- --- --- --- --- 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.
Prérequis produit | Version |
---|---|
Java Technology Edition | 5.0 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 |
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.
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/
Essayez différentes valeurs dans les zones d'entrée pour voir les images converties.
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>
Notez que les fichiers de travail et les fichiers convertis renvoyé via une référence d'URL sont stockés dans un emplacement de répertoire temporaire spécifié par la paramètre de configuration resultsTmpDir déclaré dans un paramètre d'initialisation du fichier web.xml. La partie suivante du fichier web.xml file démontre son utilisation :
... <init-param> <!-- Définissez la propriété suivante sur le chemin complet où vous souhaitez sauvegarder les images venant d'être mises à l'échelle/converties. --> <!-- Par exemple, sous Linux/Unix : /tmp --> <!-- Par exemple, sous Windows : c:\temp --> <!-- Si aucune valeur n'est spécifiée, la valeur par défaut est l'attribut "javax.servlet.context.tempdir" ServletContext défini par le conteneur Web. --> <!-- Lorsque la chaîne spéciale java.io.tmpdir est indiquée, le service utilise la propriété système Java avec la clé "java.io.tmpdir" --> <param-name>com.ibm.ws.mobile.appsvcs.graphics.resultsTmpDir</param-name> <param-value>java.io.tmpdir</param-value> </init-param> ...
Reportez-vous aux instructions d'installation spécifiques à chaque version :
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.
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
- Connectez-vous à la console administrative pour le serveur d'application.
- Naviguez jusqu'à Applications > Nouvelle application. (Note : dans WebSphere Application Server Version 6.1, sélectionnez Installation d'une nouvelle application)
- Sélectionnez New Enterprise Application. (Note : dans WebSphere Application Server Version 6.1, ignorez cette étape)
- Parcourez votre système de fichiers et sélectionnez le fichier appsvcs-graphics.ear localisé précédemment. Cliquez sur Suivant.
- Cliquez sur Suivant pour préparer l'installation d'application. (Note : dans WebSphere Application Server Version 6.1, ignorez cette étape)
- Cliquez sur Suivant pour accepter les options d'installation par défaut.
- Cliquez sur Suivant pour accepter les options par défaut pour le mappage des modules vers les serveurs.
- 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)
- Cliquez sur Suivant pour accepter les options par défaut pour le mappage des hôtes virtuels pour les modules Web.
- Consultez le récapitulatif des options d'installation.
- Cliquez sur Terminer.
- Cliquez sur Sauvegarder dans la configuration principale.
- Naviguez jusqu'à Applications > Types d'application > WebSphere Enterprise Applications. (Note : dans WebSphere Application Server Version 6.1, naviguez jusqu'à Applications > Enterprise Applications)
- Sélectionnez IBM WebSphere Application Server - Graphics Conversion service, et cliquez sur Démarrer.
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.
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
Connectez-vous à la console administrative pour le serveur d'application.
- Cliquez sur Applications > Deployer dans le menu de gauche. (Note : dans WebSphere Application Server Community Edition Version 2.0, cliquez sur Applications > Déployer)
- 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.