KraQA workshop

You can use any Java JDK distribution in your machine => 11. If you don't have one follow these steps.

1. Install Java JDK
1. Open https://www.oracle.com/nl/java/technologies/javase-jdk11-downloads.html
2. Click in the correct link placed in the Download column related to your Operation System
3. Accept the terms and click on the download button
4. If you don't have an Oracle Account, create one to download the Java JDK or login if you have an account
5. When the download is complete double-click in the file and follows the screen steps
6. Test the installation
• Open the Terminal/Command Prompt
• Run the following command: java -version
• The output should be the Java version you downloaded
2. Configure the environment variables

If you are not familiar with how to set the environment variables in your Operational System, please follow one of these tutorials:

• How to add JAVA_HOME on Ubuntu?
• How to set JAVA_HOME on Windows 10?
• How to Set $JAVA_HOME environment variable on macOS

You can follow the instructions on the official website or following some tutorials

• Using the official Maven website
• Follow the steps placed in Installing Apache Maven
• Using well know tutorials
• How to install Maven on Windows
• How to install Maven on MacOSX
• How to install Maven on Ubuntu

You can use your preferred IDE. I will use the IntelliJ IDEA

1. Download the IntelliJ IDEA Community Edition
2. Follow all the screen steps to install it on your machine

You also needs the Lombok plugin

1. Open the IntelliJ IDEA
2. Open the Preferences
3. Click on the Plugins item
4. In the Plugin screen click on Marketplace tab
5. Search for Lombok and click on Install
6. Restart the IntelliJ IDEA

And enable the Annotation Processors

1. Open the IntelliJ IDEA
2. Open the Preferences
3. Click on the Build, Execution, Deployment -> Compiler -> Java Annotation Processors
4. Check the item Enable annotation processing

1. Access the following link https://github.com/eliasnogueira?tab=packages&repo_name=credit-api
2. In the Package list click on the first link on the list
3. On the section Asserts on the right side click in the .jar file. It will be like credit-api-version.jar
4. Save the jar file in a place you will remember

1. Open your Terminal/Command Prompt
2. Navigates to the folder you saved the jar file you downloaded
3. Execute the following command: java -jar FILENAME.jar where FILENAME is the jar filename. Example: credit-api-1.3.0.jar
4. You will see a message "Application has started! Happy tests!"
5. Your backend is ready

1. With the backend project running access the following URL http://localhost:8088/swagger-ui/index.html
2. You will be able to see the API documentation, like the image below

1. You can stop the backend project you started in the Terminal/Command Prompt by pressing CTRL + C

Only follow these steps if the previous one failed. Please consider first review all the previous pre-conditions.

1. Clone the backend project either downloading the .zip file or running the git clone command
• Download the .zip file from https://github.com/eliasnogueira/credit-api/archive/master.zip
• OR run git clone https://github.com/eliasnogueira/credit-api.git
2. Open the Terminal/Command Prompt
3. Navigate to the project folder, which should be credit-api-master if you downloaded it, or code-api if you cloned it
4. Run the following command mvn spring-boot:run

1. Clone or download the project
• If you want to clone it, follow these steps
1. Open the Terminal/Command Prompt
2. Run the following command: git clone https://github.com/eliasnogueira/credit-api-test.git
• If you want to download it, follow these steps
1. Click on the following link to download: https://github.com/eliasnogueira/credit-api-test/archive/main.zip
2. Open the project in your favorite IDE. I recommend you to use the IntelliJ IDEA Community Edition
• Open the IntelliJ IDEA
• Click on the Open button
• Navigate to the project folder and click on Open
• Wait until the IDEA finish to load your project

1. Using the IDE or the command line
• Using the IntelliJ IDEA
1. Open the IntelliJ IDEA
2. Click on the Open button
3. Navigate to the project folder and click on Open
4. Wait until the IDEA finish to load your project
5. Click on the Maven tab on the right side of your IDEA
6. In the Maven tab, click on the Reload all Maven project button

• Using the command line
1. Open the Terminal/Command Prompt
2. Navigate to the project folder
3. Run the following command: mvn verify