Trong bài này, tôi sẽ giới thiệu với các bạn một số tính năng mới hỗ trợ cho Annotation trong Java 8 là Repeating annotation, Type Annotation.
Nếu bạn chưa biết về Annotation, hãy xem bài viết Hướng dẫn sử dụng Java Annotation trước khi tiếp tục xem nội dung tiếp theo của bài viết.
Repeating annotation
Annotations được giới thiệu trong phiên bản Java 5, tính năng này đã trở thành một tính năng hữu ích và được sử dụng rộng rãi. Tuy nhiên, có hạn chế là các annotation không thể khai báo nhiều hơn một lần cùng một vị trí. Java 8 đã giới thiệu tính năng Repeating annotation, nó cho phép các annotation giống nhau có thể được khai báo nhiều lần cùng một vị trí.
Ví dụ:
package com.gpcoder.annotation;
import java.lang.annotation.ElementType;
import java.lang.annotation.Repeatable;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
public class RepeatingAnnotations {
// 1. Declare a Repeatable Annotation Type
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Repeatable(Filters.class)
public @interface Filter {
String value();
};
// 2. Declare the Containing Annotation Type
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
public @interface Filters {
Filter[] value();
}
// 3. Use repeating annotations
@Filter("filter1")
@Filter("filter2")
public interface Filterable {
}
public static void main(String[] args) {
// 4. Retrieving Annotations via the Filter class
Filter[] arrFilter = Filterable.class.getAnnotationsByType(Filter.class);
for (Filter filter : arrFilter) {
System.out.println(filter.value());
}
// Another way
// 4. Retrieving Annotations via the Filters class
Filters filters = Filterable.class.getAnnotation(Filters.class);
for (Filter filter : filters.value()) {
System.out.println(filter.value());
}
}
}
Ouput của chương trình trên:
filter1 filter2 filter1 filter2
Như bạn thấy trong ví dụ trên có một Annotation trên class Filter được đánh dấu @Repeatable(Filters.class). Lớp Filters chỉ nắm giữ annotation Filter, trình biên dịch Java compiler cố gắng để che giấu sự hiện diện của nó từ developer. Vì vậy, interface Filterable có chú thích Filter được định nghĩa hai lần (không đề cập tới Filters).
Ngoài ra, Reflection API cũng cung cấp phương thức mới là getAnnotationsByType() để trả về các repeating annotation. Chú ý rằng Filterable.class.getAnnotation(Filters.class) sẽ trả về instance của Filters bởi trình biên dịch.
Type Annotation
Trước Java 8, Annotation chỉ có thể được áp dụng cho các khai báo (class, contructor, method, …). Từ Java 8, Annotation cũng có thể được áp dụng cho bất kỳ kiểu dữ liệu nào(Type), bao gồm: new operator, type casts, implements clauses và throws clauses.
Type annotation được tạo ra để hỗ trợ phân tích, cải tiến các chương trình Java bằng cách đảm bảo kiểm tra kiểu mạnh hơn. Bạn có thể sử dụng nhiều Annotation type để kiểm tra nhiều loại lỗi khác nhau cho cùng một kiểu.
Ví dụ: bạn muốn đảm bảo rằng một biến cụ thể trong chương trình của bạn không bao giờ được gán cho NULL, tránh lỗi NullPointerException. Bạn có thể viết một Annotation để kiểm tra điều này. Sau đó, bạn sẽ sửa đổi code của mình để chú thích biến cụ thể đó, cho biết rằng nó không bao giờ được gán cho NULL.
Ví dụ: @NonNull @Size(max = 100) String str;
Khi bạn biên dịch, nếu sử dụng NonNull tại dòng lệnh, trình biên dịch sẽ in một cảnh báo nếu nó phát hiện ra một vấn đề tiềm ẩn, cho phép bạn sửa đổi mã để tránh lỗi. Sau khi bạn sửa mã để loại bỏ tất cả cảnh báo, lỗi cụ thể này sẽ không xảy ra khi thực thi chương trình.
Thực sự tôi chưa áp dụng Type Annotation nhiều trong dự án do code khá khó đọc và khó bảo trì, các bạn có hứng thú với chủ đề có thể hiểu thêm một số link sau:
- https://jaxenter.com/jsr-308-explained-java-type-annotations-107706.html
- https://www.mscharhag.com/java/java-8-type-annotations
- https://checkerframework.org/jsr308/specification/java-annotation-design.html
Tài liệu tham khảo:
- https://docs.oracle.com/javase/tutorial/java/annotations/repeating.html
- https://docs.oracle.com/javase/tutorial/java/annotations/type_annotations.html
- https://www.javacodegeeks.com/2014/05/java-8-features-tutorial.html#repeating_annotations