HugoFMiranda / java-rest-books

Sample code of DZone article about Spring REST service

java-rest-books

Sample code of DZone article: https://dzone.com/articles/leverage-http-status-codes-to-build-a-rest-service

Requirements

• JDK 8
• Maven 3.x

Setup

Clone the repository:

git clone https://github.com/sbouclier/java-rest-books.git

Go inside the folder:

cd java-rest-books/

Run the application:

mvn clean install spring-boot:run

Open your browser an go to http://localhost:8080/api/books to see some books.

API methods

Create book

curl -X POST --header 'Content-Type: application/json' --header 'Accept: */*' -d '{ \ 
   "authors": [ \ 
     { \ 
       "firstName": "John", \ 
       "lastName": "Doe" \ 
     } \ 
   ], \ 
   "description": "desc", \ 
   "isbn": "123-1234567890", \ 
   "publisher": "My publisher", \ 
   "title": "My book" \ 
 }' 'http://localhost:8080/api/books'

Get a book

curl -X GET --header 'Accept: application/json' 'http://localhost:8080/api/books/978-0321356680'

Update book

curl -X PUT --header 'Content-Type: application/json' --header 'Accept: application/json' -d '{ \ 
   "authors": [ \ 
     { \ 
       "firstName": "John", \ 
       "lastName": "Doe" \ 
     } \ 
   ], \ 
   "description": "new desc", \ 
   "isbn": "978-1617292545", \ 
   "publisher": "new publisher", \ 
   "title": "new title" \ 
 }' 'http://localhost:8080/api/books/978-1617292545'

Update a book's description

curl -X PATCH --header 'Content-Type: application/json' --header 'Accept: application/json' -d 'new description' 'http://localhost:8080/api/books/978-1491900864'

Delete a book

curl -X DELETE --header 'Accept: */*' 'http://localhost:8080/api/books/978-1617292545'

Get all books

curl -X GET --header 'Accept: application/json' 'http://localhost:8080/api/books?sort=id&order=asc'