Hôm nay, chúng ta cùng tìm hiểu về các Annotation trong Spring có nghĩa là gì nhé. Nội dung tôi đề cập trong bài này sẽ xoay quanh các chủ đề dưới đây:

  • Danh sách các annotation trong Spring là gì ?
  • Kết luận

1. @Configuration

Được sử dụng để chỉ ra rằng class khai báo sử dụng Annotation @Configuration sẽ khai báo một hoặc nhiều @Bean method trong class đó. Những class khai báo với @Configuration sẽ được Spring Container quản lý và tạo Bean trong lúc chương trình đang chạy. Thông thường các bean cấu hình cho dự án tôi để trong này. Ví dụ cấu hình themeleaf, đa ngôn ngữ, và nhiều cấu hình khác cho ứng dụng.

 

2. @Bean

Method (phương thức) sử dụng @Bean ở phía trên sản xuất ra đối tượng bean và được quản lý bởi Spring Container. Bean Annotation có thể sử dụng với các tham số như name, initMethod hoặc destroyMethod.

Ví dụ dưới đây tôi sử dụng @Bean để tạo ra object Spring Template

3. @PreDetroy và @PostConstruct

Đây là cách dùng khác để quản lý vòng đời của Bean. Ngoài cách sử dụng initMethod và destroyMethod. Ta có thể sử dụng @PreDetroy và @PostConstruct với cùng một mục đích.

4. @ComponentScan

Chúng ta sử dụng @ComponentScan để thông báo có Spring Container biết phải vào package nào trong dự án để quét các Annotation và tạo Bean. Như ví dụ bên dưới, Spring sẽ quét tất cả các file trong package levunguyen.spring. Tìm các Class có Annotation để tạo Bean và các @Autowire để nhúng Bean ở trong Container vào các Class sử dụng Autowire.

5. @Component

Khi một class được đánh dấu là Component thì sẽ được tạo thành 1 Bean. Khi Spring Start thì nó quét qua các Annotation có đánh dấu là @Component thì nó sẽ tạo Bean cho class đó. Ví dụ ta có class Contact và ta đánh dấu nó là @Component thì Spring khi đọc qua class này nó sẽ tạo 1 Bean có tên là Contact trong Container của nó. Nếu có class nào dùng thì nó sẽ nhúng Bean này vào. Dùng @Component là để tạo ra một bean.

6. @PropertySource và @Value

Trong Spring, chúng ta sử dụng @PropertySource để cho Spring biết tìm các file properties cấu hình cho hệ thống ở đâu đồng thời sử dụng @Value để lấy các giá trị trong file properties.

Ví dụ bên dưới ta sử dụng classpath để khai báo file properties ta đặt ở đâu trong dự án. Tiếp đến ta sử dụng @Value để lấy các giá trị trong file properties với key tương ứng và gán vào biến mà ta sẽ sử dụng.

Sử dụng để khai báo với Spring đọc các cấu hình trong file resource vào ứng dụng.

7. @Service

Nếu một class được đánh dấu là @Service thì nó là kiểu đặc biệt của @Component. Nó được dùng để xử lý các nghiệp vụ của ứng dụng. Ví dụ như kế toán thì có nghiệp vụ là kiểm tra chi, quản lý thu. Lớp BookServiceImpl dưới đây được đánh dấu là @Service thì nó sẽ phụ trách xử lý các vấn đề liên quan đến nghiệp vụ.

8. @Repository

Nếu một class được đánh dấu là @Repository thì nó là kiểu đặc biệt của @Component . Nó được sử dụng để nói Bean này dùng để truy cập và thao tác xuống cơ sở dữ liệu. Class BookDaoImpl được đánh dấu với @Repository nghĩa là lớp này có nhiệm vụ thực hiện các câu lệnh truy vấn xuống cơ sở dữ liệu.

9. @Autowire

Tự động nhúng các Bean được Spring Container sinh ra vào Class có khai báo @Autowire. Khi Spring nó sẽ tìm kiếm bean có tên là BookDao trong container của nó, sau đó nhúng (hoặc tiêm) vào lớp BookServiceImple. Đây chính là cơ chế DI (Depedency Injection). Khi Spring bắt đầu chạy nó sẽ quét qua các lớp có sử dụng Annotation để tạo Bean đồng thời nó cũng quýt bên trong các Bean xem có khai báo @Autowire không nếu có nó sẽ tìm kiếm Bean tương ứng mà nó quản lý và nhúng vào.

10. @Scope

Khi bean được tạo ra thì nó có nhiều scope khác nhau. Scope ở đây là phạm vi Bean được sinh và và bị phá huỷ dưới sự quản lý của Spring Container. Khi Bean được sinh ra nó có 5 scope (phạm vi được sử dụng):

  • Singleton: đây là scope mặc định của 1 bean khi được sinh ra. Nếu ta không khai báo scope cụ thể thì Bean sẽ lấy Singleton scope. Singleton Bean có nghĩa là Bean chỉ tạo ra 1 lần và được sử dụng trong Container . Chỉ duy nhất 1 Bean tồn tại trong container
  • Prototype: ngược lại với singleton ta muốn có nhiều Bean (đối tượng) thì ta sử dụng scope prototype
  • Request: Bean được sinh ra thông qua các request http (yêu cầu) từ người dùng. Chỉ được dùng trong các ứng dụng web
  • Session: Bean được sinh ra thông qua các http session
  • Global-session: Bean được sinh ra thông qua các request http (yêu cầu) từ người dùng. Chỉ được dùng trong các ứng dụng web

Ví dụ sử dụng @Scope với phạm vi là request

