japicompat - 클라우드 온라인

프로그램:

이름

japicompat - 바이너리 하위 호환성을 위해 Java API를 테스트합니다.

개요

자피콤팟 [-svqhtjw4] [-또는 아웃파일] [-NS 파일 무시]

기술

자피콤팟 Java API 간의 호환성을 테스트하도록 설계된 japitools의 일부입니다.

그들은 원래 Java 자체의 무료 구현을 테스트하기 위해 설계되었습니다.
Sun의 JDK와 호환되지만 이전 버전과의 호환성을 테스트하는 데에도 사용할 수 있습니다.
모든 API 버전 간.

도구는 japize 및 japicompat입니다. Japize는 목록을 내보내는 Java 프로그램입니다.
기계가 읽을 수 있는 형식의 API. 그런 다음 Japicompat는 이러한 목록 두 개를 가져와 비교합니다.
Java 언어 사양에서 Sun이 정의한 대로 이진 호환성을 위해.

옵션

-s 추가 바이너리 호환성 검사를 비활성화합니다(JLS에서 정의한 검사만 수행).

-v 사소한 호환성 문제를 확인합니다.

SerialVersionUID 확인: japicompat는 직렬화 가능 클래스인 경우 사소한 오류를 보고합니다.
두 릴리스 사이에 다른 SerialVersionUID가 있습니다.

지원 중단 확인: japicompat는 클래스 또는 멤버가 삭제된 경우 사소한 오류를 보고합니다.
원래 API에서는 더 이상 사용되지 않지만 확인 중인 API에서는 더 이상 사용되지 않습니다.

-q 진행 보고서를 비활성화합니다.

-h HTML 형식으로 출력을 생성합니다. 생성된 HTML 파일은 japi.css에 따라 다릅니다.
매력적인 프리젠테이션을 얻을 수 있는 파일입니다.

-t 텍스트 형식으로 출력을 생성합니다. 이것이 기본값입니다.

-j 기계가 읽을 수 있는 원시 형식으로 출력을 생성합니다. 생성된 형식을 호출합니다.
"japio" 형식이며 규칙에 따라 ".japio" 파일 확장자로 저장해야 합니다.
독립 실행형 japiotext 및 japiohtml 유틸리티를 사용하여 이 형식을 변환할 수 있습니다.
html 또는 텍스트로(실제로 japicompat는 다음과 같은 경우 내부적으로 japiotext 또는 japiohtml을 호출합니다.
-h 또는 -t 플래그가 사용됨). Japio 파일은 -i 플래그와 함께 사용하여 다음을 수행할 수도 있습니다.
JDK 버전 간의 비호환성으로 인한 무시 오류를 지원합니다.

-w 오래된 버그가 있는 japi 파일에 대한 실행에 대한 경고를 비활성화합니다. 기본적으로 japicompat
이전 버전에서 원래 생성한 japi 파일에 대해 실행하면 경고가 생성됩니다.
japifix가 제거할 수 없는 알려진 버그가 있는 japitools 버전.

-4 1.4 호환 모드를 사용합니다. 이것은 비교할 API가 다음을 포함하지 않는 한 작동합니다.
1.5 전용 항목.

-o
출력 보내기 stdout 대신. 이 파일의 형식은 다음에 따라 다릅니다.
-h, -t 및 -j 플래그.

-i
Java API를 구현하려고 한다고 가정합니다. 당신은 (거의)
초기 JDK 버전(1.0 및 1.1)에 대한 적용을 완료했지만 아직 일부
1.4의 전체 커버리지를 달성하기 위한 거리(이것은 모든
작성 당시의 자유 소프트웨어 Java 구현). japicompat를 사용하여
구현을 JDK 1.4와 비교하면 정확한 결과를 얻을 수 있지만
이전 버전의 적용 범위를 보여주고 싶습니다.

불행히도 Sun은 JDK 간의 자체 바이너리 호환성 규칙을 따르지 않았습니다.
japicompat가 테스트하는 확장된 규칙은 말할 것도 없고 릴리스도 마찬가지입니다. 그래서 당신이 실행할 때
JDK 1.1과 구현을 비교하면 가짜 오류가 발생합니다.
1.4와 호환되지만 1.1과 호환되지 않는 경우 보고합니다.

분명히 당신이 정말로 원하는 것은 이와 같은 오류를 무시하고 japicompat
할 수 있는 방법을 제공합니다. 먼저 -j를 사용하여 1.1과 1.4를 비교합니다.
스위치. 그런 다음 1.1과 구현 간의 비교를 실행하여 다음을 전달합니다.
이전 실행의 출력과 함께 "-i" 옵션. 예를 들어:

$ japicompat -jo 무시-11-14.japio jdk11.japi.gz jdk14.japi.gz
$ japicompat -ho jdk11-myimpl.html -i 무시-11-14.japio jdk11.japi.gz
myimpl.japi.gz

다음을 실행하여 동일한 효과를 얻을 수도 있습니다.

$ japicompat -ho jdk11-myimpl.html -i jdk14.japi.gz jdk11.japi.gz myimpl.japi.gz

이것은 분명히 입력하기가 더 간단하고 빠르지만 다음 사이의 비교가 필요합니다.
jdk11 및 jdk14는 매번 실행됩니다. japio 파일을 수동으로 만들면
저장하고 다음에 다시 사용할 수 있도록 japicompat이 실행되도록 합니다.
두 배 더 빠릅니다.


비교할 API에 해당하는 japi 파일입니다.

japicompat는 특히 두 번째 인수가 이전 버전과 호환되는지 테스트합니다.
첫 번째로. 따라서 JDK 1.1을 완벽하게 구현하면
인수의 순서에 관계없이 오류가 발생하지만
JDK1.1과 JDK1.2의 일부를 다음과 같이 테스트해야 합니다.

$ japicompat jdk11.japi.gz myimpl.japi.gz
$ japicompat myimpl.japi.gz jdk12.japi.gz

이 두 테스트를 모두 통과하는 구현을 만드는 것은 아마도 불가능할 것입니다.
Sun의 자체 JDK1.2는 JDK1.1에 대해 테스트할 때 수많은 오류를 생성하기 때문입니다. 참조
이 상황에 대처하는 방법에 대해서는 위의 -i 옵션에 대해 설명합니다.

압축(.japi.gz) 또는 압축되지 않은(.japi) 파일을 다음으로 전달할 수 있습니다.
japicompat: 파일 확장자는 파이프 입력 여부를 결정하는 데 사용됩니다.
gzip을 통해서든 아니든.

onworks.net 서비스를 사용하여 온라인에서 japicompat 사용