Este es el comando japize que se puede ejecutar en el proveedor de alojamiento gratuito de OnWorks utilizando una de nuestras múltiples estaciones de trabajo en línea gratuitas, como Ubuntu Online, Fedora Online, emulador en línea de Windows o emulador en línea de MAC OS.
PROGRAMA:
NOMBRE
japize: produce una lista de una API en un formato legible por máquina.
SINOPSIS
japizar [abrir la cremallera] [como ] apis | ... + | - ...
DESCRIPCIÓN
japizar es parte de japitools, diseñado para probar la compatibilidad entre las API de Java.
Fueron diseñados originalmente para probar implementaciones gratuitas del propio Java para
compatibilidad con JDK de Sun, pero también se pueden utilizar para probar la compatibilidad con versiones anteriores
entre versiones de cualquier API.
Las herramientas son japize y japicompat. Japize es un programa Java que emite una lista de un
API en un formato legible por máquina. Japicompat luego toma dos de esos listados y compara
ellos por compatibilidad binaria, según lo definido por Sun en la Especificación del lenguaje Java.
Al menos uno + es requerido. tendrá ".japi" y / o ".gz" adjuntos como
apropiado.
La palabra "apis" se puede reemplazar por "explícitamente", "por nombre", "paquetes" o "clases". Estas
Las opciones indican si algo de la forma "abC" debe tratarse como una clase o un
paquete. Puede especificar esto sin ambigüedades utilizando uno de los formularios "abcpackage" o
"ab, CClass".
OPCIONES
abrir la cremallera deshabilite la compresión de la salida con gzip. Se recomienda encarecidamente comprimir la salida
ya que ahorra una gran cantidad de espacio. Las únicas situaciones en las que quizás no quieras
usar la compresión gzip es cuando la memoria y el uso de la CPU son extremadamente ajustados o si
su JVM no implementa GZIPOutputStream correctamente (en cuyo caso podría
todavía quiero gzip el archivo resultante manualmente).
as
Especificar esta opción le dice a japize que escriba su salida en un archivo con la
nombre especificado. Al escribir en un archivo con la opción "como", japize insiste en
escribir en un nombre de archivo que termine en .japi.gz para archivos comprimidos, o .japi para
archivos sin comprimir. Si el nombre de archivo que especifica no tiene la extensión correcta,
japize le agregará partes para asegurarse de que lo haga.
Si se omite la opción "como", japize escribirá en la salida estándar. En este caso
japize no tiene control sobre el nombre de archivo que usa, pero se recomienda encarecidamente
use un nombre de archivo con la extensión correcta (".japi.gz" a menos que la opción "descomprimir" fuera
especificado). Si usa cualquier otra extensión, japicompat y otras herramientas pueden ser
incapaz de reconocer el formato.
apis | explícitamente | por nombre | paquetes | privadas
Esta opción tiene un papel doble: indica el límite entre las opciones de japize
(descomprimir, como) y otros argumentos (archivos y paquetes), pero también le dice a japize cómo
tratar con argumentos ambiguamente especificados. Ver "+ | - "a continuación para obtener detalles sobre
el comportamiento de cada opción. Si no está seguro de qué especificar, "apis" es una opción segura.
elección.
apis
abc se prueba tanto como paquete como como clase. Esto siempre hará lo que quieras
(razón por la cual apis se describe como el valor predeterminado seguro) pero a expensas de posiblemente
haciendo un procesamiento adicional innecesario tratando de encontrar lo incorrecto.
explícitamente
pkgpaths de la forma abc son ilegales; debe utilizar la forma explícita.
por nombre
abc se procesará como un paquete si "c" comienza con una letra minúscula o como una
class si comienza con una mayúscula. Esto suele hacer lo que quieres pero falla.
en cosas como org.omg.CORBA.
paquetes
abc se procesará como un paquete. Si se necesita procesamiento para una clase, debe
especificarse explícitamente.
privadas
abc se procesará como una clase. Si es necesario procesar un paquete, debe
especificarse explícitamente.
|
Cualquier argumento después de "apis" que no comience con "+" o "-" se considerará
zipfiles o directorios. Estos deben especificarse exactamente como los pondría en
su CLASSPATH (excepto separados por espacios en lugar de dos puntos). Cualquier cosa que sea un
se asumirá que el archivo es un archivo zip (o jar), por lo que no puede especificar un archivo .class
directamente: si necesita hacerlo, debe especificar la carpeta que lo contiene y
luego nombre la clase para su procesamiento.
+|-
Para especificar qué clases están incluidas, use + pkgpath para agregar pkgpaths para escanear
y -pkgpath para excluir sub-pkgpaths de estos. DEBE especificar al menos uno
+ opción pkgpath para especificar qué pkgpath incluir, de lo contrario, Japize podría felizmente
escanear a través de todos los archivos zip y directorios pero en realidad no procesa ninguno de los
clases. Dado que eso sería algo inútil, japize da un error en su lugar.
Un "pkgpath" se refiere a un paquete (que incluye, por implicación, todos los
paquetes de la misma) o una sola clase. Un pkgpath para un paquete se parece a
"com.foo.pkg.sub" y un pkgpath para una clase se parece a "com.foo.pkg, Cls". los
La existencia y la ubicación de la coma indica inequívocamente qué tipo de ruta es
destinado a.
La mayoría de las veces, sin embargo, es una molestia tener que poner comas en nombres que son
en su lugar, familiarícese con los puntos y obtenga la ubicación de las comas exactamente correcta. Para esto
razón, japize acepta pkgpaths que contienen solo puntos, y le permite decirle qué
hacer de esos nombres. La interpretación de "abc" como pkgpath depende de si
especificó apis, explícitamente, por nombre, paquetes o clases.
EJEMPLO
El JDK 1.1 de Sun incluye clases en java.awt.peer y en java.text.resources que no son
parte de la API pública, aunque sean clases públicas; sin embargo, todas las demás clases en
la jerarquía de paquetes java. * es parte de la API pública. La sintaxis para construir un útil
jdk11.japi.gz sería por tanto:
$ japize as jdk11 apis classes.zip + java -java.awt.peer -java.text.resources
Tenga en cuenta que dado que todos los argumentos de pkgpath aquí son paquetes, puede guardar una pequeña cantidad de
procesando haciendo esto en su lugar:
$ japize como paquetes jdk11 classes.zip + java -java.awt.peer -java.text.resources
o incluso esto:
$ japize as jdk11 explícitamente classes.zip + java, -java.awt.peer, -java.text.resources,
Use japize en línea usando los servicios de onworks.net
