Skip to content

preparation.asciidoc

Latest commit

 

History

History
165 lines (123 loc) · 5.34 KB

preparation.asciidoc

File metadata and controls

165 lines (123 loc) · 5.34 KB

Preparation for the training

1. Setup the development environment

Before we dive into the Spring Boot training, please ensure your development environment is ready by downloading and setting up the following software on your Windows machine.

Note

If you want to avoid problems during the training, please DO NOT use paths containing spaces like C:\Program Files

1.1. Software List

  • Git for Windows: Download

  • Apache Maven (Optional): Download - Most Spring Boot projects use Maven Wrapper (mvnw), making separate installation not mandatory

  • JDK 21:

  • IDE (Choose One):

  • API client (Choose One) to test REST calls:

    • Postman: Download

    • Insomnia: Download

    • curl (command-line): Included with Git for Windows or install via Scoop

    • HTTP client in IntelliJ (Ultimate only)

1.2. Setup Instructions

  1. Download and install Git for Windows from the provided link.

  2. Choose and download JDK 21 from either the Oracle JDK or OpenJDK options and install it.

  3. Select and download an IDE of your choice (IntelliJ IDEA, Eclipse, or VSCode) for developing Spring Boot applications.

  4. (Optional) Download Apache Maven and extract it to a location without spaces (e.g. C:\Programs). Add the location to the PATH environment variable.

  5. Download and install Postman for testing your Spring Boot application’s RESTful services.

  6. Create a Github account (if you don’t have any yet).

Important

Maven Installation is Optional: Spring Boot projects typically include Maven Wrapper (mvnw.cmd), which automatically downloads and uses the correct Maven version. Your IDE also has built-in Maven support. Only install Maven separately if you plan to use it from command line frequently.

Please follow the installation instructions on the download pages for each piece of software.

1.3. Alternative Installation (Without Admin Rights)

If you don’t have administrator privileges on your machine, you can use Scoop package manager to install the required software:

Installing Scoop

  1. Open PowerShell (no admin rights required)

  2. Run the following command to install Scoop:

    Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
iwr -useb get.scoop.sh | iex

Installing Software with Scoop

Once Scoop is installed, you can install the required tools:

# Install Git
scoop install git

# Install Maven
scoop install maven

# Install JDK 21 (Eclipse Temurin)
scoop bucket add java
scoop install temurin21-jdk

# Install additional tools (optional)
scoop install postman

# curl is included with Git, or install separately:
scoop install curl
Note

Scoop installs software in your user directory (%USERPROFILE%\scoop), so no administrator privileges are required. It automatically manages PATH environment variables.

1.4. Verify Installation

After installation (whether traditional or via Scoop), verify your environment:

1. Test JDK Installation

Open Command Prompt or PowerShell and run both commands:

java -version
javac -version

You should see output like:

java version "21.0.2" 2024-01-16 LTS
Java(TM) SE Runtime Environment (build 21.0.2+13-LTS-58)
Java HotSpot(TM) 64-Bit Server VM (build 21.0.2+13-LTS-58, mixed mode, sharing)

javac 21.0.2
Warning

Common JDK Issues:

  • "java is not recognized": JDK not in PATH - reinstall JDK or manually add to PATH

  • Wrong version shown: Multiple Java versions installed - check JAVA_HOME environment variable

  • javac not found: JRE installed instead of JDK - download full JDK, not just JRE

2. Test Maven Installation (Optional)

If you installed Maven separately:

mvn -v

Expected output:

Apache Maven 3.9.5 (57804ffe001d7215b5e7bcb531cf83df38f93546)
Maven home: C:\Programs\apache-maven-3.9.5
Java version: 21.0.2, vendor: Eclipse Adoptium
Default locale: en_US, platform encoding: UTF-8
OS name: "windows 10", version: "10.0", arch: "amd64", family: "windows"
Note

If Maven verification fails: Don’t worry! Spring Boot projects use Maven Wrapper (mvnw.cmd), so manual Maven installation isn’t required. Your IDE will handle Maven operations automatically.

3. Test IDE Setup

  • Open your chosen IDE

  • Verify it detects Java 21 in project settings

  • For IntelliJ: File → Project Structure → Project → Project SDK should show Java 21

  • For Eclipse: Window → Preferences → Java → Installed JREs should list Java 21