Cómo empezar con el servicio de Graphics Conversion

Este documento es el punto de partida para obtener información sobre el servicio de Graphics Conversion. Se tratan los temas siguientes:

Visión general

El servicio de Graphics Conversion proporciona un recurso JAX-RS del lado del servidor que da soporte a escalado y la conversión entre muchos formatos gráficos. Consulte el diagrama de conversión para obtener más información.

A/De GIF JPEG PDF PNG TIFF GFX
GIF Sí[1] No Sí[1] No No
JPEG Sí[1] No No No
PDF --- --- --- --- --- ---
PNG Sí[1] No No No
SVG No Sí[2]
TIFF --- --- --- --- --- ---

[1] Soportado sólo con Java SDK Versión 6.0 o superior.

[2] Actualmente hay limitaciones en el ámbito de la función de SVG a GFX. Consulte la sección Limitaciones.

Una aplicación cliente de ejemplo, proporcionada mediante el Ejemplo de Mobile Showcase en WebSphere Application Server, muestra una invocación Ajax simple del servicio de Graphics Conversion. El cliente permite a los usuarios especificar un URL para el archivo gráfico que necesita conversión, el formato de imagen al que convertir la imagen existente y una anchura y altura máxima opcionales de anchura y altura para la imagen generada (si se solicita escalado). El servicio devuelve un URL al archivo convertido o la imagen binaria, para utilizar en cualquiera de los dos formatos que sea más adecuado para la aplicación cliente. Dado que las opciones son parámetros de consulta de URL, los usuarios también pueden crear el URL con parámetros necesarios y el navegador visualizará la imagen convertida.

Nota:
  • La aplicación de ejemplo de Graphics Conversion es sólo para ilustrar un posible uso del servicio de Graphics Conversion, y para ilustrar cómo se utilizarían invocaciones AJAX para realizar la solicitud REST.
  • Debido a las limitaciones existentes en algunos navegadores respecto a la representación de contenido de SCG en los códigos HTML IMG e IFRAME, cuando se selecciona una imagen SVG a veces se utilizan soluciones alternativas que implican la representación de imágenes que no son SVG. No obstante, esto es simplemente para fines de visualización de selección y así se indica en el documento html. Sin embargo, cuando se envía la propia solicitud AJAX al servicio, se envía siempre la propia imagen SVG para su conversión. En la vista de los resultados, siempre verá la propia imagen convertida, que se puede guardar si es necesario.

Requisitos previos:

Requisitos previos del producto Versión
Java Technology Edition 5.0 y posteriores
Servidor de aplicaciones
Java Platform, Enterprise Edition 5 y posteriores

WebSphere Application Server Versión 6.1.0.x y posteriores

WebSphere Application Server Community Edition Versión 2.X.

Navegador web Cualquier navegador web actual, como: Internet Explorer 7 y posteriores, Mozilla Firefox 3.x y posteriores, Google Chrome, Safari, Opera

Limitaciones

Consideraciones de seguridad

Utilización del servicio de Graphics Conversion

  1. Para utilizar el servicio de Graphics Conversion, despliegue el archivo .ear de servicio en un servidor de aplicaciones. Lea sobre la Instalación del servicio de Graphics Conversion.

  2. Cuando se haya desplegado el servicio, podrá utilizar la demostración del cliente proporcionada. La demostración está disponible en:

    http://<servidor>:<puerto>/appsvcs-graphics/
    
  3. Pruebe diferentes valores en los distintos campos de entrada para ver las imágenes convertidas.

  4. Para generar directamente conversiones de imágenes dinámicas en el navegador, también puede especificar un URL con los parámetros que indique, por ejemplo:

    http://<servidor>:<puerto>/appsvcs-graphics/rest/graphics/convert/binaryResponse?sourceUrl=<URL_archivo_gráfico>&desiredFormat=<formato_nuevo>&maxWidth=<anchura_opcional>&maxHeight=<altura_opcional>
    

Instalación del servicio de Graphics Conversion

Consulte las siguientes instruccciones de instalación específicas de la versión:

Instrucciones de instalación de WebSphere Application Server

En esta sección se describe el procedimiento para instalar el servicio de Graphics Conversion en la versión 6.1.0.X y posterior de IBM WebSphere Application Server. Se presupone que está familiarizado con la instalación y la administración de la aplicación para el servidor de aplicaciones.

