ayazkhuraishi/wow-auctions

World of Warcraft Auctions using Java EE Batch - JSR-352

World of Warcraft Auctions - Batch Application

Pre Requisites

• OpenJDK 11
• Maven 3.6.3
• Docker
• Blizzard API Key

Project Structure

The project uses Blizzard API for the popular game World of Warcraft. It downloads the World of Warcraft Auction House data and provides statistics about items prices evolution. Since the data may be huge, the project uses Batch processing to analyze the information.

• batch - the batch code that integrates with Blizzard API and process the data.
• quarkus-batch - integration with Quarkus to support the JBatch implementation (with Jberet).
• itest - integrations tests.

Libraries and Infra

The project uses Quarkus as the Java stack, and the built in SmallRye components as the MicroProfile implementations.

The required infrastructure provided by Docker includes:

• Postgres Database

Build

Use Maven to build the project with the following command from the project root:

mvn install

Run

Start the required infrastructure to run the application from the project root:

docker-compose up -d

To execute the Batch Application, run the following command from each batch folder root:

java -Dapi.battle.net.clientId=[REPLACE_ME] -Dapi.battle.net.clientSecret=[REPLACE_ME] -jar target/auctions-batch-runner.jar

Remember to replace the placeholders in the command by the real clientId and clientSecret required to access Blizzard API.

Test the Applications

The Application provides a REST endpoint to call the required batch processes.

Prepare

The Prepare Batch is used to retrieve the initial metadata and create the Batch structure to process auction data:

curl -v -XPOST http://localhost:8080/jobs/prepare-job/start

Process

The Process Batch process the auction data for a set of Realms. Requires the region, and the realm id to process:

curl -v -XPOST -H 'Content-Type:application/json' http://localhost:8080/jobs/process-job/start -d '{"api.blizzard.region":"us","connectedRealmId":11}'

This will process the auction data for the Realm Tichondrius in the US region. It may take a while to finish. After the processing completes, you can check the AUCTIONSTATISTICS table in the database for the statistics data.

Blog posts

• Java EE 7 Batch Processing and World of Warcraft – Part 1

• Java EE 7 Batch Processing and World of Warcraft – Part 2