Desenvolvendo e Implementando Aplicativos da Web do HATS

Existem cinco tipos de aplicativos do HATS; Web, portlet, EJB, rich client e console administrativo. Este capítulo inclui informações sobre aplicativos da Web do HATS. Para obter informações sobre os outros tipos de aplicativos, consulte os seguintes capítulos:

Além disso, um aplicativo da Web do HATS pode ser vinculado a um aplicativo WebFacing e os dois empacotados juntos podem interoperar entre si em um aplicativo corporativo único. Para obter informações adicionais, consulte WebFacing e HATS.

Os aplicativos do HATS são criados a partir de projetos do HATS utilizando o HATS Toolkit. Quando você cria um novo projeto do HATS, um conjunto de pastas é criado para ajudar a organizar os arquivos de aplicativo do HATS. Um exemplo de um projeto padrão é mostrado abaixo. A pasta de nível mais alto tem o mesmo nome fornecido ao seu projeto ao criá-lo. Nessa pasta estão as outras pastas de alto nível que contêm objetos definidos em seu projeto do HATS. Algumas pastas não aparecem até que você crie determinados objetos.

Figura 2. Visualização do Projeto da Web do HATS
Visualização do Projeto da Web do HATS

Dependendo de como você configura seu projeto do HATS, algumas ou todas estas pastas aparecerão na visualização Projetos Projetos do HATS. Você também pode especificar quais pastas aparecem na visualização Projetos do HATS, bem como ocultar as extensões dos arquivos. Para obter informações adicionais, consulte Utilizando Preferências do HATS.

Nota:
Diferentes pastas aparecem para diferentes tipos de projetos do HATS. Por exemplo, a árvore de diretórios para um projeto EJB do HATS não possui nenhuma pasta Customizações da Tela, Capturas de Tela ou Conteúdo da Web.

Você pode criar subpastas dentro dessas pastas de nível superior para ajudar a organizar seu projeto. Por exemplo, assim que você cria capturas de tela para seu projeto, você pode desejar criar pastas na pasta Capturas de Tela para organizar e agrupar as telas capturadas. Para criar uma pasta, clique com o botão direito do mouse nas pastas de nível superior na árvore e clique em Novo HATS > Pasta. Para mover um arquivo para uma pasta diferente, clique com o botão direito do mouse no arquivo e selecione Mover, ou você pode utilizar o método arrastar e soltar.

Nota:
Existe uma limitação para as subpastas. A transformação e os arquivos de modelo devem estar em subpastas do mesmo nível. Para utilizar uma transformação que resida em um determinado nível de subpastas, como \transformations\Callup\, o modelo que será acoplado com essa transformação deverá estar no mesmo nível das subpastas, como \templates\Callup\.

Os projetos do HATS podem ser compartilhados em um ambiente de equipe indo para a Visualização Navegador da perspectiva do HATS. Clique com o botão direito do mouse no projeto e selecione Equipe > Compartilhar Projeto. Selecione o tipo de repositório na lista e clique em Avançar. O Rational SDP suporta vários repositórios. Para obter informações adicionais, consulte a documentação do Rational SDP e procure no repositório.

Os projetos da Web do HATS, criados no HATS Toolkit, são extensões dos projetos da Web no ambiente de trabalho do Rational SDP. Para obter informações adicionais, clique em Ajuda > Conteúdo da Ajuda na barra de menus do Rational SDP, expanda Desenvolvimento e selecione Desenvolvendo Aplicativos da Web.

Organizando Aplicativos da Web do HATS

Por padrão, todos os aplicativos da Web do HATS são armazenados em um arquivo Enterprise Archive, como HATS_EAR7. Quando você exporta seus aplicativos e os implementa no WebSphere Application Server, o arquivo .ear do HATS contém um arquivo Web archive (.war) com os recursos para executar cada aplicativo, além de uma cópia do código executável de tempo de execução do HATS. Se preferir, você pode organizar seus aplicativos de maneira diferente, cada um em seu próprio arquivo .ear, ou em alguma outra combinação.

Considere o efeito do seguinte em seu servidor ao decidir como organizar seus aplicativos da Web:

