Die automatische Konfiguration (Autoconfiguration) ist eines der Kernfeatures von Spring Boot, das es Entwicklern ermöglicht, Anwendungen mit minimaler manueller Konfiguration zu erstellen. Sie reduziert den Aufwand, der normalerweise für die Einrichtung von Frameworks und Bibliotheken erforderlich ist, indem sie intelligente Annahmen über die benötigten Einstellungen trifft und diese automatisch konfiguriert.
In traditionellen Spring-Anwendungen mussten Entwickler oft umfangreiche XML-Dateien oder Java-basierte Konfigurationen schreiben, um verschiedene Komponenten wie Datenbanken, Webserver oder Sicherheitsmodule einzurichten. Dies führte zu einem erhöhten Aufwand und potenziellen Fehlerquellen. Spring Boot adressiert dieses Problem durch die Einführung der automatischen Konfiguration, die auf dem Prinzip Konvention vor Konfiguration basiert.
Die automatische Konfiguration in Spring Boot basiert auf mehreren Mechanismen:
Konditionale Beans
Spring Boot verwendet Annotationen wie
@ConditionalOnClass, @ConditionalOnMissingBean
und @ConditionalOnProperty, um zu bestimmen, ob bestimmte
Beans erstellt werden sollen.
Starter-Abhängigkeiten
Durch die Verwendung von Starter-Paketen wie
spring-boot-starter-web oder
spring-boot-starter-data-jpa werden die notwendigen
Abhängigkeiten eingebunden, die die automatische Konfiguration
auslösen.
SpringFactoriesLoader
Die Autokonfigurationsklassen werden über den
META-INF/spring.factories-Eintrag geladen, der in den
JAR-Dateien der Starter-Pakete definiert ist.
flowchart TD
A[Start der Anwendung] --> B{Vorhandene Abhängigkeiten analysieren}
B --> C{Passende Autokonfigurationen identifizieren}
C --> D{Konditionale Beans prüfen}
D -- Bedingungen erfüllt --> E[Beans erstellen]
D -- Bedingungen nicht erfüllt --> F[Beans nicht erstellen]Wenn sich HikariCP (ein JDBC-Connection-Pool) und ein
JDBC-Treiber im Klassenpfad befinden, wird Spring Boot automatisch einen
DataSource-Bean konfigurieren.
Ohne zusätzliche Konfiguration können Sie in Ihrer Anwendung auf die Datenquelle zugreifen:
@Service
public class UserService {
private final JdbcTemplate jdbcTemplate;
public UserService(JdbcTemplate jdbcTemplate) {
this.jdbcTemplate = jdbcTemplate;
}
// Methoden, die die Datenbank nutzen
}DataSource vorhanden ist.JdbcTemplate oder DataSource erstellen.Obwohl die automatische Konfiguration viele sinnvolle Standardwerte bereitstellt, gibt es Fälle, in denen Anpassungen erforderlich sind.
In der application.properties oder
application.yml können Sie die Datenbankeinstellungen
konfigurieren:
spring.datasource.url=jdbc:mysql://localhost:3306/meine_datenbank
spring.datasource.username=dbuser
spring.datasource.password=dbpass
spring.datasource.driver-class-name=com.mysql.cj.jdbc.DriverFalls bestimmte Autokonfigurationen nicht gewünscht sind, können diese deaktiviert werden.
@SpringBootApplication(exclude = { SecurityAutoConfiguration.class })
public class MyApplication {
// ...
}Um zu verstehen, welche Konfigurationen angewendet wurden, können Sie den Autokonfigurationsbericht nutzen.
Fügen Sie debug=true in der
application.properties hinzu oder starten Sie die Anwendung
mit dem Flag --debug.
Negative matches:
-----------------
...
Positive matches:
-----------------
...
Exclusions:
-----------
...Sie können benutzerdefinierte Autokonfigurationen erstellen, um eigene Starter-Pakete oder Bibliotheken zu unterstützen.
@Configuration
@ConditionalOnClass(MyLibrary.class)
public class MyLibraryAutoConfiguration {
@Bean
@ConditionalOnMissingBean
public MyLibrary myLibrary() {
return new MyLibrary();
}
}spring.factoriesErstellen Sie die Datei META-INF/spring.factories mit
folgendem Inhalt:
org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
com.example.MyLibraryAutoConfigurationVerstehen der Standardkonfigurationen
Machen Sie sich mit den Standardwerten vertraut, um unvorhergesehene Verhalten zu vermeiden.
Gezieltes Überschreiben von Einstellungen
Überschreiben Sie nur die Einstellungen, die für Ihre Anwendung relevant sind.
Vermeiden von redundanten Bean-Definitionen
Definieren Sie keine Beans manuell, die bereits durch die Autokonfiguration bereitgestellt werden, es sei denn, Sie möchten das Standardverhalten ändern.
Web
DispatcherServlet,
ErrorController und statischen Ressourcen.JPA
EntityManagerFactory,
DataSource und TransactionManager.Sicherheit
Templating
Reduzierter Konfigurationsaufwand
Schnellere Entwicklung durch Minimierung der Boilerplate-Konfiguration.
Konsistenz
Einheitliche Konfiguration über verschiedene Projekte hinweg.
Erweiterbarkeit
Möglichkeit, eigene Starter und Autokonfigurationen zu erstellen.
Unerwartete Beans
Die Autokonfiguration kann Beans erstellen, die nicht benötigt werden, was zu erhöhtem Ressourcenverbrauch führen kann.
Konflikte mit manuellen Konfigurationen
Manuelle Bean-Definitionen können die Autokonfiguration überschreiben, was zu unerwartetem Verhalten führen kann.
Wenn Probleme auftreten, können Sie den ConditionEvaluationReport verwenden, um zu sehen, welche Bedingungen für Beans erfüllt oder nicht erfüllt wurden.
@RestController
public class ConditionEvaluationReportController {
@Autowired
private ConditionEvaluationReport report;
@GetMapping("/autoconfig")
public ConditionEvaluationReport getReport() {
return report;
}
}Für den Zugriff auf den ConditionEvaluationReport müssen
Sie die Abhängigkeit spring-boot-actuator hinzufügen und
die entsprechende Endpoint-Sicherheit konfigurieren.
Die automatische Konfiguration in Spring Boot reduziert den Konfigurationsaufwand, indem sie intelligente Annahmen trifft und basierend auf dem Klassenpfad und vorhandenen Beans Einstellungen automatisch vornimmt. Dies ermöglicht eine schnellere Entwicklung und konsistente Konfiguration, während dennoch Flexibilität für Anpassungen und Erweiterungen besteht.