Antes de empezar

Localice el archivo EAR (archivador empresarial) del servicio de Graphics Conversion que se proporciona con la instalación del producto. Puede encontrar el archivo EAR en el árbol de instalación donde ha instalado IBM WebSphere Application Server Feature Pack for Web 2.0 and Mobile. Por ejemplo, si ha instalado el paquete de características en la siguiente ubicación:

Linux y UNIX: /opt/WebSphere/AppServer
Punto de montaje en z/OS: <raíz_instalación>
Windows: c:\WebSphere\AppServer

A continuación, puede encontrar el archivo EAR en:

Linux y UNIX: /opt/WebSphere/AppServer/web2mobilefep_1.1/installableApps/application_services/graphics/appsvcs-graphics.ear
z/OS: <raíz_instalación>/web2mobilefep_1.1/installableApps/application_services/graphics/appsvcs-graphics.ear
Windows: c:\WebSphere\AppServer\web2mobilefep_1.1\installableApps\application_services\graphics\appsvcs-graphics.ear

Instalación del servicio de Graphics Conversion mediante la consola de administración

  1. Inicie la sesión en la consola de administración para el servidor de aplicaciones.
  2. vaya a Aplicaciones > Aplicación nueva. (Nota: en WebSphere Application Server Versión 6.1, seleccione Instalar aplicación nueva)
  3. Seleccione Nueva aplicación empresarial. (Nota: en WebSphere Application Server Versión 6.1, sáltese este paso)
  4. Examine el sistema de archivos y seleccione el archivo appsvcs-graphics.ear que ha localizado anteriormente. Pulse Siguiente.
  5. Pulse Siguiente para preparar la instalación de la aplicación. (Nota: en WebSphere Application Server Versión 6.1, sáltese este paso)
  6. Pulse Siguiente para aceptar las opciones de instalación predeterminadas.
  7. Pulse Siguiente para aceptar las opciones predeterminadas para correlacionar módulos con servidores.
  8. Pulse Siguiente para aceptar las opciones predeterminadas para metadatos para módulos. (Nota: en WebSphere Application Server Versiones 6.1 y 7, sáltese este paso)
  9. Pulse Siguiente para aceptar las opciones predeterminadas para correlacionar hosts virtuales para módulos web.
  10. Revise el resumen de las opciones de instalación.
  11. Pulse Finalizar.
  12. Pulse Guardar en la configuración maestra.
  13. Vaya a Aplicaciones > Tipos de aplicación > Aplicaciones empresariales WebSphere. (Nota: en WebSphere Application Server Versión 6.1, vaya a Aplicaciones > Aplicaciones empresariales)
  14. Seleccione IBM WebSphere Application Server - Servicio de Graphics Conversion y pulse Iniciar.

Instrucciones de instalación de WebSphere Application Server Community Edition Versión 2.X

En esta sección se describe el procedimiento para instalar el servicio de Graphics Conversion en la versión 2.X de IBM WebSphere Application Server Community Edition. Se presupone que está familiarizado con la instalación y la administración de la aplicación para el servidor de aplicaciones.

Antes de empezar

Localice el archivo EAR (archivador empresarial) del servicio de Graphics Conversion que se proporciona con la instalación del producto. Puede encontrar el archivo EAR en el árbol de instalación donde ha instalado IBM WebSphere Application Server Feature Pack for Web 2.0 and Mobile. Por ejemplo, si ha instalado el paquete de características en la siguiente ubicación:

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

A continuación, puede encontrar los archivos EAR y de biblioteca en:

Linux y 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

Instalación mediante la consola de administración

Inicie la sesión en la consola de administración para el servidor de aplicaciones.

  1. Pulse Aplicaciones > Aplicación de despliegue en el menú de la izquierda. (Nota: en WebSphere Application Server Community Edition Versión 2.0, pulse Aplicaciones > Desplegar nueva)
  2. En el campo Archivo, examine el sistema de archivos y seleccione el archivo appsvcs-graphics.ear que ha localizado anteriormente. Deje vacío el campo Plan y las opciones predeterminadas seleccionadas. A continuación, pulse Instalar.

La aplicación se inicia automáticamente y se completa la instalación.