Convertendo um Projeto Java Existente para um Projeto de Plug-in

Se você tiver um projeto Java existente, será possível convertê-lo para um projeto de plug-in OSGi. O pacote configurável OSGi pode ser executado em um ambiente de JVM compartilhado e em um servidor JVM.

Sobre Esta Tarefa

Esta tarefa supõe que você tenha um projeto Java existente em sua área de trabalho e deseje convertê-la para um projeto de plug-in OSGi.

Procedimento

  1. Na visualização do Package Explorer, clique com o botão direito do mouse no projeto Java que você deseja converter para um projeto de plug-in e clique em Configurar > Converter para Projetos de Plug-in O diálogo Converter Projetos Existentes é exibido.
    Uma captura de tela do diálogo Converter Projetos Existentes mostrando quatro projetos Java disponíveis para conversão, porém somente um está selecionado atualmente.
    O diálogo contém uma lista de todos os projetos Java em sua área de trabalho. O que você escolheu para converter está selecionado. É possível alterar sua seleção ou selecionar mais de um projeto Java para converter para um projeto de plug-in.
  2. Clique em Concluir. Ao clicar em Concluir, o projeto ou projetos Java são convertidos para projetos de plug-in. O nome do projeto não muda, mas , os projetos agora incluem um arquivo de manifesto e um arquivo de propriedades de construção.
  3. Necessário: Requisito: Você deve agora editar o arquivo de manifesto do plug-in e incluir as dependências da API JCICS. Se você não executar essas etapas, será capaz de exportar e instalar o pacote configurável, mas ele não poderá ser executado.
    Nota: Em versões do CICS anteriores ao CICS TS versão 4.2, era preciso incluir a biblioteca de classes Java, dfjcics.jar, no caminho de construção Java. Com o CICS TS versão 4.2, o OSGi gerencia o caminho de construção para você. Antes de executar as etapas a seguir, você deve editar o caminho de construção atual e remover todas as referências a dfhjcics.jar. Se você não remover as referências a dfhjcics.jar, um erro NoSuchMethodException ocorrerá em tempo de execução.
    1. Na visualização do Package Explorer, clique com o botão direito do mouse no nome do projeto e clique em Ferramentas PDE > Abrir Manifesto. O arquivo de manifesto é aberto no editor de manifesto.
    2. Importante: Em versões do CICS anteriores ao CICS TS versão 4.2, a biblioteca de classes Java, conhecida como JCICS, é fornecida no arquivo JAR dfjcics.jar. No CICS TS versão 4.2, a biblioteca é fornecida no arquivo com.ibm.cics.server.jar. Se seu manifesto do projeto contiver a declaração: Import-Package: dfhjcics.jar;, você deve remover a declaração antes de continuar com as etapas restantes.
    3. Selecione a guia Dependências e, na seção Pacotes Importados, clique em Incluir. O diálogo Seleção de Pacote é aberto.
    4. Selecione o pacote com.ibm.cics.server e clique em OK. O pacote é exibido na lista de Pacotes Importados.
    5. Opcional: Opcional: Repita a etapa anterior para instalar os seguintes pacotes, se necessário, para o seu aplicativo:
      Tabela 1.
      Pacote Descrição
      com.ibm.record A API Java para programas legados que usam IByteBuffer da Estrutura de Registro Java que era fornecida com o VisualAge. Anteriormente no arquivo dfjcics.jar.
    6. Pressione Ctrl +S para salvar o arquivo de manifesto.

Resultados

Você converteu com êxito seu projeto Java existente para um projeto de plug-in. Entretanto, você deve agora atualizar o arquivo de manifesto para incluir uma declaração CICS-MainClass. Para obter informações adicionais, consulte os links relacionados.