japonize - Online în cloud

PROGRAM:

NUME

japize - Produceți o listă a unui API într-un format care poate fi citit de mașină.

REZUMAT

japoneze [descomprimați] [la fel de ] apis | ... +|- ...

DESCRIERE

japoneze face parte din japitools, conceput pentru a testa compatibilitatea între API-urile Java.

Au fost concepute inițial pentru a testa implementările gratuite ale Java în sine
compatibilitatea cu JDK-ul Sun, dar pot fi utilizate și pentru testarea compatibilității cu versiunile inverse
între versiunile oricărui API.

Instrumentele sunt japize și japicompat. Japize este un program Java care emite o listă de un
API într-un format care poate fi citit de mașină. Japicompat ia apoi două astfel de listări și compară
pentru compatibilitate binară, așa cum este definită de Sun în specificația limbajului Java.

Cel puțin un + este necesară. va avea „.japi” și/sau „.gz” adăugat ca
corespunzătoare.

Cuvântul „apis” poate fi înlocuit cu „explicit”, „byname”, „pachet” sau „clases”. Aceste
opțiunile indică dacă ceva din forma „abC” ar trebui tratat ca o clasă sau a
pachet. Puteți specifica acest lucru fără ambiguitate utilizând una dintre formele „abcpackage” sau
„ab,CCclass”.

OPŢIUNI

dezarhivați dezactivați comprimarea ieșirii cu gzip. Arhivarea ieșirii este foarte recomandată
deoarece economisește cantități uriașe de spațiu. Singurele situații în care s-ar putea să nu vrei
pentru a utiliza compresia gzip sunt atunci când memoria și utilizarea procesorului sunt extrem de strânse sau dacă
JVM-ul dvs. nu implementează corect GZIPOutputStream (caz în care ați putea
încă mai doriți să gzip fișierul rezultat manual).

as
Specificarea acestei opțiuni îi spune japize să își scrie rezultatul într-un fișier cu
numele specificat. Când scrieți într-un fișier cu opțiunea „ca”, japize insistă
scrierea într-un nume de fișier care se termină în .japi.gz pentru fișierele comprimate sau .japi pentru
fișiere necomprimate. Dacă numele fișierului pe care îl specificați nu are extensia potrivită,
japonize va adăuga părți pentru a se asigura că o face.

Dacă opțiunea „ca” este omisă, japize va scrie la ieșirea standard. În acest caz
japize nu are control asupra numelui de fișier pe care îl utilizați, dar este recomandat să o facă
utilizați un nume de fișier cu extensia corectă (.japi.gz), cu excepția cazului în care opțiunea „dezarhivare” a fost
specificat). Dacă utilizați orice altă extensie, japicompat și alte instrumente pot fi
incapabil să recunoască formatul.

apis | explicit | dupa nume | ofertele | clase
Această opțiune are un rol dublu: indică granița dintre opțiunile japize
(unzip, as) și alte argumente (fișiere și pachete), dar îi spune și japize cum
se ocupă de argumente specificate în mod ambiguu. Vezi „+|- " mai jos pentru detalii despre
comportamentul fiecărei opțiuni. Dacă nu sunteți sigur ce să specificați, „apis” este un seif
alegere.

apis
abc este încercat atât ca pachet, cât și ca clasă. Acest lucru va face întotdeauna ceea ce doriți
(de aceea apis este descris ca implicit sigur), dar în detrimentul posibil
efectuând procesări suplimentare inutile încercând să găsească lucrul greșit.

explicit
pkgpaths cu forma abc sunt ilegale - trebuie să utilizați formularul explicit.

dupa nume
abc va fi procesat ca un pachet dacă „c” începe cu o literă mică sau ca a
clasa dacă începe cu una mare. Acest lucru face de obicei ceea ce vrei, dar nu reușește
pe lucruri precum org.omg.CORBA.

ofertele
abc va fi procesat ca un pachet. Dacă este necesară procesarea pentru o clasă, aceasta trebuie
fi specificat în mod explicit.

clase
abc va fi procesat ca o clasă. Dacă este necesară procesarea unui pachet, aceasta trebuie
fi specificat în mod explicit.

|
Orice argumente după „apis” care nu încep cu „+” sau „-” sunt considerate a fi
fișiere zip sau directoare. Acestea ar trebui specificate exact așa cum le-ați introduce
CLASSPATH-ul dvs. (cu excepția celor separate prin spații și nu prin două puncte). Orice este a
fișierul se va presupune a fi un fișier zip (sau jar), așa că nu puteți specifica un fișier .class
direct - dacă trebuie să faceți asta, ar trebui să specificați folderul care îl conține și
apoi denumește clasa pentru procesare.

+|-
Pentru a specifica ce clase sunt incluse, utilizați +pkgpath pentru a adăuga pkgpaths care urmează să fie scanat
și -pkgpath pentru a exclude sub-pkgpath ale acestora. TREBUIE să specificați cel puțin unul
+pkgpath opțiunea pentru a specifica ce pkgpath să includă, altfel Japize ar putea cu plăcere
scanează prin toate fișierele zip și directoarele, dar nu procesează de fapt niciunul dintre
clase. Deoarece ar fi un lucru inutil de făcut, japize dă o eroare în schimb.

Un „pkgpath” se referă fie la un pachet (care include, implicit, toate sub-
pachete din acesta) sau o singură clasă. Un pkgpath pentru un pachet arată ca
„com.foo.pkg.sub”, iar un pkgpath pentru o clasă arată ca „com.foo.pkg,Cls”. The
existența și plasarea virgulei indică fără ambiguitate ce tip de cale este
intenționat.

De cele mai multe ori, totuși, este o durere să fii nevoit să pui virgulă în nume care sunt
în schimb, familiarizați-vă cu punctele și obțineți plasarea virgulelor exact corect. Pentru aceasta
motiv, japize acceptă pkgpaths care conțin doar puncte și vă permite să-i spuneți ce să facă
face din acele nume. Interpretarea lui „abc” ca pkgpath depinde dacă
ați specificat apis, în mod explicit, după nume, pachete sau clase.

EXEMPLU

Sun JDK 1.1 include clase în java.awt.peer și în java.text.resources care nu sunt
parte a API-ului public, chiar dacă sunt clase publice; cu toate acestea, orice altă clasă în
ierarhia pachetelor java.* face parte din API-ul public. Sintaxa pentru a construi un util
jdk11.japi.gz ar fi prin urmare:

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

Rețineți că, deoarece toate argumentele pkgpath de aici sunt pachete, puteți salva o cantitate mică de
procesare făcând acest lucru în schimb:

$ japize ca pachete jdk11 classes.zip +java -java.awt.peer -java.text.resources

sau chiar asta:

$ japize ca jdk11 explicit classes.zip +java, -java.awt.peer, -java.text.resources,

Utilizați japonize online folosind serviciile onworks.net