Introdução ao serviço de Conversão de Gráficos

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:

Visão Geral

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 PDF 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
PDF --- --- --- --- --- ---
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.

Nota:
  • O aplicativo de amostra de Conversão de Gráficos serve somente para ilustrar um uso possível do serviço de Conversão Gráfica e ilustrar como as chamadas do AJAX podem ser usadas para fazer a solicitação REST.
  • Devido às limitações existentes em determinados navegadores em relação à renderização do conteúdo SVG nas tags html img e iframe, são usadas, ocasionalmente, soluções alternativas que envolvem a renderização de uma imagem não SVG quando a imagem SVG é selecionada. Entretanto, isso é simplesmente para fim de exibição de seleção e é, assim, observado no documento html. Entretanto, quando a solicitação real do AJAX é enviada ao serviço, a imagem SVG real é sempre enviada para conversão. Na visualização do resultado, você sempre verá a imagem convertida real, que poderá ser salva, se necessário.

Pré-requisitos:

Pré-requisito do produto Version
Java Technology Edition 5.0 e posterior
Java Platform, Enterprise Edition 5
application server 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

Limitações

Considerações sobre Segurança

Usando o serviço de Conversão de Gráficos

  1. 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.

  2. 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/
    
  3. Tente valores diferentes nos diversos campos de entrada para ver as imagens convertidas.

  4. 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>
    

Instalando o serviço de Conversão de Gráficos

Consulte as seguintes instruções de instalação específica da versão:

Instruções de instalação do WebSphere Application

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.

Antes de começar

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

Instalando o serviço de Conversão de Gráficos usando o console administrativo

  1. Efetue login no console administrativo do servidor de aplicativos.
  2. Navegue até Aplicativos > Novo Aplicativo. (Nota: No WebSphere Application Server Versão 6.1, selecione Instalar Novo Aplicativo)
  3. Selecione Novo Aplicativo Corporativo. (Nota: No WebSphere Application Server Versão 6.1, ignore esta etapa)
  4. Navegue no sistema de arquivos e selecione o arquivo appsvcs-graphics.ear localizado anteriormente. Clique em Avançar.
  5. 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)
  6. Clique em Avançar para aceitar as opções de instalação padrão.
  7. Clique em Avançar para aceitar as opções padrão para módulos de mapa para servidores.
  8. 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)
  9. Clique em Avançar para aceitar as opções padrão para hosts virtuais de mapa para módulos da Web.
  10. Revise o resumo das opções de instalação.
  11. Clique em Concluir.
  12. Clique em Salvar na configuração principal.
  13. Navegue até Aplicativos > Tipos de Aplicativos > Aplicativos Corporativos do WebSphere. (Nota: No WebSphere Application Server Versão 6.1, navegue até Aplicativos > Aplicativos Corporativos)
  14. Selecione o IBM WebSphere Application Server - serviço de Conversão de Gráficos e clique em Iniciar.

Instruções de instalação do WebSphere Application Server Community Edition Versão 2.X

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.

Antes de começar

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

Instalação por meio do console administrativo

Efetue login no console administrativo do servidor de aplicativos.

  1. Clique em Aplicativos > Implementador no menu da esquerda. (Nota: No WebSphere Application Server Community Edition Versão 2.0, clique em Aplicativos> Implementar Novo)
  2. 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.