← Zurück zum Blog

Java: Spring-Boot-MVC-Controller wird nicht aufgerufen

Übersetzter Artikel. Original lesen

Einleitung

Spring ist eine großartige Plattform mit vielen verschiedenen Projekten. Nachdem ich bisher das Spring Framework verwendet hatte, wollte ich Spring Boot mit annotationsbasierter statt XML-basierter Konfiguration ausprobieren.

Ein guter Einstieg ist Spring Initializr, mit dem sich schnell ein Grundprojekt erstellen lässt.

Ich wählte Thymeleaf als Template Engine und importierte das Projekt in IntelliJ IDEA. Nach dem Anlegen neuer Packages und Controller stellte ich fest, dass die Controller beim Start nicht im Request Mapper registriert wurden. Jeder Seitenaufruf endete auf der 404-Seite unter /error.

Was war passiert?

Konfigurationsklasse der Anwendung:

package me.kamwo.mcs.application;

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

@SpringBootApplication
public class McsApplication {

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

Ein Controller:

package me.kamwo.mcs.presentation.control;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;

/**
 * Created by kamwo on 15.02.15.
 */
@Controller
public class HomeController {

    @RequestMapping(value = "/")
    public String index(){
        System.out.println("Home Page");
        return "index";
    }
}

Alles sah normal aus :-) Warum funktionierte es dennoch nicht? Ein Blick auf @SpringBootApplication hilft:

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
@Configuration
@EnableAutoConfiguration
@ComponentScan
public @interface SpringBootApplication {

	/**
	 * Exclude specific auto-configuration classes such that they will never be applied.
	 */
	Class<?>[] exclude() default {};

}

Auffällig ist @ComponentScan, das Packages nach Spring-Komponenten durchsucht. @SpringBootApplication startet den Scan im Package me.kamwo.mcs.application. Der Controller liegt jedoch unter me.kamwo.mcs.presentation.control und wird deshalb nicht gefunden. Vor Spring Boot 1.3 wird @SpringBootApplication ersetzt und ein basePackages-Pfad angegeben:

Vor Spring Boot 1.3.x

package me.kamwo.mcs.application;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.EnableAutoConfiguration;
import org.springframework.context.annotation.ComponentScan;
import org.springframework.context.annotation.Configuration;

@Configuration
@ComponentScan(basePackages = "me.kamwo")
@EnableAutoConfiguration
public class McsApplication {

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

Ab Spring Boot 1.3.x

Seit Spring Boot 1.3.x akzeptiert @SpringBootApplication den Parameter scanBasePackages, an den die zu scannenden Package-Namen übergeben werden:

package me.kamwo.mcs.application;

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

@SpringBootApplication(scanBasePackages={"me.kamwo"})
public class McsApplication {

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

Ich hoffe, dieser Beitrag hilft weiter :-)