Utilisation des packages facultatifs installés

Vous pouvez associer une ou plusieurs bibliothèques partagées à une application à l'aide d'un package facultatif installé qui déclare les bibliothèques partagées dans le fichier manifeste de l'application. Les classes représentées par les bibliothèques partagées sont ensuite chargées dans le chargeur de classes de l'application, pour que les classes soient accessibles par l'application.

Avant de commencer

Vous trouverez des informations sur les packages facultatifs installés dans Installed optional packages et dans la section 8.2 de la spécification Java 2 Platform, Enterprise Edition (J2EE), version 1.4 à l'adresse http://docs.oracle.com/javaee/1.4/api/index.html.

WebSphere® Application Server ne prend pas en charge la sémantique Java 2 Platform Standard Edition (J2SE) Installed Optional Package utilisée dans la spécification J2SE (http://docs.oracle.com/cd/E19455-01/806-7503/6jgceuig7/index.html), qui sert principalement l'environnement d'applet. WebSphere Application Server ignore les balises spécifiques aux applets dans les fichiers manifeste.

A propos de cette tâche

Les packages facultatifs installés étendent les possibilités des bibliothèques partagées existantes d'un serveur d'applications. Les packages facultatifs installés permettent à un administrateur de déclarer dans un fichier de description d'application une dépendance à une bibliothèque partagée, les éléments des packages facultatifs installés étant listés dans le fichier de description, et d'associer automatiquement l'application à la bibliothèque partagée. Lors de l'installation de l'application, le fichier .jar de la bibliothèque partagée est ajouté au chemin d'accès aux classes du chargeur de classes d'application.

Si vous utilisez un module facultatif installé pour associer une bibliothèque partagée à une application, n'associez pas la même bibliothèque partagée à un chargeur de classes d'application et un chargeur de classes de serveur à l'aide de la console d'administration.

Procédure

  1. Assemblez le fichier de bibliothèque, y compris les informations de manifeste qui l'identifient comme extension.

    Vous trouverez ci-après deux exemples de fichier manifeste. Dans le premier, l'application app1.ear fait référence à un unique fichier de bibliothèque partagée, 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

    Dans le second exemple de fichier manifeste, le fichier app1.ear de l'application fait référence à plusieurs fichiers .jar de la bibliothèque partagée :

    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
  2. Créez une bibliothèque partagée qui représente le fichier de bibliothèque assemblé à l'étape 1.
    Cette opération permet d'installer le fichier de bibliothèque comme bibliothèque partagée.
  3. Copiez le fichier .jar de la bibliothèque partagée dans les membres du cluster.
  4. Assemblez l'application en déclarant dans le fichier manifeste de l'application les dépendances aux fichiers de bibliothèque dont le nom provient du manifeste créé à l'étape 1.
  5. Installez l'application sur le serveur ou sur le cluster.

Résultats

Lors de l'installation de l'application, les fichiers .jar de la bibliothèque partagée sont ajoutés au chemin d'accès aux classes du chargeur de classes d'application.