Il s'agit de la commande jtreg qui peut être exécutée dans le fournisseur d'hébergement gratuit OnWorks en utilisant l'un de nos nombreux postes de travail en ligne gratuits tels que Ubuntu Online, Fedora Online, l'émulateur en ligne Windows ou l'émulateur en ligne MAC OS
PROGRAMME:
Nom
jtreg - Harnais de test de régression
DESCRIPTION
Usage:
options jtreg... tests...
Les tests peuvent être fournis sous forme de fichiers ou de dossiers contenant des fichiers de test, ou au moyen de groupes de tests.
De longues listes d'options et de tests peuvent être encapsulées dans des « fichiers at ».
Options détaillées
Ces options contrôlent la quantité de sortie écrite sur la console pendant l'exécution
tests
-v | -v: | -verbeux | -verbeux:
Augmentez la quantité de sortie écrite sur la console. Une valeur ou une sélection
des combinaisons de valeurs séparées par des virgules peuvent être données pour sélectionner le type de
sortie souhaitée.
défaut
Trois lignes de sortie par test : début, fin, état
Sommaire
Une ligne de sortie par test : statut, nom du test
tout le contenu sélectionné du fichier JTR pour tous les tests (inclut stdout/stderr)
Contenu sélectionné du fichier JTR pour les tests réussis
échec Contenu sélectionné du fichier JTR pour les tests échoués
erreur Contenu sélectionné du fichier JTR pour les tests erronés
nopass Supprimer la sortie pour les tests réussis
temps Temps écoulé par action
multirun
Mises à jour pour chaque suite de tests lorsque des tests de plusieurs suites sont exécutés.
-v1 Court pour -verbeux:résumé
-Virginie Court pour -verbeux:tout
-ve Court pour -verbeux:Erreur
-vf Court pour -verbeux:échouer
-vp Court pour -verbeux:passer
-Vermont Court pour -verbeux:temps
Options de documentation
Options pour une documentation supplémentaire
-h [mots...] | -Aide [mots...] | -usage [mots...]
Aide en ligne de commande. Donnez des mots pour voir les informations d'aide contenant ceux-ci ou utilisez "-help all"
pour voir toute l'aide disponible.
-n | -relnote
Notes de publication
-aide en ligne [mots...]
Afficher l'aide en ligne. Vous pouvez également l'afficher depuis le menu Aide du bureau.
-t | -tagspec
Spécification de balise prise en charge par cette implémentation
-version
Donnez des informations sur la version de jtreg utilisée.
Options générales
-allowSetSecurityManager | -allowSetSecurityManager:
Autoriser les tests sameVM à définir un gestionnaire de sécurité. La valeur par défaut est « oui » si l'option n'est pas spécifiée.
ou aucune valeur donnée pour l'option.
oui Autoriser les tests sameVM à définir un gestionnaire de sécurité
non Ne pas autoriser les tests sameVM à définir un gestionnaire de sécurité
sur Autoriser les tests sameVM à définir un gestionnaire de sécurité
désactivé Ne pas autoriser les tests sameVM à définir un gestionnaire de sécurité
vrai Autoriser les tests sameVM à définir un gestionnaire de sécurité
Ne pas autoriser les tests sameVM à définir un gestionnaire de sécurité
-c | -vérifier
Vérifie l'exactitude des descriptions de tests. N'exécute PAS les tests.
-conc: | -concurrence:
facteur de concurrence
est:
Spécifiez un répertoire de base pour les fichiers et répertoires de test
-e:nom[=valeur][,nom[=valeur]...]
Spécifiez les variables d'environnement supplémentaires à transmettre à chaque test. Si une valeur est
non donné pour un nom, la valeur actuelle de la variable d'environnement sera utilisée.
Les variables d'environnement standard, telles que DISPLAY, LANG, windir, SystemRoot, etc.
être automatiquement attribué à chaque test, s'ils sont définis dans l'environnement actuel.
-g | -gui
Accédez aux extensions de régression via l'interface graphique standard du harnais JavaTest
-ignorer:
Spécifiez comment gérer les tests contenant une balise @ignore.
silencieux Ignorez complètement de tels tests.
erreur (par défaut). Exécutez les actions jusqu'à la balise @ignore, puis donnez un résultat « Erreur ».
Exécutez le test, comme si la balise @ignore n'était pas présente.
-l | -listtests
Énumérez les tests qui seraient exécutés au lieu de les exécuter.
-Lock:
Fichier de verrouillage à utiliser pour les tests dans les répertoires « à accès exclusif » lors de l'exécution de tests dans
plusieurs instances simultanées de jtreg.
-chemin natif:
Chemin vers l'emplacement des bibliothèques et programmes natifs nécessaires aux tests.
-noignore
supprimer l'effet de toutes les balises @ignore, permettant au test de se dérouler comme si le
Les balises @ignore n'étaient pas présentes. Obsolète : voir le -ignorer option.
-n° | -pas de rapport
Ne générez pas de rapport final.
-o: | -observateur:
Spécifie la classe pour observer la progression d'une suite de tests ; la classe doit
implémenter une interface spécifique ; contacter un développeur pour plus de détails. Par exemple
-o:SampleRegressionObserver
-od: | -observerDir: | -op: | -observerPath:
Spécifie le chemin d'accès d'un répertoire ou d'un fichier .jar dans lequel se trouve la classe d'observateur
situé. Le chemin d'accès donné est simplement ajouté au CLASSPATH utilisé pour les tests,
il faut donc veiller à ne pas entrer en conflit avec les noms des observateurs lors de la désignation d'un observateur.
classes internes au harnais JavaTest ou au JRE, par exemple, mettre la classe d'observateur
dans son propre package nommé.
-r: | -reportDir:
Tous les fichiers de rapport sont placés ici ; « ./JTreport » est la valeur par défaut
-conserver | -conserver: ,...
Spécifiez les fichiers à conserver après l'exécution de chaque test. Si -conserver n'est pas
spécifié, seuls les fichiers du dernier test exécuté seront conservés. Si -conserver
Si aucun argument n'est spécifié, tous les fichiers seront conservés. Sinon, les fichiers
peut être décrit par une ou plusieurs des valeurs suivantes :
aucun Ne conservez aucun des fichiers générés par chaque test
réussir Conserver les fichiers générés par les tests réussis
échouer Conserver les fichiers générés par les tests qui échouent
erreur Conserver les fichiers générés par les tests qui ont provoqué une erreur
tous Conserver tous les fichiers générés par chaque test
modèle de fichier
Conserver les fichiers correspondant à un nom spécifique. Le nom peut contenir « * » pour correspondre à n'importe quel nom.
séquence de caractères. Par exemple, result.* ou *.err.
-ro | -rapport uniquement
Générer un rapport pour les tests déjà exécutés. Aucun test n'est réexécuté.
Le répertoire de travail contenant les résultats des tests exécutés doit être fourni.
L'emplacement par défaut est « ./JTwork ». Pour spécifier un autre répertoire, utilisez -workDir.
-spectacle:Nom des informations dans le fichier de résultats, telles que « réexécution ».
Afficher les informations sélectionnées dans le fichier de résultats d'un test
-showGroups
Afficher l'extension (aux fichiers et aux répertoires) des groupes donnés dans la commande
ligne. Pour voir l'expansion de tous les groupes d'une suite de tests, spécifiez le nom de
la suite de tests.
-startHttpd
Démarrez le serveur http pour afficher les résultats des tests
-w: | -workDir:
Emplacement des fichiers .class, .jtr, etc. « ./JTwork » est la valeur par défaut
-xml | -xml:vérifier
Créez des fichiers XML Ant/Junit dans le répertoire workDir. Vérifiez éventuellement si le fichier est bien installé.
formé.
Options de délai d'attente
Ces options contrôlent le comportement lorsque les tests s'exécutent plus longtemps que leur durée spécifiée.
valeur de délai d'attente.
-th: | -timeoutHandler:
Spécifie la classe qui gère les délais d'attente. La classe doit s'étendre.
com.sun.javatest.regtest.TimeoutHandler. Par exemple -th:MonGestionnaire
-thd: | -timeoutHandlerDir:
Spécifie le chemin d'accès d'un répertoire ou d'un fichier .jar dans lequel le gestionnaire de délai d'attente
classe est localisée. Le chemin d'accès donné est simplement ajouté au CLASSPATH utilisé pour
les tests, il faut donc veiller à ne pas entrer en collision lors de la désignation d'un gestionnaire de délai d'attente
avec les noms des classes internes au harnais JavaTest ou au JRE, par exemple, mettre
la classe de gestionnaire de délai d'attente dans son propre package nommé.
-thtimeout:<#secondes> | -timeoutHandlerTimeout:<#secondes>
Spécifie la limite de temps d'exécution du gestionnaire de délai d'expiration. Si le délai d'expiration est dépassé,
le gestionnaire ne termine pas ses actions dans le délai spécifié, il sera
Interrompu. Les valeurs non positives signifient qu'il n'y a aucune limitation. La valeur par défaut est 5.
minutes (300 secondes).
-temps libre: | -timeoutFactor:
Un facteur d'échelle pour prolonger le délai d'expiration par défaut de tous les tests. Généralement utilisé lorsque
exécuter des tests sur des systèmes lents ou des systèmes avec des systèmes de fichiers lents.
-tl:<#secondes> | -limite de temps:<#secondes>
N'exécutez pas de tests spécifiant un délai d'expiration supérieur à une valeur donnée. La comparaison
est effectué par rapport à toutes les valeurs spécifiées dans le test, avant qu'un facteur de temporisation ne soit
appliqué.
Options de sélection des tests
Ces options peuvent être utilisées pour affiner l’ensemble des tests à exécuter.
-a | -automatique | -automagique
Tout test avec /manuel ne sera pas exécuté
-punaise:
Exécutez uniquement les tests qui s'appliquent au bugid donné.
-exclure: | -Xexclure:
Fournir un fichier spécifiant les tests à ne pas exécuter
-k: | -mots-clés:
Une expression booléenne à mot-clé pour la sélection de tests. L'expression peut contenir un mot-clé.
noms, combinés avec & (et), | (ou), ! (pas) et parenthèses.
-m | -Manuel
Seuls les tests avec /manuel sera exécuté
-pas de coquille
Tous les tests contenant des actions shell ne seront pas exécutés
-coquille Seuls les tests contenant des actions shell seront exécutés
-statut: ,...
Sélectionnez les tests en fonction de leurs résultats lors d'une précédente exécution. La valeur peut être 1 ou
plusieurs des valeurs suivantes, séparées par des virgules.
passer les tests qui ont réussi
échec Tests qui ont échoué
notRun Tests qui n'ont pas été exécutés
erreur Tests qui n'ont pas pu être exécutés en raison d'erreurs ou tests qui ont été ignorés
Options du mode test
Chaque test se compose d'une série d'étapes, appelées actions. Le harnais jtreg fournit
différents modes, qui déterminent la JVM à utiliser pour exécuter chaque action. Le mode par défaut
consiste à exécuter chaque action dans une nouvelle JVM.
-avm | -agentvm
Exécutez chaque action à l'aide d'un pool de JVM réutilisables, sauf lorsqu'une action spécifie
Sinon, il offre de bonnes performances et une isolation raisonnable entre les actions :
si une JVM peut être réinitialisée à un état standard après avoir été utilisée, elle sera
remis à la piscine pour être réutilisé ; sinon, il sera jeté et remplacé si et
si nécessaire. Ce mode est généralement recommandé pour toute utilisation. Le JDK à utiliser peut
être spécifié avec -testjdk or -jdk, à l'exception des actions @compile, qui utilisent
-compilejdk or -jdk. Si aucune valeur n'est fournie, la variable d'environnement
JAVA_HOME est utilisé.
-ovm | -autrevm
Exécuter chaque action dans une nouvelle JVM. Il s'agit de la valeur par défaut. Elle fournit le maximum
l'isolement entre les actions, au détriment des performances. Le JDK à utiliser
peut être spécifié avec -testjdk or -jdk, à l'exception des actions @compile, qui utilisent
-compilejdk or -jdk. Si aucune valeur n'est fournie, la variable d'environnement
JAVA_HOME est utilisé.
-s | -svm | -samevm
Exécutez chaque action dans la même JVM que le harnais jtreg, sauf lorsqu'une action
spécifie le contraire. Il offre des performances maximales, mais une isolation minimale.
entre les actions, de telle sorte qu'un mauvais test peut entraîner tous les tests ultérieurs du test
exécuter jusqu'à l'échec. Ce mode ne convient qu'aux suites de tests bien exécutées et ne peut pas être
utilisé en conjonction avec le -concurrence option. Il n'est plus recommandé pour
usage général. La version du JDK utilisée peut être spécifiée avec -testjdk or -jdk. Si un
la valeur n'est pas fournie, la version du JDK sera alors déterminée par l'environnement
la variable d'environnement JT_JAVA si elle est définie. Sinon, la variable d'environnement JAVA_HOME est
utilisé.
Options liées au JDK
Par défaut, les tests seront exécutés avec la JVM par défaut du JDK de test. Vous pouvez passer
toutes les options JVM applicables via l'utilisation -vmoption; en outre, la JVM la plus courante
Les options sont également prises en charge directement. Pour plus de détails sur chaque option, consultez le
documentation pour cette version du JDK, ou essayez d'utiliser « java -Aide" ou "java -X".
Si une option n'est pas applicable à une plate-forme ou à une version particulière du JDK, elle le sera.
rejeté.
-agentlib: <[= ]
Charger la bibliothèque d'agents natifs
-agentpath: <[= ]
Charger la bibliothèque d'agent natif par le chemin d'accès complet
-classique | -vert | -originaire de | -point chaud | -client | -serveur | -d32 | -d64
Options de machine virtuelle
-compilejdk:
Compiler tous les tests à l'aide du JDK spécifié. En l'absence de spécification, les tests sont compilés avec
Le JDK utilisé pour exécuter les tests. Voir aussi -jdk. par exemple
-jdk:/usr/local/java/jdk1.5/solaris-sparc
-cpa: | -classpathappend:
Ajoutez le classPath fourni au CLASSPATH de chaque test. Ceci est conçu pour
être utilisé principalement pour les tests nécessitant des fonctionnalités JDK non essentielles. Par exemple,
pour tester Swing, qui ne fait pas partie du noyau JDK1.1, l'ajout suivant au
CLASSPATH serait nécessaire : -cpa:/usr/local/java/swing-1.0.3/swingall.jar
-D=
Définir une propriété système
-déboguer: ...
Utilisez ceci pour spécifier les options de la machine virtuelle afin d'attacher un débogueur à une machine virtuelle exécutant un test.
similaire à -vmoptions sauf qu'il n'est pas utilisé lors du démarrage des machines virtuelles utilisées pour interroger
les propriétés de cette machine virtuelle. Voir aussi -optionsjava et -vmoptions.
-activer les assertions | -activer les assertions:* | -un | -un:* | -désactiver les assertions |
-désactiver les assertions:* | -Dans | -Dans:*
Activer ou désactiver les assertions
-activer les assertions système | -esa | -désactiver les assertions système | -dsa
Activer ou désactiver les assertions système
-javaagent: <[= ]
Charger l'agent de langage de programmation Java
-javacoption:
Option de compilation supplémentaire. Vous pouvez l'activer plusieurs fois. Tout élément intégré
les noms de fichiers doivent être donnés avec des chemins absolus.
-javacoptions: ...
Options de compilation supplémentaires. Vous pouvez spécifier cette option plusieurs fois, ou en donner plusieurs.
valeurs ensemble, séparées par des espaces. Si vous indiquez plusieurs valeurs, vous devrez peut-être
Entourez-les de guillemets, selon le shell utilisé. Tous les noms de fichiers intégrés doivent
être donné avec des chemins absolus. Attention : n'utilisez pas ce formulaire si l'une des options
possède un argument tel qu'un nom de fichier pouvant contenir des espaces. Dans ce cas, utilisez-en un.
ou plus -javacoption options à la place.
-javaoption:
Option Java supplémentaire pour l'exécution de classes de test. Vous pouvez attribuer cette option plusieurs fois.
fois. Tous les noms de fichiers intégrés doivent être indiqués avec des chemins absolus. Voir aussi
-vmoption.
-optionsjava: ...
Options Java supplémentaires pour l'exécution des classes de test. Vous pouvez attribuer cette option plusieurs fois.
fois, ou donnez plusieurs valeurs ensemble, séparées par des espaces. Si vous donnez plusieurs
valeurs, vous devrez peut-être les placer entre guillemets, selon le shell utilisé.
Les noms de fichiers intégrés doivent être indiqués avec des chemins absolus. Attention : ne pas utiliser ce format.
si l'une des options possède un argument tel qu'un nom de fichier qui pourrait contenir des espaces.
Dans ce cas, utilisez un ou plusieurs -javaoption options à la place. Voir aussi -vmoptions.
-jdk: | -testjdk:
Exécutez tous les tests à l'aide du JDK spécifié. par exemple -jdk:/usr/local/java/jdk1.5/solaris-sparc
-jit Activez le JIT pour les tests. Le JIT est activé par défaut.
-limitmods: [, ...]
Limiter l'univers des modules observables
-nojit Désactiver le JIT pour les tests.
-vmoption:
Toute autre option de machine virtuelle. Vous pouvez l'activer plusieurs fois. Toute machine virtuelle intégrée
Les noms de fichiers doivent être indiqués avec des chemins absolus. Cette option sera utilisée lorsque
Compilation et exécution de classes. Voir aussi -javaoption.
-vmoptions: ...
Autres options de machine virtuelle. Vous pouvez spécifier cette option plusieurs fois ou attribuer plusieurs valeurs.
ensemble, séparés par des espaces. Si vous indiquez plusieurs valeurs, vous devrez peut-être les inclure.
entre guillemets, selon le shell utilisé. Tous les noms de fichiers intégrés doivent être
donné avec des chemins absolus. Attention : n'utilisez pas ce formulaire si l'une des options a
un argument tel qu'un nom de fichier pouvant contenir des espaces. Dans ce cas, utilisez un ou plusieurs
plus -vmption options à la place. Cette option sera utilisée lors de la compilation et de l'exécution.
Cours. Voir aussi -optionsjava.
-X* Options VM non standard.
-Xbootclasspath:
Définir le chemin de recherche pour les classes et les ressources d'amorçage
-Xbootclasspath/un:
Ajouter à la fin du chemin de classe d'amorçage
-Xbootclasspath/p:
Préfixer devant le chemin de classe d'amorçage
-Xint* | -Xmixed* | -Xcomp*
Options de machine virtuelle non standard
-Xrunjcov*
Options pour exécuter jcov
-XX* | -Xms* | -Xmx*
Options de machine virtuelle non standard
Tests Spécification des collections de tests.
fichiers at
De longues listes d'options et de tests peuvent être encapsulées dans des fichiers at. Placez-les
options et/ou tests dans un fichier et spécifiez le nom du fichier sur la ligne de commande
avec @file. Les options ou tests contenant des espaces doivent être inclus dans
des guillemets simples ou doubles. Des commentaires peuvent être inclus dans le fichier en
en les préfixant par « # ». Pour spécifier une option commençant par « @ » dans la commande
ligne, utilisez "@@" pour éviter l'expansion de @file.
Groupes Une suite de tests peut définir des groupes de tests nommés. Pour spécifier le nom d'un groupe de
tests sur la ligne de commande, utilisez test-suite-dir:group-name, où test-suite-dir est un
chemin vers le répertoire racine de la suite de tests (c'est-à-dire le répertoire contenant le
fichier TEST.ROOT), et où group-name est le nom du groupe de tests défini dans
la suite de tests. Si test-suite-dir est omis, la valeur par défaut est la suivante : est
option, si elle est donnée, ou vers le répertoire courant dans le cas contraire. (Remarque : sous Windows, pour
éviter toute confusion avec les noms de chemin absolus incluant un spécificateur de lecteur, le
test-suite-dir ne doit pas être spécifié avec un chemin relatif composé d'un seul
lettre.)
Les groupes sont définis dans une suite de tests à l'aide d'un ou plusieurs Java
fichiers de propriétés. Les noms de ces fichiers doivent être répertoriés dans l'entrée « groupes » de
TEST.ROOT. Si le nom du fichier est entre crochets, aucun message d'erreur ne s'affichera.
donné si le fichier est introuvable. Dans les fichiers de propriétés, chaque entrée précise
éléments à inclure ou à exclure du groupe. Pour inclure un test ou un répertoire de
Pour les tests, il suffit de spécifier le nom du test ou du répertoire. Pour exclure un test ou
répertoire de tests, utilisez « - » suivi du nom du test ou du répertoire.
pour inclure le contenu d'un autre groupe, utilisez ':' suivi du nom du groupe.
Il ne doit pas y avoir d'espace entre le « - » ou le « : » et le nom qui suit.
Pour plus de détails et d'exemples, consultez l'aide en ligne. Vous pouvez y accéder directement depuis le
ligne de commande avec « -onlineHelp » ...", ou vous pouvez démarrer le harnais JavaTest et utiliser
le menu Aide.
jtreg peut également être exécuté avec Ant. Consultez l'aide en ligne pour plus de détails. Par exemple, utilisez
Option de ligne de commande « -onlineHelp ant ».
DROIT D'AUTEUR
Copyright © 1999, 2016, Oracle et/ou ses filiales. Tous droits réservés. Utilisation sous réserve de disponibilité.
aux termes de la licence.
options jtreg... tests...
Les tests peuvent être fournis sous forme de fichiers ou de dossiers contenant des fichiers de test, ou au moyen de groupes de tests.
De longues listes d'options et de tests peuvent être encapsulées dans des « fichiers at ».
Pour de brefs détails sur un sujet, utilisez "-help ...". L'argument est une commande
option ou un autre mot lié au sujet. Utilisez "-help all" pour afficher toute l'aide
entrées.
Des informations sont disponibles pour les sujets suivants.
Options détaillées
Ces options contrôlent la quantité de sortie écrite sur la console pendant l'exécution
tests
Options de documentation
Options pour une documentation supplémentaire
Options générales
Options de délai d'attente
Ces options contrôlent le comportement lorsque les tests s'exécutent plus longtemps que leur durée spécifiée.
valeur de délai d'attente.
Options de sélection des tests
Ces options peuvent être utilisées pour affiner l’ensemble des tests à exécuter.
Options du mode test
Chaque test se compose d'une série d'étapes, appelées actions. Le harnais jtreg fournit
différents modes, qui déterminent la JVM à utiliser pour exécuter chaque action. Le mode par défaut
consiste à exécuter chaque action dans une nouvelle JVM.
Options liées au JDK
Par défaut, les tests seront exécutés avec la JVM par défaut du JDK de test. Vous pouvez passer
toutes les options JVM applicables via l'utilisation -vmoption; en outre, la JVM la plus courante
Les options sont également prises en charge directement. Pour plus de détails sur chaque option, consultez le
documentation pour cette version du JDK, ou essayez d'utiliser « java -Aide" ou "java -X".
Si une option n'est pas applicable à une plate-forme ou à une version particulière du JDK, elle le sera.
rejeté.
Tests Spécification des collections de tests.
Pour plus de détails et d'exemples, consultez l'aide en ligne. Vous pouvez y accéder directement depuis le
ligne de commande avec « -onlineHelp » ...", ou vous pouvez démarrer le harnais JavaTest et utiliser
le menu Aide.
jtreg peut également être exécuté avec Ant. Consultez l'aide en ligne pour plus de détails. Par exemple, utilisez
Option de ligne de commande « -onlineHelp ant ».
Copyright © 1999, 2016, Oracle et/ou ses filiales. Tous droits réservés. Utilisation sous réserve de disponibilité.
aux termes de la licence.
Utilisez jtreg en ligne à l'aide des services onworks.net