japize — online w chmurze

PROGRAM:

IMIĘ

japize - Stwórz listę API w formacie do odczytu maszynowego.

STRESZCZENIE

japonia [rozsunąć suwak] [Jak ] pszczoła | ... +|- ...

OPIS

japonia jest częścią japitools, zaprojektowaną do testowania zgodności między interfejsami API Java.

Zostały pierwotnie zaprojektowane do testowania darmowych implementacji samej Javy
zgodności z pakietem JDK firmy Sun, ale można ich również używać do testowania kompatybilności wstecznej
między wersjami dowolnego API.

Narzędziami są japize i japicompat. Japize to program Java, który emituje listę plików
API w formacie do odczytu maszynowego. Następnie Japicompat bierze dwie takie listy i porównuje
je pod kątem kompatybilności binarnej, zgodnie z definicją firmy Sun w Specyfikacji języka Java.

Przynajmniej jeden + jest wymagane. będzie miał dodane ".japi" i/lub ".gz" jako
właściwe.

Słowo „apis” można zastąpić „jawnie”, „byname”, „packages” lub „classes”. Te
opcje wskazują, czy coś w postaci „abC” powinno być traktowane jako klasa czy a
pakiet. Możesz to jednoznacznie określić za pomocą jednego z formularzy „abcpackage” lub
"ab,CKlasa".

OPCJE

rozsunąć suwak wyłącz spakowanie danych wyjściowych za pomocą gzip. Spakowanie danych wyjściowych jest wysoce zalecane
ponieważ oszczędza ogromną ilość miejsca. Jedyne sytuacje, w których możesz nie chcieć
użycie kompresji gzip ma miejsce, gdy użycie pamięci i procesora jest bardzo ograniczone lub jeśli
twoja JVM nie implementuje poprawnie GZIPOutputStream (w takim przypadku możesz
nadal chcesz ręcznie spakować wynikowy plik gzip).

as
Określenie tej opcji każe japize zapisać swoje dane wyjściowe do pliku z rozszerzeniem
określona nazwa. Podczas zapisywania do pliku z opcją „as” japize nalega
zapisywanie do pliku o nazwie kończącej się na .japi.gz dla plików skompresowanych lub .japi dla
nieskompresowane pliki. Jeśli określona nazwa pliku nie ma odpowiedniego rozszerzenia,
japize doda do niego części, aby to zapewnić.

Jeśli opcja "as" zostanie pominięta, japize zapisze na standardowe wyjście. W tym przypadku
japize nie ma kontroli nad używaną nazwą pliku, ale jest to zdecydowanie zalecane
użyj nazwy pliku z poprawnym rozszerzeniem (.japi.gz), chyba że opcja „rozpakuj” była
określony). Jeśli używasz innego rozszerzenia, japicompat i inne narzędzia mogą być
nie można rozpoznać formatu.

pszczoła | wyraźnie | wg nazwy | Pakiety | Klasy
Ta opcja ma podwójną rolę: wskazuje granicę między opcjami japize
(unzip, as) i inne argumenty (pliki i pakiety), ale także mówi japize jak to zrobić
radzić sobie z niejednoznacznie określonymi argumentami. Zobacz "+|- " poniżej, aby uzyskać szczegółowe informacje nt
zachowanie każdej opcji. Jeśli nie masz pewności, który wybrać, „apis” to sejf
wybór.

pszczoła
abc jest wypróbowany zarówno jako pakiet, jak i klasa. To zawsze zrobi to, co chcesz
(dlatego apis jest opisywany jako bezpieczne ustawienie domyślne), ale kosztem prawdopodobnie
wykonując dodatkowe niepotrzebne przetwarzanie, próbując znaleźć niewłaściwą rzecz.

wyraźnie
ścieżki pkg w postaci abc są niedozwolone — należy użyć jawnej formy.

wg nazwy
abc zostanie przetworzone jako pakiet, jeśli „c” zaczyna się od małej litery lub jako a
class, jeśli zaczyna się od dużej litery. Zwykle robi to, co chcesz, ale kończy się niepowodzeniem
na rzeczach takich jak org.omg.CORBA.

Pakiety
abc zostanie przetworzony jako pakiet. Jeśli potrzebne jest przetwarzanie dla klasy, musi
być wyraźnie określone.

Klasy
abc będzie przetwarzane jako klasa. Jeśli potrzebne jest przetwarzanie dla paczki, musi
być wyraźnie określone.

|
Wszelkie argumenty po „apis”, które nie zaczynają się od „+” lub „-”, są traktowane jako argumenty
pliki zip lub katalogi. Powinny one być określone dokładnie tak, jakbyś je umieścił
twoja ŚCIEŻKA KLASY (z wyjątkiem oddzielenia spacjami, a nie dwukropkami). Wszystko, co jest
plik zostanie przyjęty jako plik zip (lub jar), więc nie można określić pliku .class
bezpośrednio - jeśli musisz to zrobić, powinieneś określić folder, który go zawiera i
następnie nazwij klasę do przetwarzania.

+|-
Aby określić, które klasy mają być uwzględnione, użyj +pkgpath, aby dodać pkgpath do przeskanowania
i -pkgpath, aby wykluczyć ich ścieżki podrzędne. MUSISZ określić co najmniej jeden
opcja +pkgpath, aby określić, która ścieżka pkg ma zostać uwzględniona, w przeciwnym razie Japize mógłby z radością
przeszukaj wszystkie pliki zip i katalogi, ale nie przetwarzaj żadnego z nich
klasy. Ponieważ byłoby to bezużyteczne, zamiast tego japize zwraca błąd.

„ścieżka pkg” odnosi się do pakietu (który przez dorozumianie obejmuje wszystkie podrzędne
jego pakiety) lub pojedynczą klasę. Ścieżka pkg dla pakietu wygląda tak
„com.foo.pkg.sub”, a ścieżka pkg dla klasy wygląda następująco „com.foo.pkg,Cls”. The
istnienie i umieszczenie przecinka wskazuje jednoznacznie, o jaki typ ścieżki chodzi
zamierzony.

Jednak przez większość czasu stawianie przecinków w nazwach jest uciążliwe
zamiast tego zaznajom się z kropkami i dokładnie umieść przecinek. Dla tego
dlatego japize akceptuje ścieżki pkg zawierające tylko kropki i pozwala ci powiedzieć, co ma robić
zrobić z tych imion. Interpretacja „abc” jako ścieżki pkg zależy od tego, czy
określiłeś interfejs API, jawnie, według nazwy, pakietów lub klas.

PRZYKŁAD

JDK 1.1 firmy Sun zawiera klasy w java.awt.peer i java.text.resources, które nie są
część publicznego API, mimo że są klasami publicznymi; jednak co druga klasa w
hierarchia pakietów java.* jest częścią publicznego interfejsu API. Składnia do skonstruowania użytecznego
jdk11.japi.gz będzie zatem:

$ japize jako jdk11 apisclass.zip +java -java.awt.peer -java.text.resources

Zauważ, że ponieważ wszystkie argumenty pkgpath tutaj są pakietami, możesz zaoszczędzić niewielką ilość
przetwarzanie, wykonując to zamiast tego:

$ japize jako pakiety jdk11 class.zip +java -java.awt.peer -java.text.resources

albo nawet to:

$ japize jako jdk11 jawnie class.zip +java, -java.awt.peer, -java.text.resources,

Korzystaj z japize online, korzystając z usług onworks.net