japize - En ligne dans le Cloud

PROGRAMME:

Nom

japize - Produire une liste d'une API dans un format lisible par machine.

SYNOPSIS

japiser [décompresser] [comme ] apis | +|-

DESCRIPTION

japiser fait partie de japitools, conçu pour tester la compatibilité entre les API Java.

Ils ont été conçus à l'origine pour tester les implémentations libres de Java lui-même pour
compatibilité avec le JDK de Sun, mais ils peuvent également être utilisés pour tester la rétrocompatibilité
entre les versions de n'importe quelle API.

Les outils sont japize et japicompat. Japize est un programme Java qui émet une liste d'un
API dans un format lisible par machine. Japicompat prend ensuite deux de ces listes et compare
pour la compatibilité binaire, comme défini par Sun dans la spécification du langage Java.

Au moins un + est requis. aura ".japi" et/ou ".gz" ajouté comme
approprié.

Le mot "apis" peut être remplacé par "explicitement", "byname", "packages" ou "classes". Ces
les options indiquent si quelque chose de la forme "abC" doit être traité comme une classe ou un
emballer. Vous pouvez le spécifier sans ambiguïté en utilisant l'un des formulaires « abcpackage », ou
"ab,Classe C".

OPTIONS

ouvrir désactiver la compression de la sortie avec gzip. Il est fortement recommandé de compresser la sortie
car il économise d'énormes quantités d'espace. Les seules situations où vous pourriez ne pas vouloir
utiliser la compression gzip lorsque l'utilisation de la mémoire et du processeur est extrêmement limitée ou si
votre JVM n'implémente pas correctement GZIPOutputStream (auquel cas vous pourriez
voulez toujours gzip le fichier résultant manuellement).

as
Spécifier cette option indique à japize d'écrire sa sortie dans un fichier avec le
nom spécifié. Lors de l'écriture dans un fichier avec l'option "as", japize insiste sur
écrire dans un nom de fichier se terminant par .japi.gz pour les fichiers compressés, ou .japi pour
fichiers non compressés. Si le nom de fichier que vous spécifiez n'a pas la bonne extension,
japize y ajoutera des pièces pour s'assurer qu'il le fait.

Si l'option "as" est omise, japize écrira sur la sortie standard. Dans ce cas
japize n'a aucun contrôle sur le nom de fichier que vous utilisez, mais il est fortement recommandé de
utilisez un nom de fichier avec l'extension correcte (".japi.gz" à moins que l'option "unzip" n'ait été
spécifié). Si vous utilisez une autre extension, japicompat et d'autres outils peuvent être
incapable de reconnaître le format.

apis | explicitement | de nom | Forfaits | les classes
Cette option a un double rôle : elle indique la frontière entre les options japize
(unzip, as) et d'autres arguments (fichiers et packages), mais indique également à japize comment
traiter des arguments spécifiés de manière ambiguë. Voir "+|- " ci-dessous pour plus de détails sur
le comportement de chaque option. Si vous ne savez pas lequel spécifier, "apis" est un coffre-fort
choix.

apis
abc est essayé à la fois en tant que package et en tant que classe. ça fera toujours ce que tu veux
(c'est pourquoi apis est décrit comme la valeur par défaut sûre) mais au détriment éventuellement
faire un traitement supplémentaire inutile en essayant de trouver la mauvaise chose.

explicitement
Les chemins pkg de la forme abc sont illégaux - vous devez utiliser la forme explicite.

de nom
abc sera traité comme un package si "c" commence par une lettre minuscule, ou comme un
classe si elle commence par une majuscule. Cela fait généralement ce que vous voulez mais échoue
sur des choses comme org.omg.CORBA.

Forfaits
abc sera traité comme un package. Si le traitement d'une classe est nécessaire, il doit
être spécifié explicitement.

les classes
abc sera traité comme une classe. Si le traitement d'un colis est nécessaire, il doit
être spécifié explicitement.

|
Tous les arguments après "apis" qui ne commencent pas par "+" ou "-" sont considérés comme
zipfiles ou répertoires. Ceux-ci doivent être spécifiés exactement comme vous les auriez mis dans
votre CLASSPATH (sauf séparés par des espaces plutôt que des deux-points). Tout ce qui est un
le fichier sera supposé être un fichier zip (ou jar), vous ne pouvez donc pas spécifier un fichier .class
directement - si vous devez le faire, vous devez spécifier le dossier qui le contient et
puis nommez la classe à traiter.

+|-
Pour spécifier quelles classes sont incluses, utilisez +pkgpath pour ajouter des pkgpaths à analyser
et -pkgpath pour exclure les sous-pkgpaths de ceux-ci. Vous DEVEZ spécifier au moins un
+ option pkgpath pour spécifier quel pkgpath à inclure, sinon Japize pourrait se faire plaisir
parcourir tous les fichiers zip et répertoires mais ne traiter aucun des
Des classes. Comme ce serait une chose inutile à faire, japize renvoie une erreur à la place.

Un "pkgpath" fait référence soit à un package (qui inclut, par implication, tous les sous-
paquets de celui-ci) ou une seule classe. Un pkgpath pour un paquet ressemble à
« com.foo.pkg.sub » et un chemin pkg pour une classe ressemble à « com.foo.pkg,Cls ». Les
l'existence et le placement de la virgule indiquent sans ambiguïté quel type de chemin est
prévu.

La plupart du temps, cependant, c'est pénible de devoir mettre des virgules dans des noms qui sont
familiarisez-vous avec les points à la place et obtenez exactement le bon placement des virgules. Pour ça
raison, japize accepte les pkgpaths contenant uniquement des points et vous permet de lui dire quoi faire
faire de ces noms. L'interprétation de " abc " comme un pkgpath dépend de si
vous avez spécifié des API, explicitement, par nom, des packages ou des classes.

EXEMPLE

Le JDK 1.1 de Sun inclut des classes dans java.awt.peer et dans java.text.resources qui ne sont pas
font partie de l'API publique, même s'il s'agit de classes publiques ; cependant, toutes les autres classes de
la hiérarchie des packages java.* fait partie de l'API publique. La syntaxe pour construire un utile
jdk11.japi.gz serait donc :

$ japize comme jdk11 apis classes.zip +java -java.awt.peer -java.text.resources

Notez que puisque tous les arguments pkgpath ici sont des packages, vous pouvez économiser une petite quantité de
traitement en faisant ceci à la place :

$ japize en tant que packages jdk11 classes.zip +java -java.awt.peer -java.text.resources

ou même ceci :

$ japize as jdk11 explicitement classes.zip +java, -java.awt.peer, -java.text.resources,

Utiliser japize en ligne en utilisant les services onworks.net