Espaço em Disco
Se você criar cada aplicativo em seu próprio arquivo .ear, ele terá sua própria cópia do código de tempo de execução do HATS. O código de tempo de execução é de aproximadamente 25 MB. Multiplique esse valor pelo número de aplicativos para ver a quantidade de espaço em disco consumida em seu sistema de tempo de execução para todos os seus aplicativos.
Implementação
Se você reimplementar um arquivo .ear do HATS, estará reimplementando todos os aplicativos contidos naquele arquivo .ear, mesmo se alguns dos aplicativos estiverem inalterados.
Registro e Rastreio

O registro e rastreio são controlados no nível do arquivo .ear, não no nível do aplicativo HATS individual. Se cada aplicativo do HATS estiver em seu próprio arquivo .ear, você poderá controlar suas configurações de log e rastreio independentemente de quaisquer outros aplicativos. Se você tiver vários aplicativos do HATS em um arquivo .ear, as configurações de log e rastreio se aplicarão a todos os aplicativos do HATS no arquivo .ear. As mensagens para todos os aplicativos do HATS no arquivo .ear são inseridas no mesmo arquivo de log e as informações de rastreio para todos os aplicativos do HATS são inseridas no mesmo arquivo de rastreio.

É possível incluir uma palavra-chave opcional adicional, traceLogDirectory, no arquivo runtime.properties. Isto permite especificar um diretório específico para os arquivos de saída. O arquivo é localizado no diretório was_dir/installedApps/ear_name para um aplicativo corporativo HATS.

Rastreamento de Licença
O rastreamento de licença também é controlado no nível do arquivo .ear, não no nível do aplicativo HATS individual. Se cada aplicativo HATS estiver em seu próprio arquivo .ear, o rastreamento de licença será feito, independentemente dos outros aplicativos. Se você tiver vários aplicativos HATS em um arquivo .ear, o rastreamento de licença será executado para todos os aplicativos HATS no arquivo .ear. As informações sobre o uso da licença são mantidas para todos os aplicativos HATS no arquivo .ear e são inseridas no mesmo arquivo de uso de licença.

Movendo Projetos da Web do HATS para um Arquivo .ear Diferente

Em qual arquivo .ear seus arquivos de projeto são inseridos é determinado quando você cria o projeto. Depois que criar o projeto, você pode movê-lo de um .ear para outro, utilizando as seguintes etapas:

Para incluir o projeto em um arquivo .ear:

  1. Clique na guia Navegador do HATS Toolkit para exibir os arquivos .ear.
  2. Expanda o arquivo .ear no qual deseja incluir o projeto. Expanda a pasta META-INF e localize o arquivo application.xml.
  3. Inicie o editor do application.xml do Rational SDP dando um clique duplo no arquivo application.xml.
  4. Na visualização Design do editor application.xml, no grupo Visão Geral, selecione Aplicativo e clique em Incluir.
  5. No diálogo Incluir Item, selecione Módulo e clique em OK.
  6. Selecione o projeto que deseja incluir no arquivo .ear e clique em Concluir.
  7. Feche o editor application.xml do Rational SDP.

Para remover o projeto de um arquivo .ear:

  1. Clique na guia Navegador do HATS Toolkit para exibir os arquivos .ear.
  2. Expanda o arquivo .ear do qual deseja remover o projeto. Expanda a pasta META-INF e localize o arquivo application.xml.
  3. Inicie o editor do application.xml do Rational SDP dando um clique duplo no arquivo application.xml.
  4. Na visualização Design do editor application.xml, no grupo Visão Geral, selecione o projeto que deseja remover do arquivo .ear e clique em Remover.
  5. Feche o editor application.xml do Rational SDP.

Fazendo Backup de Projetos do HATS

Assim como com qualquer atividade de desenvolvimento de software, é uma prática recomendada fazer backup dos projetos do HATS para se proteger contra perda de dados ou distorção. Além de criar backups durante seu próprio ciclo de desenvolvimento, você também deve criar backups antes de instalar a manutenção do HATS. Isto permite reverter para o nível de manutenção anteriormente instalado, se necessário. Para criar um backup para o projeto do HATS, utilize a função export project interchange do Rational SDP. Para obter mais informações, consulte Exportando um Projeto da Web.

Para restaurar um projeto do HATS a partir de um backup, use a função Importar Intercâmbio de Projetos. Para obter informações adicionais, consulte Importando um Projeto da Web.

