Nếu ứng dụng của các bạn sử dụng Spring Framework 7 trở lên thì từ nay các bạn có thể sử dụng class RestClient để consume các RESTful APIs rồi. Cụ thể như thế nào? Hãy cùng mình tìm hiểu trong bài viết này các bạn nhé!
Để làm ví dụ, mình sẽ tạo mới một Spring Boot project version 4.0.0 trở đi, sử dụng Web Starter dependency như sau:
Mình sẽ consume 2 API mà mình đã expose trong 2 bài viết về API Versioning sử dụng request header và path parameter các bạn nhé!
Để làm ví dụ, để đơn giản, mình cũng sẽ sử dụng class CommandLineRunner để khi chạy ứng dụng Spring Boot lên, nó sẽ gọi tới 2 APIs trên sử dụng class RestClient.
Các bạn có thể khởi tạo đối tượng của class RestClient với baseURL như sau:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 |
package com.huongdanjava.springboot; import org.springframework.boot.CommandLineRunner; import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; import org.springframework.context.ApplicationContext; import org.springframework.context.annotation.Bean; import org.springframework.web.client.RestClient; @SpringBootApplication public class SpringBootRestClientApplication { public static void main(String[] args) { SpringApplication.run(SpringBootRestClientApplication.class, args); } @Bean CommandLineRunner commandLineRunner(ApplicationContext ctx) { return args -> { RestClient restClient = RestClient.builder() .baseUrl("http://localhost:8080") .build(); }; } } |
Nếu RESTful API mà các bạn cần consume có sử dụng API Versioning, như ví dụ trong bài viết API Versioning sử dụng request header với Spring framework thì các bạn có thể sử dụng class ApiVersionInserter để thêm thông tin version, ví dụ như sau:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 |
package com.huongdanjava.springboot; import org.springframework.boot.CommandLineRunner; import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; import org.springframework.context.ApplicationContext; import org.springframework.context.annotation.Bean; import org.springframework.web.client.ApiVersionInserter; import org.springframework.web.client.RestClient; @SpringBootApplication public class SpringBootRestClientApplication { public static void main(String[] args) { SpringApplication.run(SpringBootRestClientApplication.class, args); } @Bean CommandLineRunner commandLineRunner(ApplicationContext ctx) { return args -> { ApiVersionInserter apiVersionInserter = ApiVersionInserter.builder() .useHeader("X-Api-Version") .build(); RestClient restClient = RestClient.builder() .baseUrl("http://localhost:8080") .apiVersionInserter(apiVersionInserter) .build(); }; } } |
Vì API trong bài viết API Versioning sử dụng request header với Spring framework sử dụng header để làm API versioning nên các bạn có thể sử dụng phương thức useHeader() của class ApiVersionInserter để thêm thông tin header name. Giá trị của header name này sẽ được khai báo khi chúng ta gọi tới endpoint “/hello” như sau:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 |
package com.huongdanjava.springboot; import org.springframework.boot.CommandLineRunner; import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; import org.springframework.context.ApplicationContext; import org.springframework.context.annotation.Bean; import org.springframework.http.MediaType; import org.springframework.web.client.ApiVersionInserter; import org.springframework.web.client.RestClient; @SpringBootApplication public class SpringBootRestClientApplication { public static void main(String[] args) { SpringApplication.run(SpringBootRestClientApplication.class, args); } @Bean CommandLineRunner commandLineRunner(ApplicationContext ctx) { return args -> { ApiVersionInserter apiVersionInserter = ApiVersionInserter.builder() .useHeader("X-Api-Version") .build(); RestClient restClient = RestClient.builder() .baseUrl("http://localhost:8080") .apiVersionInserter(apiVersionInserter) .build(); String body = restClient.get() .uri("/hello") .accept(MediaType.APPLICATION_JSON) .apiVersion("1.0.0") .retrieve() .body(String.class); System.out.println(body); }; } } |
Như các bạn thấy, chúng ta sử dụng phương thức apiVersion() để truyền thông tin version của endpoint.
Kết quả khi các bạn chạy ví dụ này như sau:
Nếu các bạn request tới API trong bài viết API Versioning sử dụng path parameter với Spring framework thì các bạn có thể sử dụng phương thức usePathSegment() của class ApiVersionInserter để định nghĩa segment chứa thông tin version như sau:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 |
package com.huongdanjava.springboot; import org.springframework.boot.CommandLineRunner; import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; import org.springframework.context.ApplicationContext; import org.springframework.context.annotation.Bean; import org.springframework.http.MediaType; import org.springframework.web.client.ApiVersionInserter; import org.springframework.web.client.RestClient; @SpringBootApplication public class SpringBootRestClientApplication { public static void main(String[] args) { SpringApplication.run(SpringBootRestClientApplication.class, args); } @Bean CommandLineRunner commandLineRunner(ApplicationContext ctx) { return args -> { ApiVersionInserter apiVersionInserter = ApiVersionInserter.builder() .usePathSegment(0) .build(); RestClient restClient = RestClient.builder() .baseUrl("http://localhost:8080") .apiVersionInserter(apiVersionInserter) .build(); String body = restClient.get() .uri("/hello") .accept(MediaType.APPLICATION_JSON) .apiVersion("v1.0.0") .retrieve() .body(String.class); System.out.println(body); }; } } |
Kết quả khi mình chạy ví dụ này như sau:
