japize - Online nel cloud

PROGRAMMA:

NOME

japize - Produce un elenco di un'API in un formato leggibile dalla macchina.

SINOSSI

giapponese [decomprimere] [come ] apis | ... +|- ...

DESCRIZIONE

giapponese fa parte di japitools, progettato per testare la compatibilità tra le API Java.

Sono stati originariamente progettati per testare implementazioni gratuite di Java stesso per
compatibilità con JDK di Sun, ma possono anche essere utilizzati per testare la compatibilità con le versioni precedenti
tra le versioni di qualsiasi API.

Gli strumenti sono japize e japicompat. Japize è un programma Java che emette un elenco di an
API in un formato leggibile dalla macchina. Japicompat quindi prende due di questi elenchi e confronta
per la compatibilità binaria, come definito da Sun nella specifica del linguaggio Java.

Almeno un + è obbligatorio. avrà ".japi" e/o ".gz" aggiunti come
appropriato.

La parola "apis" può essere sostituita da "esplicitamente", "per nome", "pacchetti" o "classi". Queste
le opzioni indicano se qualcosa della forma "abC" deve essere trattato come una classe o a
pacchetto. Puoi specificarlo senza ambiguità utilizzando uno dei moduli "abcpackage" o
"ab,CClass".

VERSIONI

decomprimere disabilita lo zippare dell'output con gzip. Zippare l'output è altamente raccomandato
poiché consente di risparmiare enormi quantità di spazio. Le uniche situazioni in cui potresti non volere
usare la compressione gzip sono quando l'utilizzo della memoria e della CPU è estremamente limitato o se
la tua JVM non implementa correttamente GZIPOutputStream (nel qual caso potresti
vuoi ancora gzip manualmente il file risultante).

as
Specificando questa opzione si dice a japize di scrivere il proprio output in un file con il
nome specificato. Quando si scrive su un file con l'opzione "as", japize insiste su
scrivere su un nome di file che termina con .japi.gz per file compressi o .japi per
file non compressi. Se il nome del file specificato non ha l'estensione corretta,
japize aggiungerà parti per assicurarsi che lo faccia.

Se l'opzione "as" viene omessa, japize scriverà sullo standard output. In questo caso
japize non ha alcun controllo sul nome del file che usi, ma è fortemente raccomandato
usa un nome di file con l'estensione corretta (.japi.gz" a meno che l'opzione "unzip" non fosse
specificato). Se usi qualsiasi altra estensione, japicompat e altri strumenti potrebbero essere
impossibile riconoscere il formato.

apis | espressamente | per nome | Packages | classi
Questa opzione ha un duplice ruolo: indica il confine tra le opzioni japize
(unzip, as) e altri argomenti (file e pacchetti), ma dice anche a japize come fare
trattare argomenti specificati in modo ambiguo. Vedi "+|- " di seguito per i dettagli su
il comportamento di ciascuna opzione. Se non sei sicuro di quale specificare, "apis" è sicuro
scelta.

apis
abc viene provato sia come pacchetto che come classe. Questo farà sempre quello che vuoi
(motivo per cui apis è descritto come l'impostazione predefinita sicura) ma a spese di possibilmente
facendo un'elaborazione extra non necessaria cercando di trovare la cosa sbagliata.

espressamente
pkgpaths della forma abc sono illegali - devi usare la forma esplicita.

per nome
abc verrà elaborato come un pacchetto se "c" inizia con una lettera minuscola o come a
class se inizia con una maiuscola. Questo di solito fa quello che vuoi ma fallisce
su cose come org.omg.CORBA.

Packages
abc verrà elaborato come un pacchetto. Se è necessaria l'elaborazione per una classe, deve
essere specificato esplicitamente.

classi
abc verrà elaborato come una classe. Se è necessaria l'elaborazione per un pacchetto, deve
essere specificato esplicitamente.

|
Qualsiasi argomento dopo "apis" che non inizia con "+" o "-" viene considerato
zipfile o directory. Questi dovrebbero essere specificati esattamente come li inseriresti
il tuo CLASSPATH (tranne separato da spazi anziché da due punti). Tutto ciò che è un
si presuppone che il file sia un file zip (o jar), quindi non è possibile specificare un file .class
direttamente - se hai bisogno di farlo dovresti specificare la cartella che lo contiene e
quindi nominare la classe per l'elaborazione.

+|-
Per specificare quali classi sono incluse, usa +pkgpath per aggiungere pkgpaths da scansionare
e -pkgpath per escludere i sub-pkgpath di questi. DEVI specificarne almeno uno
+pkgpath opzione per specificare quale pkgpath includere, altrimenti Japize potrebbe felicemente
scansiona tutti i file zip e le directory ma non elabora effettivamente nessuno dei
classi. Dal momento che sarebbe una cosa inutile da fare, japize dà invece un errore.

Un "pkgpath" si riferisce a un pacchetto (che include, implicitamente, tutti i sub-
pacchetti di esso) o una singola classe. Un pkgpath per un pacchetto assomiglia a
"com.foo.pkg.sub" e un pkgpath per una classe assomiglia a "com.foo.pkg,Cls". Il
l'esistenza e il posizionamento della virgola indicano inequivocabilmente quale tipo di percorso è
previsto.

La maggior parte delle volte, però, è una seccatura dover mettere le virgole nei nomi che sono
familiarità con i punti invece e ottenere la posizione della virgola esattamente corretta. Per questo
ragione, japize accetta pkgpaths contenenti solo punti e ti consente di dirgli cosa fare
fare di quei nomi. L'interpretazione di "abc" come pkgpath dipende dal fatto che
hai specificato API, in modo esplicito, per nome, pacchetti o classi.

ESEMPIO

JDK 1.1 di Sun include classi in java.awt.peer e in java.text.resources che non lo sono
parte dell'API pubblica, anche se sono classi pubbliche; tuttavia, ogni altra classe in
la gerarchia del pacchetto java.* fa parte dell'API pubblica. La sintassi per costruire un utile
jdk11.japi.gz sarebbe quindi:

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

Nota che poiché tutti gli argomenti pkgpath qui sono pacchetti, potresti risparmiare una piccola quantità di
elaborazione facendo invece questo:

$ japize come pacchetti jdk11 classes.zip +java -java.awt.peer -java.text.resources

o anche questo:

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

Usa japize online utilizzando i servizi onworks.net