japize - Online na nuvem

PROGRAMA:

NOME

japize - Produz uma listagem de uma API em um formato legível por máquina.

SINOPSE

Japize [descompactar] [Como ] apis | ... + | - ...

DESCRIÇÃO

Japize faz parte do japitools, projetado para testar a compatibilidade entre APIs Java.

Eles foram originalmente projetados para testar implementações gratuitas do próprio Java para
compatibilidade com o JDK da Sun, mas também podem ser usados ​​para testar a compatibilidade com versões anteriores
entre as versões de qualquer API.

As ferramentas são japize e japicompat. Japize é um programa Java que emite uma lista de um
API em formato legível por máquina. Japicompat então pega duas dessas listagens e compara
para compatibilidade binária, conforme definido pela Sun na Especificação da linguagem Java.

Pelo menos um + É necessário. terá ".japi" e / ou ".gz" anexado como
apropriado.

A palavra "apis" pode ser substituída por "explicitamente", "byname", "pacotes" ou "classes". Esses
opções indicam se algo no formato "abC" deve ser tratado como uma classe ou um
pacote. Você pode especificar isso de forma inequívoca usando uma das formas "abcpackage" ou
"ab, CClass".

OPÇÕES

descompactar desabilite a compactação da saída com gzip. Compactar a saída é altamente recomendado
uma vez que economiza muito espaço. As únicas situações em que você pode não querer
usar a compactação gzip é quando a memória e o uso da CPU são extremamente restritos ou se
sua JVM não implementa GZIPOutputStream corretamente (nesse caso, você pode
ainda deseja compactar o arquivo resultante manualmente).

as
Especificar esta opção diz ao japize para gravar sua saída em um arquivo com o
nome especificado. Ao gravar em um arquivo com a opção "como", o japize insiste em
gravar em um nome de arquivo que termina em .japi.gz para arquivos compactados ou .japi para
arquivos descompactados. Se o nome do arquivo que você especificar não tiver a extensão correta,
japize irá adicionar partes a ele para garantir que isso aconteça.

Se a opção "como" for omitida, o japize gravará na saída padrão. Nesse caso
japize não tem controle sobre o nome do arquivo que você usa, mas é altamente recomendável
use um nome de arquivo com a extensão correta (".japi.gz" a menos que a opção "descompactar" fosse
Especificadas). Se você usar qualquer outra extensão, japicompat e outras ferramentas podem ser
incapaz de reconhecer o formato.

apis | explicitamente | apelido | pacotes | aulas
Esta opção tem uma função dupla: indica o limite entre as opções de japão
(descompactar, as) e outros argumentos (arquivos e pacotes), mas também diz ao japize como
lidar com argumentos especificados ambiguamente. Veja "+ | - "abaixo para obter detalhes sobre
o comportamento de cada opção. Se você não tiver certeza de qual especificar, "apis" é um seguro
escolha.

apis
abc é testado como um pacote e uma classe. Isso sempre fará o que você quiser
(é por isso que apis é descrito como o padrão seguro), mas às custas de, possivelmente,
fazendo processamento desnecessário extra tentando encontrar a coisa errada.

explicitamente
pkgpaths da forma abc são ilegais - você deve usar a forma explícita.

apelido
abc será processado como um pacote se "c" começar com uma letra minúscula ou como um
classe se começar com uma maiúscula. Isso geralmente faz o que você quer, mas falha
em coisas como org.omg.CORBA.

pacotes
abc será processado como um pacote. Se o processamento de uma classe for necessário, ele deve
ser especificado explicitamente.

aulas
abc será processado como uma classe. Se o processamento de um pacote for necessário, ele deve
ser especificado explicitamente.

|
Quaisquer argumentos após "apis" que não comecem com "+" ou "-" são considerados
arquivos zip ou diretórios. Eles devem ser especificados exatamente como você os colocaria em
seu CLASSPATH (exceto separados por espaços em vez de dois pontos). Qualquer coisa que seja um
arquivo será considerado um arquivo zip (ou jar), então você não pode especificar um arquivo .class
diretamente - se você precisar fazer isso, você deve especificar a pasta que o contém e
em seguida, nomeie a classe para processamento.

+|-
Para especificar quais classes são incluídas, use + pkgpath para adicionar pkgpaths a serem verificados
e -pkgpath para excluir sub-pkgpaths deles. Você DEVE especificar pelo menos um
+ opção pkgpath para especificar qual pkgpath incluir, caso contrário, Japize poderia
escaneia todos os arquivos zip e diretórios, mas não processa realmente nenhum dos
Aulas. Já que isso seria uma coisa inútil de se fazer, japize dá um erro.

Um "pkgpath" se refere a um pacote (que inclui, por implicação, todos os sub-
pacotes) ou uma única classe. Um caminho de pacote para um pacote parece
"com.foo.pkg.sub," e um pkgpath para uma classe se parece com "com.foo.pkg, Cls". o
existência e colocação da vírgula indicam inequivocamente qual tipo de caminho é
pretendido.

Na maioria das vezes, porém, é uma dor ter que colocar vírgulas em nomes que são
familiarize-se com os pontos e acerte a vírgula exatamente. Por esta
razão, o japize aceita pkgpaths contendo apenas pontos e permite que você diga o que
fazer desses nomes. A interpretação de "abc" como um caminho de pacote depende se
você especificou apis, explicitamente, por nome, pacotes ou classes.

EXEMPLO

O JDK 1.1 da Sun inclui classes em java.awt.peer e em java.text.resources que não são
parte da API pública, embora sejam classes públicas; no entanto, todas as outras classes em
a hierarquia do pacote java. * faz parte da API pública. A sintaxe para construir um útil
jdk11.japi.gz seria, portanto:

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

Observe que, uma vez que todos os argumentos de pkgpath aqui são pacotes, você pode economizar uma pequena quantidade de
processamento ao fazer isto:

$ japize como pacotes jdk11 classes.zip + java -java.awt.peer -java.text.resources

ou mesmo isto:

$ japize como jdk11 explicitamente classes.zip + java, -java.awt.peer, -java.text.resources,

Use japize online usando serviços onworks.net