japicompat - Online sa Cloud

PROGRAMA:

NAME

japicompat - Subukan ang mga Java API para sa binary backwards compatibility.

SINOPSIS

japicompat [-svqhtjw4] [-alinman outfile] [-i ignorefiles]

DESCRIPTION

japicompat ay bahagi ng japitools, na idinisenyo upang subukan ang pagiging tugma sa pagitan ng mga Java API.

Ang mga ito ay orihinal na idinisenyo para sa pagsubok ng mga libreng pagpapatupad ng Java mismo para sa
compatibility sa Sun's JDK, ngunit magagamit din ang mga ito para sa pagsubok ng backward compatibility
sa pagitan ng mga bersyon ng anumang API.

Ang mga gamit ay japize at japicompat. Ang Japize ay isang Java program na naglalabas ng listahan ng isang
API sa isang format na nababasa ng makina. Ang Japicompat ay kukuha ng dalawang ganoong listahan at naghahambing
ang mga ito para sa binary compatibility, gaya ng tinukoy ng Sun sa Java Language Specification.

Opsyon

-s huwag paganahin ang mga karagdagang binary compatibility checks (ang mga tseke lang ang tinukoy ng JLS).

-v paganahin ang mga pagsusuri para sa maliliit na problema sa compatibility.

Pagsusuri ng SerialVersionUID: nag-uulat ang japicompat ng maliit na error kung isang Serializable na klase
ay may ibang SerialVersionUID sa pagitan ng dalawang release.

Pagsusuri sa paghinto sa paggamit: nag-uulat ang japicompat ng isang maliit na error kung ang isang klase o miyembro ay
hindi na ginagamit sa orihinal na API ngunit hindi na ginagamit sa API na sinusuri.

-q hindi pinapagana ang mga ulat sa pag-unlad.

-h bumubuo ng output sa HTML na format. Ang mga HTML file na ginawa ay nakadepende sa japi.css
file upang makakuha ng kaakit-akit na presentasyon.

-t bumubuo ng output sa format ng teksto. Ito ang default.

-j bumubuo ng output sa raw machine readable form. Ang format na ginawa ay tinatawag
"japio" na format, at ayon sa convention ay dapat i-save gamit ang ".japio" na file extension.
Maaaring gamitin ang standalone na japiotext at japiohtml utilities para i-convert ang format na ito
sa html o text (talaga, ang japicompat ay tumatawag sa japiotext o japiohtml sa loob kung
ang -h o -t na mga watawat ay ginagamit). Ang mga Japio file ay maaari ding gamitin kasama ang -i flag to
suportahan ang pagbalewala sa mga error na dulot ng mga hindi pagkakatugma sa pagitan ng mga bersyon ng JDK.

-w huwag paganahin ang mga babala para sa pagtakbo laban sa mga lumang buggy japi file. Bilang default japicompat
gagawa ng mga babala kung tatakbo laban sa mga japi file na orihinal na nabuo ng mas matanda
mga bersyon ng japitools na may alam na mga bug na hindi maalis ng japifix.

-4 gumamit ng 1.4-compatible na mode. Gumagana ito hangga't hindi naglalaman ang mga API na ihahambing
1.5-lamang na mga item.

-o
Ipadala ang output sa sa halip na stdout. Ang format ng file na ito ay depende sa
ang -h, -t at -j na mga flag.

-i
Ipagpalagay na sinusubukan mong ipatupad ang Java API. Mayroon kang (halos marami)
nakumpleto ang saklaw ng mga unang bersyon ng JDK (1.0 at 1.1) ngunit mayroon pa ring ilan
distansya upang makamit ang buong saklaw na 1.4 (ito ay isang tumpak na paglalarawan ng lahat
Libreng Software Java na mga pagpapatupad sa oras ng pagsulat). Gamit ang japicompat sa
ihambing ang iyong pagpapatupad sa JDK 1.4 ay nagbibigay ng mga tumpak na resulta, ngunit maaari mo rin
gustong ipakita ang iyong saklaw ng mga naunang bersyon.

Sa kasamaang palad, hindi sinunod ng Sun ang kanilang sariling mga panuntunan sa compatibility ng binary sa pagitan ng JDK
mga release, pabayaan ang mga pinalawak na panuntunan na sinusuri ng japicompat. Kaya kapag tumakbo ka a
paghahambing sa pagitan ng JDK 1.1 at ng iyong pagpapatupad, makakakuha ka ng huwad na error
mga ulat kapag tugma ka sa 1.4 ngunit hindi 1.1.

Malinaw na kung ano ang talagang gusto mo ay huwag pansinin ang mga error tulad nito, at japicompat
nagbibigay ng paraan para gawin ito. Una, magpatakbo ng paghahambing sa pagitan ng 1.1 at 1.4 gamit ang -j
lumipat. Pagkatapos ay patakbuhin ang paghahambing sa pagitan ng 1.1 at iyong pagpapatupad, na ipinapasa ang
"-i" na opsyon na may output ng nakaraang run. Halimbawa:

$ japicompat -jo ignore-11-14.japio jdk11.japi.gz jdk14.japi.gz
$ japicompat -ho jdk11-myimpl.html -i ignore-11-14.japio jdk11.japi.gz
myimpl.japi.gz

Maaari mo ring makuha ang parehong epekto sa pamamagitan ng pagpapatakbo:

$ japicompat -ho jdk11-myimpl.html -i jdk14.japi.gz jdk11.japi.gz myimpl.japi.gz

Ito ay malinaw na mas simple at mas mabilis na mag-type, ngunit nangangailangan ng paghahambing sa pagitan
jdk11 at jdk14 na tatakbo sa bawat solong oras. Ang paggawa ng japio file nang manu-mano ay nagpapahintulot
para ito ay mai-save at magamit muli sa susunod na pagkakataon, na nagbibigay-daan sa japicompat na tumakbo
dalawang beses na mas mabilis.


Ang mga japi file na tumutugma sa mga API na ihahambing.

Ang japicompat ay partikular na sumusubok na ang pangalawang argumento ay backwardly-compatible
kasama ang una. Samakatuwid, ang perpektong pagpapatupad ng JDK 1.1 ay magbubunga ng no
mga error anuman ang pagkakasunud-sunod ng mga argumento, ngunit isang perpektong pagpapatupad ng
Ang JDK1.1 kasama ang mga bahagi ng JDK1.2 ay dapat masuri tulad ng sumusunod:

$ japicompat jdk11.japi.gz myimpl.japi.gz
$ japicompat myimpl.japi.gz jdk12.japi.gz

Malamang na imposibleng gumawa ng pagpapatupad na pumasa sa parehong mga pagsubok na ito,
dahil ang sariling JDK1.2 ng Sun ay gumagawa ng maraming error kapag nasubok laban sa JDK1.1. Tingnan ang
talakayan ng -i na opsyon sa itaas para sa isang paraan upang makayanan ang sitwasyong ito.

Maaaring maipasa ang alinman sa mga naka-compress (.japi.gz) o hindi naka-compress (.japi) na mga file sa
japicompat: Ang extension ng file ay ginagamit upang matukoy kung mag-pipe input o hindi
sa pamamagitan ng gzip o hindi.

Gumamit ng japicompat online gamit ang mga serbisyo ng onworks.net