japize - онлайн в хмарі

ПРОГРАМА:

ІМ'Я

japize - створити список API у машиночитаному форматі.

СИНТАКСИС

япізувати [розпакувати] [як ] апіс | ... +|- ...

ОПИС

япізувати є частиною japitools, призначеної для перевірки сумісності між Java API.

Спочатку вони були розроблені для тестування безкоштовних реалізацій самої Java
сумісність з JDK від Sun, але їх також можна використовувати для тестування зворотної сумісності
між версіями будь-якого API.

Інструменти - japize і japicompat. Japize - це програма на Java, яка створює список файлів
API у машиночитаному форматі. Потім Japicompat бере два таких списки та порівнює
їх для бінарної сумісності, як визначено Sun у Специфікації мови Java.

Принаймні один + необхідно. буде додано ".japi" та/або ".gz" як
необхідності.

Слово «apis» можна замінити на «явно», «за ім'ям», «пакети» або «класи». Ці
Параметри вказують, чи слід розглядати щось у формі "abC" як клас чи a
пакет. Ви можете вказати це однозначно, використовуючи одну з форм "abcpackage" або
"ab,CClass".

ВАРІАНТИ

розстебнути блискавку вимкнути стиснення виводу за допомогою gzip. Настійно рекомендується застібати вихідні дані
оскільки це економить величезну кількість місця. Єдині ситуації, коли вам не хочеться
використовувати стиснення gzip, коли використання пам’яті та процесора надзвичайно обмежене або якщо
ваша JVM неправильно реалізує GZIPOutputStream (у цьому випадку ви можете
все одно хочете заархівувати отриманий файл вручну).

as
Якщо вказати цю опцію, japize має записати свій вихід у файл із файлом
вказана назва. Під час запису у файл із опцією «як», japize наполягає на
запис до імені файлу, що закінчується на .japi.gz для стиснутих файлів або .japi для
нестиснені файли. Якщо вказана назва файлу не має правильного розширення,
japize додасть до нього частини, щоб переконатися, що це так.

Якщо параметр «як» опущено, japize запише на стандартний вихід. В цьому випадку
japize не має контролю над іменем файлу, який ви використовуєте, але настійно рекомендується
використовуйте ім’я файлу з правильним розширенням (.japi.gz), якщо не була опція «розпакувати».
вказано). Якщо ви використовуєте будь-яке інше розширення, це може бути Japicompat та інші інструменти
не вдається розпізнати формат.

апіс | явно | прізвище | пакети | класів
Цей параметр має подвійну роль: він вказує на межу між варіантами япіза
(unzip, as) та інші аргументи (файли та пакети), але також вказує japize, як це зробити
працювати з неоднозначно заданими аргументами. Дивіться "+|- " нижче для детальної інформації про
поведінка кожного варіанта. Якщо ви не впевнені, що вказати, "apis" є сейфом
вибір.

апіс
abc пробується і як пакет, і як клас. Це завжди буде робити те, що ви хочете
(саме тому apis описується як безпечний за замовчуванням), але за рахунок можливо
виконувати додаткову непотрібну обробку, намагаючись знайти неправильну річ.

явно
pkgpaths форми abc є незаконними - ви повинні використовувати явну форму.

прізвище
abc буде оброблено як пакет, якщо "c" починається з малої літери, або як a
клас, якщо він починається з великої літери. Зазвичай це робить те, що ви хочете, але не вдається
на такі речі, як org.omg.CORBA.

пакети
abc буде оброблено як пакет. Якщо необхідна обробка для класу, вона має бути обов’язковою
бути вказано явно.

класів
abc буде оброблено як клас. Якщо для пакета необхідна обробка, вона має бути обов’язковою
бути вказано явно.

|
Будь-які аргументи після "apis", які не починаються з "+" або "-", вважаються такими
zip-файли або каталоги. Їх потрібно вказати точно так, як ви їх додасте
ваш CLASSPATH (крім розділених пробілами, а не двокрапками). Все, що є
буде вважатися файлом zip (або jar), тому ви не можете вказати файл .class
безпосередньо - якщо вам потрібно це зробити, ви повинні вказати папку, що містить це та
потім назвіть клас для обробки.

+|-
Щоб указати, які класи включені, використовуйте +pkgpath, щоб додати pkgpaths для сканування
та -pkgpath, щоб виключити під-pkgpath із них. Ви ПОВИННІ вказати принаймні один
Опція +pkgpath, щоб вказати, який pkgpath включити, інакше Japize міг би бути щасливим
сканувати всі zip-файли та каталоги, але фактично не обробляти жодного з них
класи. Оскільки це було б марним, натомість japize видає помилку.

"pkgpath" відноситься до пакета (який включає в себе, неявно, всі під-
його пакети) або один клас. Pkgpath для пакета виглядає так
"com.foo.pkg.sub", а pkgpath для класу виглядає як "com.foo.pkg,Cls". The
наявність і розміщення коми однозначно вказує, який тип шляху
за призначенням.

У більшості випадків, однак, важко ставити кому в іменах, які є
натомість знайомі з крапками та правильно розставте кому. Для цього
Причина в тому, що japize приймає pkgpaths, що містять лише точки, і дозволяє вам вказувати, що робити
зробити з цих імен. Інтерпретація "abc" як pkgpath залежить від того, чи
ви явно вказали apis, ім'я, пакети або класи.

приклад

JDK 1.1 Sun включає класи в java.awt.peer і в java.text.resources, які не є
частина публічного API, навіть якщо вони є відкритими класами; проте кожен інший клас у
ієрархія пакетів java.* є частиною загальнодоступного API. Синтаксис для побудови корисного
Таким чином, jdk11.japi.gz буде:

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

Зауважте, що оскільки всі аргументи pkgpath тут є пакетами, ви можете заощадити невелику кількість
обробка, роблячи це замість цього:

$ japize як jdk11 пакує classes.zip +java -java.awt.peer -java.text.resources

або навіть це:

$ japize як jdk11 явно classes.zip +java, -java.awt.peer, -java.text.resources,

Використовуйте japize онлайн за допомогою служб onworks.net