japize - Trực tuyến trên đám mây

CHƯƠNG TRÌNH:

TÊN

japize - Tạo danh sách API ở định dạng máy có thể đọc được.

SYNOPSIS

nhật bản [giải nén] [như ] apis | hữu ích. Cảm ơn ! + | - hữu ích. Cảm ơn !

MÔ TẢ

nhật bản là một phần của japitools, được thiết kế để kiểm tra tính tương thích giữa các API Java.

Ban đầu chúng được thiết kế để kiểm tra các triển khai miễn phí của chính Java cho
khả năng tương thích với JDK của Sun, nhưng chúng cũng có thể được sử dụng để kiểm tra khả năng tương thích ngược
giữa các phiên bản của bất kỳ API nào.

Các công cụ là japize và japicompat. Japize là một chương trình Java tạo ra một danh sách
API ở định dạng máy có thể đọc được. Japicompat sau đó lấy hai danh sách như vậy và so sánh
chúng để tương thích nhị phân, như được Sun định nghĩa trong Đặc tả ngôn ngữ Java.

Ít nhất một + bắt buộc. sẽ có ".japi" và / hoặc ".gz" được thêm vào
thích hợp.

Từ "apis" có thể được thay thế bằng "rõ ràng", "tên riêng", "gói" hoặc "lớp". Này
các tùy chọn cho biết liệu thứ gì đó có dạng "abC" nên được coi là một lớp hay một
Bưu kiện. Bạn có thể chỉ định điều này một cách rõ ràng bằng cách sử dụng một trong các dạng "abcpackage", hoặc
"ab, CClass".

LỰA CHỌN

giải nén vô hiệu hóa nén đầu ra bằng gzip. Nén đầu ra rất được khuyến khích
vì nó tiết kiệm một lượng lớn không gian. Những tình huống duy nhất mà bạn có thể không muốn
để sử dụng tính năng nén gzip là khi mức sử dụng bộ nhớ và CPU cực kỳ chặt chẽ hoặc nếu
JVM của bạn không triển khai GZIPOutputStream một cách chính xác (trong trường hợp đó, bạn có thể
vẫn muốn gzip tệp kết quả theo cách thủ công).

as
Việc chỉ định tùy chọn này yêu cầu japize ghi đầu ra của nó vào một tệp có
tên cụ thể. Khi ghi vào tệp có tùy chọn "dưới dạng", japize nhấn mạnh vào
ghi vào tên tệp kết thúc bằng .japi.gz đối với tệp nén hoặc .japi đối với
các tệp không nén. Nếu tên tệp bạn chỉ định không có phần mở rộng phù hợp,
japize sẽ thêm các bộ phận vào nó để đảm bảo rằng nó hoạt động.

Nếu tùy chọn "as" bị bỏ qua, japize sẽ ghi vào đầu ra tiêu chuẩn. Trong trường hợp này
japize không có quyền kiểm soát tên tệp bạn sử dụng, nhưng chúng tôi thực sự khuyên bạn nên
sử dụng tên tệp có phần mở rộng chính xác (".japi.gz" trừ khi tùy chọn "giải nén" là
được chỉ định). Nếu bạn sử dụng bất kỳ tiện ích mở rộng nào khác, japicompat và các công cụ khác có thể
không thể nhận dạng được định dạng.

apis | rõ ràng | bằng tên | gói | các lớp học
Tùy chọn này có vai trò kép: nó chỉ ra ranh giới giữa các tùy chọn nhật bản
(giải nén, dưới dạng) và các đối số khác (tệp và gói), nhưng cũng cho japize biết cách
đối phó với các đối số được chỉ định không rõ ràng. Xem "+ | - "bên dưới để biết chi tiết về
hành vi của mỗi tùy chọn. Nếu bạn không chắc nên chỉ định cái nào, thì "apis" là một an toàn
sự lựa chọn.

apis
abc được thử cả dưới dạng một gói và một lớp. Điều này sẽ luôn làm những gì bạn muốn
(đó là lý do tại sao apis được mô tả là mặc định an toàn) nhưng với chi phí có thể
thực hiện thêm quá trình xử lý không cần thiết để cố gắng tìm ra điều sai.

