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
- 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. 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.
- 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.
- 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.
- 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.
- 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.
- Selecione a guia Dependências e, na seção
Pacotes Importados, clique em Incluir. O diálogo Seleção de Pacote é aberto.
- Selecione o pacote com.ibm.cics.server e
clique em OK. O pacote é exibido na lista
de Pacotes Importados.
- 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. |
- 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.