Giao diện Java API

Question

Kể từ khi tôi bắt đầu chơi với Scala, tôi đã có một câu hỏi lớn liên quan đến API Java: tại sao Oracle giữ trang same old HTML bằng thẻ "frameset" và không có chức năng tìm kiếm nào cả? Có vẻ như họ chưa thực hiện trên Web 2.0 ...

Mặt khác, trong khi không phải là trang web tốt nhất trong lịch sử web, có nhiều đơn đặt hàng có thể sử dụng được nhiều hơn.

Dù sao thì, nếu có ai biết lý do tại sao và, quan trọng hơn, nếu có tài liệu Java API có giao diện tốt hơn, vui lòng cho tôi biết!

Answer 1

Gần đây, đối với Java 7, JavaDoc đã được cải thiện để có thể sử dụng CSS tùy chỉnh. Đây là kết quả đầu tiên: http://download.java.net/jdk7/docs/api/. Công việc tiếp tục và tôi nghĩ chúng ta sẽ thấy nhiều hơn khi cập nhật mới xuất hiện. Tôi đồng ý rằng ScalaDoc là cấp trên, nhưng họ không phải đối phó với 15 năm di sản.

Answer 2

Javadocs cung cấp đầu ra ở định dạng đó và được xuất bản tại địa chỉ đó, tôi đoán không ai thực sự thấy cần cải thiện, nhưng bây giờ bạn đề cập đến nó, nó tạo ra một dự án phụ thú vị. Tôi googled xung quanh để tìm nếu có bất kỳ "tốt hơn" giao diện nhưng không có may mắn.

Bạn có thể chạy javadoc -h để xem các tùy chọn bổ sung nào có sẵn nếu bạn muốn tạo lại javadocs. Một số tính năng thú vị là cung cấp đầu trang/chân trang tùy chỉnh và liên kết với nguồn, nhưng không có gì với hiệu ứng bạn đang yêu cầu.

Answer 3

Các trang HTML đó được tạo bằng cách sử dụng các công cụ Javadoc, một cách tiêu chuẩn để xây dựng tài liệu bằng Java.

Tôi không biết liệu có các trang web khác có định dạng API tốt hơn hay không, nhưng nếu nó giúp bạn với bất kỳ thứ gì và bạn đang sử dụng IDE và SDK, bạn có thể thấy mã nguồn cho hầu hết các các tệp ở đó.

Answer 4

javadoc được thiết kế để trở thành mẫu số chung thấp nhất. Hầu như mọi trình duyệt web đều có thể hiển thị nó, ngay cả khi không hỗ trợ JavaScript.

Nếu bạn đang tìm kiếm khả năng truy cập và tìm kiếm nhanh hơn, bạn có thể truy cập JavaDoc từ bên trong một IDE chẳng hạn như Eclipse.