rõ ràng
pkgpaths của biểu mẫu abc là bất hợp pháp - bạn phải sử dụng biểu mẫu rõ ràng.

bằng tên
abc sẽ được xử lý dưới dạng một gói nếu "c" bắt đầu bằng một chữ cái thường hoặc dưới dạng
nếu nó bắt đầu bằng chữ hoa. Điều này thường làm những gì bạn muốn nhưng không thành công
trên những thứ như org.omg.CORBA.

gói
abc sẽ được xử lý dưới dạng một gói. Nếu cần xử lý cho một lớp, nó phải
được chỉ định rõ ràng.

các lớp học
abc sẽ được xử lý như một lớp. Nếu cần xử lý một gói, nó phải
được chỉ định rõ ràng.

|
Mọi đối số sau "apis" không bắt đầu bằng "+" hoặc "-" được coi là
tệp zip hoặc thư mục. Những điều này phải được chỉ định chính xác như bạn sẽ đưa chúng vào
CLASSPATH của bạn (ngoại trừ được phân tách bằng dấu cách thay vì dấu hai chấm). Bất cứ điều gì đó là một
tệp sẽ được giả định là tệp zip (hoặc jar), vì vậy bạn không thể chỉ định tệp .class
trực tiếp - nếu bạn cần làm điều đó, bạn nên chỉ định thư mục chứa nó và
sau đó đặt tên cho lớp để xử lý.

+|-
Để chỉ định các lớp nào được bao gồm, hãy sử dụng + pkgpath để thêm các pkgpath sẽ được quét
và -pkgpath để loại trừ các pkgpath con trong số này. Bạn PHẢI chỉ định ít nhất một
+ tùy chọn pkgpath để chỉ định pkgpath nào cần bao gồm, nếu không Japize có thể vui vẻ
quét qua tất cả các tệp zip và thư mục nhưng không thực sự xử lý bất kỳ
các lớp học. Vì đó sẽ là một việc vô ích để làm, thay vào đó, japize đưa ra một lỗi.

"Pkgpath" đề cập đến một gói (bao gồm, theo ngụ ý, tất cả
gói của nó) hoặc một lớp đơn lẻ. Đường dẫn pkgpath cho một gói trông giống như
"com.foo.pkg.sub" và pkgpath cho một lớp trông giống như "com.foo.pkg, Cls". Các
sự tồn tại và vị trí của dấu phẩy cho biết rõ ràng loại đường dẫn nào là
dự định.

Tuy nhiên, hầu hết thời gian, thật khó khăn khi phải đặt dấu phẩy trong những cái tên
thay vào đó quen thuộc với dấu chấm và đặt đúng vị trí dấu phẩy. Đối với điều này
lý do, japize chấp nhận pkgpaths chỉ chứa các dấu chấm và cho phép bạn cho biết nó phải làm gì
cấu tạo của những cái tên đó. Việc giải thích "abc" dưới dạng pkgpath phụ thuộc vào việc
bạn đã chỉ định apis, rõ ràng, theo tên, gói hoặc lớp.

THÍ DỤ

Sun's JDK 1.1 bao gồm các lớp trong java.awt.peer và trong java.text.resources không
một phần của API công khai, mặc dù chúng là các lớp công khai; tuy nhiên, mọi lớp khác trong
hệ thống phân cấp gói java. * là một phần của API công khai. Cú pháp để xây dựng một
jdk11.japi.gz do đó sẽ là:

$ japize dưới dạng jdk11 apis class.zip + java -java.awt.peer -java.text.resources

Lưu ý rằng vì tất cả các đối số pkgpath ở đây là các gói, bạn có thể tiết kiệm một lượng nhỏ
xử lý bằng cách thực hiện điều này thay thế:

$ japize dưới dạng jdk11 gói các lớp.zip + java -java.awt.peer -java.text.resources

hoặc thậm chí điều này:

$ japize dưới dạng jdk11 rõ ràng các lớp.zip + java, -java.awt.peer, -java.text.resources,

Sử dụng japize trực tuyến bằng các dịch vụ onworks.net