design eines restful-API zum Buch-management-system (JSON-Daten, Spring MVC, Restful API)

Ich bin neu, um all die Sachen habe ich unten geschrieben. Ich weiß, Grundkenntnisse in Java-Programmierung. Benutzt habe ich die base-level-soap-Sachen in der Vergangenheit. Aber hier verstehe ich nicht, was das Rest-API ist? Wie sieht es aus? Was hat es zu liefern, wenn sein entwickelt?

Ich würde schätzen jede Hilfe, die können mich führen, wo Sie anfangen sollen, welche Klassen zu erstellen, welche Technologien zu verstehen, bevor ich diese Arbeit. Ich möchte wirklich lernen, dieses Zeug.

Ich bauen möchte, eine RESTful API mit Spring MVC

Muss ich bauen Sie ein Buch-management-system für die Bibliothek.

1)Bedarf Es der Unterstützung von JSON-Daten-format für die API.

2)Anwendung Bezeichnung "Bibliothek", so dass auf allen Endpunkten starten mit

3)http://x.x.x.x:8080/library.

4)Application server muss ausgeführt werden, auf port 8080.

1)Ressourcen-Modell

Bücher ---> Bewertungen
|
|
Autoren

2) Ressource Details

Bücher

---ISBN (Key) # Sie generieren diesen Schlüssel.

---Titel (erforderliches Feld)

---Datum der Veröffentlichung (Pflichtfeld)

---Sprache (Optionales Feld)

---Anzahl der Seiten (Optionales Feld)

- - - - Status {verfügbar, Check-out, in-Warteschlange oder verloren} # default auf 'verfügbar'

Autoren

- - - - ID (Key) # Sie generieren diesen Schlüssel.

- - - - Name (Pflichtfeld)

Bewertungen

- - - - ID (Key) # Sie generieren diesen Schlüssel.

---Bewertung (1-5 Sterne) (Pflichtfeld)

---Kommentar (Pflichtfeld)

*API ' s zu bauen*
1) Root-API -

○ Ressource: GET - /(E. g http://x.y.z:8080/library/v1/)

○ Beschreibung: Dies ist, wo kann der Kunde den workflow starten des Systems. Gibt eine Liste der links, um den workflow zu starten, die zum erstellen neuer Bücher.

Erwartete Antwort:

HTTP Code: 200
{
“links” : [
{ “rel”: “create-book”, “herf”: “/books”, “method”: “POST” }
]
}

2)Buch Erstellen-API

○ Ressource: POST - /Bücher

○ Beschreibung: Fügen Sie ein neues Buch zusammen mit dem Autor-Informationen in die Bibliothek.

Beispiel-Anfrage: POST /Bücher mit den folgenden payload in den request-body.

{
"title" : "Programming Amazon EC2",
"publication-date" : "2/11/2011",
"language" : "eng",
"num-pages": 185,
"status" : "available",
"authors" : [
{ "name" : "Jurg Vliet" },
{"name" : "FlaviaPagenelli"} ]
}

Erwartete Antwort:

HTTP Code: 201

{
“links” : [
{ “rel”: “view-book”, “herf”: “/books/1”, “method”: “GET” },
{ “rel”: “update-book”, “herf”: “/books/1”, “method”: “PUT” },
{ “rel”: “delete-book”, “herf”: “/books/1”, “method”: “DELETE” },
{ “rel”: “create-review”, “herf”: “/books/1/reviews”, “method”: “POST” }
]
}

Ebenso viele weitere API ' s......

Dankend im Voraus, Jede Hilfe ist willkommen.