Aplicativos OSGi
Um aplicativo OSGi agrupa um conjunto de pacotes configuráveis para fornecer uma lógica de negócios coerente. O aplicativo pode consistir em diferentes tipos de pacotes configuráveis, como pacotes configuráveis ativados pela web e pacotes configuráveis ativados pela persistência.
Os pacotes configuráveis em um aplicativo OSGi são isolados dos pacotes configuráveis, serviços ou pacotes que são definidos em outro aplicativo OSGi, a não ser que os pacotes configuráveis, serviços ou pacotes sejam compartilhados explicitamente pelos dois aplicativos. Um aplicativo OSGi pode conter diretamente pacotes configuráveis OSGi ou pacotes configuráveis de referência que são hospedados em um repositório de pacotes configuráveis OSGi.
Os pacotes configuráveis OSGi no aplicativo podem compartilhar serviços com outros aplicativos OSGi. Se um aplicativo OSGi produz quaisquer serviços externos e referências, eles são expostos explicitamente declarando-os em um manifesto do aplicativo. De maneira semelhante, os serviços e referências externos que o aplicativo OSGi consome são declarados no manifesto do aplicativo. Um aplicativo OSGi também pode usar metadados para ativar o compartilhamento de alguns de seus pacotes configuráveis constituintes no sistema. Desse modo, o compartilhamento pode reduzir a memória e os requisitos de recurso de um sistema.
Conteúdo do Archive
- Se um cabeçalho Conteúdo do Aplicativo não estiver definido, o conteúdo de archive definirá o conteúdo do aplicativo OSGi.
- Se um cabeçalho Conteúdo do Aplicativo for definido, o conteúdo de archive definirá um repositório inicial de pacotes configuráveis do qual os pacotes configuráveis podem ser fornecidos. Se um pacote configurável com uma versão específica for instalado em um repositório administrado, e o pacote configurável também estiver contido em um archive de aplicativo, o pacote configurável do archive será usado.
Manifesto do Aplicativo
O manifesto do aplicativo, META-INF/APPLICATION.MF, descreve a modularidade no nível do aplicativo. Por padrão, quando o manifesto do aplicativo não for declarado, o conteúdo do aplicativo será o conjunto de pacotes configuráveis OSGi contidos no aplicativo OSGi e nenhum serviço ou referência externos será produzido ou consumido.
- Application-SymbolicName
O nome simbólico exclusivo do aplicativo OSGi, que usa a notação do pacote semelhante para Java.
- Application-Version
A versão do aplicativo, usando a sintaxe do OSGi para uma versão do pacote configurável.
- Application-Name
O Nome do Aplicativo.
- Application-ImportService
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 serviço podem ser declarados.
Um conjunto de filtros para serviços externos que o aplicativo consome. O manifesto do aplicativo deve conter as classes que os serviços requerem. Se esse cabeçalho não estiver especificado, nenhum dos serviços necessários serão importados.
Especifique os serviços necessários em uma lista separada por vírgula com o nome da interface de serviço seguido primeiro por atributos ou diretivas.
Por Exemplo:<identificador de serviço>;<diretivas>;<atributos>
O cabeçalho ImportService do Aplicativo possui o seguinte atributo:test.it;filter="some_filter"- filtragem
- Um filtro de serviço OSGi.
- Application-ExportService
Declara os serviços que são visíveis fora do pacote configurável. Qualquer serviço não declarado aqui tem visibilidade apenas dentro do pacote configurável.
Um conjunto de filtros para serviços externos que o aplicativo produz. Se esse cabeçalho não estiver especificado, nenhum dos serviços necessários serão exportados.
Especifique os serviços exportados em uma lista separada por vírgula com o nome da interface de serviço seguido primeiro por atributos ou diretivas.
Por Exemplo:<identificador de serviço>;<diretivas>;<atributos>
O cabeçalho Application-ExportService possui o seguinte atributo:test.it;filter="some_filter"- filtragem
- Um filtro de serviço OSGi.
- Use-Bundle
Um pacote configurável compartilhado que fornece pelo menos um pacote a um pacote configurável do aplicativo.
Uma lista de pacotes configuráveis ou pacotes configuráveis compostos para usar para satisfazer as dependências de pacote de pacotes configuráveis na lista Application-Content. Cada pacote configurável ou pacote configurável composto na lista Use-Bundle deve fornecer pelo menos um pacote a pelo menos um pacote configurável na lista Application-Content. Esses pacotes configuráveis são fornecidos no espaço de pacote configurável compartilhado no tempo de execução.
Frequentemente, você não necessita de um cabeçalho Use-Bundle, mas há algumas situações em que ele é útil. É possível usá-lo para restringir o nível no qual o compartilhamento é possível. Por exemplo, é possível assegurar que um aplicativo use o mesmo pacote configurável para importações de pacotes com os quais ele tenha sido testado. Alternativamente, é possível assegurar que dois aplicativos usam o mesmo pacote configurável para importações de pacotes. A configuração da restrição no nível do aplicativo pode manter o pacote configurável flexível.
- Application-WebModules
Lista de projetos da web dinâmicos não OSGi que são incluídos no aplicativo.
Esse cabeçalho não faz parte do padrão OSGi.
- Application-Content
- Uma lista de pacotes configuráveis compostos, fragmentos de pacote configurável e pacotes configuráveis com o intervalo aceitável de especificações da versão do OSGi que são incluídas no aplicativo.Dica: Ao incluir um fragmento na lista Conteúdo do Aplicativo, assegure-se de incluir o pacote configurável do host para o fragmento.O formato é uma lista separada por vírgula de declarações de módulo, em que cada declaração de módulo usa o seguinte formato:
<module identifier>;<directives>;<attributes>Tipicamente, o identificador de módulo é o nome simbólico de um pacote configurável. Para fazer referência a um recurso que não é um pacote configurável, o identificador de módulo é o caminho relativo para a raiz do aplicativo OSGi.
O cabeçalho Conteúdo do Aplicativo possui o seguinte atributo:- version
- A versão do módulo é especificada usando a sintaxe do OSGi para um intervalo de versão. Especifique a versão mínima do aplicativo seguida pela versão máxima para a qual o aplicativo pode estar atualizado. Por exemplo, "[1.0.0,2.0.0)" significa versão 1.0.0 e todas as versões mais recentes até, mas excluindo a versão 2.0.0.
O cabeçalho Application-Content define os aplicativos importantes que compõem os serviços de negócios, mas não define a lista integral de pacotes configuráveis no aplicativo. Se um pacote configurável que for listado no conteúdo usar um pacote que não esteja incluído no aplicativo, uma análise de dependência será executada e os pacotes configuráveis ausentes serão incluídos. Esses pacotes configuráveis não podem fornecer serviços externos ao aplicativo e não podem ter a segurança aplicada a eles. Os pacotes configuráveis que são incluídos usando esse mecanismo são compartilhados.
Manifesto de Implementação
Quando um aplicativo OSGi for instalado, o manifesto do aplicativo especificará os pacotes configuráveis que compreendem um aplicativo. Ele pode especificar mais que uma versão para alguns pacotes configuráveis.
O manifesto de implementação, META-INF/DEPLOYMENT.MF, especifica todos os pacotes configuráveis que compõem o aplicativo, incluindo os pacotes configuráveis necessários para seguir a análise de dependência. O manifesto de implementação especifica a versão real de cada pacote configurável que é usado no aplicativo. Ele será criado automaticamente quando um ativo Enterprise Bundle Archive (EBA) for instalado e ele assegurar que cada vez que um servidor de aplicativos for iniciado, os pacotes configuráveis que compõem o aplicativo serão os mesmos.
Um EBA define um conjunto de pacotes configuráveis OSGi que são implementados como um aplicativo OSGi único e que são isolados de outros aplicativos OSGi. Um arquivo EBA é um archive único com uma extensão do arquivo .eba. Ele contém um conjunto de módulos aplicativos ou um manifesto do aplicativo ou ambos.
Após a instalação de um aplicativo, a versão de um pacote configurável pode ser atualizada por meio da configuração do ativo EBA.
- Application-SymbolicName
- O nome simbólico exclusivo do aplicativo, que usa a notação do pacote semelhante para Java. Isso corresponde ao valor Application-SymbolicName no manifesto do aplicativo.
- Application-Version
- A versão do aplicativo, usando a sintaxe do OSGi para uma versão do pacote configurável. Isso corresponde ao valor Application-Version no manifesto do aplicativo.
- Deployed-Content
Uma lista separada por vírgulas de nomes simbólicos dos pacotes configuráveis e das versões exatas a serem utilizadas.
A lista inclui todos os pacotes configuráveis que são listados no cabeçalho Application-Content no manifesto do aplicativo e pacotes configuráveis que são importados por análise de dependência. Tipos de módulo não OSGi são incluídos usando o nome simbólico do pacote configurável convertido.
O cabeçalho Deployed-Content tem a seguinte diretiva:- deployed-version
- A versão exata do pacote configurável especificado que usa a sintaxe do OSGi para uma versão.