É possível associar uma ou mais bibliotecas compartilhadas a um aplicativo
utilizando um pacote opcional instalado que declara as bibliotecas compartilhadas no
arquivo de manifesto do aplicativo. As classes representadas pelas bibliotecas compartilhadas
são, então, carregadas no carregador de classes do aplicativo, disponibilizando as classes
para o aplicativo.
Antes de Iniciar
Leia sobre os pacotes opcionais instalados em Pacotes Opcionais Instalados na seção 8.2 da especificação Java 2 Platform, Enterprise Edition (J2EE),
Versão 1.4 em http://docs.oracle.com/javaee/1.4/api/index.html.
WebSphere Application Server não suporta as semânticas do Pacote Opcional Instalado do Java 2 Platform Standard Edition (J2SE)
na especificação J2SE (http://docs.oracle.com/cd/E19455-01/806-7503/6jgceuig7/index.html), que atende principalmente
o ambiente do applet. O WebSphere Application Server ignora tags específicas do
applet em arquivos de manifesto.
Sobre Esta Tarefa
Os pacotes opcionais instalados expandem os recursos da biblioteca compartilhada
existentes de um servidor de aplicativos. Os pacotes opcionais
instalados permitem que um administrador declare uma dependência em um arquivo de manifesto
do aplicativo a uma biblioteca compartilhada, com elementos do pacote opcional instalado
listados no arquivo de manifesto, e associe automaticamente o aplicativo à biblioteca
compartilhada. Durante a instalação do aplicativo, o arquivo .jar da biblioteca compartilhada
é incluído no caminho de classe do carregador de classes do aplicativo.
Se
você usar um pacote opcional instalado para associar uma biblioteca compartilhada
com um aplicativo, não associe a mesma biblioteca compartilhada com um carregador
de classes de aplicativo ou um carregador de classes de servidor usando o console administrativo.
Procedimento
- Monte o arquivo de biblioteca, incluindo as informações de manifesto que
o identificam como uma extensão.
A seguir estão dois arquivos de manifesto de amostra. O primeiro arquivo de manifesto de amostra faz com que o aplicativo app1.ear faça referência a
um único arquivo de biblioteca compartilhado util.jar:
app1.ear:
META-INF/application.xml
ejb1.jar:
META-INF/MANIFEST.MF:
Extension-List: util
util-Extension-Name: com/example/util
util-Specification-Version: 1.4
META-INF/ejb-jar.xml
util.jar:
META-INF/MANIFEST.MF:
Extension-Name: com/example/util
Specification-Title: example.com's util package
Specification-Version: 1.4
Specification-Vendor: example.com
Implementation-Version: build96
O segundo arquivo de manifesto de amostra faz com que o aplicativo app1.ear faça referência a vários arquivos .jar de bibliotecas compartilhadas:
app1.ear:
META-INF/application.xml
ejb1.jar:
META-INF/MANIFEST.MF:
Extension-List: util1 util2 util3
Util1-Extension-Name: com/example/util1
Util1-Specification-Version: 1.4
Util2-Extension-Name: com/example/util2
Util2-Specification-Version: 1.4
Util3-Extension-Name: com/example/util3
Util3-Specification-Version: 1.4
META-INF/ejb-jar.xml
util1.jar:
META-INF/MANIFEST.MF:
Extension-Name: com/example/util1
Specification-Title: example.com's util package
Specification-Version: 1.4
Specification-Vendor: example.com
Implementation-Version: build96
util2.jar:
META-INF/MANIFEST.MF:
Extension-Name: com/example/util2
Specification-Title: example.com's util package
Specification-Version: 1.4
Specification-Vendor: example.com
Implementation-Version: build96
util3.jar:
META-INF/MANIFEST.MF:
Extension-Name: com/example/util3
Specification-Title: example.com's util package
Specification-Version: 1.4
Specification-Vendor: example.com
Implementation-Version: build96
- Crie uma biblioteca compartilhada que represente o arquivo de biblioteca
montado na etapa 1. Isso instala o arquivo de biblioteca como uma biblioteca compartilhada.
- Copie o arquivo .jar da biblioteca compartilhada para
os membros do cluster.
- Monte o aplicativo, declarando no arquivo de manifesto do aplicativo as dependências
dos arquivos de bibliotecas denominados que o manifesto criou para a etapa 1.
- Instale o aplicativo no servidor ou cluster.
Resultados
Durante a instalação do aplicativo, os arquivos .jar da biblioteca compartilhada
serão incluídos no caminho de classe do carregador de classes do aplicativo.