japize - Интернет в облаке

ПРОГРАММА:

ИМЯ

japize - создать список API в машиночитаемом формате.

СИНТАКСИС

японировать [распаковать] [так как ] пчела | ... + | - ...

ОПИСАНИЕ

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

Изначально они были разработаны для тестирования бесплатных реализаций самой Java для
совместимость с Sun JDK, но их также можно использовать для тестирования обратной совместимости
между версиями любого API.

Инструменты японские и японские. Japize - это программа на Java, которая выводит список
API в машиночитаемом формате. Japicompat затем берет два таких списка и сравнивает
их для двоичной совместимости, как определено Sun в Спецификации языка Java.

Хотя бы один + требуется для. будут добавлены ".japi" и / или ".gz" как
необходимости.

Слово «apis» можно заменить на «явно», «по имени», «пакеты» или «классы». Эти
параметры указывают, следует ли рассматривать что-либо в форме "abC" как класс или
упаковка. Вы можете указать это однозначно, используя одну из форм «abcpackage» или
«ab, CClass».

ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ

расстегнуть молнию отключить архивирование вывода с помощью gzip. Настоятельно рекомендуется заархивировать результат
так как это экономит огромное количество места. Единственные ситуации, когда вы можете не захотеть
использовать сжатие gzip, когда использование памяти и ЦП чрезвычайно ограничено или если
ваша JVM неправильно реализует GZIPOutputStream (в этом случае вы можете
все еще хочу вручную gzip получившийся файл).

as
Указание этого параметра указывает japize записывать вывод в файл с расширением
указанное имя. При записи в файл с опцией "as" japize настаивает на
запись в файл с именем, заканчивающимся на .japi.gz для сжатых файлов или .japi для
несжатые файлы. Если указанное вами имя файла не имеет правильного расширения,
japize добавит к нему части, чтобы убедиться, что это так.

Если опция «as» опущена, japize будет записывать в стандартный вывод. В этом случае
japize не контролирует используемое вами имя файла, но настоятельно рекомендуется
используйте имя файла с правильным расширением (".japi.gz", если только опция "распаковать") не была
указано). Если вы используете какое-либо другое расширение, то japicompat и другие инструменты могут быть недоступны.
не может распознать формат.

пчела | эксплицитно | по имени | пакеты | классов
Этот параметр имеет двойную роль: он указывает границу между вариантами японского развития.
(unzip, as) и другие аргументы (файлы и пакеты), но также сообщает japize, как
иметь дело с неоднозначно указанными аргументами. См. "+ | - "ниже для получения подробной информации о
поведение каждого варианта. Если вы не уверены, что указать, apis - безопасный
выбор.

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

эксплицитно
pkgpath формы abc недопустимы - вы должны использовать явную форму.

по имени
abc будет обрабатываться как пакет, если "c" начинается со строчной буквы, или как
класс, если он начинается с прописной. Обычно это делает то, что вы хотите, но не работает
на такие вещи, как org.omg.CORBA.

пакеты
abc будет обработан как пакет. Если требуется обработка для класса, она должна
указывать явно.

классов
abc будет обработан как класс. Если требуется обработка посылки, она должна
указывать явно.

|
Любые аргументы после «apis», которые не начинаются с «+» или «-», считаются
zip-файлы или каталоги. Их следует указывать точно так, как если бы вы их указали.
ваш CLASSPATH (кроме разделенных пробелами, а не двоеточиями). Все, что
Предполагается, что файл является файлом zip (или jar), поэтому вы не можете указать файл .class
напрямую - если вам нужно это сделать, вы должны указать папку, в которой он находится, и
затем назовите класс для обработки.

+|-
Чтобы указать, какие классы включены, используйте + pkgpath для добавления pkgpaths для сканирования
и -pkgpath, чтобы исключить их под-pkgpath. Вы ДОЛЖНЫ указать хотя бы один
+ опция pkgpath, чтобы указать, какой pkgpath включить, иначе Japize с радостью
сканировать все zip-файлы и каталоги, но не обрабатывать ни один из
классы. Так как это было бы бесполезно, вместо этого japize выдает ошибку.

"Pkgpath" относится к пакету (который подразумевает, что все вложенные
пакеты этого) или одного класса. Путь к пакету выглядит так:
com.foo.pkg.sub, а путь к pkgpath для класса выглядит как com.foo.pkg, Cls. В
наличие и размещение запятой однозначно указывает, какой тип пути
предназначена.

Однако в большинстве случаев сложно ставить запятые в названиях,
вместо этого знакомы с точками и правильно расставляют запятые. Для этого
причина, japize принимает pkgpaths, содержащие только точки, и позволяет вам указать, что
сделайте из этих имен. Интерпретация abc как пути к pkgpath зависит от того,
вы явно указали apis, по имени, пакетам или классам.

ПРИМЕР

Sun JDK 1.1 включает классы в 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