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

public static void main(String[] args) {
    SpringApplication aplicacio = new SpringApplication(CicloUrbanaApplication.class);
    ConfigurableApplicationContext context = aplicacio.run(args);
    // El context queda viu: mentre Tomcat escolti, el procés no acaba
}

   _____ _      _       _   _      _
  / ____(_)    | |     | | | |    | |
 | |     _  ___| | ___ | | | |_ __| |__   __ _ _ __   __ _
 | |    | |/ __| |/ _ \| | | | '__| '_ \ / _` | '_ \ / _` |
 | |____| | (__| | (_) | |_| | |  | |_) | (_| | | | | (_| |
  \_____|_|\___|_|\___/ \___/|_|  |_.__/ \__,_|_| |_|\__,_|

 Xarxa municipal de bicicletes electriques de Ribalta
 Versio de l'aplicacio    : ${application.version:sense-versio}
 Spring Boot              : ${spring-boot.version}
 Perfils actius           : ${spring.profiles.active:cap}

# Desactivar-lo del tot
spring.main.banner-mode=off

# Enviar-lo al log en lloc de a la consola
spring.main.banner-mode=log

# Fer servir un fitxer amb un altre nom o ubicació
spring.banner.location=classpath:banners/ciclourbana.txt

2026-08-31T10:22:40.812+02:00  INFO 18422 --- [ciclourbana] [  restartedMain] c.c.CicloUrbanaApplication               : Starting CicloUrbanaApplication using Java 21.0.5 with PID 18422 (/home/joan/ciclourbana/target/classes started by joan in /home/joan/ciclourbana)
2026-08-31T10:22:40.815+02:00  INFO 18422 --- [ciclourbana] [  restartedMain] c.c.CicloUrbanaApplication               : No active profile set, falling back to 1 default profile: "default"
2026-08-31T10:22:41.104+02:00  INFO 18422 --- [ciclourbana] [  restartedMain] .e.DevToolsPropertyDefaultsPostProcessor : Devtools property defaults active! Set 'spring.devtools.add-properties' to 'false' to disable
2026-08-31T10:22:42.688+02:00  INFO 18422 --- [ciclourbana] [  restartedMain] o.s.b.w.embedded.tomcat.TomcatWebServer  : Tomcat initialized with port 8080 (http)
2026-08-31T10:22:42.703+02:00  INFO 18422 --- [ciclourbana] [  restartedMain] o.apache.catalina.core.StandardService   : Starting service [Tomcat]
2026-08-31T10:22:42.704+02:00  INFO 18422 --- [ciclourbana] [  restartedMain] o.apache.catalina.core.StandardEngine    : Starting Servlet engine: [Apache Tomcat/10.1.31]
2026-08-31T10:22:42.760+02:00  INFO 18422 --- [ciclourbana] [  restartedMain] o.a.c.c.C.[Tomcat].[localhost].[/]       : Initializing Spring embedded WebApplicationContext
2026-08-31T10:22:42.761+02:00  INFO 18422 --- [ciclourbana] [  restartedMain] w.s.c.ServletWebServerApplicationContext : Root WebApplicationContext: initialization completed in 1920 ms
2026-08-31T10:22:42.905+02:00  INFO 18422 --- [ciclourbana] [  restartedMain] o.s.b.w.embedded.tomcat.TomcatWebServer  : Tomcat started on port 8080 (http) with context path '/'
2026-08-31T10:22:42.918+02:00  INFO 18422 --- [ciclourbana] [  restartedMain] c.c.CicloUrbanaApplication               : Started CicloUrbanaApplication in 2.174 seconds (process running for 2.512)

2026-08-31T10:22:42.905+02:00  INFO 18422 --- [ciclourbana] [restartedMain] o.s.b.w.e.tomcat.TomcatWebServer : Tomcat started on port 8080
└──────── data i hora ───────┘ └nivell┘ └PID┘  └ app ─┘  └── fil ──┘  └──── classe (abreujada) ────┘ └─ missatge ─┘

# Mostra un informe de quines autoconfiguracions s'han aplicat i quines no
debug=true

# Traça el procés d'arrencada de Spring
logging.level.org.springframework.boot.autoconfigure=DEBUG

package com.ciclourbana.estacions;

import org.springframework.stereotype.Component;

import java.util.ArrayList;
import java.util.List;

/**
 * Magatzem en memòria de les estacions de la xarxa de Ribalta.
 * És una solució provisional fins al mòdul 4, on es
 * substituirà per un repositori de Spring Data JPA.
 */
@Component
public class MagatzemEstacions {

    private final List<Estacio> estacions = new ArrayList<>();

    public List<Estacio> llistarTotes() {
        return List.copyOf(estacions);   // còpia immutable: ningú no la modifica des de fora
    }

    public void afegir(Estacio estacio) {
        estacions.add(estacio);
    }

    public int comptar() {
        return estacions.size();
    }

    public int capacitatTotal() {
        return estacions.stream()
                .mapToInt(Estacio::capacitat)
                .sum();
    }
}

package com.ciclourbana.comu;

import com.ciclourbana.estacions.MagatzemEstacions;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.boot.context.event.ApplicationReadyEvent;
import org.springframework.context.event.EventListener;
import org.springframework.core.env.Environment;
import org.springframework.stereotype.Component;

/**
 * Registra al log un resum de l'estat de la xarxa
 * tan bon punt CicloUrbana acaba d'arrencar.
 */
@Component
public class AvisArrencada {

    private static final Logger log = LoggerFactory.getLogger(AvisArrencada.class);

    private final MagatzemEstacions magatzemEstacions;
    private final Environment entorn;

    // Injecció per constructor: Spring passa els beans necessaris en crear aquesta classe
    public AvisArrencada(MagatzemEstacions magatzemEstacions, Environment entorn) {
        this.magatzemEstacions = magatzemEstacions;
        this.entorn = entorn;
    }

    @EventListener(ApplicationReadyEvent.class)
    public void enEstarLlesta() {
        String port = entorn.getProperty("server.port", "8080");

        log.info("================================================");
        log.info(" CicloUrbana llesta - xarxa municipal de Ribalta");
        log.info(" Estacions carregades : {}", magatzemEstacions.comptar());
        log.info(" Capacitat total      : {} ancoratges", magatzemEstacions.capacitatTotal());
        log.info(" API disponible a     : http://localhost:{}/api/v1/estacions", port);
        log.info("================================================");
    }
}

package com.ciclourbana.estacions;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.boot.CommandLineRunner;
import org.springframework.core.annotation.Order;
import org.springframework.stereotype.Component;

/**
 * Carrega les estacions inicials de la xarxa de Ribalta en arrencar.
 * Provisional fins al mòdul 4, on les dades vindran de la
 * base de dades mitjançant migracions de Flyway.
 */
@Component
@Order(1)   // s'executa abans que altres runners amb @Order superior
public class CarregadorEstacionsDemo implements CommandLineRunner {

    private static final Logger log = LoggerFactory.getLogger(CarregadorEstacionsDemo.class);

    private final MagatzemEstacions magatzemEstacions;

    public CarregadorEstacionsDemo(MagatzemEstacions magatzemEstacions) {
        this.magatzemEstacions = magatzemEstacions;
    }

    @Override
    public void run(String... args) {
        log.info("Carregant estacions de demostració de Ribalta...");

        magatzemEstacions.afegir(new Estacio(1L, "Plaça Major",
                "Plaça Major, 1", 24, 40.4168, -3.7038));
        magatzemEstacions.afegir(new Estacio(2L, "Estació Nord",
                "Avinguda Estació 3", 30, 40.4290, -3.7020));
        magatzemEstacions.afegir(new Estacio(3L, "Parc del Riu",
                "Passeig Fluvial 12", 18, 40.4105, -3.6950));
        magatzemEstacions.afegir(new Estacio(4L, "Universitat",
                "Campus Sud, accés B", 36, 40.4402, -3.7255));

        log.info("Carregades {} estacions", magatzemEstacions.comptar());
    }
}

package com.ciclourbana.estacions;

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

import java.util.List;

@RestController
@RequestMapping("/api/v1/estacions")
public class EstacioController {

    private final MagatzemEstacions magatzemEstacions;

    public EstacioController(MagatzemEstacions magatzemEstacions) {
        this.magatzemEstacions = magatzemEstacions;
    }

    @GetMapping
    public List<Estacio> llistarEstacions() {
        return magatzemEstacions.llistarTotes();
    }
}

... o.s.b.w.embedded.tomcat.TomcatWebServer : Tomcat started on port 8080 (http)
... c.c.e.CarregadorEstacionsDemo           : Carregant estacions de demostració de Ribalta...
... c.c.e.CarregadorEstacionsDemo           : Carregades 4 estacions
... c.c.CicloUrbanaApplication              : Started CicloUrbanaApplication in 2.301 seconds
... c.c.comu.AvisArrencada                  : ================================================
... c.c.comu.AvisArrencada                  :  CicloUrbana llesta - xarxa municipal de Ribalta
... c.c.comu.AvisArrencada                  :  Estacions carregades : 4
... c.c.comu.AvisArrencada                  :  Capacitat total      : 108 ancoratges
... c.c.comu.AvisArrencada                  :  API disponible a     : http://localhost:8080/api/v1/estacions
... c.c.comu.AvisArrencada                  : ================================================

package com.ciclourbana.comu;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.boot.ApplicationArguments;
import org.springframework.boot.ApplicationRunner;
import org.springframework.stereotype.Component;

/**
 * Exemple de lectura d'opcions de línia d'ordres.
 * Ús: java -jar ciclourbana.jar --mode=manteniment --verbose
 */
@Component
public class LectorArguments implements ApplicationRunner {

    private static final Logger log = LoggerFactory.getLogger(LectorArguments.class);

    @Override
    public void run(ApplicationArguments args) {
        // Opcions amb nom, de l'estil --clau=valor
        log.info("Opcions rebudes: {}", args.getOptionNames());

        if (args.containsOption("mode")) {
            // getOptionValues retorna una llista: una opció es pot repetir
            String mode = args.getOptionValues("mode").get(0);
            log.info("Arrencant en mode: {}", mode);
        }

        // Arguments solts, sense el prefix --
        log.info("Arguments sense nom: {}", args.getNonOptionArgs());
    }
}

package com.ciclourbana;

import org.springframework.boot.Banner;
import org.springframework.boot.WebApplicationType;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.builder.SpringApplicationBuilder;

@SpringBootApplication
public class CicloUrbanaApplication {

    public static void main(String[] args) {
        new SpringApplicationBuilder(CicloUrbanaApplication.class)
                // Sense bàner: els agregadors de logs ho agraeixen
                .bannerMode(Banner.Mode.OFF)
                // Forçar el tipus d'aplicació en lloc de deduir-lo del classpath
                .web(WebApplicationType.SERVLET)
                // Perfil actiu per defecte si no se n'indica cap altre (mòdul 7)
                .profiles("default")
                // Propietats per defecte: les de menor prioritat de totes
                .properties("spring.application.name=ciclourbana")
                // Listener per a un esdeveniment anterior a la creació del context
                .listeners(esdeveniment -> {
                    if (esdeveniment instanceof org.springframework.boot.context.event.ApplicationStartingEvent) {
                        System.out.println(">> Arrencant CicloUrbana...");
                    }
                })
                // Registrar el hook d'aturada de la JVM (actiu per defecte)
                .registerShutdownHook(true)
                .run(args);
    }
}

new SpringApplicationBuilder(CicloUrbanaApplication.class)
        .web(WebApplicationType.NONE)   // sense Tomcat: el procés acaba en acabar
        .bannerMode(Banner.Mode.OFF)
        .run(args);

# src/main/resources/application.properties

# En rebre el senyal d'aturada, deixar d'acceptar peticions noves
# i esperar que acabin les que estan en curs
server.shutdown=graceful

# Temps màxim d'espera abans de forçar el tancament (per defecte 30s)
spring.lifecycle.timeout-per-shutdown-phase=20s

... o.s.b.w.e.tomcat.GracefulShutdown : Commencing graceful shutdown. Waiting for active requests to complete
... o.s.b.w.e.tomcat.GracefulShutdown : Graceful shutdown complete

package com.ciclourbana.comu;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.context.event.ContextClosedEvent;
import org.springframework.context.event.EventListener;
import org.springframework.stereotype.Component;

@Component
public class AvisAturada {

    private static final Logger log = LoggerFactory.getLogger(AvisAturada.class);

    @EventListener(ContextClosedEvent.class)
    public void enTancar() {
        log.info("CicloUrbana s'està aturant. Tancant recursos oberts...");
        // Aquí alliberaries connexions externes, bolcaries memòries cau pendents, etc.
    }
}

spring.main.register-shutdown-hook=false

# src/main/resources/banner.txt
  ____ _      _        _   _      _
 / ___(_) ___| | ___  | | | |_ __| |__   __ _ _ __   __ _
| |   | |/ __| |/ _ \ | | | | '__| '_ \ / _` | '_ \ / _` |
| |___| | (__| | (_) || |_| | |  | |_) | (_| | | | | (_| |
 \____|_|\___|_|\___/  \___/|_|  |_.__/ \__,_|_| |_|\__,_|

 Aplicacio : ${application.title:ciclourbana}
 Versio    : ${application.version:desenvolupament}
 Boot      : ${spring-boot.version}
 Perfil    : ${spring.profiles.active:default}
 Xarxa municipal de bicicletes electriques de Ribalta

./mvnw spring-boot:run
# Mostra el bàner amb Boot 3.3.5 i perfil "default"

# Desactivar-lo temporalment sense tocar el fitxer de propietats
./mvnw spring-boot:run -Dspring-boot.run.arguments=--spring.main.banner-mode=off

# O de manera permanent a application.properties
echo "spring.main.banner-mode=off" >> src/main/resources/application.properties

package com.ciclourbana.comu;

import com.ciclourbana.estacions.MagatzemEstacions;
import com.ciclourbana.estacions.Estacio;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.boot.CommandLineRunner;
import org.springframework.core.annotation.Order;
import org.springframework.stereotype.Component;

import java.util.List;

/**
 * Comprova en arrencar que la xarxa de Ribalta és en un estat vàlid.
 * S'executa DESPRÉS del carregador d'estacions gràcies a @Order(2).
 */
@Component
@Order(2)
public class VerificadorArrencada implements CommandLineRunner {

    private static final Logger log = LoggerFactory.getLogger(VerificadorArrencada.class);
    private static final int MINIM_ESTACIONS = 3;

    private final MagatzemEstacions magatzemEstacions;

    public VerificadorArrencada(MagatzemEstacions magatzemEstacions) {
        this.magatzemEstacions = magatzemEstacions;
    }

    @Override
    public void run(String... args) {
        log.info("Verificant la configuració de la xarxa de Ribalta...");

        List<Estacio> estacions = magatzemEstacions.llistarTotes();

        // Comprovació 1: nombre mínim d'estacions
        if (estacions.size() < MINIM_ESTACIONS) {
            throw new IllegalStateException(
                    "La xarxa necessita com a mínim " + MINIM_ESTACIONS
                    + " estacions per operar, però només n'hi ha " + estacions.size()
                    + ". Reviseu el carregador de dades.");
        }

        // Comprovació 2: cap estació sense ancoratges
        List<String> senseCapacitat = estacions.stream()
                .filter(estacio -> estacio.capacitat() <= 0)
                .map(Estacio::nom)
                .toList();

        if (!senseCapacitat.isEmpty()) {
            throw new IllegalStateException(
                    "Hi ha estacions amb capacitat 0, cosa que impedeix retornar bicicletes: "
                    + String.join(", ", senseCapacitat));
        }

        log.info("Verificació superada: {} estacions vàlides, {} ancoratges en total",
                estacions.size(), magatzemEstacions.capacitatTotal());
    }
}

... APPLICATION FAILED TO START
...
java.lang.IllegalStateException: La xarxa necessita com a mínim 3 estacions per operar,
però només n'hi ha 2. Reviseu el carregador de dades.

package com.ciclourbana.comu;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.boot.context.event.ApplicationReadyEvent;
import org.springframework.context.event.ContextClosedEvent;
import org.springframework.context.event.EventListener;
import org.springframework.stereotype.Component;

import java.time.Duration;
import java.time.Instant;

/**
 * Registra el temps d'arrencada i el temps total d'activitat
 * de CicloUrbana.
 */
@Component
public class CronometreAplicacio {

    private static final Logger log = LoggerFactory.getLogger(CronometreAplicacio.class);

    // Moment en què es construeix el bean: durant el refresh del context
    private final Instant instantCreacio = Instant.now();
    private Instant instantLlest;

    @EventListener(ApplicationReadyEvent.class)
    public void enEstarLlesta(ApplicationReadyEvent esdeveniment) {
        this.instantLlest = Instant.now();

        // El mateix esdeveniment sap quan va arrencar SpringApplication
        long millisegonsTotals = esdeveniment.getTimeTaken().toMillis();

        log.info("CicloUrbana llesta. Arrencada completa en {} ms", millisegonsTotals);
        log.info("Des de la creació dels beans fins a l'arrencada: {} ms",
                Duration.between(instantCreacio, instantLlest).toMillis());
    }

    @EventListener(ContextClosedEvent.class)
    public void enTancar() {
        if (instantLlest == null) {
            log.warn("CicloUrbana s'atura abans d'haver acabat d'arrencar");
            return;
        }
        Duration activitat = Duration.between(instantLlest, Instant.now());
        log.info("CicloUrbana s'atura després de {} hores, {} minuts i {} segons de servei",
                activitat.toHours(),
                activitat.toMinutesPart(),
                activitat.toSecondsPart());
    }
}

# src/main/resources/application.properties
server.shutdown=graceful
spring.lifecycle.timeout-per-shutdown-phase=20s
logging.level.org.springframework.boot.web.embedded.tomcat.GracefulShutdown=INFO

# Terminal 1
java -jar target/ciclourbana-0.0.1-SNAPSHOT.jar

# Terminal 2: enviar SIGTERM al procés (equival a docker stop)
kill $(pgrep -f ciclourbana)

... o.s.b.w.e.tomcat.GracefulShutdown : Commencing graceful shutdown. Waiting for active requests to complete
... c.c.comu.CronometreAplicacio      : CicloUrbana s'atura després de 0 hores, 1 minuts i 34 segons de servei
... o.s.b.w.e.tomcat.GracefulShutdown : Graceful shutdown complete