japize – Online in der Cloud

PROGRAMM:

NAME/FUNKTION

japize – Erstellen Sie eine Auflistung einer API in einem maschinenlesbaren Format.

ZUSAMMENFASSUNG

japize [entpacken] [als ] apis | ... +|- ...

BESCHREIBUNG

japize ist Teil von japitools und wurde entwickelt, um die Kompatibilität zwischen Java-APIs zu testen.

Sie wurden ursprünglich zum Testen kostenloser Implementierungen von Java selbst entwickelt
Kompatibilität mit Suns JDK, sie können aber auch zum Testen der Abwärtskompatibilität verwendet werden
zwischen Versionen einer beliebigen API.

Die Tools sind japize und japicompat. Japize ist ein Java-Programm, das eine Liste von an ausgibt
API in einem maschinenlesbaren Format. Japicompat nimmt dann zwei solcher Auflistungen und vergleicht sie
sie aus Gründen der Binärkompatibilität, wie von Sun in der Java Language Specification definiert.

Mindestens ein + ist erforderlich. wird „.japi“ und/oder „.gz“ angehängt
angemessen.

Das Wort „apis“ kann durch „explicitly“, „byname“, „packages“ oder „classes“ ersetzt werden. Diese
Optionen geben an, ob etwas in der Form „abC“ als Klasse oder als a behandelt werden soll
Paket. Sie können dies eindeutig angeben, indem Sie eine der Formen „abcpackage“ oder verwenden
„ab,CClass“.

OPTIONAL

entpacken Deaktivieren Sie das Zippen der Ausgabe mit gzip. Es wird dringend empfohlen, die Ausgabe zu komprimieren
da es enorm viel Platz spart. Die einzigen Situationen, in denen Sie möglicherweise nicht möchten
Die Verwendung der gzip-Komprimierung erfolgt, wenn die Speicher- und CPU-Auslastung extrem knapp ist oder wenn
Ihre JVM implementiert GZIPOutputStream nicht korrekt (in diesem Fall könnten Sie
Ich möchte die resultierende Datei immer noch manuell komprimieren.

as
Durch Angabe dieser Option wird japize angewiesen, seine Ausgabe in eine Datei mit dem zu schreiben
angegebenen Namen. Beim Schreiben in eine Datei mit der Option „as“ besteht japize darauf
Schreiben in einen Dateinamen mit der Endung .japi.gz für komprimierte Dateien oder .japi für
unkomprimierte Dateien. Wenn der von Ihnen angegebene Dateiname nicht die richtige Erweiterung hat,
japize wird Teile hinzufügen, um sicherzustellen, dass dies der Fall ist.

Wenn die Option „as“ weggelassen wird, schreibt japize in die Standardausgabe. In diesem Fall
japize hat keine Kontrolle über den von Ihnen verwendeten Dateinamen, es wird jedoch dringend empfohlen, dies zu tun
Verwenden Sie einen Dateinamen mit der richtigen Erweiterung („.japi.gz“, es sei denn, die Option „unzip“ war aktiviert
angegeben). Wenn Sie eine andere Erweiterung verwenden, können dies Japicompat und andere Tools sein
Ich kann das Format nicht erkennen.

apis | explizit | namentlich | Pakete | Unterricht
Diese Option hat eine doppelte Rolle: Sie zeigt die Grenze zwischen japize-Optionen an
(unzip, as) und andere Argumente (Dateien und Pakete), sagt japize aber auch, wie es geht
Umgang mit mehrdeutig spezifizierten Argumenten. Siehe „+|- " weiter unten finden Sie Einzelheiten dazu
das Verhalten jeder Option. Wenn Sie nicht sicher sind, was Sie angeben sollen: „apis“ ist sicher
Wahl.

apis
abc wird sowohl als Paket als auch als Klasse ausprobiert. Dies wird immer das tun, was Sie wollen
(weshalb APIs als sicherer Standard bezeichnet wird), aber auf Kosten von möglicherweise
zusätzliche unnötige Verarbeitung durchführen, um das Falsche zu finden.

explizit
Paketpfade der Form abc sind illegal – Sie müssen die explizite Form verwenden.

namentlich
abc wird als Paket verarbeitet, wenn „c“ mit einem Kleinbuchstaben beginnt, oder als a
Klasse, wenn sie mit einem Großbuchstaben beginnt. Dies macht normalerweise das, was Sie wollen, schlägt jedoch fehl
auf Dingen wie org.omg.CORBA.

Pakete
abc wird als Paket verarbeitet. Wenn eine Verarbeitung für eine Klasse erforderlich ist, muss dies geschehen
explizit angegeben werden.

Unterricht
abc wird als Klasse verarbeitet. Wenn eine Verarbeitung für ein Paket erforderlich ist, muss dies geschehen
explizit angegeben werden.

|
Alle Argumente nach „apis“, die nicht mit „+“ oder „-“ beginnen, werden als Argumente angesehen
ZIP-Dateien oder Verzeichnisse. Diese sollten genau so angegeben werden, wie Sie sie eingeben würden
Ihr CLASSPATH (außer durch Leerzeichen statt Doppelpunkte getrennt). Alles, was ein ist
Es wird davon ausgegangen, dass es sich bei der Datei um eine ZIP- (oder JAR-)Datei handelt, sodass Sie keine .class-Datei angeben können
direkt – wenn Sie dies tun müssen, sollten Sie den Ordner angeben, der es enthält und
Benennen Sie dann die zu verarbeitende Klasse.

+|-
Um anzugeben, welche Klassen enthalten sind, verwenden Sie +pkgpath, um zu scannende Paketpfade hinzuzufügen
und -pkgpath, um Unterpaketpfade davon auszuschließen. Sie MÜSSEN mindestens einen angeben
+pkgpath-Option, um anzugeben, welcher pkgpath eingeschlossen werden soll, andernfalls könnte Japize das problemlos tun
Durchsuchen Sie alle ZIP-Dateien und Verzeichnisse, verarbeiten Sie jedoch keine davon
Klassen. Da dies sinnlos wäre, gibt japize stattdessen einen Fehler aus.

Ein „pkgpath“ bezieht sich entweder auf ein Paket (das implizit alle untergeordneten Pakete enthält).
Pakete davon) oder eine einzelne Klasse. Ein pkgpath für ein Paket sieht so aus
„com.foo.pkg.sub“ und ein Paketpfad für eine Klasse sieht wie „com.foo.pkg,Cls“ aus. Der
Das Vorhandensein und die Platzierung des Kommas geben eindeutig an, um welche Art von Pfad es sich handelt
beabsichtigt.

