Let's take a simple web service as

Let's take a simple web service as an example: querying a phonebook application for the details of a given user. All we have is the user's ID.

Using Web Services and SOAP, the request would look something like this:





12345



(The details are not important; this is just an example.) The entire shebang now has to be sent (using an HTTP POST request) to the server. The result is probably an XML file, but it will be embedded, as the "payload", inside a SOAP response envelope.

And with REST? The query will probably look like this:

http://www.acme.com/phonebook/UserDetails/12345
Note that this isn't the request body -- it's just a URL. This URL is sent to the server using a simpler GET request, and the HTTP reply is the raw result data -- not embedded inside anything, just the data you need in a way you can directly use.

It's easy to see why Web Services are often used with libraries that create the SOAP/HTTP request and send it over, and then parse the SOAP response.
With REST, a simple network connection is all you need. You can even test the API directly, using your browser.
Still, REST libraries (for simplifying things) do exist, and we will discuss some of these later.
Note how the URL's "method" part is not called "GetUserDetails", but simply "UserDetails". It is a common convention in REST design to use nouns rather than verbs to denote simple resources.

The letter analogy
A nice analogy for REST vs. SOAP is mailing a letter: with SOAP, you're using an envelope; with REST, it's a postcard. Postcards are easier to handle (by the receiver), waste less paper (i.e., consume less bandwidth), and have a short content. (Of course, REST requests aren't really limited in length, esp. if they use POST rather than GET.)

But don't carry the analogy too far: unlike letters-vs.-postcards, REST is every bit as secure as SOAP. In particular, REST can be carried over secure sockets (using the HTTPS protocol), and content can be encrypted using any mechanism you see fit. Without encryption, REST and SOAP are both insecure; with proper encryption in place, both are equally secure.

Kết quả (Việt) 1:

chúng ta hãy một dịch vụ web đơn giản là một ví dụ: truy vấn một ứng dụng danh bạ điện thoại cho các chi tiết của một người dùng. tất cả chúng ta có là id của người sử dụng

sử dụng dịch vụ web và xà phòng, yêu cầu sẽ giống như thế này:.?


acme.com / danh bạ ">

12345



(các chi tiết không quan trọng;. này chỉ là một ví dụ) toàn bộ công việc bây giờ đã được gửi (sử dụng một yêu cầu http post) đến máy chủ kết quả có thể là một tập tin xml, nhưng nó sẽ được nhúng, là "tải trọng". , bên trong một phong bì phản ứng xà phòng.

và với phần còn lại?truy vấn có thể sẽ trông như thế này:


http://www.acme.com/phonebook/userdetails/12345 lưu ý rằng đây không phải là cơ quan yêu cầu - nó chỉ là một địa chỉ. url này được gửi đến máy chủ bằng cách sử dụng nhận được yêu cầu đơn giản, và http trả lời là dữ liệu kết quả thô -. không nhúng vào bên trong bất cứ điều gì, chỉ cần các dữ liệu bạn cần trong một cách mà bạn có thể sử dụng trực tiếp

thật dễ dàng để xem lý do tại sao các dịch vụ web thường được sử dụng với các thư viện mà tạo yêu cầu xà phòng / http và gửi nó qua, và sau đó phân tích các phản ứng xà phòng.
với phần còn lại, một kết nối mạng đơn giản là tất cả các bạn cần. thậm chí bạn có thể kiểm tra các api trực tiếp, sử dụng trình duyệt của bạn.
vẫn còn, thư viện còn lại (đối với đơn giản hóa mọi thứ) có tồn tại, và chúng tôi sẽ thảo luận về một số trong những sau đó.
lưu ý như thế nào "phương pháp" một phần của url không được gọi là "getuserdetails", nhưng chỉ đơn giản là "UserDetails". nó là một quy ước chung trong thiết kế phần còn lại sử dụng danh từ chứ không phải là động từ để biểu thị tài nguyên đơn giản

tương tự thư
một tương tốt đẹp cho phần còn lại, so với xà phòng được gởi một bức thư:. bằng xà phòng, bạn đang sử dụng một phong bì, với phần còn lại , đó là một tấm bưu thiếp. bưu thiếp được dễ dàng hơn để xử lý (bởi người nhận),lãng phí giấy ít hơn (ví dụ, tiêu thụ ít băng thông), và có một nội dung ngắn. (Tất nhiên, yêu cầu còn lại không thực sự giới hạn chiều dài, đặc biệt nếu họ sử dụng bài thay vì nhận được..)

Nhưng không thực hiện tương tự quá xa: không giống như chữ-vs-bưu thiếp, phần còn lại là mỗi bit như đảm bảo như xà phòng. đặc biệt, phần còn lại có thể được thực hiện trên ổ cắm an toàn (sử dụng giao thức https),và nội dung có thể được mã hóa bằng cách sử dụng bất kỳ cơ chế bạn thấy phù hợp. mà không cần mã hóa, nghỉ ngơi và xà phòng đều không an toàn, với mã hóa thích hợp tại chỗ, cả hai đều an toàn.

Kết quả (Việt) 2:

Hãy lấy một dịch vụ web đơn giản như là một ví dụ: truy vấn ứng dụng danh bạ để biết chi tiết của một người dùng nhất định. Tất cả chúng ta có là ID của người dùng.

sử dụng dịch vụ Web và xà phòng, yêu cầu sẽ xem xét một cái gì đó như thế này:


< xà phòng: phong Bì
xmlns:soap = "http://www.w3.org/2001/12/soap-envelope"
xà phòng: encodingStyle = "http://www.w3.org/2001/12/soap-encoding" >
< xà phòng: cơ thể pb = "http://www.Acme.com/phonebook">

12345



(các chi tiết là không quan trọng; đây là chỉ là một ví dụ.) Shebang toàn bộ bây giờ đã gửi (bằng cách sử dụng một yêu cầu HTTP bài) vào hệ phục vụ. Kết quả có thể là một tập tin XML, nhưng nó sẽ được nhúng vào, như "trọng", bên trong một xà phòng phản ứng phong bì.

và với phần còn lại? Các truy vấn có thể sẽ giống như thế này:

http://www.acme.com/phonebook/UserDetails/12345
lưu ý rằng đây không phải là yêu cầu cơ thể - đó là chỉ cần một URL. URL này sẽ được gửi đến máy chủ bằng cách sử dụng một GET yêu cầu đơn giản, và trả lời HTTP là dữ liệu nguyên quả--không nhúng bên trong bất cứ điều gì, chỉ cần các dữ liệu mà bạn cần trong một cách bạn có thể trực tiếp sử dụng.

Nó rất dễ dàng để xem tại sao dịch vụ Web thường được sử dụng với các thư viện tạo ra yêu cầu SOAP/HTTP và gửi nó qua, và sau đó phân tích cú pháp phản ứng xà phòng.
với phần còn lại, một kết nối mạng đơn giản là tất cả các bạn cần. Bạn có thể thậm chí thử API trực tiếp, bằng cách sử dụng trình duyệt của bạn.
Tuy nhiên, còn lại thư viện (đối với đơn giản hóa những điều) tồn tại, và chúng tôi sẽ thảo luận về một số các sau.
Lưu ý làm thế nào các URL "phương thức" phần không được gọi là "GetUserDetails", nhưng chỉ đơn giản là "UserDetails". Đó là một quy ước phổ biến trong thiết kế còn lại để sử dụng từ chứ không phải là động từ để chỉ đơn giản tài nguyên.

tương tự thư
một tương tự tốt đẹp cho phần còn lại so với xà phòng gửi thư một lá thư: với xà phòng, bạn đang sử dụng một phong bì; với phần còn lại, nó là một bưu thiếp. Bưu thiếp dễ dàng hơn để xử lý (bởi người nhận), lãng phí giấy ít hơn (tức là, tiêu thụ băng thông ít hơn), và có một nội dung ngắn. Thực (Tất nhiên, còn lại yêu cầu không phải là sự giới hạn dài, đặc biệt nếu họ sử dụng bài chứ không phải là GET.)

Nhưng không thực hiện tương tự quá xa: không giống như chữ cái vs bưu thiếp, còn lại là mỗi bit như là an toàn như xà phòng. Đặc biệt, phần còn lại có thể được thực hiện trên ổ cắm an toàn (sử dụng giao thức HTTPS), và nội dung có thể được mã hóa bằng cách sử dụng bất kỳ cơ chế mà bạn thấy phù hợp. Nếu không có mã hóa, nghỉ ngơi và xà phòng là cả hai không an toàn; với mã hóa thích hợp tại chỗ, cả hai đều không kém an toàn.