Este documento es el punto de partida para obtener información sobre el servicio de Graphics Conversion. Se tratan los temas siguientes:
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 PNG TIFF GFX GIF Sí Sí[1] No Sí[1] No No JPEG Sí[1] Sí No Sí No No --- --- --- --- --- --- PNG Sí[1] Sí No Sí No No SVG No Sí Sí Sí Sí 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.
Requisitos previos del producto | Versión |
---|---|
Java Technology Edition | 5.0 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 |
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.
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/
Pruebe diferentes valores en los distintos campos de entrada para ver las imágenes convertidas.
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>
Tenga en cuenta que los archivos de trabajo y los archivos convertidos devueltos mediante referencia de URL se almacenan en una ubicación de directorio temporal que especifica el parámetro de configuración resultsTmpDir declarado en un parámetro de inicialización del archivo web.xml. El siguiente fragmento del archivo web.xml muestra su uso:
... <init-param> <!-- Defina la propiedad siguiente en la vía de acceso completa donde desee que se guarden las imágenes que se acaban de escalar y convertir. --> <!-- Por ejemplo, en Linux/Unix: /tmp --> <!-- Por ejemplo, en Windows: c:\temp --> <!-- Cuando no se especifica ningún valor, el valor predeterminado es el atributo ServletContext "javax.servlet.context.tempdir" definido por el contenedor web. --> <!-- Cuando se especifica la serie especial java.io.tmpdir, el servicio utiliza la propiedad del sistema Java con la clave "java.io.tmpdir" --> <param-name>com.ibm.ws.mobile.appsvcs.graphics.resultsTmpDir</param-name> <param-value>java.io.tmpdir</param-value> </init-param> ...
Consulte las siguientes instruccciones de instalación específicas de la versión:
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.
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
- Inicie la sesión en la consola de administración para el servidor de aplicaciones.
- vaya a Aplicaciones > Aplicación nueva. (Nota: en WebSphere Application Server Versión 6.1, seleccione Instalar aplicación nueva)
- Seleccione Nueva aplicación empresarial. (Nota: en WebSphere Application Server Versión 6.1, sáltese este paso)
- Examine el sistema de archivos y seleccione el archivo appsvcs-graphics.ear que ha localizado anteriormente. Pulse Siguiente.
- Pulse Siguiente para preparar la instalación de la aplicación. (Nota: en WebSphere Application Server Versión 6.1, sáltese este paso)
- Pulse Siguiente para aceptar las opciones de instalación predeterminadas.
- Pulse Siguiente para aceptar las opciones predeterminadas para correlacionar módulos con servidores.
- 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)
- Pulse Siguiente para aceptar las opciones predeterminadas para correlacionar hosts virtuales para módulos web.
- Revise el resumen de las opciones de instalación.
- Pulse Finalizar.
- Pulse Guardar en la configuración maestra.
- Vaya a Aplicaciones > Tipos de aplicación > Aplicaciones empresariales WebSphere. (Nota: en WebSphere Application Server Versión 6.1, vaya a Aplicaciones > Aplicaciones empresariales)
- Seleccione IBM WebSphere Application Server - Servicio de Graphics Conversion y pulse Iniciar.
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.
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
Inicie la sesión en la consola de administración para el servidor de aplicaciones.
- 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)
- 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.