Meistens ist es jedoch mühsam, in solche Namen Kommas einfügen zu müssen
Machen Sie sich stattdessen mit Punkten vertraut und setzen Sie die Kommas genau richtig. Dafür
Aus diesem Grund akzeptiert japize pkgpaths, die nur Punkte enthalten, und lässt Sie ihm sagen, was es tun soll
Machen Sie aus diesen Namen. Die Interpretation von „abc“ als Paketpfad hängt davon ab, ob
Sie haben APIs explizit, namentlich, Pakete oder Klassen angegeben.

BEISPIEL

Suns JDK 1.1 enthält Klassen in java.awt.peer und in java.text.resources, die nicht vorhanden sind
Teil der öffentlichen API, auch wenn es sich um öffentliche Klassen handelt; jedoch jede zweite Klasse in
Die Pakethierarchie java.* ist Teil der öffentlichen API. Die Syntax zum Erstellen eines nützlichen
jdk11.japi.gz wäre also:

$ japize as jdk11 apisclasses.zip +java -java.awt.peer -java.text.resources

Beachten Sie, dass Sie eine kleine Menge davon einsparen könnten, da es sich hier bei allen pkgpath-Argumenten um Pakete handelt
Verarbeitung, indem Sie stattdessen Folgendes tun:

$ japize als JDK11-Paketeclasses.zip +java -java.awt.peer -java.text.resources

oder sogar das:

$ japize as jdk11 explizit groups.zip +java, -java.awt.peer, -java.text.resources,

Nutzen Sie japize online über die Dienste von onworks.net