japize - Online in de cloud

PROGRAMMA:

NAAM

japize - Produceer een lijst van een API in een machinaal leesbaar formaat.

KORTE INHOUD

japen [uitpakken] [als ] apis | ... +|- ...

PRODUCTBESCHRIJVING

japen is onderdeel van japitools, ontworpen om te testen op compatibiliteit tussen Java API's.

Ze waren oorspronkelijk ontworpen voor het testen van gratis implementaties van Java zelf
compatibiliteit met Sun's JDK, maar ze kunnen ook worden gebruikt voor het testen van achterwaartse compatibiliteit
tussen versies van welke API dan ook.

De tools zijn japize en japicompat. Japize is een Java-programma dat een lijst met een
API in een machinaal leesbaar formaat. Japicompat neemt vervolgens twee van dergelijke vermeldingen en vergelijkt deze
ze op binaire compatibiliteit, zoals gedefinieerd door Sun in de Java Language Specification.

Minstens één + Is benodigd. zal ".japi" en/of ".gz" toegevoegd worden als
geschikt.

Het woord "apis" kan worden vervangen door "expliciet", "bijnaam", "pakketten" of "klassen". Deze
opties geven aan of iets in de vorm "abC" als een klasse of als a moet worden behandeld
pakket. U kunt dit ondubbelzinnig aangeven door gebruik te maken van één van de formulieren "abcpakket", of
"ab,CKlasse".

OPTIES

unzip schakel het zippen van de uitvoer uit met gzip. Het wordt sterk aanbevolen om de uitvoer te zippen
omdat het enorme hoeveelheden ruimte bespaart. De enige situaties waarin je dat misschien niet wilt
gzip-compressie gebruiken is wanneer het geheugen- en CPU-gebruik extreem krap is of als
uw JVM implementeert GZIPOutputStream niet correct (in dat geval zou u dat wel kunnen doen).
wil je het resulterende bestand nog steeds handmatig gzippen).

as
Het specificeren van deze optie vertelt japize om de uitvoer naar een bestand met de extensie
opgegeven naam. Bij het schrijven naar een bestand met de "as"-optie staat japize erop
schrijven naar een bestandsnaam die eindigt op .japi.gz voor gecomprimeerde bestanden, of .japi voor
ongecomprimeerde bestanden. Als de bestandsnaam die u opgeeft niet de juiste extensie heeft,
japize zal er onderdelen aan toevoegen om ervoor te zorgen dat dit het geval is.

Als de optie "as" wordt weggelaten, zal japize naar de standaarduitvoer schrijven. In dit geval
japize heeft geen controle over de bestandsnaam die u gebruikt, maar het wordt sterk aanbevolen
gebruik een bestandsnaam met de juiste extensie (".japi.gz" tenzij de optie "unzip" was
opgegeven). Als u een andere extensie gebruikt, kunnen japicompat en andere tools dat ook zijn
kan het formaat niet herkennen.

apis | uitdrukkelijk | bij naam | Paketten | klassen
Deze optie heeft een dubbele rol: zij geeft de grens aan tussen japize-opties
(unzip, as) en andere argumenten (bestanden en pakketten), maar vertelt japize ook hoe dat moet
omgaan met dubbelzinnig gespecificeerde argumenten. Zie "+|- " hieronder voor meer informatie
het gedrag van elke optie. Als u niet zeker weet wat u moet opgeven, is 'apis' een kluis
keuze.

apis
abc wordt zowel als pakket als als klasse geprobeerd. Dit zal altijd doen wat je wilt
(daarom wordt apis beschreven als de veilige standaard), maar ten koste van eventueel
extra onnodige verwerking uitvoeren om het verkeerde te vinden.

uitdrukkelijk
pkgpaths van de vorm abc zijn illegaal - je moet de expliciete vorm gebruiken.

bij naam
abc wordt als pakket verwerkt als "c" begint met een kleine letter, of als a
class als deze begint met een hoofdletter. Dit doet meestal wat je wilt, maar faalt
op zaken als org.omg.CORBA.

Paketten
abc wordt als pakket verwerkt. Als verwerking voor een klasse nodig is, moet dat ook gebeuren
expliciet worden vermeld.

klassen
abc wordt als klasse verwerkt. Als verwerking voor een pakket nodig is, moet dat ook gebeuren
expliciet worden vermeld.

|
Alle argumenten na "apis" die niet beginnen met "+" of "-" worden als zodanig beschouwd
zip-bestanden of mappen. Deze moeten precies worden gespecificeerd zoals u ze zou invoeren
uw CLASSPATH (behalve gescheiden door spaties in plaats van dubbele punten). Alles wat een
Er wordt aangenomen dat het bestand een zip-bestand (of jar-bestand) is, dus u kunt geen .class-bestand opgeven
direct - als u dat moet doen, moet u de map opgeven die het bevat en
geef vervolgens de klasse een naam voor verwerking.

+|-
Om te specificeren welke klassen zijn opgenomen, gebruikt u +pkgpath om pkgpaths toe te voegen die moeten worden gescand
en -pkgpath om sub-pkgpath hiervan uit te sluiten. U MOET er minstens één specificeren
+pkgpath optie om te specificeren welk pkgpath moet worden opgenomen, anders zou Japize dat met plezier kunnen doen
scan door alle zip-bestanden en mappen, maar verwerk geen van de
klassen. Omdat dat nutteloos zou zijn, geeft japize in plaats daarvan een foutmelding.

Een "pkgpath" verwijst naar een pakket (dat impliciet alle sub-
pakketten ervan) of een enkele klasse. Een pkgpath voor een pakket ziet er als volgt uit
"com.foo.pkg.sub," en een pkgpath voor een klasse ziet eruit als "com.foo.pkg,Cls". De
het bestaan ​​en de plaatsing van de komma geeft ondubbelzinnig aan welk type pad het is
bedoeld.

Meestal is het echter vervelend om komma's te moeten plaatsen in namen die dat wel zijn
vertrouwd met punten, en zorg ervoor dat de kommaplaatsing precies goed is. Voor deze
Daarom accepteert japize pkgpaths die alleen punten bevatten, en laat jij hem vertellen wat hij moet doen
maken van die namen. De interpretatie van "abc" als pkgpath hangt ervan af of
u hebt expliciet api's, bijnaam, pakketten of klassen opgegeven.

VOORBEELD

Sun's JDK 1.1 bevat klassen in java.awt.peer en in java.text.resources die dat niet zijn
onderdeel van de publieke API, ook al zijn het publieke klassen; echter, elke andere klas in
de pakkethiërarchie java.* maakt deel uit van de openbare API. De syntaxis om een ​​bruikbaar bestand te construeren
jdk11.japi.gz zou daarom zijn:

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

Merk op dat, aangezien alle pkgpath-argumenten hier pakketten zijn, u er een kleine hoeveelheid van kunt besparen
verwerken door in plaats daarvan dit te doen:

$ japize als jdk11-pakketten klassen.zip +java -java.awt.peer -java.text.resources

of zelfs dit:

$ japize als jdk11 expliciet klassen.zip +java, -java.awt.peer, -java.text.resources,

Gebruik japize online met behulp van onworks.net-services