11. @Valid

Dùng để kiểm tra dữ liệu có đúng như mình mong muốn hay không. Ví dụ dưới đây mình mong muốn name là không được rỗng, author không được rỗng. Nếu dữ liệu bị rỗng thì @Validate sẽ bắt lỗi.

12. @Controller

Một class được đánh dấu là Controller thì để khai báo Class đó là một Controller và có nhiệm vụ Mapping Request trên URL vào các method tương ứng trong Controller. Ví dụ dưới đây tôi khai báo Class HomeController là một Controller. Khi người dùng gõ vào http://localhost:8080/ thì sẽ được xử lý bởi Class HomeController. Như vậy nhiệm vụ của Controller là điều hướng các request (yêu cầu) người dùng vào method xử lý.

13. @RequestMapping

Có nhiệm vụ ánh xạ các request (yêu cầu) người dùng vào method tương ứng trong Controller. Ví dụ : Khi ta nhập vào URL là http://localhost:8080/method2 thì nó sẽ được xử lý bởi phương thức là public String method2().

Ví dụ: Khi ta nhập vào URL là http://localhost:8080/method3 thì nó sẽ được xử lý bởi phương thức là public String method3().

14. @PathVariable

PathVariable được sử dụng để xử lý những URL động, có một hoặc nhiều parameter trong URL.

Ví dụ bên dưới khi người dùng gõ vào là http://localhost:8080/test2/10/nguyen.

test2: sẽ ứng với method test2 trong controller thông qua @Request.

10: số 10 sẽ được gán vào biên id nhờ PathVariable (@PathVariable(“id”) int id).

nguyen: chữ nguyên sẽ gán vào biến name nhờ PathVariable (@PathVariable(“name”) String name).

15. @RequestParam

Chúng ta sử dụng @RequestParam để bắt các giá trị các tham số mà người dùng truyền vào trên URL theo định dạng key và value.

Ví dụ tôi có cái link sau http://localhost:8080/api/foos?id=abc. Bây giờ tôi muốn lấy giá trị abc của tham số id trên URL thì tôi sẽ dùng @RequestParam. Ở đây tôi khai báo giá trị tham số trên URL theo định dạng key = value (id=abc).

Chúng ta khai báo @RequestParame trong method getFoos(@RequestParam String id). Như vậy biến id sẽ có giá trị là abc nhờ cơ chế mapping.

16. @ModelAttribute

Một trong những Annotation quan trọng trong Spring đó là @ModelAttribute. Chúng ta sử dụng ModelAttribute như một cầu nối giữa Controller và View. Từ Controller, chúng ta truyền các dữ liệu qua cho View thông qua ModelAttribute. Từ View, chúng ta sẽ sử dụng Themeleaf để đọc các dữ liệu từ model và hiển thị ra cho người dùng.

Tầng View, chúng ta sử dụng model để lấy các giá trị từ người dùng và gắn vào thuộc tính modelAttribute.

Ở tầng Controller, ta sử dụng @ModelAttribute là tham số trong phương thức để lấy các giá trị từ view truyền vào.

17. @RequestBody

@RequestBody được sử dụng để lấy các giá trị mà người dùng gửi lên Server mà các giá trị đó được chứa trong phần thân (body) của request.

Ví dụ như tôi request xong gửi lên server dữ liệu (sendInfo) là một JSON gồm có tên, địa chỉ bằng method post và dữ liệu được gửi trong phần thân của request . Để nhận được dữ liệu JSON này từ client thì chúng ta dùng @RequestBody trong method để lấy kết quả.

Trong method handle ta sử dụng @RequestBody để lấy dữ liệu JSON (sendInfo) từ client gửi lên và gán giá trị đó cho biến body.

18. @ResponseBody

Tôi sử dụng @ResponseBody để nói cho controller biết rằng ta sẽ trả về một đối tượng Object kiểu JSON cho client chứ tôi không render ra một trang view.

Chúng ta có thể dùng @RestController Annotation thay thế @Controller Annotation. Điều này sẽ loại bỏ nhu cầu sử dụng @ResponseBody.

19. @RequestHeader và @ResponseHeader

@RequestHeader được sử dụng khi ta muốn lấy dữ liệu được truyền bằng Header của một request (yêu cầu từ client).

Ví dụ sau ta truyền thêm biến my-number trong phần header của request gửi lên server. @RequestHeader được khai báo trong phương thức doubleNumber có nhiệm vụ lấy giá trị từ header truyền vào biê[email protected]

Chúng ta sử dụng @ResponseHeader khi mình muốn trả về thêm dữ liệu cho client ở phần trên cùng của mỗi response.

Ví dụ sau ta trả thêm các giá trị ở trên phần header cho client thông qua phương thức response.setHeader.

20. @SessionAttribute

Chúng ta sử dụng @SessionAttribute để lưu trữ các giá trị trong một phiên làm việc. Giống như mình làm một ứng dụng shopping cart . Khi người dùng chọn 1 sản phẩm thì mình dùng session mình lưu lại. Khi khách hàng thanh toán giỏ hàng thì ta lấy hết tất cả các mặt hàng chứa trong session ra và tính toán.

Các annotation cho hibernate https://dzone.com/articles/all-hibernate-annotations-mapping-annotations

Author: Lê Vũ Nguyên

Đăng ký nhận bộ tài liệu học Java trên 2 trang giấy tại đây

Xem thêm: Java Coding Bootcamp là gì? Tổng quan về Java Coding Bootcamp


Hãy tham gia nhóm Học lập trình để thảo luận thêm về các vấn đề cùng quan tâm.