RESTful Web Services - Java (JAX-RS)
JAX-RSlà viết tắt của JAVA API cho RESTful Web Services. JAX-RS là một đặc tả và API ngôn ngữ lập trình dựa trên JAVA để cung cấp hỗ trợ cho các Dịch vụ Web RESTful đã tạo. Phiên bản 2.0 của nó được phát hành vào ngày 24 tháng 5 năm 2013. JAX-RS sử dụng các chú thích có sẵn từ Java SE 5 để đơn giản hóa việc phát triển tạo và triển khai các dịch vụ web dựa trên JAVA. Nó cũng cung cấp hỗ trợ tạo máy khách cho Dịch vụ Web RESTful.
Thông số kỹ thuật
Sau đây là các chú thích được sử dụng phổ biến nhất để ánh xạ tài nguyên dưới dạng tài nguyên dịch vụ web.
Sr.No. | Chú thích & Mô tả |
---|---|
1 |
@Path Đường dẫn tương đối của lớp / phương thức tài nguyên. |
2 |
@GET Yêu cầu HTTP Get, được sử dụng để tìm nạp tài nguyên. |
3 |
@PUT Yêu cầu HTTP PUT, được sử dụng để cập nhật tài nguyên. |
4 |
@POST Yêu cầu HTTP POST, được sử dụng để tạo tài nguyên mới. |
5 |
@DELETE Yêu cầu HTTP DELETE, được sử dụng để xóa tài nguyên. |
6 |
@HEAD Yêu cầu HTTP HEAD, được sử dụng để nhận trạng thái khả dụng của phương thức. |
7 |
@Produces Nêu rõ Phản hồi HTTP được tạo bởi dịch vụ web. Ví dụ: APPLICATION / XML, TEXT / HTML, APPLICATION / JSON, v.v. |
số 8 |
@Consumes Nêu loại Yêu cầu HTTP. Ví dụ: application / x-www-formurlencoded để chấp nhận dữ liệu biểu mẫu trong phần thân HTTP trong khi yêu cầu POST. |
9 |
@PathParam Liên kết tham số được truyền cho phương thức với một giá trị trong đường dẫn. |
10 |
@QueryParam Liên kết tham số được truyền cho phương thức với tham số truy vấn trong đường dẫn. |
11 |
@MatrixParam Liên kết tham số được truyền cho phương thức với tham số ma trận HTTP trong đường dẫn. |
12 |
@HeaderParam Liên kết tham số được truyền cho phương thức với tiêu đề HTTP. |
13 |
@CookieParam Liên kết tham số được truyền cho phương thức với Cookie. |
14 |
@FormParam Liên kết tham số được truyền cho phương thức thành một giá trị biểu mẫu. |
15 |
@DefaultValue Gán giá trị mặc định cho một tham số được truyền cho phương thức. |
16 |
@Context Bối cảnh của tài nguyên. Ví dụ: HTTPRequest làm ngữ cảnh. |
Note- Chúng tôi đã sử dụng Jersey, một triển khai tham chiếu của JAX-RS 2.0 của Oracle, trong các chương RESTful Web Services - Ứng dụng đầu tiên và RESTful Web Services - Các chương.