{"id":589,"date":"2025-01-24T23:37:05","date_gmt":"2025-01-24T22:37:05","guid":{"rendered":"https:\/\/www.xn--javaeinfacherklrt-4qb.de\/?p=589"},"modified":"2025-02-28T23:40:43","modified_gmt":"2025-02-28T22:40:43","slug":"conditionalonmissingbean-in-spring","status":"publish","type":"post","link":"https:\/\/www.xn--javaeinfacherklrt-4qb.de\/?p=589","title":{"rendered":"@ConditionalOnMissingBean in Spring"},"content":{"rendered":"\n

Die Annotation @ConditionalOnMissingBean<\/code> ist ein leistungsstarkes Werkzeug im Spring-Framework, das es Entwicklern erm\u00f6glicht, Beans nur dann zu registrieren, wenn keine andere Bean des gleichen Typs bereits vorhanden ist. Dies ist besonders n\u00fctzlich in Konfigurationsklassen, bei der Implementierung von Bibliotheken und beim Anpassen des Spring-Kontexts.<\/p>\n\n\n\n

1. Grundlagen von @ConditionalOnMissingBean<\/code><\/h2>\n\n\n\n

Die Annotation @ConditionalOnMissingBean<\/code> stammt aus dem Spring Boot-Projekt und befindet sich im Paket org.springframework.boot.autoconfigure.condition<\/code>. Sie wird in der Regel in Konfigurationsklassen verwendet, um zu pr\u00fcfen, ob eine bestimmte Bean bereits im Kontext existiert. Falls nicht, wird eine neue Bean registriert.<\/p>\n\n\n\n

1.1 Syntax<\/h3>\n\n\n
@Configuration\npublic<\/span> class<\/span> MyConfiguration<\/span> <\/span>{\n    @Bean\n    @ConditionalOnMissingBean\n    public<\/span> MyService myService() {\n        return<\/span> new<\/span> MyServiceImpl();\n    }\n}\n<\/code><\/span>Code-Sprache:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
In diesem Beispiel wird eine Bean vom Typ MyService<\/code> nur dann registriert, wenn nicht bereits eine andere Bean dieses Typs existiert.<\/p>\n\n\n\n
2. Vorteile und Anwendungsf\u00e4lle<\/h2>\n\n\n\n
2.1 Flexibilit\u00e4t in Bibliotheken<\/h3>\n\n\n\n
Bei der Entwicklung von Spring Boot Startern oder Bibliotheken ist es oft gew\u00fcnscht, Standardimplementierungen bereitzustellen, aber Entwicklern die M\u00f6glichkeit zu geben, eigene Implementierungen zu \u00fcberschreiben. @ConditionalOnMissingBean<\/code> erm\u00f6glicht genau das.<\/p>\n\n\n\n
2.2 Erweiterbarkeit<\/h3>\n\n\n\n
In Microservice-Architekturen oder stark modularisierten Anwendungen kann diese Annotation genutzt werden, um Standardkonfigurationen anzubieten, die bei Bedarf durch spezifische Implementierungen ersetzt werden k\u00f6nnen.<\/p>\n\n\n\n
2.3 Vermeidung von Konflikten<\/h3>\n\n\n\n
In komplexen Spring-Kontexten mit mehreren Konfigurationsklassen kann es leicht zu Konflikten kommen, wenn mehrere Beans desselben Typs definiert sind. @ConditionalOnMissingBean<\/code> hilft, solche Probleme zu vermeiden.<\/p>\n\n\n\n
3. Erweiterte Nutzung<\/h2>\n\n\n\n
3.1 Verwendung mit name<\/code>-Attribut<\/h3>\n\n\n\n
Die Annotation erlaubt es, nach Beans anhand ihres Namens zu suchen:<\/p>\n\n\n
@Bean\n@ConditionalOnMissingBean(name = \"specificService\"<\/span>)\npublic<\/span> MyService defaultService() {\n    return<\/span> new<\/span> DefaultMyServiceImpl();\n}\n<\/code><\/span>Code-Sprache:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
Diese Bean wird nur dann erstellt, wenn es keine andere Bean mit dem Namen specificService<\/code> gibt.<\/p>\n\n\n\n
3.2 Verwendung mit spezifischen Typen<\/h3>\n\n\n\n
Man kann explizit festlegen, welche Typen gepr\u00fcft werden sollen:<\/p>\n\n\n
@Bean\n@ConditionalOnMissingBean(MyService.class)\npublic MyService myService() {\n    return<\/span> new<\/span> MyServiceImpl();\n}\n<\/code><\/span>Code-Sprache:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
Hier wird sichergestellt, dass myService()<\/code> nur dann erstellt wird, wenn keine andere Bean vom Typ MyService<\/code> vorhanden ist.<\/p>\n\n\n\n
3.3 Kombination mit anderen @Conditional<\/code>-Annotationen<\/h3>\n\n\n\n
Spring bietet weitere bedingte Annotationen wie @ConditionalOnProperty<\/code>, @ConditionalOnClass<\/code>, die sich mit @ConditionalOnMissingBean<\/code> kombinieren lassen:<\/p>\n\n\n
@Bean\n@ConditionalOnMissingBean\n@ConditionalOnProperty(name = \"myapp.feature.enabled\"<\/span>, havingValue = \"true\"<\/span>)\npublic<\/span> MyService conditionalService() {\n    return<\/span> new<\/span> ConditionalMyServiceImpl();\n}\n<\/code><\/span>Code-Sprache:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
Diese Bean wird nur erstellt, wenn myapp.feature.enabled=true<\/code> ist und<\/strong> keine andere MyService<\/code>-Bean vorhanden ist.<\/p>\n\n\n\n
4. Unterschiede zu @Primary<\/code> und @ConditionalOnBean<\/code><\/h2>\n\n\n\n
    \n
  • @Primary<\/code>: Wird genutzt, um eine bevorzugte Bean auszuw\u00e4hlen, wenn mehrere Beans eines Typs existieren.<\/li>\n\n\n\n
  • @ConditionalOnBean<\/code>: Das Gegenteil von @ConditionalOnMissingBean<\/code>, wird nur ausgef\u00fchrt, wenn eine bestimmte Bean bereits existiert.<\/li>\n<\/ul>\n\n\n\n
    5. Nachteile und potenzielle Probleme<\/h2>\n\n\n\n
    Trotz ihrer Vorteile hat @ConditionalOnMissingBean<\/code> auch einige Herausforderungen und Einschr\u00e4nkungen, die beachtet werden sollten:<\/p>\n\n\n\n
    5.1 Abh\u00e4ngigkeit von der Ladereihenfolge<\/h3>\n\n\n\n
    Die Annotation pr\u00fcft, ob eine Bean bereits existiert, was von der Reihenfolge der Konfigurationsklassen und der Initialisierung der Beans abh\u00e4ngig sein kann. Falls eine Bean erst sp\u00e4ter registriert wird, kann es zu unerwarteten Ergebnissen kommen.<\/p>\n\n\n\n
    Beispielproblem:<\/strong><\/p>\n\n\n
    @Configuration\nclass<\/span> ConfigA<\/span> <\/span>{\n    @Bean\n    @ConditionalOnMissingBean\n    public<\/span> MyService myService() {\n        return<\/span> new<\/span> MyServiceImpl();\n    }\n}\n\n@Configuration\nclass<\/span> ConfigB<\/span> <\/span>{\n    @Bean\n    public<\/span> MyService customService() {\n        return<\/span> new<\/span> CustomMyServiceImpl();\n    }\n}\n<\/code><\/span>Code-Sprache:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
    Falls ConfigB<\/code> nach ConfigA<\/code> geladen wird, wird customService()<\/code> registriert, aber myService()<\/code> wurde bereits erstellt. Dies kann zu unerwarteten Verhaltensweisen f\u00fchren.<\/p>\n\n\n\n
    L\u00f6sung:<\/strong> Man kann explizit die Reihenfolge mit @AutoConfigureOrder<\/code> oder @DependsOn<\/code> steuern.<\/p>\n\n\n\n
    5.2 Schwierigkeiten bei Debugging und Wartung<\/h3>\n\n\n\n
    Da die Bean-Registrierung von vorhandenen Beans abh\u00e4ngt, kann es schwierig sein, nachzuvollziehen, warum eine bestimmte Bean nicht registriert wurde. Besonders in komplexen Spring-Projekten mit vielen Autokonfigurationen kann dies das Debugging erschweren.<\/p>\n\n\n\n
    5.3 Unbeabsichtigtes Unterdr\u00fccken von Beans<\/h3>\n\n\n\n
    Wenn eine bereits existierende Bean f\u00e4lschlicherweise als „nicht vorhanden“ erkannt wird, kann eine unerw\u00fcnschte Standardimplementierung registriert werden. Dies kann zu unerwarteten Fehlern f\u00fchren.<\/p>\n\n\n\n
    L\u00f6sung:<\/strong><\/p>\n\n\n\n
      \n
    • Pr\u00fcfen, ob @Primary<\/code> oder @Qualifier<\/code> korrekt gesetzt wurden.<\/li>\n\n\n\n
    • Sicherstellen, dass alle notwendigen Konfigurationen geladen sind.<\/li>\n<\/ul>\n\n\n\n
      6. Fazit<\/h2>\n\n\n\n
      Die Annotation @ConditionalOnMissingBean<\/code> ist ein wesentliches Werkzeug zur Gestaltung flexibler, erweiterbarer Spring-Boot-Anwendungen. Sie verhindert Konflikte, erlaubt Anpassungen und sorgt f\u00fcr eine saubere, modulare Architektur. Insbesondere in Bibliotheken oder Frameworks, die mit Spring Boot arbeiten, ist sie unverzichtbar.<\/p>\n\n\n\n
      Allerdings ist es wichtig, die Abh\u00e4ngigkeit von der Ladereihenfolge zu beachten und sicherzustellen, dass die gew\u00fcnschte Bean-Registrierung wie erwartet funktioniert. Durch geeignete Debugging-Strategien und eine bewusste Steuerung der Konfigurationsklassen kann man potenzielle Probleme minimieren und das volle Potenzial dieser Annotation nutzen.<\/p>\n","protected":false},"excerpt":{"rendered":"
      Die Annotation @ConditionalOnMissingBean ist ein leistungsstarkes Werkzeug im Spring-Framework, das es Entwicklern erm\u00f6glicht, Beans nur dann zu registrieren, wenn keine andere Bean des gleichen Typs bereits vorhanden ist. Dies ist besonders n\u00fctzlich in Konfigurationsklassen, bei der Implementierung von Bibliotheken und beim Anpassen des Spring-Kontexts. 1. Grundlagen von @ConditionalOnMissingBean Die Annotation @ConditionalOnMissingBean stammt aus dem Spring […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[5],"tags":[],"class_list":["post-589","post","type-post","status-publish","format-standard","hentry","category-spring"],"_links":{"self":[{"href":"https:\/\/www.xn--javaeinfacherklrt-4qb.de\/index.php?rest_route=\/wp\/v2\/posts\/589","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.xn--javaeinfacherklrt-4qb.de\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.xn--javaeinfacherklrt-4qb.de\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.xn--javaeinfacherklrt-4qb.de\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.xn--javaeinfacherklrt-4qb.de\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=589"}],"version-history":[{"count":1,"href":"https:\/\/www.xn--javaeinfacherklrt-4qb.de\/index.php?rest_route=\/wp\/v2\/posts\/589\/revisions"}],"predecessor-version":[{"id":590,"href":"https:\/\/www.xn--javaeinfacherklrt-4qb.de\/index.php?rest_route=\/wp\/v2\/posts\/589\/revisions\/590"}],"wp:attachment":[{"href":"https:\/\/www.xn--javaeinfacherklrt-4qb.de\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=589"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.xn--javaeinfacherklrt-4qb.de\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=589"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.xn--javaeinfacherklrt-4qb.de\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=589"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}