RESTful and HATEOAS Services: Revisited
RESTful and HATEOAS Services: Revisited
Still not clear on the differences between RESTful and HATEOAS services? Read on for some clarity.
Join the DZone community and get the full member experience.
Join For FreeSnapLogic is the leading self-service enterprise-grade integration platform. Download the 2018 GartnerMagic Quadrant for Enterprise iPaaS or play around on the platform, risk free, for 30 days.
I get a lot of traffic for my original article on RESTful and HATEOAS services, so I’ve decided to update and revise the article.
REST stands for Representational State Transfer. The main selling point of RESTful Services is that they are designed to be used on the internet using HTTP. It has the following constraints –
- Resources: Easily understood directory structure URI.
- Uniform Interface: Create, Retrieve, Update, Delete are accessed over HTTP via POST, GET, PUT, and DELETE methods.
- Messages: Most commonly these are JSON, but can be any format — HTML, XML, plain text, …
- Stateless: Interactions not stored, and state is handled in the request.
RESTful Examples
| GET | Select | GET /customerservice/customers/1 |
| POST | Create | POST /customerservice/customers |
| PUT | Update or Create – Idempotent | PUT /customerservice/customers |
| PATCH | Update only – Idempotent | PATCH /customerservice/customers/1 |
| DELETE | Remove record | DELETE /customerservice/customers/1 |
The HTTP return codes are used for success/failure:
| 1xx | Informational |
| 2xx | Success |
| 3xx | Redirection |
| 4xx | Client Error |
| 5xx | Server Error |
HATEOAS is an additional constraint on RESTful services. It requires the response to return the location of the data, and you can also return a list of other operations at that point. The advantage of this approach is that you can navigate the RESTful service model.
HATEOAS Examples
GET customerservice/customers/1 HTTP/1.1 HTTP/1.1 200 OK
<?xml version=”1.0″?>
<customer>
<id>1</id>
</customer>
Would have an additional link paramater to show its source
<?xml version=”1.0″?>
<customer>
<id>1</id>
<link rel=”self” href=”http://localhost:8080/customerservice/customers/1″; />
</customer>With SnapLogic’s integration platform you can save millions of dollars, increase integrator productivity by 5X, and reduce integration time to value by 90%. Sign up for our risk-free 30-day trial!
Like This Article? Read More From DZone
Published at DZone with permission of Martin Farrell , DZone MVB. See the original article here.
Opinions expressed by DZone contributors are their own.
{{ parent.title || parent.header.title}}
{{ parent.tldr }}
{{ parent.linkDescription }}
{{ parent.urlSource.name }}