Remarque : Avant d'utiliser le présent document et le produit associé, prenez connaissance des informations générales figurant à la section Remarques.
Cette édition s'applique à IBM Developer Kit for Windows, Java 2 Technology Edition, Version 1.3.1, 32-bit version, ainsi qu'aux versions et modifications suivantes, sauf indication contraire dans les nouvelles éditions.
(c) Copyright Sun Microsystems, Inc. 1997, 2001, 901 San Antonio Rd., Palo Alto, CA 94303 USA. All rights reserved.
(c) Copyright International Business Machines Corporation, 1999, 2002. All rights reserved.
Ce fichier README contient des informations sur le composant Runtime Environment fourni avec IBM Developer Kit for Windows, Java 2 Technology Edition, Version 1.3.1, 32-bit version. Vous devez vous y reporter si vous avez l'intention de distribuer le composant Runtime Environment avec votre produit.
Le composant Runtime Environment est pris en charge par les systèmes d'exploitation suivants :
Le composant Runtime Environment contient la machine virtuelle Java (JVM), les classes Java Sun Microsystems et des fichiers de prise en charge. Il ne contient pas toutes les classes disponibles dans le composant Developer Kit package.
Le composant Runtime Environment comprend des fichiers .dll, ainsi que des classes pour prendre en charge les programme Java lors de leur exécution. Le composant Runtime Environment ne comporte aucun outil de développement (comme appletviewer ou javac), ni aucune classe qui appartiendrait uniquement à un système de développement.
Pour plus d'informations sur les fichiers à redistribuer avec les programmes Java, reportez-vous à la section Conditions requises pour la redistribution.
Le compilateur JIT génère dynamiquement le code machine utilisé par les séquences de code intermédiaire dans une application ou une applet Java en cours d'exécution. Le compilateur JIT (jitc.dll) est activé par défaut.
Vous pouvez désactiver le compilateur JIT afin d'isoler plus facilement les incidents liés à une application, à une applet Java ou au compilateur lui-même.
Vous disposez de deux méthodes pour désactiver le compilateur JIT :
set JAVA_COMPILER=NONE
Sous Windows NT, Windows 2000 et Windows XP, vous pouvez également définir JAVA_COMPILER dans les paramètres Environnement des propriétés système. (Sous Windows NT, ouvrez le panneau de configuration et sélectionnez Système, puis Environnement. Sous Windows 2000 et Windows XP, ouvrez le Panneau de configuration, sélectionnez Système, cliquez sur l'onglet Avancé, puis sur Variables d'environnement).
java -Djava.compiler=NONE myapp
Pour activer le compilateur, tapez la commande suivante :
set JAVA_COMPILER=jitc
Pour vérifier si le compilateur JIT est activé ou non, tapez la commande suivante :
java -version
Si le compilateur JIT est utilisé, un message s'affiche et indique notamment :
JIT enabled: jitc
Si le compilateur JIT n'est pas utilisé, le message suivant s'affiche :
JIT disabled
Pour obtenir les numéros de compilation et de version IBM, entrez la commande suivante :
java -version
Pour exécuter une application Java, tapez la commande suivante :
java nom_classe
où nom_classe
représente le nom du fichier de classe Java
(application Java) que vous souhaitez exécuter. Pour plus
d'informations sur les paramètres disponibles lors du lancement de
l'outil Java, reportez-vous à la section Interpréteur Java Runtime.
Remarque : Si vous n'avez pas installé le composant Runtime Environment en tant que machine java virtuelle, vous devez d'abord définir le chemin d'accès en spécifiant tous les répertoires. Pour mettre à jour le chemin, tapez la commande suivante :
set path=rép_java\jre\bin;%path%
où rép_java
représente le répertoire d'installation du
composant Runtime Environment. Par défaut, il s'agit du répertoire
Lors de la redistribution du composant Runtime Environment, vous devez inclure les fichiers disponibles dans le composant suivant :
Pour obtenir des informations spécifiques sur les fichiers à redistribuer, reportez-vous au contrat de licence relatif au produit.
Le terme requis signifie que les détenteurs de la licence qui distribuent le composant Runtime doivent inclure ces fichiers à leur programme, que ce programme utilise ces fichiers ou non.
Le composant Runtime Environment comprend les répertoires \bin et \lib, ainsi que les sous-répertoires associées. Ces deux répertoires et leurs sous-répertoires doivent résider dans le même répertoire. Le répertoire bin contient des fichiers exécutables et des bibliothèques natives. Le répertoire lib contient des classes et des fichiers de propriétés.
Tous les fichiers contenus dans les répertoires bin et lib sont nécessaires pour effectuer la redistribution.
Remarque : La bibliothèque d'exécution du code C en mode natif (msvcrt.dll) se trouve dans le répertoire système Windows. Assurez-vous que le fichier se trouve à cet endroit. L'emplacement de ce répertoire varie en fonction du système d'exploitation mais il correspond généralement aux chemins d'accès suivants :
L'outil Java lance l'interpréteur Java Runtime pour l'exécution des applications Java. La syntaxe à utiliser pour lancer l'outil java est la suivante :
java [-options] nom_classe <args>
L'argument nom_classe
correspond au nom du
fichier de classe à exécuter. Les arguments à transmettre à la classe doivent
être placés après le nom de la classe sur la ligne de commande.
java -jar [-options] fichier_jar <args>
L'argument fichier_jar
correspond au nom du fichier
JAR à exécuter. Les arguments à transmettre au fichier jar
doivent être placés après le fichier jar sur la ligne de commande.
Un autre outil, javaw, est disponible. L'outil javaw est comparable à l'outil java mais il n'appelle pas la fenêtre de la console. La syntaxe à utiliser pour lancer l'outil javaw est la suivante :
javaw [options] nom_classe <args>
Les options de l'outil java sont définies comme suit :
Les options -X ne sont pas des options standard et peuvent être modifiées sans préavis.
La page Web de Sun contient un exemple "Hello World". Cet exemple explique comment créer une application Java de base qui s'exécute et s'intègre dans Java Runtime Environment. Consultez le site Web de Sun à l'adresse : http://java.sun.com Vous pouvez vous procurer l'exemple "Hello World" en recherchant "Hello World" et "Notes for Developers".
Cet exemple explique comment développer une application avec Developer Kit et la déployer plus facilement avec Runtime Environment, très simplement et de façon complètement transparente.
Dans votre produit, vous devez proposer une méthode pour :
Si vous redistribuez le composant Runtime Environment, vous devez vérifier que votre procédure d'installation ne remplace pas une installation existante (sauf s'il s'agit d'une version antérieure de Runtime Environment).
La méthode recommandée consiste à prendre les fichiers disponibles dans le module zip de redistribution Runtime Environment (ibm-jre-n131p-win32-x86.zip) et de les installer dans la même structure de répertoires. Veillez à inclure tous les fichiers stockés dans les répertoires bin et lib, ainsi que dans les sous-répertoires associés. Ces répertoires sont décrits à la section Conditions requises pour la redistribution. Le composant Runtime Environment ne peut être redistribué que dans son intégralité. En effet, l'application que vous distribuez comporte sa propre copie de Runtime Environment.
Si vous optez pour cette méthode, ne tentez pas d'émuler les étapes d'installation effectuées par le programme d'installation de Runtime Environment.
Remarque : Lors de l'installation du composant Runtime Environment, vous devez enregistrer les données du programme dans le registre Windows de la manière suivante :
Java2 Runtime Environment/1.3.1/JavaHome | répertoire racine de java\jre |
Java2 Runtime Environment/1.3.1/RuntimeLib | répertoire racine de java\jre\bin\classic\jvm.dll |
Java2 Runtime Environment/1.3.1/Microversion | 0 |
Java Plug-in/1.3.1/JavaHome | répertoire racine de java\jre |
Java Plug-in/1.3.1/RuntimeLib | répertoire racine de java\jre\bin\classic\jvm.dll |
Nom de clé | Valeur de clé |
Lucida Sans Typewriter Regular (TrueType) | LucidaTypewriterRegular.ttf |
Lucida Bright Demibold Italic (TrueType) | LucidaBrightDemiItalic.ttf |
Lucida Bright Italic (TrueType) | LucidaBrightItalic.ttf |
Lucida Bright Regular (TrueType) | LucidaBrightRegular.ttf |
Lucida Sans Demibold (TrueType) | LucidaSansDemiBold.ttf |
Lucida Sans Demibold Oblique (TrueType) | LucidaSansDemiOblique.ttf |
Lucida Sans Oblique (TrueType) | LucidaSansOblique.ttf |
Lucida Sans Regular (TrueType) | LucidaSansRegular.ttf |
Lucida Sans Typewriter Bold (TrueType) | LucidaTypewriterBold.ttf |
Lucida Sans Typewriter Bold Oblique (TrueType) | LucidaTypewriterBoldOblique.ttf |
Lucida Sans Typewriter Oblique (TrueType) | LucidaTypewriterOblique.ttf |
Lucida Bright Demibold (TrueType) | LucidaBrightDemiBold.ttf |
A titre d'exemple, le chemin d'accès complet d'une valeur de clé peut correspondre à :
Le composant Developer Kit propose l'option d'exécution JVM -Xgcpolicy pour définir les règles de récupération de place.
-Xgcpolicy accepte deux valeurs, optthruput (par défaut) et optavgpause. Cette option contrôle le comportement du récupérateur en établissant des compromis entre le débit de l'application et l'ensemble du système et les délais d'interruption nécessités par la récupération de place.
Le format et les valeurs de cette option sont les suivants :
-Xgcpolicy:optthruputet
-Xgcpolicy:optavgpause
Lorsque l'espace disponible dans le segment ne permet pas à une application de créer un objet, la fonction de récupération de place identifie les objets non référencés et les supprime, ce qui rétablit l'état du segment et permet de répondre rapidement aux demandes d'affectation de ressources actuelles et ultérieures. Des cycles de récupération de place de ce type génèrent parfois des interruptions inattendues dans l'exécution du code d'application. A mesure que la taille et la complexité des applications augmentent, la taille des segments s'accroît et les interruptions causées par le processus de récupération de place deviennent plus longues et plus gênantes. La valeur de récupération de place par défaut, optthruput, offre un débit très élevé aux applications, au prix d'interruptions fréquentes, d'une durée comprise entre quelques millisecondes et plusieurs secondes, selon la taille du segment et la quantité de place à récupérer.
La valeur optavgpause réduit sensiblement la durée des interruptions générées par le processus de récupération de place et réduit l'impact de l'augmentation de taille du segment sur la durée des interruptions. L'effet de cette option est le plus sensible dans des configurations comportant des segments de grande taille. (Un segment est considéré comme grand lorsqu'il atteint au moins 1 Go.) Les délais d'interruption sont réduits en faisant alterner les opérations de récupération de place et les exécutions normales du programme. Cette alternance réduit un peu le débit de l'application.
Si le segment Java est proche de la saturation et que la place à récupérer est très limitée, les demandes de nouveaux objets ne sont pas satisfaites rapidement car aucun espace n'est disponible immédiatement. Si le segment est utilisé au maximum de sa capacité ou presque, une baisse de performances se produit au niveau des applications, indépendamment du réglage des options définies ci-dessus. Si des demandes d'espace supplémentaire sont effectuées, l'application reçoit une exception Out of Memory qui entraîne l'arrêt de la JVM si cette dernière n'est pas interceptée et traitée. Dans ces cas de figure, il est recommandé d'augmenter la taille du segment à l'aide de l'option -Xmx ou de réduire le nombre d'objets d'application utilisés.
Pour obtenir des informations sur l'ajustement de la taille du segment et sur les incidences de la récupération de place sur les performances des applications, consultez les sites Web suivants :
Sun fournit le composant Java Access Bridge pour permettre aux technologies d'assistance Windows natives (par exemple, d'accéder au support Java Accessibility dans une application Java. Ces programmes d'assistance Windows natifs doivent avoir été écrits pour effectuer des appels à Java Access Bridge.
Le composant Java Access Bridge disponible auprès de Sun comprend un programme d'installation qui place cinq fichiers dans les répertoires appropriés : access-bridge.jar, jaccess.jar, accessibility.properties, JavaAccessBridge.dll et WindowsAccessBridge.dll.
Si vous avez déjà installé IBM Accessibility Bridge (JawBridge), qui permet à Windows 2000 Magnifier de fonctionner avec les applications Swing, et que vous souhaitez l'exécuter en même temps que Java Access Bridge, modifiez la ligne dans le fichier accessibility.properties pour obtenir :
#
.
Consultez ce site Web pour connaître les modalités de téléchargement du composant Java Access :
Chaque fichier de propriétés contient des commentaires qui décrivent comment utiliser et modifier le fichier.
Le présent document peut contenir des informations ou des références concernant certains produits, logiciels ou services IBM non annoncés dans ce pays. Pour plus de détails, référez-vous aux documents d'annonce disponibles dans votre pays, ou adressez-vous à votre partenaire commercial IBM. Toute référence à un produit, logiciel ou service IBM n'implique pas que seul ce produit, logiciel ou service puisse être utilisé. Tout autre élément fonctionnellement équivalent peut être utilisé, s'il n'enfreint aucun droit d'IBM. Il est de la responsabilité de l'utilisateur d'évaluer et de vérifier lui-même les installations et applications réalisées avec des produits, logiciels ou services non expressément référencés par IBM.
IBM peut détenir des brevets ou des demandes de brevet couvrant les produits mentionnés dans le présent document. La remise de ce document ne vous donne aucun droit de licence sur ces brevets ou demandes de brevet. Si vous désirez recevoir des informations concernant l'acquisition de licences, veuillez en faire la demande par écrit à l'adresse suivante :
Les informations sur les licences concernant les produits utilisant un jeu de caractères double octet peuvent être obtenues par écrit à l'adresse suivante :
Le paragraphe suivant ne s'applique ni au Royaume-Uni, ni dans aucun autre pays dans lequel il serait contraire aux lois locales.
LE PRESENT DOCUMENT EST LIVRE EN L'ETAT. IBM DECLINE TOUTE RESPONSABILITE, EXPLICITE OU IMPLICITE, RELATIVE AUX INFORMATIONS QUI Y SONT CONTENUES, Y COMPRIS EN CE QUI CONCERNE LES GARANTIES DE VALEUR MARCHANDE OU D'ADAPTATION A VOS BESOINS. Certaines juridictions n'autorisent pas l'exclusion des garanties implicites, auquel cas l'exclusion ci-dessus ne vous sera pas applicable.
Le présent document peut contenir des inexactitudes ou des coquilles. Il est mis à jour périodiquement. Chaque nouvelle édition inclut les mises à jour. IBM peut modifier sans préavis les programmes et les logiciels qu'il décrit.
Les références à des sites Web non IBM sont fournies à titre d'information uniquement et n'impliquent en aucun cas une adhésion aux données qu'ils contiennent. Les éléments figurant sur ces sites Web ne font pas partie des éléments du présent produit IBM et l'utilisation de ces sites relève de votre seule responsabilité.
IBM pourra utiliser ou diffuser, de toute manière qu'elle jugera appropriée et sans aucune obligation de sa part, tout ou partie des informations qui lui seront fournies.
Les licenciés souhaitant obtenir des informations permettant : (i) l'échange des données entre des logiciels créés de façon indépendante et d'autres logiciels (dont celui-ci), et (ii) l'utilisation mutuelle des données ainsi échangées, doivent adresser leur demande à :
Ces informations peuvent être soumises à des conditions particulières, prévoyant notamment le paiement d'une redevance.
Le logiciel sous licence décrit dans ce document et tous les éléments sous licence disponibles s'y rapportant sont fournis par IBM conformément aux termes du Contrat sur les produits et services IBM, des Conditions internationales d'utilisation des logiciels IBM ou de tout autre accord équivalent.
Les données de performance indiquées dans ce document ont été déterminées dans un environnement contrôlé. Par conséquent, les résultats peuvent varier de manière significative selon l'environnement d'exploitation utilisé. Certaines mesures évaluées sur des systèmes en cours de développement ne sont pas garanties sur tous les systèmes disponibles. En outre, elles peuvent résulter d'extrapolations. Les résultats peuvent donc varier. Il incombe aux utilisateurs de ce document de vérifier si ces données sont applicables à leur environnement d'exploitation.
Les informations concernant des produits non IBM ont été obtenues auprès des fournisseurs de ces produits, par l'intermédiaire d'annonces publiques ou via d'autres sources disponibles. IBM n'a pas testé ces produits et ne peut confirmer l'exactitude de leurs performances ni leur compatibilité. Elle ne peut recevoir aucune réclamation concernant des produits non IBM. Toute question concernant les performances de produits non IBM doit être adressée aux fournisseurs de ces produits.
IBM est une marque d'International Business Machines dans certains pays.
Java et toutes les marques et logos incluant Java sont des marques de Sun Microsystems, Inc dans certains pays. La technologie Java est utilisée avec l'autorisation exclusive de la société Sun Microsystems, Inc.
Microsoft, Windows, Windows NT et le logo Windows sont des marques de Microsoft Corporation dans certains pays.
D'autres sociétés sont propriétaires des autres marques, noms de produits ou logos qui pourraient apparaître dans ce document.