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
Nội dung
- 1. @Configuration
- 2. @Bean
- 3. @PreDetroy và @PostConstruct
- 4. @ComponentScan
- 5. @Component
- 6. @PropertySource và @Value
- 7. @Service
- 8. @Repository
- 9. @Autowire
- 10. @Scope
- 11. @Valid
- 12. @Controller
- 13. @RequestMapping
- 14. @PathVariable
- 15. @RequestParam
- 16. @ModelAttribute
- 17. @RequestBody
- 18. @ResponseBody
- 19. @RequestHeader và @ResponseHeader
- 20. @SessionAttribute
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.
@Configuration
public class WebConfig implements WebMvcConfigurer {
@Bean
@Description("Thymeleaf template resolver serving HTML 5")
public ClassLoaderTemplateResolver templateResolver() {
var templateResolver = new ClassLoaderTemplateResolver();
templateResolver.setPrefix("mytemplates/");
templateResolver.setCacheable(false);
templateResolver.setSuffix(".html");
templateResolver.setTemplateMode("HTML5");
templateResolver.setCharacterEncoding("UTF-8");
return templateResolver;
}
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
@Bean
@Description("Thymeleaf template engine with Spring integration")
public SpringTemplateEngine templateEngine() {
var templateEngine = new SpringTemplateEngine();
templateEngine.setTemplateResolver(templateResolver());
return templateEngine;
}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.
public class Computer {
@PostConstruct
public void turnOn(){
System.out.println("Load operating system");
}
@PreDestroy
public void turnOff(){
System.out.println("Close all programs");
}
}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.
@ComponentScan(basePackages = "levunguyen.spring ")
@Configuration
public class SpringComponentScanApp {
// ...
}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.
@Component
@Scope("request")
public class Contact {
}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.
@Configuration
@ComponentScan(basePackages = { "levunguyen.*" })
@PropertySource("classpath:config.properties")
public class AppConfigMongoDB {
//1.2.3.4
@Value("${mongodb.url}")
private String mongodbUrl;
//hello
@Value("${mongodb.db}")
private String defaultDb;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ụ.
@Service
public class BookServiceImpl implements BookService {
}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.
@Repository
public class BookDaoImpl implements BookDao {
}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.
@Service
public class BookServiceImpl implements BookService {
@Autowired
private BookDao bookDao;
@Autowired
private CustomerDao customerDao;
...
}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
@Component
@Scope("request")
public class Contact {
}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.
@Entity
public class Book {
@Id
@GeneratedValue
private Long id;
@NotEmpty(message = "Please provide a name")
private String name;
@NotEmpty(message = "Please provide a author")
private String author;
@NotNull(message = "Please provide a price")
@DecimalMin("1.00")
private BigDecimal price;
//...
}
@RestController
public class BookController {
@PostMapping("/books")
Book newBook(@Valid @RequestBody Book newBook) {
return repository.save(newBook);
}
//...
}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ý.
@Controller
public class HomeController {
@RequestMapping("/")
public String homePage() {
return "home";
}
}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().
//Xử lý cho request có phương thức http là post và url hoặc action method là "/home/method2
@RequestMapping(value = "/method2", method = RequestMethod.POST)
public String method2() {
return "method2";
}
//Xử lý cho request có phương thức http là post hoặc get có url hoặc
// form action method là "/home/method3
@RequestMapping(value = "/method3", method = {RequestMethod.POST, RequestMethod.GET})
public String method3() {
return "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).
@RequestMapping("/test2/{id}/{name}")
public String test2(@PathVariable("id") int id, @PathVariable("name") String name, Model model) {
model.addAttribute("id", id);
model.addAttribute("name", name);
return "test2";
}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.
@GetMapping("/api/foos")
@ResponseBody
public String getFoos(@RequestParam String id) {
return "ID: " + id;
}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.
<form:form method="POST" action="/spring-mvc-basics/addEmployee"
modelAttribute="employee">
<form:label path="name">Name</form:label>
<form:input path="name" />
<form:label path="id">Id</form:label>
<form:input path="id" />
<input type="submit" value="Submit" />
</form:form>Ở 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.
@RequestMapping(value = "/addEmployee", method = RequestMethod.POST)
public String submit( @ModelAttribute("employee") Employee employee) {
model.addAttribute("name", employee.getName());
model.addAttribute("id", employee.getId());
employeeMap.put(employee.getId(), employee);
return "employeeView";
}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ả.
var name = $("#id-manuf-name").val();
var address = $("#id-manuf-address").val();
var phone = $("#id-manuf-phone").val();
var sendInfo = {
Name: name,
Address: address,
Phone: phone
$.ajax({
type: "POST",
url: "/Home/Add",
dataType: "json",
success: function (msg) {
if (msg) {
alert("Somebody" + name + " was added in list !");
location.reload(true);
} else {
alert("Cannot add to list !");
}
},
data: sendInfo
});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.
@RequestMapping(path = "/something", method = RequestMethod.PUT)
public @ResponseBody String helloWorld() {
return "Hello World";
}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ên@ResponseHeader.
@GetMapping("/double")
public ResponseEntity<String> doubleNumber(@RequestHeader("my-number") int myNumber) {
return new ResponseEntity<String>(String.format("%d * 2 = %d",
myNumber, (myNumber * 2)), HttpStatus.OK);
}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.
public String addUser(@Valid User user, BindingResult bindingResult,HttpServletRequest request,HttpServletResponse response)
{
if(bindingResult.hasErrors())
{
bindingResult.getFieldError();
return"edit";
}
response.setHeader("Cache-Control","no-cache,no-store,must-revalidate");
response.setHeader("Pragma","no-cache");
response.setDateHeader("Expires", 0);
return "redirect:/welcome/profile/"+user.getName();
}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.
@Controller
@SessionAttributes("shoppingCart")
public class AddToCartController {
@PostMapping("/addToCart")
public String addToCart(final Model model, @ModelAttribute ShoppingCart shoppingCart, final String productCode) {
if (shoppingCart != null) {
//add product to the shopping cart list
shoppingCart.setProduct(productCode);
model.addAttribute("cart", shoppingCart);
} else {
ShoppingCart cart = new ShoppingCart();
cart.setCustomerName("Super customer");
cart.setProduct(productCode);
model.addAttribute("cart", cart);
}
return "redirect:" + "product-detail-page";
}
@ModelAttribute("shoppingCart")
public ShoppingCart shoppingCart() {
return new ShoppingCart();
}
}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
0 Lời bình