This is an application I built to get my hands on Blizzard's APIs, specifically World of Warcraft APIs.
You need to provide a client id and a client secret that will authenticate the application with Blizzard's API.
You can generate credentials on Blizzard's API Portal, provided you have a Blizzard account. There are detailed instructions to guide you through the process.
mvnw clean package
Several configuration variables are read from the environment and the application will fail to start if they're not present. The choice of environment variables over simple properties files allows easy configuration of cloud deployments, as this application was first meant to be hosted on Heroku.
The required variables are the following :
WC_BLIZZARD_API_CLIENT_IDBlizzard API Client IDWC_BLIZZARD_API_CLIENT_SECRETBlizzard API Client secretWC_ADMIN_CREDENTIALS_USERNAMEAdmin area usernameWC_ADMIN_CREDENTIALS_PASSWORDAdmine area password
If you're deploying to Heroku, you can drop a .env file in the KEY=VALUE format to set the variable. There are also
plugins that can use the .env file to load the variables automatically when you run the application from your IDE.
For IntelliJ, you can use EnvFile.
Lastly, if you don't want to use environment variables, you can write directly the values you want in the various properties files of the application where they are read. Keed in mind this will make deployment on multiple environments more complicated, but it's more than enough for local use and toying around.
java -jar webapp/target/wow-completionist.jar
If you want to activate live reload for Thymeleaf templates, run the application with --spring.profiles.active=dev.
The application by default will run on port 8080 and will use whichever port is defined in the PORT environment variable.
Open the application at http://localhost:8080/, this will open character selection page.
From here, you can navigate to existing application modules (currently only one module is supported):
- Battle and vanity pets (
http://localhost:8080/<region>/<realm>/<character>/pets)