Exportando e Importando Projetos da Web do HATS

Exportando um Projeto da Web

Você pode exportar seus projetos da Web do HATS para salvar e utilizar como backups ou para mover para outro sistema do HATS Toolkit. Para executar a exportação, utilize o seguinte método:

Arquivo Project Interchange

Esta função possui vários benefícios. Ela permite exportar vários projetos e o .ear associado de uma só vez. Além disso, não é necessário criar um projeto no HATS Toolkit de destino antes de importar o arquivo project interchange. Para exportar o projeto como um arquivo project interchange, execute as seguintes etapas:

  1. Na barra de menus, selecione Arquivo > Exportar para abrir o assistente de Exportação.
  2. Selecione Outro > Project Interchange e clique em Avançar.
  3. Selecione o projeto e seu projeto EAR associado.
  4. Especifique um nome de arquivo .zip e o local para o arquivo .zip no qual você deseja salvar o projeto.
  5. Clique em Concluir.

Importando um Projeto da Web

Para importar um projeto em um arquivo project interchange para o HATS Toolkit:

  1. Na barra de menus, clique em Arquivo > Importar para abrir o assistente de Importação.
  2. Selecione Outro > Project Interchange e clique em Avançar.
  3. Especifique o arquivo .zip que deseja importar no campo A partir do arquivo zip.
  4. Especifique a área de trabalho para a qual você deseja importar o arquivo no campo Raiz de local do projeto.
  5. Selecione os projetos no arquivo do Project Interchange que deseja importar para a área de trabalho especificada.
  6. Clique em Concluir.

Para obter informações sobre como migrar um projeto do HATS de um release anterior do HATS, consulte Migração do HATS.

Implementando Aplicativos HATS da Web

Os termos aplicativo da Web do HATS, aplicativo WebSphere e aplicativo Java™ EE podem ser utilizados alternadamente para fazer referência a um aplicativo da Web criado a partir de um projeto do HATS. É um aplicativo HATS da Web porque foi desenvolvido no HATS Toolkit. É um aplicativo WebSphere porque será instalado e executado no WebSphere Application Server. É um aplicativo Java EE porque está em conformidade com os padrões Java EE.

Para implementar seu aplicativo HATS da Web em um ambiente de tempo de execução, você deve:

As seguintes seções descrevem como desempenhar cada uma destas tarefas.

Ativando o Tempo de Execução do HATS

Independente de onde tenha obtido o pacote do HATS (CD do HATS, Web, ou empacotado com outro produto), você instala a mesma versão do HATS Toolkit. Essa é uma versão de uso limitado que você pode utilizar para avaliar o HATS. Para ativar completamente os tempos de execução para produção de acordo com sua prova de titularidade licenciada, você deve especificar suas configurações de licença utilizando o assistente Configurações de Licença incluído no HATS Toolkit. Para obter mais informações, consulte as seções Evaluating HATS e Enabling HATS runtime and license settings, na publicação Introdução do HATS.

Exportando seu Projeto como um Aplicativo Java EE

Para implementar seu aplicativo da Web do HATS para um ambiente de tempo de execução do WebSphere Application Server, primeiro, é necessário empacotá-lo em um aplicativo Java EE. Para fazer isso, exporte seu projeto como um arquivo EAR.

Para exportar o projeto, siga estas etapas:

  1. Destaque (com um único clique) o nome do projeto na visualização Projetos HATS.
  2. Clique no ícone Exportar Projeto do HATS na barra de ferramentas principal ou clique com o botão direito do mouse no nome do projeto e selecione Exportar Projeto.
  3. Na janela Exportar, escolha um projeto Enterprise Application na lista suspensa ou digite o nome de um projeto Enterprise Application no campoProjeto EAR.
  4. Digite um local de destino no campo Destino ou clique no botão Procurar para selecionar o destino do arquivo .ear exportado.
  5. Se quiser exportar os arquivos de origem do projeto juntamente com os arquivos executáveis, selecione a caixa Exportar arquivos de origem. Se você incluir os arquivos de origem, outro desenvolvedor pode extraí-los de seu arquivo .ear. Isso pode fazer a colaboração ou o serviço mais fáceis, mas você deve decidir se isso cria um risco de segurança.
  6. Se você tiver exportado este projeto a esta localização antes, o processo de exportação pergunta se você deseja sobrescrever os arquivos existentes. Isso visa protegê-lo de sobrescrever arquivos que você pode desejar manter, talvez arquivar uma versão anterior de seu projeto. Se quiser sobrescrever arquivos anteriores sem que seja pedida uma confirmação, selecione a caixa Sobrescrever arquivo existente.
  7. Clique em Concluir. O projeto será exportado como um aplicativo JavaEE, representado por um arquivo Enterprise Archive com a extensão .ear, com o diretório e o nome de arquivo que você especificou.

