Bookstore API server

A simple bookstore API server written as an excersice for learning Java.

Installation

Download Java and Maven, and set up their path variables

Running the server

git clone https://github.com/samiulsami/apitest.git

cd apitest

mvn package

java -jar target/apitest-1.0-SNAPSHOT-jar-with-dependencies.jar

API Endpoints

method	url	body	actions
GET	http://localhost:8000/bookstore/login	--header 'Authorization: Basic c2FtaToxMjM0'	returns a JWT token $TOKEN
GET	http://localhost:8000/bookstore/books	--header 'Authorization: Bearer $TOKEN'	returns all books
GET	http://localhost:8000/bookstore/books/{id}	--header 'Authorization: Bearer $TOKEN'	returns book with given id
POST	http://localhost:8000/bookstore/books	given below	adds a book
PUT	http://localhost:8000/bookstore/books/{id}	given below	updates book with given id
DELETE	http://localhost:8000/bookstore/books/{id}	--header 'Authorization: Bearer $TOKEN'	deletes book with given id

---

Some cURL commands

Login and receive a JWT $TOKEN (username: sami, password: 1234)

curl --location 'http://localhost:8000/bookstore/login' \
--header 'Authorization: Basic c2FtaToxMjM0'

Show all books

curl --location 'http://localhost:8000/bookstore/books' \
--header 'Authorization: Bearer $TOKEN'

Show book with given {id}

curl --location 'http://localhost:8000/bookstore/books/1' \
--header 'Authorization: Bearer $TOKEN'

Add book

curl --location --request POST 'http://localhost:8000/bookstore/books' \
--header 'title: dsad' \
--header 'authorName: askdj' \
--header 'authorID: 123' \
--header 'pages: 111' \
--header 'Authorization: Bearer $TOKEN'

Update book with given {id}

curl --location --request PUT 'http://localhost:8000/bookstore/books/6' \
--header 'title: Cat Cafe' \
--header 'authorName: George Orwell' \
--header 'pages: 140' \
--header 'authorID: 2' \
--header 'Authorization: Bearer $TOKEN'

Delete book with given {id}

curl --location --request DELETE 'http://localhost:8000/bookstore/books/5' \
--header 'Authorization: Bearer $TOKEN'

---

References

• https://metamug.com/article/security/jwt-java-tutorial-create-verify.html
• https://github.com/metamug/java-jwt/blob/master/src/test/java/com/metamug/jwt/JWebTokenTest.java
• https://medium.com/consulner/framework-less-rest-api-in-java-dd22d4d642fa
• https://github.com/heheh13/api-server
• https://github.com/MobarakHsn/api-server/tree/master
• https://github.com/AbdullahAlShaad/bookstore-api-server
• https://codefresh.io/blog/java_docker_pipeline/
• https://stackoverflow.com/questions/2022032/building-a-runnable-jar-with-maven-2

Download and run Docker Image

docker pull sami7786/apitest:1.0

OR

docker build -t sami7786/apitest:1.0 .

docker run -p 8000:8000 sami7786/apitest:1.0

Make File

TODO