Item-Search-service

Item Search API retrieves data from iTunes Store and Google Books. It uses resilience4j for the service to be resilient when the iTunes api and google api do not respond or respond with latency more than 3 seconds(it is configurable) Errors (including timeouts) from any of the upstream services won't affect user's request. resilience4j also gives the concurrency to call each API. to adjust the max result of search for api calls set the environment variable MAX_RESULTS or pass via parameter -DMAX_RESULTS=5. they also defined in docker-compose.yml files.

##Other options for Resiliency and Concurrency Another approach is by using Spring WebFlux and Spring WebClient.

Another approach is by using ExecutorService to call each API and Future.get(3, TimeUnit.SECONDS) for fetching and Resiliency

Software needed

1. Apache Maven (http://maven.apache.org).
2. Docker (http://docker.com).
3. Git Client (http://git-scm.com).

Building the Docker Image

To build the code for project as a docker image, open a command-line window change to the directory where you have downloaded the project source code.

Run the following maven command. This command will execute the Spotify docker plugin defined in the pom.xml file.

mvn clean package docker:build

If everything builds successfully you should see a message indicating that the build was successful.

Running the Application

Now we are going to use docker-compose to start the actual image. To start the docker image, change to the directory containing your project source code. Issue the following docker-compose command:

docker-compose -f compose/common/docker-compose.yml up

If everything starts correctly you should see a bunch of spring boot information fly by on standard out. At this point all of the services needed for the project code will be running.

How to call API

The Application exposed a REST Endpoint for searching Albums and Books

API Request: Http Method : GET

REST Endpoint URL:

http://localhost:8080/api/items?term=reza

API Documents

http://localhost:8080/swagger-ui.html

API healthChecks

Shows health information of running API and application.

http://localhost:8080/actuator/health

API metrics

Shows "metrics" information of the running API and application.

http://localhost:8080/actuator/metrics/book.api.in.seconds

http://localhost:8080/actuator/metrics/album.api.in.seconds

Profile

Application used spring.profiles.active Environment property By default dev profile is active.