Sử dụng Chú thích Không Chú ý trong đối số phương thức

Question

Tôi vừa mới bắt đầu sử dụng chú thích @NotNull với Java 8 và nhận được một số kết quả không mong muốn.

Tôi có một phương pháp như thế này:

public List<Found> findStuff(@NotNull List<Searching> searchingList) { 
    ... code here ... 
} 

Tôi đã viết một bài kiểm tra JUnit đi qua trong giá trị null cho searchingList tranh cãi. Tôi đã mong đợi một số loại lỗi xảy ra nhưng nó đã trải qua như thể chú thích không có ở đó. Đây có phải là hành vi mong đợi không? Từ những gì tôi hiểu, điều này là để cho phép bạn bỏ qua viết mã kiểm tra không có bản mẫu.

Giải thích về chính xác những gì chính xác của @NotNull được thực hiện sẽ được đánh giá cao.

Answer 1

@Nullable và @NotNull không làm gì cả. Chúng được coi là công cụ Tài liệu.

Các Chú @Nullable nhắc nhở bạn về sự cần thiết để giới thiệu một kiểm tra NPE khi:

1. phương pháp có thể trở về null Calling.
2. Biến dereferencing (trường, biến cục bộ, tham số) có thể là rỗng.

Các @NotNull Chú là, trên thực tế, một hợp đồng rõ ràng tuyên bố như sau:

1. Một phương pháp không nên trả về null.
2. Biến (như trường, biến cục bộ và tham số) không được giữ giá trị rỗng.

dụ:

thay vì viết:

/** 
* @param aX should not be null 
*/ 
public void setX(
    final Object aX) 
{ 
... 
} 

bạn có thể sử dụng

public void setX(
    @NotNull 
    final Object aX) 
{ 
... 
} 

Answer 2

SO @NotNull chỉ là một thẻ ... Nếu bạn muốn xác nhận nó, sau đó bạn phải sử dụng một cái gì đó như validator hibernate jsr 303

ValidatorFactory validatorFactory = Validation.buildDefaultValidatorFactory(); 
Validator validator = validatorFactory.getValidator(); 
Set<ConstraintViolation<List<Searching>> violations = validator.validate(searchingList);