Este es el comando japicompat 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
japicompat: prueba las API de Java para la compatibilidad binaria con versiones anteriores.
SINOPSIS
japicompat [-svqhtjw4] [-o archivo] [-I ignorar archivos]
DESCRIPCIÓN
japicompat 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.
CAMPUS
-s deshabilite las comprobaciones adicionales de compatibilidad binaria (solo realice comprobaciones definidas por JLS).
-v habilite las comprobaciones de problemas menores de compatibilidad.
Comprobación de SerialVersionUID: japicompat informa un error menor si es una clase serializable
tiene un SerialVersionUID diferente entre las dos versiones.
Comprobación de obsolescencia: japicompat informa un error menor si una clase o miembro estaba
en desuso en la API original, pero no está en desuso en la API que se está comprobando.
-q desactiva los informes de progreso.
-h genera salida en formato HTML. Los archivos HTML producidos dependen de japi.css
archivo para obtener una presentación atractiva.
-t genera salida en formato de texto. Este es el predeterminado.
-j genera resultados en formato legible por máquina sin procesar. El formato producido se llama
formato "japio" y, por convención, debe guardarse con una extensión de archivo ".japio".
Las utilidades japiotext y japiohtml independientes se pueden utilizar para convertir este formato
en html o texto (en realidad, japicompat llama a japiotext o japiohtml internamente si
se utilizan las banderas -ho -t). Los archivos Japio también se pueden utilizar con el indicador -i para
admite ignorar los errores causados por incompatibilidades entre las versiones de JDK.
-w deshabilite las advertencias para ejecutar contra archivos japi con errores antiguos. Por defecto japicompat
producirá advertencias si se ejecuta contra archivos japi originalmente generados por
versiones de japitools que tenían errores conocidos que japifix no puede eliminar.
-4 utilice el modo compatible con 1.4. Esto funciona siempre que las API para comparar no contengan
Artículos solo 1.5.
-o
Envíe la salida a en lugar de stdout. El formato de este archivo depende de
los indicadores -h, -t y -j.
-i
Suponga que está intentando implementar la API de Java. Tienes (bastante)
cobertura completa de las primeras versiones de JDK (1.0 y 1.1) pero todavía tienen algunas
distancia para lograr una cobertura total de 1.4 (esta es una descripción precisa de todos
Implementaciones Java de software libre en el momento de redactar este artículo). Usando japicompat para
comparar su implementación con JDK 1.4 da resultados precisos, pero también puede
desea mostrar su cobertura de las versiones anteriores.
Desafortunadamente, Sun no ha seguido sus propias reglas de compatibilidad binaria entre JDK
lanzamientos, y mucho menos las reglas expandidas que japicompat prueba. Entonces, cuando ejecutas un
comparación entre JDK 1.1 y su implementación, obtendrá un error falso
informa cuando es compatible con 1.4 pero no con 1.1.
Obviamente lo que realmente quieres es ignorar errores como este, y japicompat
proporciona una forma de hacerlo. Primero, ejecute una comparación entre 1.1 y 1.4 usando -j
cambiar. Luego ejecute la comparación entre 1.1 y su implementación, pasando el
Opción "-i" con la salida de la ejecución anterior. Por ejemplo:
$ japicompat -jo ignorar-11-14.japio jdk11.japi.gz jdk14.japi.gz
$ japicompat -ho jdk11-myimpl.html -ignoro-11-14.japio jdk11.japi.gz
miimpl.japi.gz
También puede obtener el mismo efecto ejecutando:
$ japicompat -ho jdk11-myimpl.html -i jdk14.japi.gz jdk11.japi.gz myimpl.japi.gz
Obviamente, esto es más simple y rápido de escribir, pero requiere la comparación entre
jdk11 y jdk14 para que se ejecuten cada vez. Hacer el archivo japio manualmente permite
para que se guarde y se use de nuevo la próxima vez, lo que permite que japicompat funcione
dos veces más rápido.
Los archivos japi correspondientes a las API a comparar.
japicompat prueba específicamente que el segundo argumento es compatible con versiones anteriores
con el primero. Por lo tanto, una implementación perfecta de JDK 1.1 no produciría
errores independientemente del orden de los argumentos, pero una perfecta implementación de
JDK1.1 más partes de JDK1.2 deben probarse de la siguiente manera:
$ japicompat jdk11.japi.gz myimpl.japi.gz
$ japicompat miimpl.japi.gz jdk12.japi.gz
Probablemente sea imposible hacer una implementación que pase estas dos pruebas,
ya que el propio JDK1.2 de Sun produce numerosos errores cuando se prueba con JDK1.1. Ver el
discusión de la opción -i anterior para una forma de hacer frente a esta situación.
Se pueden pasar archivos comprimidos (.japi.gz) o sin comprimir (.japi) a
japicompat: la extensión del archivo se usa para determinar si se debe canalizar o no la entrada
a través de gzip o no.
Use japicompat en línea usando los servicios de onworks.net
