/petstore

JEE Mini Project

Primary LanguageJava

PetStore Application

Introduction

MicroProfile Starter has generated this MicroProfile application for you.

This project uses Quarkus, the Supersonic Subatomic Java Framework.

If you want to learn more about Quarkus, please visit its website: https://quarkus.io/ .

Packaging and running the application

If you want to build an ??ber-jar, execute the following command:

./gradlew build -Dquarkus.package.type=uber-jar

To run the application:

java -jar build/petstore-runner.jar

The application can be also packaged using simple:

./gradlew build

It produces the quarkus-run.jar file in the build/quarkus-app/ directory. Be aware that it is not an ??ber-jar as the dependencies are copied into the build/quarkus-app/lib/ directory.

To launch the test page, open your browser at the following URL

http://localhost:8080/index.html

Running the application in dev mode

You can run your application in dev mode that enables live coding using:

./gradlew quarkusDev

NOTE: Quarkus now ships with a Dev UI, which is available in dev mode only at http://localhost:8080/q/dev/.

Creating a native executable

Mind having GRAALVM_HOME set to your Mandrel or GraalVM installation.

You can create a native executable using:

./gradlew build -Dquarkus.package.type=native

Or, if you don't have Mandrel or GraalVM installed, you can run the native executable build in a container using:

./gradlew build -Dquarkus.package.type=native -Dquarkus.native.container-build=true

Or to use Mandrel distribution:

./gradlew build -Dquarkus.package.type=native -Dquarkus.native.container-build=true -Dquarkus.native.builder-image=quay.io/quarkus/ubi-quarkus-mandrel:20.3-java11

You can then execute your native executable with:

./build/petstore-runner

If you want to learn more about building native executables, please consult https://quarkus.io/guides/building-native-image.

Creating a Docker Image

./gradlew build -Dquarkus.package.type=native -Dquarkus.native.container-build=true -Dquarkus.container-image.build=true

To check built docker image

docker images

To run the docker image

docker -i --rm -p 8080:8080 vinuri/petstore:unspecified Specify your relevant Image name & tag.

You can check running containers with below command docker ps

Then, try accessing http://localhost:8080/v1/pets

Deploying Application

To deploy the demo app on a docker-compose please visit ./deploy

CURL Commands

CURL/WGET command to test the APIs once deployed curl -v <url> e.g. curl -v http://localhost:8080/v1/pets

◾ Pets

i. Get all pets

curl --location --request GET http://localhost:8080/v1/pets

ii. Get pet by ID (id=1)

curl --location --request GET http://localhost:8080/v1/pets/1

iii. Add a pet

curl -H "Content-Type: application/json" -X POST http://localhost:8080/v1/pets/add -d "{\"petAge\": \"1\",\"petId\": \"4\",\"petName\": \"Tiki\", \"petType\": \"Fish\"}"

iv. Delete a Pet (id=3)

curl --location --request DELETE http://localhost:8080/v1/pets/delete/3

v. Update a Pet (id=4)

curl -H "Content-Type: application/json" -X PUT http://localhost:8080/v1/pets/4 -d "{\"petAge\": \"2\",\"petName\": \"Kiki\", \"petType\": \"Fish\"}"

vi. Search pet by name

curl --location --request GET http://localhost:8080/v1/pets/name/Sudda

vii. Search pet by age

curl --location --request GET http://localhost:8080/v1/pets/age/2

◾ Pet Types

i. Get all types

curl --location --request GET http://localhost:8080/v1/pets-types

ii. Get pet type by ID (id=1)

curl --location --request GET http://localhost:8080/v1/pets-types/1

iii. Add a pet type

curl -H "Content-Type: application/json" -X POST http://localhost:8080/v1/pets-types/add -d "{\"petId\": \"4\",\"petTypeType\": \"Fish\"}"

iv. Delete a Pet type (id=2)

curl --location --request DELETE http://localhost:8080/v1/pets-types/delete/2

v. Update a Pet type

curl -H "Content-Type: application/json" -X PUT http://localhost:8080/v1/pets-types/3 -d "{\"petTypeType\": \"Cat\"}"

Testing

To run test suite ./gradlew test

You can find the test cases in the src/test folder. (PetResourceTest.java & PetTypeResourceTest.java)

Run in Postman