Instalando Seu Aplicativo em um Ambiente de Tempo de Execução

Depois de exportar o projeto do HATS como um aplicativo Java EE e transferir o arquivo .ear do aplicativo para o sistema de produção, instale-o ativando o Console Administrativo WebSphere e procure o local do arquivo .ear. Para obter informações adicionais sobre a instalação de aplicativos no WebSphere Application Server, consulte a biblioteca do WebSphere Application Server em http://www.ibm.com/software/webservers/appserv/was/library/ e selecione o link para o centro de informações para a sua versão do WebSphere Application Server. No conteúdo do produto WebSphere Application Server, consulte o capítulo sobre a implementação de aplicativos.

Após o aplicativo ter sido instalado, teste-o tornando a URL visível em um navegador da Web em outro sistema. Então, você poderá divulgar o URL a seus usuários. Por exemplo, a URL pode ser semelhante a http://hostname/hatsappname/ em que hostname é o nome do host IP e o domínio em que o WebSphere Application Server está instalado e hatsappname é o nome de seu aplicativo do HATS.

Notas:
  1. Para obter informações adicionais sobre a instalação de aplicativos do HATS em plataformas específicas, consulte o Centro de Informações do HATS em http://publib.boulder.ibm.com/infocenter/hatshelp/v75/index.jsp.
  2. Se os aplicativos do HATS forem implementados no WebSphere Application Server com a segurança Java 2 ativada, e não forem iniciados, consulte Segurança Java 2 para obter informações adicionais.
  3. O HATS suporta várias instâncias de navegador da mesma estação de trabalho acessando o mesmo aplicativo do HATS. No entanto, essas múltiplas instâncias do navegador não devem compartilhar o mesmo ID de sessão HTTP.

    A sessão entre o navegador acessando o aplicativo HATS e o WebSphere Application Server foi designada com um ID de sessão HTTP. O ID de sessão HTTP possibilita que pedidos subsequentes do mesmo navegador retornem para o mesmo aplicativo HATS. Pedidos subsequentes utilizam a mesma sessão Telnet (3270 ou 5250) que existe entre o aplicativo HATS no servidor e o host.

    Diferentes navegador implementam o ID de sessão HTTP de maneira diferente. O Microsoft® Internet Explorer espera que todas as sessões do navegador no mesmo processo compartilhem o mesmo ID de sessão HTTP. Quando você ativa um nova janela do navegador utilizando o mesmo atalho, uma nova sessão do navegador utilizando o mesmo atalho, uma nova sessão do navegador é iniciada e compartilha o mesmo processo e o ID de sessão HTTP.

    Uma maneira de abrir um novo processo do Internet Explorer com um ID de sessão HTTP exclusivo, no Windows® XP por exemplo, se o Internet Explorer estiver em sua lista inicial, é selecionar Iniciar > Internet Explorer. Selecionar Iniciar > Todos os Programas > Internet Explorer também inicia um novo processo do Internet Explorer com um ID de sessão HTTP exclusivo.

    Notas:
    1. A função Ctrl-N do Internet Explorer não inicia um novo processo, porque ela abre uma nova janela que possui o mesmo ID de processo e o mesmo ID de sessão HTTP que o da janela da qual foi originada.
    2. Para o Internet Explorer 8, é possível utilizar Arquivo > Nova Sessão para abrir um novo navegador com um ID de sessão exclusivo.
    Nota:

    No Internet Explorer, é possível localizar o ID de sessão HTTP para uma janela do navegador selecionando Visualizar > Origem na barra de menus ou clicando com o botão direito do mouse na janela do navegador Internet Explorer e selecionando Visualizar Origem para visualizar a atribuição de tag de origem para a página. Role para baixo até a tag Form do HATS na janela de origem, que é semelhante ao seguinte:

    <FORM NAME="HATSform" dir="" METHOD="POST"
    ACTION="/YourHATSAppName/entry">.

    Dentro desta tag Form, localize o parâmetro SESSIONID, que é semelhante ao seguinte:

    <INPUT TYPE="HIDDEN" NAME="SESSIONID"
    VALUE="PIOncS1GehNWxWo_49VCBzC" />
    Nota:
    Quando você acessa um aplicativo HATS que exibe apenas uma transformação padrão da tela e não executa macros quando é iniciado, o SESSIONID possui um valor de "INVALID." O valor SESSIONID é designado quando você envia algo para o host, tal como quando pressiona a tecla Enter, e obtém uma resposta.

    É possível verificar se um novo processo está sendo iniciando utilizando o Gerenciador de Tarefas no Windows. Inicie o Gerenciador de Tarefas e clique no título da coluna 'Nome da imagem' na guia Processos para classificar as informações por nome de imagem. Role para baixo até visualizar quantos processos 'iexplore.exe' estão na lista. Tente iniciar algumas novas janelas do Internet Explorer utilizando o atalho Iniciar > Internet Explorer. Se um novo processo for iniciado, um novo processo iexplore.exe será incluído na exibição. Caso contrário, um processo existente está no controle da nova janela do navegador.

  4. O HATS exige o nome de exibição do aplicativo, como definido no arquivo web.xml do aplicativo, para corresponder ao caminho do contexto do aplicativo da Web utilizado na URL do navegador. Se o valor do nome de exibição for alterado para ser diferente do caminho do contexto do aplicativo, você pode encontrar um erro java.lang.nullPointerException ou um erro javax.servlet.ServletException ao executar o aplicativo HATS. Por exemplo, um projeto do HATS denominado MyHatsProject tem um nome de exibição padrão MyHatsProject. Este projeto, quando implementado com um aplicativo da Web, deve ser acessado com uma URL semelhante à http://myServer/MyHatsProject/ para operar adequadamente. A alteração do nome de exibição para algum outro diferente de MyHatsProject faz com que o aplicativo fique inoperável.

