Mọi element có annotation @Deprecated có nghĩa element đó không nên dùng nữa vì:
- Dùng nó rủi ro và có thể gây lỗi.
- Có thể không tương thích các phiên bản sau.
- Có thể bị xóa các phiên bản sau.
- Có giải pháp tốt và hiệu quả hơn thay thế.
Java 9 thêm hai element mới: thuộc tính since và forRemoval.
1) since: Element chỉ định phiên bản deprecated của API element được annotation.
2) forRemoval: Element biểu thị API element được annotation có thể bị xóa phiên bản sau, và API có thể migrate.
Trang web sau là tài liệu cho class Boolean trong Java 9. Annotation @Deprecated dùng thuộc tính since trong tài liệu: Boolean Class.
Trang web sau mô tả class System trong Java 9. Annotation @Deprecated trong tài liệu dùng thuộc tính forRemoval: System Class.
