japicompat - Bulutta Çevrimiçi

Program:

ADI

japicompat - Java API'lerini ikili geriye dönük uyumluluk açısından test edin.

SİNOPSİS

japicompat [-svqhtjw4] [-veya dosya] [-ben yok sayılan dosyalar]

TANIM

japicompat Java API'leri arasındaki uyumluluğu test etmek için tasarlanmış japitools'un bir parçasıdır.

Başlangıçta Java'nın ücretsiz uygulamalarını test etmek için tasarlandılar.
Sun'ın JDK'sı ile uyumluluk, ancak geriye dönük uyumluluğu test etmek için de kullanılabilirler
herhangi bir API'nin sürümleri arasında.

Araçlar japize ve japicompat'tır. Japize, bir liste yayan bir Java programıdır.
API, makine tarafından okunabilir bir biçimde. Japicompat daha sonra bu tür iki liste alır ve karşılaştırır
Java Dil Belirtimi'nde Sun tarafından tanımlandığı gibi ikili uyumluluk için.

SEÇENEKLER

-s ek ikili uyumluluk kontrollerini devre dışı bırakın (yalnızca JLS tarafından tanımlanan kontrolleri yapın).

-v küçük uyumluluk sorunları için kontrolleri etkinleştirin.

SerialVersionUID denetimi: japicompat, Serileştirilebilir bir sınıf varsa küçük bir hata bildirir
iki sürüm arasında farklı bir SerialVersionUID'ye sahip.

Kullanımdan kaldırma denetimi: japicompat, bir sınıf veya üye
orijinal API'de kullanımdan kaldırılmıştır, ancak kontrol edilen API'de kullanımdan kaldırılmamıştır.

-q ilerleme raporlarını devre dışı bırakır.

-h HTML formatında çıktı üretir. Üretilen HTML dosyaları japi.css'ye bağlıdır
çekici bir sunum elde etmek için dosya.

-t metin biçiminde çıktı üretir. Bu varsayılandır.

-j ham makine tarafından okunabilir biçimde çıktı üretir. Üretilen format denir
"japio" biçimindedir ve geleneksel olarak bir ".japio" dosya uzantısıyla kaydedilmelidir.
Bu formatı dönüştürmek için bağımsız japiotext ve japiohtml yardımcı programları kullanılabilir
html veya metne dönüştürün (aslında japicompat, japiotext veya japiohtml'yi dahili olarak çağırır,
-h veya -t bayrakları kullanılır). Japio dosyaları ayrıca -i bayrağıyla kullanılabilir.
JDK sürümleri arasındaki uyumsuzluklardan kaynaklanan hataları yok saymayı destekler.

-w eski buggy japi dosyalarına karşı çalıştırma uyarılarını devre dışı bırakın. Varsayılan olarak japicompat
orijinal olarak eski tarafından oluşturulan japi dosyalarına karşı çalıştırılırsa uyarılar üretecektir.
japifix'in ortadan kaldıramadığı bilinen hatalara sahip japitools sürümleri.

-4 1.4 uyumlu modu kullanın. Bu, karşılaştırılacak API'ler şunları içermediği sürece çalışır:
1.5-yalnızca öğeler.

-o
çıktıyı şuraya gönder: stdout'un yerine. Bu dosyanın formatı şunlara bağlıdır:
-h, -t ve -j bayrakları.

-i
Java API'sini uygulamaya çalıştığınızı varsayalım. sahipsin (hemen hemen)
erken JDK sürümlerinin (1.0 ve 1.1) kapsamını tamamladı, ancak yine de bazı
1.4'ün tam kapsamını elde etmek için mesafe (bu, tüm
Yazma sırasında Özgür Yazılım Java uygulamaları). japicompat kullanarak
uygulamanızı JDK 1.4 ile karşılaştırmak doğru sonuçlar verir, ancak
önceki sürümlerin kapsamını göstermek istiyorum.

Ne yazık ki Sun, JDK arasında kendi ikili uyumluluk kurallarına uymadı.
japicompat'ın test ettiği genişletilmiş kuralları bırakın. Yani bir çalıştırdığınızda
JDK 1.1 ile uygulamanız arasındaki karşılaştırma, sahte hata alırsınız
1.4 ile uyumlu olduğunuzda ancak 1.1 ile uyumlu olmadığınızda raporlar.

Açıkçası, gerçekten istediğiniz şey, bunun gibi hataları görmezden gelmek ve japicompat
yapmak için bir yol sağlar. İlk olarak, -j kullanarak 1.1 ile 1.4 arasında bir karşılaştırma yapın
değiştirmek. Ardından, 1.1 ile uygulamanız arasındaki karşılaştırmayı çalıştırın,
Önceki çalıştırmanın çıktısı ile "-i" seçeneği. Örneğin:

$ japicompat -jo yoksay-11-14.japio jdk11.japi.gz jdk14.japi.gz
$ japicompat -ho jdk11-myimpl.html - görmezden geliyorum-11-14.japio jdk11.japi.gz
myimpl.japi.gz

Aynı efekti çalıştırarak da elde edebilirsiniz:

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

Bu açıkça daha basit ve yazması daha hızlıdır, ancak bunlar arasında karşılaştırma yapılmasını gerektirir.
jdk11 ve jdk14 her seferinde çalıştırılacak. Japio dosyasını manuel olarak yapmak
kaydedilmesi ve bir dahaki sefere tekrar kullanılması için, bu da japicompat'ın çalışmasına izin verir.
iki kat daha hızlı.


Karşılaştırılacak API'lere karşılık gelen japi dosyaları.

japicompat özellikle ikinci argümanın geriye dönük olarak uyumlu olduğunu test eder
ilk ile. Bu nedenle, JDK 1.1'in mükemmel bir şekilde uygulanması, hiçbir
argümanların sırasına bakılmaksızın hatalar, ancak mükemmel bir uygulama
JDK1.1 artı JDK1.2 parçaları aşağıdaki gibi test edilmelidir:

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

Her iki testi de geçen bir uygulama yapmak muhtemelen imkansızdır,
Sun'ın kendi JDK1.2'si, JDK1.1'e karşı test edildiğinde çok sayıda hata ürettiğinden. Bkz.
Bu durumla başa çıkmanın bir yolu için yukarıdaki -i seçeneğinin tartışılması.

Sıkıştırılmış (.japi.gz) veya sıkıştırılmamış (.japi) dosyalar,
japicompat: Dosya uzantısı, girdinin yönlendirilip yönlendirilmeyeceğini belirlemek için kullanılır
gzip aracılığıyla veya değil.

onworks.net hizmetlerini kullanarak japicompat'ı çevrimiçi kullanın