Alterações Necessárias no Ambiente de Tempo de Execução

Configurando a Política do Carregador do Classe

Ao implementar seus aplicativos da Web do HATS ou executar os aplicativos no ambiente de teste local, a política do carregador de classes WAR deve ser configurada por aplicativo Java EE em qualquer uma das seguintes situações:

O HATS configura automaticamente a política do carregador de classes para esses aplicativos.

Configurando os Aplicativos do HATS em um Ambiente de Cluster

Se você implementar aplicativos da Web do HATS em um ambiente de cluster vertical, cada instância do servidor de aplicativos criará seus próprios arquivos para criação de log, rastreio e rastreamento de licenças. Isso é conseguido decorando-se os nomes dos arquivos de saíra com o nome completo da instância do servidor de aplicativos. Por exemplo, o modelo padrão para o arquivo de log é messages.txt, mas o nome do arquivo real será algo semelhante a messages_myCell_myNode_myAppServerInstance_1.txt.

Por padrão, todas as instâncias do servidor lêem o mesmo arquivo runtime.properties para suas definições. Para controlar corretamente as definições de tempo de execução, você deve configurar cada instância para que ela tenha seu próprio arquivo de propriedades de tempo de execução. Isto permite controlar o rastreio para cada instância de forma independente e evita a alteração espontânea de configurações de tempo de execução.

