Java 9 - Chú thích @Deprecated nâng cao
@Deprecated annotation đã được giới thiệu trong phiên bản java 5. Phần tử chương trình được chú thích bằng @Deprecated có nghĩa là nó không nên được sử dụng vì bất kỳ lý do nào sau đây:
- Việc sử dụng nó có thể dẫn đến lỗi.
- Nó có thể không tương thích trong phiên bản tương lai.
- Nó có thể bị xóa trong phiên bản tương lai.
- Một giải pháp thay thế tốt hơn và hiệu quả hơn đã thay thế nó.
Trình biên dịch tạo cảnh báo bất cứ khi nào một phần tử không dùng nữa được sử dụng. Với Java 9, hai cải tiến mới được thực hiện cho chú thích @Deprecated.
forRemoval- Cho biết liệu phần tử được chú thích có bị xóa trong phiên bản trong tương lai hay không. Giá trị mặc định là sai.
since- Trả về phiên bản mà phần tử chú thích không được dùng nữa. Giá trị mặc định là chuỗi trống.
Không được chấp nhận với kể từ
Ví dụ sau về lớp Boolean javadoc trên Java 9 minh họa việc sử dụng thuộc tính since trên chú thích @Deprecated.
Lớp Boolean
Không được chấp nhận với forRemoval
Ví dụ sau về javadoc lớp Hệ thống trên Java 9 minh họa việc sử dụng thuộc tính forRemoval trên chú thích @Deprecated.
Lớp hệ thống