Chú thích Phản chiếu Java Đặt hàng

Question

Khi truy cập Chú thích được xác định trên Trường thông qua Phản ánh (tức là sử dụng phương pháp getDeclaredAnnotations() : Annotation[]), đặc tả Java 6 hoặc 7 có đảm bảo về thứ tự mà Chú thích được trả về. Tôi đã kiểm tra các tài liệu java có liên quan nhưng dường như không thể tìm thấy một câu trả lời dứt khoát.

Answer 1

Đó thực sự là một chút không xác định. Hãy bắt đầu với các tính năng Java 8 chú thích lặp lại như có một số bit về nó:

JLS §9.7.5. Multiple Annotations of the Same Type:

Chú thích ngầm tuyên bố được gọi là chú thích chứa, và chú thích nhiều loại T mà xuất hiện trong ngữ cảnh được gọi là chú thích cơ bản . Các phần tử của phần tử (array-typed) value của chú thích vùng chứa là tất cả chú thích cơ bản theo thứ tự từ trái sang phải, trong đó chúng xuất hiện trong ngữ cảnh.

Vì vậy, vùng chứa sẽ cung cấp chú thích lặp lại theo thứ tự.

Bên cạnh đó, tài liệu của AnnotatedElement quy định cụ thể:

Đối với một lời gọi get[Declared]AnnotationsByType(Class <T>), thứ tự của các chú thích đó là trực tiếp hoặc gián tiếp có mặt trên một yếu tố E được tính như nếu chú thích hiện gián tiếp trên E có mặt trực tiếp trên E thay cho chú thích vùng chứa của chúng theo thứ tự xuất hiện trong phần tử giá trị của chú thích vùng chứa.

Đưa hai này lại với nhau, nó ngụ ý rằng chú thích lặp đi lặp lại như @Foo(1) @Foo(2) @Foo(3) được lưu trữ như bạn đã viết @FooContainer({@Foo(1), @Foo(2), @Foo(3)}) và sau này, bất kể như thế nào nó ban đầu được tạo ra, sẽ được xử lý bởi getDeclaredAnnotations() như chú thích mặt trực tiếp của lệnh đó.

Vì vậy, câu trả lời cho chú thích lặp lại là thứ tự sẽ là “thứ tự từ trái sang phải mà chúng xuất hiện”.

---

Nhưng có một kết luận khác chúng tôi có thể rút ra từ tài liệu của AnnotatedElement. Vì nó cho biết thứ tự chú thích được tính như thể các chú thích gián tiếp có mặt trực tiếp thay cho chú thích vùng chứa, nó ngụ ý rằng nếu bạn viết @Foo(1) @FooContainer({@Foo(2), @Foo(3)}) hoặc @FooContainer({@Foo(1), @Foo(2)}) @Foo(3), thứ tự sẽ giống như các phần tử của vùng chứa sẽ thay thế nó giống như bạn đã viết @Foo(1) @Foo(2) @Foo(3).

Thật thú vị, how that is achieved:

Nếu chú thích của các loại chú thích annotationClass được tìm thấy là cả trực tiếp và trình bày gián tiếp, sau đó getDeclaredAnnotations() sẽ được gọi để xác định thứ tự của các yếu tố trong mảng được trả về.

Ghi chú triển khai này là chỉ báo đầu tiên trong toàn bộ tài liệu mà getDeclaredAnnotations() có thứ tự đáng tin cậy.Nó được sử dụng để xác định thứ tự được yêu cầu để hoàn thành hợp đồng được mô tả ở trên.

Vì vậy, câu trả lời là, có, getDeclaredAnnotations() cung cấp chú thích theo thứ tự được đảm bảo, nhưng thông tin đó không được đính kèm trực tiếp vào tài liệu của chính phương thức đó.

Điều này bắt nguồn từ tài liệu Java 8, nhưng kể từ khi Java 6 và 7 đạt đến kết thúc của cuộc sống ngay bây giờ và sẽ không thay đổi, thực tế là hành vi được quan sát thực hiện của chúng khớp với hành vi được đảm bảo ít nhất cho Java 8, có thể là đủ để dựa vào nó.