Siga estas etapas para configurar cada uma das instâncias do aplicativo do HATS em cluster verticalmente para que tenham seu próprio arquivo runtime.properties:

  1. Faça uma cópia do arquivo runtime.properties para cada instância do servidor de aplicativos no cluster vertical.
    1. Localize o arquivo runtime.properties do seu aplicativo HATS. Esse arquivo deveria estar no diretório installedApps\app_name.ear sob o diretório no qual você instalou o WebSphere Application Server.
    2. Para cada instância, faça uma cópia do arquivo runtime.properties, com um nome exclusivo, no mesmo diretório. Por exemplo, você poderia nomear os arquivos Clone1runtime.properties, Clone2runtime.properties e assim por diante. Você pode utilizar qualquer nome de arquivo válido, mas o nome deve ajudar o administrador a identificar a instância do servidor de aplicativo com o qual este arquivo está associado.
    3. Neste ponto, para instâncias do servidor n, você possui n arquivos de propriedades de tempo de execução exclusivos.
    4. Se você tiver mais de um arquivo .ear do HATS em seu ambiente de cluster vertical, repita essa etapa em cada diretório do arquivo .ear.
  2. Inclua uma nova definição de configuração para identificar o arquivo runtime.properties utilizado por cada instância. Por exemplo, para o WebSphere Application Server V6.x:
    1. Selecione Servidores de Aplicativos no item Servidores na área de janela de navegação à esquerda do console administrativo do WebSphere Application Server.
    2. Selecione a instância do servidor na lista de servidores de aplicativos.
    3. Selecione Gerenciamento de Java e Processos na guia Configuração do servidor.
    4. Selecione Definição de Processo > Java Virtual Machine > Propriedades Customizadas.
    5. Na janela Propriedades Customizadas, clique em Novo.
    6. No campo Nome, digite hats.runtime.properties.
    7. No campo Valor, digite o nome do arquivo de propriedades criado para este servidor, por exemplo, Clone2runtime.properties. Não especifique os nomes de diretórios nem as barras neste valor.
    8. O campo Descrição não exige um valor.
    9. Clique em Aplicar.
    10. Repita este procedimento para cada instância do servidor.

Depois de incluir a nova propriedade customizada e assegurar que cada instância do servidor tenha sua própria cópia do arquivo runtime.properties com nome exclusivo, será necessário reiniciar cada aplicativo para começar a utilizar os novos arquivos.

O HATS console administrativo pode ser utilizado para controlar as configurações dos membros de cluster. Utilize a pasta Introdução no painel Navegação da página da Web Administração para selecionar o Escopo de Gerenciamento. Depois que escolher o cluster, a escolha da visualização de Configurações de Rastreio perguntará qual membro de cluster específico você deseja controlar.

Nota:
Existem considerações especiais para a utilização de armazenamento em cluster e de listas de usuários. Para obter informações adicionais, consulte Armazenamento em Cluster e Listas de Usuários

Desenvolvendo Aplicativos do HATS para Dispositivos Remotos

É possível desenvolver aplicativos da Web do HATS que podem ser acessados por dispositivos remotos como telefones celulares, terminais de coleta de dados e PDAs (personal digital assistants). O processo é o mesmo para desenvolver qualquer aplicativo da Web do HATS com algumas considerações em virtude das capacidades do dispositivo remoto e seu navegador da Web, por exemplo, tamanho da tela e limitações de interação.

Para criar um projeto para seu aplicativo para dispositivos remotos, ative o assistente para Criar um Projeto utilizando uma das seguintes ações:

No assistente Criar um Projeto, no painel do HATS Project:

  1. Insira um nome para o projeto do dispositivo remoto.
  2. Opcionalmente, insira uma descrição.
  3. Aceite o local padrão.
  4. Selecione Web para indicar um projeto da Web.
    Nota:
    Se a opção de implementação da Web estiver desativada, isso indica que não há tempos de execução do servidor definidos. Para definir os tempos de execução do servidor, vá para Janela > Preferências > Servidor > Tempos de Execução Instalados e inclua pelo menos uma definição de tempo de execução.
  5. Para o campo Servidor de Destino, selecione um dos WebSphere Application Servers suportados.
  6. Para o campo Projeto do Aplicativo Corporativo, insira o nome do projeto EAR a ser usado para teste no ambiente de testes local.
  7. Selecione Otimizar Opções de Dispositivos Remotos.
  8. Clique em Avançar e continue a criar seu projeto normalmente.

Considerações e Limitações de Dispositivos Remotos

Ao criar um projeto do HATS e selecionar Otimizar Opções para Dispositivos Remotos, o HATS inicializa o projeto com as opções que funcionam melhor para dispositivos remotos. Algumas opções, por exemplo, impressão, teclado, atualização assíncrona e outras opções, não são suportadas e, portanto, estão desativadas. Tenha em mente as considerações e limitações a seguir ao desenvolver seu aplicativo para dispositivos remotos.

Além das opções que o HATS desativa automaticamente, as seguintes funções não são suportadas e não devem ser implementadas nos aplicativos do HATS para dispositivos remotos: