Salta el contingut

Versió adaptada: Pràctica Guiada "Hola Món" amb Spring Boot utilitzant IntelliJ IDEA

En aquesta versió, s'han incorporat indicacions específiques per fer la pràctica guiada utilitzant IntelliJ IDEA com a entorn de desenvolupament.

1. Configuració inicial amb IntelliJ IDEA

Requisits previs

  • Tenir instal·lat IntelliJ IDEA, Java 17+ i Maven (o Gradle, però Maven és recomanable per a la integració directa amb IntelliJ).
  • Pots utilitzar la versió Community (gratuïta) o Ultimate (de pagament).

Crear el projecte amb Spring Initializr directament des d'IntelliJ

  1. Obre IntelliJ IDEA.
  2. Ves a File > New > Project.
  3. Tria Spring Initializr i fes clic a Next.
    • Si és la primera vegada, pot demanar configurar la URL de Spring Initializr. Deixa la predeterminada (https://start.spring.io).
  4. Omple els camps:
    • Project SDK: Tria Java 17 (o superior).
    • Group: com.example
    • Artifact: hola-mon
    • Type: Maven (o Gradle)
    • Language: Java
    • Packaging: JAR
    • Java: 17
  5. Afegeix la dependència Spring Web.
  6. Fes clic a Finish.

IntelliJ crearà el projecte directament, prepararà l’estructura i descarregarà les dependències automàticament.

2. Explora l'estructura del projecte

  • A la finestra de l'explorador de projectes de IntelliJ, localitza:
    • src/main/java/com/example/hola_mon/HolaMonApplication.java
    • src/main/resources/application.properties
  • IntelliJ permet navegar ràpidament amb Ctrl+Shift+N (cerca de fitxers) i Ctrl+E (fitxers recents).

3. Edita la classe principal

Obre HolaMonApplication.java i assegura’t que conté:

package com.example.hola_mon;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class HolaMonApplication {
    public static void main(String[] args) {
        SpringApplication.run(HolaMonApplication.class, args);
    }
}

4. Crea el controlador REST

A la carpeta com.example.hola_mon dins src/main/java, crea HelloWorldController.java (Clic dret > New > Java Class):

package com.example.hola_mon;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class HelloWorldController {

    @GetMapping("/hola")
    public String hola() {
        return "Hola Món!";
    }

    @GetMapping("/hola-personalitzat")
    public String holaPersonalitzat(@RequestParam(value = "nom", defaultValue = "Visitant") String nom) {
        return "Hola, " + nom + "!";
    }
}

5. Executa la teva aplicació des de IntelliJ

  1. Busca la classe HolaMonApplication.java.
  2. Clic dret sobre el fitxer i selecciona Run 'HolaMonApplication.main()'.
    • IntelliJ compilarà i executarà l’aplicació utilitzant el plugin de Maven o Gradle incorporat.
  3. Observa la consola per assegurar-te que l’aplicació arrenca correctament (veuràs el banner de Spring Boot i el port).

6. Prova els endpoints

  • Obre un navegador i entra:
    • http://localhost:8080/hola (Resposta: Hola Món!)
    • http://localhost:8080/hola-personalitzat?nom=Anna (Resposta: Hola, Anna!)
  • També pots utilitzar la consola integrada de IntelliJ per executar curl.

7. Solucions a problemes habituals en IntelliJ

Problema Solució
El projecte no descarrega dependències correctament Fes clic a Reload Project al costat del fitxer pom.xml/build.gradle
Error de versió de Java Ves a File > Project Structure > Project i assegura’t que l’SDK és Java 17 o superior
El servidor ocupa el port 8080 Modifica application.properties amb: server.port=8082

8. Construir i empaquetar amb IntelliJ

  • Per construir el JAR, ves a la pestanya Maven (o Gradle) lateral, tria la tasca package i executa-la.
  • El JAR apareixerà a target/hola-mon-0.0.1-SNAPSHOT.jar (Maven) o build/libs/hola-mon-0.0.1-SNAPSHOT.jar (Gradle).

9. Parar l’aplicació

  • A la consola d’execució d’IntelliJ, prem el botó de parada (stop) o Ctrl+C si tens la consola oberta externament.

Aquesta versió afegeix totes les instruccions específiques per realitzar la pràctica a través d’IntelliJ IDEA, aprofitant les funcionalitats i ergonomia de l’entorn. Si necessites la versió en format descarregable, indica-ho!