Pacotes configuráveis compostos OSGi
Os pacotes configuráveis compostos agrupam pacotes configuráveis em agregações para garantir o comportamento consistente. Um pacote configurável composto contém pacotes configuráveis ou referências a pacote configurável fora da área de trabalho ou da plataforma de destino. Um pacote configurável composto assegura o comportamento consistente a partir de um conjunto de pacotes configuráveis compartilhados em uma versão específica.
Um Composite Bundle Archive (CBA) agrupa pacotes configuráveis compartilhados em agregações. Um CBA pode conter pacotes configuráveis OSGi ou pacotes configuráveis de referência que são hospedados no repositório interno de pacotes configuráveis. Crie um CBA quando desejar assegurar o comportamento consistente através de um conjunto de pacotes configuráveis compartilhados. É possível usar o CBA para conectar esse conjunto de pacotes configuráveis, em uma versão específica, a um aplicativo.
Um CBA é um archive com uma extensão do arquivo .cba. Ele contém um manifesto composto META-INF/COMPOSITEBUNDLE.MF, que define o CBA e, opcionalmente, alguns pacotes configuráveis OSGi com os quais iniciar o repositório. Os pacotes configuráveis, que um CBA contém ou faz referência, são definidos com versões exatas, em contraposição a um EBA, em que os pacotes configuráveis são definidos com intervalos de versões.
Um pacote configurável composto está instalado no repositório interno de pacotes configuráveiso do tempo de execução. Se o CBA contiver diretamente os pacotes configuráveis OSGi, esses pacotes configuráveis serão instalados no repositório como se fossem carregados individualmente. O CBA também é incluído no repositório de pacotes configuráveis. Se o CBA fizer referência aos pacotes configuráveis OSGi, esses pacotes configuráveis deverão estar presentes no repositório interno de pacotes configuráveis.
Após a instalação de um CBA no repositório interno de pacotes configuráveis, seus pacotes configuráveis estarão disponíveis para todos os aplicativos que desejam usá-los quando o aplicativo for resolvido. Se um pacote ou serviço necessário estiver disponível na mesma versão de um pacote configurável e de um CBA, o processo de fornecimento selecionará o pacote ou serviço a partir do CBA.
- Um CBA possui um manifesto composto, que é uma instrução de modularidade que afirma que os pacotes configuráveis podem ser implementados, não que eles serão resolvidos. Um arquivo EBA possui um manifesto do aplicativo, que é uma instrução de fornecimento.
- Um CBA pode importar ou exportar pacotes, mas uma arquivo EBA não pode.
- Um arquivo EBA não precisa definir completamente seu conteúdo. Quando o aplicativo é implementado, uma análise de dependência é executada e pacotes configuráveis adicionais podem ser fornecidos.
- Um arquivo EBA pode definir quais pacotes configuráveis em seu conteúdo são compartilhados.
- Os pacotes configuráveis em um CBA são visíveis no repositório, mas os pacotes configuráveis em um arquivo EBA são privados para o aplicativo.
Arquivo de Manifesto do Pacote Configurável Composto OSGi
- Manifest-Version
- Descreve a versão do arquivo de manifesto.
- CompositeBundle-ManifestVersion
- Descreve a versão do pacote configurável composto.
- Bundle-Name
- Fornece um nome legível pelo usuário para um pacote configurável composto.
- Se você não especificar um valor, o valor padrão será o nome simbólico do pacote configurável composto.
- Bundle-SymbolicName
- Identifica exclusivamente um pacote configurável composto na estrutura. Ele não substitui a necessidade de um cabeçalho do Nome do Pacote Configurável.
- Bundle-Version
- Descreve a versão do pacote configurável composto e permite que diversas versões de um pacote configurável composto sejam ativas simultaneamente na mesma instância da estrutura.
- CompositeBundle-Content
- Uma lista de pacotes configuráveis e de fragmentos de pacotes configuráveis no pacote configurável composto. Todos os pacotes configuráveis e os fragmentos devem estar disponíveis para implementação e devem estar contidos no arquivo cba, ou existirem no repositório local de pacotes configuráveis. Os pacotes configuráveis e fragmentos devem ter números da versão exatos. Se você exigir o mesmo pacote configurável composto com versões diferentes de seu conteúdo, será necessário criar versões diferentes do pacote configurável composto, uma versão para cada uso.
- O formato é uma lista separada por vírgula de declarações do módulo, em que cada declaração do módulo usa o seguinte formato:
<module identifier>;<directives>;<attributes> - O cabeçalho CompositeBundle-Content possui o seguinte atributo:
- version
- A versão do módulo é especificada usando a sintaxe do OSGi para um intervalo de versão. A versão deve ser especificada como um intervalo exato, por exemplo, "[1.0.0,1.0.0]".
- Import-Package
- Declara as dependências externas do pacote configurável que são usadas pelo OSGi Framework para resolução do pacote configurável. As versões específicas ou os intervalos das versões para cada pacote podem ser declaradas.
- Use essa propriedade para especificar os nomes de quaisquer pacotes que você deseja que seu pacote configurável importe a partir do tempo de execução. Se você não especificar o pacote de que seu pacote configurável precisa nesta propriedade, poderá obter uma exceção NoClassDefFound quando o pacote configurável for carregado.
- Nota: Você também deve especificar o pacote que você deseja importar (usando Import-Package) na propriedade Export-Package do pacote configurável que contém o pacote.
- Export-Package
- Declara os pacotes que estão visíveis fora do pacote configurável. Qualquer pacote não declarado aqui possui visibilidade apenas no pacote configurável.
- Use essa propriedade para especificar o nome de qualquer pacote que você deseja que seu pacote configurável exporte para o tempo de execução. Se você não especificar os pacotes que são requeridos por outros pacotes configuráveis nesta propriedade, os pacotes configuráveis dependentes poderão não resolver.
- CompositeBundle-ExportService
Uma lista de nomes de interfaces de serviços e filtros opcionais que identificam os serviços que estão presentes no pacote configurável composto e que podem ser exportados para uso fora do pacote configurável composto. As interfaces que um serviço exportado implementa serão úteis fora do pacote configurável composto, se essas interfaces forem visíveis fora o pacote configurável composto.
O formato é uma lista separada por vírgula de serviços, na forma de um nome de interface de serviço, seguido por atributos ou diretivas. O cabeçalho CompositeBundle-ExportService possui o seguinte atributo:- filtragem
- Um filtro de serviço OSGi.
- CompositeBundle-ImportService
Uma lista de nomes de interfaces de serviços e filtros opcionais que identificam os serviços que o conteúdo do pacote configurável composto deseja usar de fora do pacote configurável composto. Pelo menos um desses serviços deve existir no tempo de execução.
O formato é uma lista separada por vírgula de serviços, na forma de um nome da interface de serviço, seguido por atributos ou diretivas. O cabeçalho CompositeBundle-ImportService possui o seguinte atributo:- filtragem
- Um filtro de serviço OSGi.