Importando um Arquivo JAR Binário para um Projeto de Plug-in OSGi

É possível criar um projeto de plug-in a partir de um arquivo JAR binário existente. Esse método é útil em situações em que haja restrições de licenciamento ou o arquivo binário não possa ser extraído. Entretanto, um pacote configurável OSGi que contenha um arquivo JAR não é suportado em um ambiente de JVM compartilhado.

Sobre Esta Tarefa

Esta tarefa cria um novo projeto de plug-in OSGi a partir de um arquivo JAR binário existente. O arquivo JAR precisa estar no sistema de arquivos local.

Procedimento

  1. Na barra de menus do Eclipse, clique em Arquivo > Novo > Projeto para abrir o assistente Novo.
  2. Expanda a pasta Desenvolvimento de Plug-in e clique em Plug-in a Partir de Arquivos JAR Existentes. Clique em Avançar. O diálogo de seleção de JAR é aberto.
  3. Localize o arquivo JAR a ser convertido. Se o arquivo estiver em sua área de trabalho do Eclipse, clique em Incluir. Se o arquivo estiver em uma pasta em seu computador, clique em Incluir Externo e navegue até o arquivo JAR. Selecione o arquivo necessário e clique em Abrir para incluí-lo no diálogo de seleção de JAR. Clique em Avançar. O diálogo Propriedades do Projeto de Plug-in é aberto.
    Uma captura de tela do assistente Novo Plug-in a Partir de Arquivos JAR Existentes
  4. No campo Nome do projeto, insira o nome do projeto que você deseja criar. Um nome de projeto é obrigatório.
  5. Preencha os seguintes campos na seção Propriedades do Plug-in conforme necessário:
    ID do Plug-in
    O ID do plug-in é gerado automaticamente a partir do nome do projeto, porém é possível alterar o ID se você desejar.
    Nome do Plug-in
    O nome do plug-in é gerado automaticamente a partir do nome do projeto, porém é possível alterar o nome se você desejar.
    Ambiente de Execução
    Esse campo especifica o nível mínimo de JRE necessário para a execução do plug-in. Selecione o nível de Java™ que corresponde ao ambiente de execução em sua plataforma de destino de tempo de execução do CICS.
  6. Na seção Plataforma de Destino, selecione uma estrutura OSGi e selecione padrão no menu.
  7. Certifique-se de que Descompactar os arquivos JAR para o projeto não esteja selecionado e clique em Concluir. O Eclipse cria o projeto de plug-in na área de trabalho. O projeto contém o arquivo JAR binário mas o projeto não é suportado em um ambiente de JVM compartilhado.
  8. 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.
    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. Selecione a guia Dependências e, na seção Pacotes Importados, clique em Incluir. O diálogo Seleção de Pacote é aberto.
    3. Selecione o pacote com.ibm.cics.server e clique em OK. O pacote é exibido na lista de Pacotes Importados.
    4. Opcional: Opcional: Repita a etapa anterior para instalar o seguinte pacote, 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.
    5. Pressione Ctrl +S para salvar o arquivo de manifesto.

Resultados

Você criou com êxito o projeto de plug-in na área de trabalho. 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.