Este documento é o ponto de início para o aprendizado do serviço de Conversão de Gráficos. Os seguintes tópicos serão cobertos:
O serviço de Conversão de Gráficos fornece um recurso JAX-RS do lado do servidor que suporta o escalonamento e as conversões de e para diversos formatos gráficos. Consulte o gráfico de conversões para obter detalhes.
De/Para GIF JPEG PNG TIFF GFX GIF Sim Sim [1] Não Sim [1] Não Não JPEG Sim [1] Sim Não Sim Não Não --- --- --- --- --- --- PNG Sim [1] Sim Não Sim Não Não SVG Não Sim Sim Sim Sim Sim[2] TIFF --- --- --- --- --- --- [1] Suportado somente com o Java SDK Versão 6.0 ou superior.
[2] Atualmente há limitações no escopo da função SVG para GFX. Consulte a seção Limitações.
Um aplicativo cliente de amostra, fornecido por meio do Amostra do Mobile Showcase no WebSphere Application Server, ilustra uma chamada Ajax simples do serviço de Conversão de Gráficos. O cliente permite que os usuários especifiquem uma URL para o arquivo gráfico que precisa de conversão, o formato da imagem no qual converter a imagem existente e a largura e altura máximas opcionais da imagem gerada (se for solicitado o escalonamento). O serviço retorna uma URL para o arquivo convertido, ou a imagem binária, para ser usada no formato mais conveniente para o aplicativo cliente. Visto que as opções são parâmetros de consulta de URL, os usuários também podem construir a URL com os parâmetros necesários e o navegador exibirá a imagem convertida.
Pré-requisito do produto | Version |
---|---|
Java Technology Edition | 5.0 e posterior |
|
WebSphere Application Server Versão 6.1.0.x e posterior WebSphere Application Server Community Edition Versão 2.X. |
Navegador da Web | Qualquer navegador atualizado da Web, como: Internet Explorer 7 e posterior, Mozilla Firefox 3.x e posterior, Google Chrome Safari Opera |
Para usar o serviço de Conversão de Gráficos, implemente o arquivo .ear de serviço em um servidor de aplicativos. Leia sobre isso em Instalando o serviço de Conversão de Gráficos.
Depois de implementar o serviço, será possível usar o demo do cliente fornecido. O demo está disponível em:
http://<server>:<port>/appsvcs-graphics/
Tente valores diferentes nos diversos campos de entrada para ver as imagens convertidas.
Para gerar diretamente as conversões de imagem dinâmica no navegador, também é possível inserir uma URL com os parâmetros especificados, como por exemplo:
http://<server>:<port>/appsvcs-graphics/rest/graphics/convert/binaryResponse?sourceUrl=<graphic_file_url>&desiredFormat=<new_format>&maxWidth=<optional_width>&maxHeight=<optional_height>
Observe que os arquivos de trabalho e os arquivos convertidos, retornados por meio da referência de URL, são armazenados em um local de diretório temporário especificado pelo parâmetro de configuração resultsTmpDir declarado em um parâmetro de inicialização do arquivo web.xml. A seguinte parte do arquivo web.xml demonstra seu uso:
... <init-param> <!-- Set the following property to the full path where you want newly scaled and converted images to be saved. --> <!-- For example, on Linux/Unix: /tmp --> <!-- For example, on Windows: c:\temp --> <!-- When no value is specified, the default is the "javax.servlet.context.tempdir" ServletContext attribute set by the web container. --> <!-- When the special string java.io.tmpdir is specified, the service uses the Java system property with key "java.io.tmpdir" --> <param-name>com.ibm.ws.mobile.appsvcs.graphics.resultsTmpDir</param-name> <param-value>java.io.tmpdir</param-value> </init-param> ...
Consulte as seguintes instruções de instalação específica da versão:
Esta seção descreve o procedimento para instalar o serviço de Conversão de Gráficos na Versão 6.1.0.X e posterior do IBM WebSphere Application Server. Presume-se que esteja familiarizado com a instalação e administração do aplicativo do servidor de aplicativos.
Localize o arquivo archive corporativo (EAR) do serviço de Conversão de Gráficos fornecido com a instalação do produto. É possível localizar o arquivo EAR na árvore de instalação na qual o IBM WebSphere Application Server Feature Pack for Web 2.0 and Mobile foi instalado. Por exemplo, se instalou o feature pack no seguinte local:
Linux e UNIX: /opt/WebSphere/AppServer Ponto de montagem do z/OS: <install_root> Windows: c:\WebSphere\AppServer
Em seguida, será possível localizar o arquivo EAR em:
Linux e 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
- Efetue login no console administrativo do servidor de aplicativos.
- Navegue até Aplicativos > Novo Aplicativo. (Nota: No WebSphere Application Server Versão 6.1, selecione Instalar Novo Aplicativo)
- Selecione Novo Aplicativo Corporativo. (Nota: No WebSphere Application Server Versão 6.1, ignore esta etapa)
- Navegue no sistema de arquivos e selecione o arquivo appsvcs-graphics.ear localizado anteriormente. Clique em Avançar.
- Clique em Avançar para se preparar para a instalação do aplicativo. (Nota: No WebSphere Application Server Versão 6.1, ignore esta etapa)
- Clique em Avançar para aceitar as opções de instalação padrão.
- Clique em Avançar para aceitar as opções padrão para módulos de mapa para servidores.
- Clique em Avançar para aceitar as opções padrão para Metadados para módulos. (Nota: No WebSphere Application Server Versões 6.1 e 7, ignore esta etapa)
- Clique em Avançar para aceitar as opções padrão para hosts virtuais de mapa para módulos da Web.
- Revise o resumo das opções de instalação.
- Clique em Concluir.
- Clique em Salvar na configuração principal.
- Navegue até Aplicativos > Tipos de Aplicativos > Aplicativos Corporativos do WebSphere. (Nota: No WebSphere Application Server Versão 6.1, navegue até Aplicativos > Aplicativos Corporativos)
- Selecione o IBM WebSphere Application Server - serviço de Conversão de Gráficos e clique em Iniciar.
Esta seção descreve o procedimento para instalar o serviço de Conversão de Gráficos na Versão 2.X do IBM WebSphere Application Server Community Edition. Presume-se que esteja familiarizado com a instalação e administração do aplicativo do servidor de aplicativos.
Localize o arquivo archive corporativo (EAR) do serviço de Conversão de Gráficos fornecido com a instalação do produto. É possível localizar o arquivo EAR na árvore de instalação na qual o IBM WebSphere Application Server Feature Pack for Web 2.0 and Mobile foi instalado. Por exemplo, se instalou o feature pack no seguinte local:
Linux e UNIX: /opt/WebSphere/AppServerCommunityEdition Windows: c:\WebSphere\AppServerCommunityEdition
Em seguida, será possível localizar o arquivo EAR e os arquivos de biblioteca em:
Linux e 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
Efetue login no console administrativo do servidor de aplicativos.
- Clique em Aplicativos > Implementador no menu da esquerda. (Nota: No WebSphere Application Server Community Edition Versão 2.0, clique em Aplicativos> Implementar Novo)
- No campo Archive, navegue no sistema de arquivos e selecione o arquivo appsvcs-graphics.ear localizado anteriormente. Mantenha o campo Plano vazio e as opções padrão selecionadas. Em seguida, clique em Instalar.
O aplicativo será iniciado automaticamente e a instalação concluída.