Khung Restlet bao gồm bốn phần chính.
1. Restlet API
Thứ nhất, đó là "API Restlet", một API trung hỗ trợ các khái niệm về REST và tạo điều kiện cho việc xử lý các cuộc gọi cho cả client-side và server-side ứng dụng. API này được hỗ trợ bởi Restlet Engine và cả hai đều được vận chuyển trong một JAR ("org.restlet.jar").
Sự tách biệt giữa API và triển khai này tương tự với API giữa Servlet API và Web container như Jetty hoặc Tomcat hoặc giữa JDBC API và trình điều khiển JDBC cụ thể.
2. Lấy nội dung của một trang Web
Như chúng ta đã đề cập trong giấy giới thiệu, khuôn khổ Restlet là cùng lúc một khách hàng và một khung máy chủ. Ví dụ, Restlet có thể dễ dàng làm việc với các tài nguyên từ xa bằng cách sử dụng trình kết nối máy khách HTTP của nó. Một kết nối trong REST là một phần tử phần mềm cho phép giao tiếp giữa các thành phần, thường bằng cách thực hiện một bên của một giao thức mạng. Restlet cung cấp một số việc triển khai các trình kết nối máy khách dựa trên các dự án nguồn mở hiện có. Phần trình kết nối liệt kê tất cả các trình kết nối máy khách và máy chủ có sẵn và giải thích cách sử dụng và định cấu hình chúng.
Ở đây chúng ta sẽ nhận được các đại diện của một nguồn tài nguyên hiện có và đầu ra nó trong JVM console:
// Outputting the content of a Web page
new ClientResource("http://").get().write(System.out);
Lưu ý rằng ví dụ trên sử dụng một cách đơn giản để phát hành các cuộc gọi thông qua ClientResource lớp. Nếu bạn cần kiểm soát nhiều luồng hoặc kiểm soát nhiều hơn, bạn vẫn có thể thao tác sử dụng trực tiếp lớp Khách hàng hoặc trực tiếp yêu cầu Yêu cầu đối tượng. Ví dụ bên dưới cách đặt một số tùy chọn trong cuộc gọi khách hàng của bạn, như URI liên kết giới thiệu. Nó cũng có thể là các ngôn ngữ và các loại phương tiện mà bạn muốn nhận như một phản ứng:
// Create the client resource
ClientResource resource = new ClientResource("http://www.restlet.org");
// Customize the referrer property
resource.setReferrerRef("http://www.mysite.org");
// Write the response entity on the console
resource.get().write(System.out);
3. Lắng nghe các trình duyệt Web
Bây giờ, chúng tôi muốn xem cách khung Restlet có thể nghe khách hàng yêu cầu và trả lời chúng. Chúng ta sẽ sử dụng trình kết nối máy chủ HTTP Restlet nội bộ (mặc dù nó có thể chuyển sang những người khác như là dựa trên Jetty của Mortbay) và trả về một biểu diễn chuỗi đơn giản là "hello, world" dưới dạng văn bản thuần túy. Lưu ý rằng lớp Part03 mở rộng cơ sở ServerResource lớp được cung cấp bởi Restlet:
public class Part03 extends ServerResource {
public static void main(String[] args) throws Exception {
// Create the HTTP server and listen on port 8182
new Server(Protocol.HTTP, 8182, Part03.class).start();
}
@Get
public String toString() {
return "hello, world";
}
}
Nếu bạn chạy mã này và khởi động máy chủ của bạn, bạn có thể mở một trình duyệt Web và nhấn. Trên thực tế, bất kỳ URI nào cũng sẽ hoạt động, hãy thử thêm. Lưu ý rằng nếu bạn kiểm tra máy chủ của mình từ một máy khác, bạn cần phải thay thế "localhost" bằng địa chỉ IP của máy chủ của bạn hoặc tên miền của máy chủ nếu nó được xác định.
Cho đến nay, chúng tôi đã cho bạn thấy mức trừu tượng cao nhất trong API Restlet, với các lớp ClientResource và ServerResource. Nhưng khi chúng ta tiến lên phía trước, bạn sẽ khám phá ra rằng hai lớp đó được hỗ trợ bởi một API phong phú, cho phép bạn thao tác tất cả các tạo tác REST.
4. Tổng quan về một kiến trúc REST
Hãy bước trở lại một chút và xem xét kiến trúc web điển hình từ một điểm REST của xem. Trong sơ đồ dưới đây, các cổng đại diện cho đầu nối cho phép giao tiếp giữa các thành phần được biểu diễn bằng các hộp lớn hơn.
Oh, làm thế nào để tôi cảm thấy đau đớn của bạn! Chắc chắn là một cuộc bỏ phiếu! – BobbyShaftoe
Kiểm tra http://stackoverflow.com/questions/1710199/which-is-the-best-java-rest-api-restlet-or-jersey và xem xét liệu đây có phải là bản sao chính xác hay không. – ripper234
Tôi đồng ý với bạn! Người ta sẽ nghĩ rằng một API như RESTlet sẽ "giúp" bạn. Tôi có thể viết một khung công tác dịch vụ web đơn giản trong một phần ba thời gian để tôi hiểu kiến trúc RESTlet. – Spider