Pacotes Opcionais Instalados

Os pacotes opcionais instalados permitem que os aplicativos utilizem as classes nos arquivos deJava™ (.jar) sem ter que incluí-los explicitamente em um caminho de classe. Um pacote opcional instalado é um arquivo .jar contendo tags especializadas no arquivo de manifesto que permitem ao servidor de aplicativos identificá-lo. Um pacote opcional instalado declara um ou mais arquivos .jar da biblioteca compartilhada no arquivo de manifesto de um aplicativo. Quando o aplicativo é instalado em um servidor ou cluster, as classes representadas pelas bibliotecas compartilhadas são carregadas no carregador de classes do aplicativo, disponibilizando as classes para o aplicativo.

Quando um aplicativo Java Platform, Enterprise Edition (Java EE) estiver instalado em um servidor ou em um cluster, as informações de dependência serão especificadas em seu arquivo de manifesto. O produto lê as informações de dependência do aplicativo (arquivo .ear) para associar automaticamente o aplicativo a um arquivo .jar do pacote opcional instalado. O produto inclui os arquivos .jar em pacotes opcionais associados ao caminho de classe do aplicativo. As classes nos pacotes opcionais instalados estão, então, disponíveis às classes do aplicativo.

Os pacotes opcionais instalados usados pelo produto são descritos na seção 8.2 da especificação do Java 2 Platform, Enterprise Edition (J2EE), Versão 1.4 em http://docs.oracle.com/javaee/.

O produto suporta a utilização do arquivo de manifesto (manifest.mf) nos arquivos .jar e da biblioteca compartilhada e arquivos .ear do aplicativo. O produto não suporta a semântica do Pacote opcional instalado Java 2 Platform Standard Edition (J2SE) usada na especificação do J2SE (http://docs.oracle.com/javase/1.3/docs/), que atende principalmente o ambiente do applet. O produto ignora marcações específicas do applet em arquivos de manifesto.

Arquivo manifest.mf de Amostra

Um arquivo de manifesto de amostra segue para um app1.ear do aplicativo que refere-se a um único arquivo util.jar da biblioteca compartilhada:

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

A sintaxe de uma entrada do manifesto depende da aplicação da entrada em um membro com uma função de definição (a biblioteca compartilhada) ou um membro com uma função de referência (um aplicativo Java EE ou um módulo em um aplicativo Java EE).

Tag de Entrada do Manifesto

As entradas de manifesto usam as tags principais a seguir:

Extension-List
Uma tag requerida com sintaxe variável. No contexto da função de referência (manifesto do aplicativo), essa é uma lista delimitada de espaços que identifica e constrói tags exclusivas Extension-Name, Extension-Specification para cada elemento na lista. No contexto da função de definição (biblioteca compartilhada), essa tag não é válida.
Extension-Name
Uma tag requerida que fornece um nome e liga os membros de definição e referência. A sintaxe do elemento na função de referência é prefixar o elemento com a cadeia <ListElement>. Para cada elemento em Extension-List, há uma tag <ListElement>-Extension-Name correspondente. O valor literal da sequência de definição para essa tag (na amostra acima, com/example/util1) é usado para corresponder (em um teste de igualdade) as tags correspondentes entre as funções de definição e referência.
Specification-Version
Uma tag requerida, que identifica a versão da especificação e liga os membros de definição e referência.
Implementation-Version
Uma tag opcional que identifica a versão da implementação e liga os membros de referência e definição.

Há informações adicionais sobre essas tags na especificação do arquivo .jar em http://docs.oracle.com/javase/1.4.2/docs/.


Ícone que indica o tipo de tópico Tópico de Conceito



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=ccws_installoptpkg
Nome do arquivo: ccws_installoptpkg.html