spring boot
v3.3.6
Spring Boot vous aide à créer des applications et des services de production basés sur Spring avec un minimum de complications. Il faut une vision avisée de la plate-forme Spring afin que les utilisateurs nouveaux et existants puissent accéder rapidement aux éléments dont ils ont besoin.
Vous pouvez utiliser Spring Boot pour créer des applications Java autonomes qui peuvent être démarrées à l'aide java -jar ou de déploiements WAR plus traditionnels. Nous fournissons également un outil de ligne de commande qui exécute les scripts Spring.
Nos principaux objectifs sont :
Offrez une expérience de démarrage radicalement plus rapide et largement accessible pour tous les développements Spring.
Soyez opiniâtre, mais éloignez-vous rapidement lorsque les exigences commencent à s'écarter des valeurs par défaut.
Fournir une gamme de fonctionnalités non fonctionnelles communes à de grandes classes de projets (par exemple, serveurs intégrés, sécurité, métriques, contrôles de santé, configuration externalisée).
Absolument aucune génération de code et aucune exigence de configuration XML.
La documentation de référence comprend des instructions d'installation détaillées ainsi qu'un guide getting started complet.
Voici un aperçu rapide d’une application Spring Boot complète en Java :
import org.springframework.boot.*;import org.springframework.boot.autoconfigure.*;import org.springframework.web.bind.annotation.*;@RestController@SpringBootApplicationpublic class Exemple {@RequestMapping("/")String home( ) {return "Bonjour tout le monde !";
}public static void main(String[] args) {SpringApplication.run(Example.class, args);
}
}Rencontrez-vous des problèmes avec Spring Boot ? Nous voulons aider!
Consultez la documentation de référence, en particulier les procédures : elles fournissent des solutions aux questions les plus courantes.
Apprenez les bases de Spring — Spring Boot s'appuie sur de nombreux autres projets Spring ; consultez le site Web spring.io pour une multitude de documentation de référence. Si vous êtes nouveau sur Spring, essayez l’un des guides.
Si vous effectuez une mise à niveau, lisez les notes de version pour connaître les instructions de mise à niveau et les fonctionnalités « nouvelles et remarquables ».
Posez une question - nous surveillons stackoverflow.com pour les questions marquées avec spring-boot . Vous pouvez également discuter avec la communauté sur Gitter.
Signalez les bogues avec Spring Boot sur github.com/spring-projects/spring-boot/issues.
Spring Boot utilise le système de suivi des problèmes intégré de GitHub pour enregistrer les bogues et les demandes de fonctionnalités. Si vous souhaitez soulever un problème, veuillez suivre les recommandations ci-dessous :
Avant de consigner un bug, veuillez effectuer une recherche dans le système de suivi des problèmes pour voir si quelqu'un a déjà signalé le problème.
Si le problème n'existe pas déjà, créez un nouveau problème.
Veuillez fournir autant d'informations que possible avec le rapport de problème. Nous aimons connaître la version de Spring Boot, le système d'exploitation et la version de JVM que vous utilisez.
Si vous devez coller du code ou inclure une trace de pile, utilisez Markdown. ``` s'échappe avant et après votre texte.
Si possible, essayez de créer un scénario de test ou un projet qui reproduit le problème et attachez-le au problème.
Vous n'avez pas besoin de construire à partir des sources pour utiliser Spring Boot (binaires dans repo.spring.io), mais si vous souhaitez essayer la dernière et la meilleure version, Spring Boot peut être construit et publié sur votre cache Maven local à l'aide de Gradle. emballage. Vous avez également besoin du JDK 17.
$ ./gradlew publierToMavenLocal
Cela créera tous les fichiers jar et la documentation et les publiera dans votre cache Maven local. Il n'exécutera aucun des tests. Si vous souhaitez tout construire, utilisez la tâche build :
$ ./build wgradlew
Il existe plusieurs modules dans Spring Boot. Voici un aperçu rapide :
La bibliothèque principale fournissant des fonctionnalités prenant en charge les autres parties de Spring Boot. Ceux-ci incluent :
La classe SpringApplication , fournissant des méthodes pratiques statiques qui peuvent être utilisées pour écrire une application Spring autonome. Son seul travail consiste à créer et actualiser un Spring ApplicationContext approprié.
Applications Web intégrées avec un choix de conteneur (Tomcat, Jetty ou Undertow).
Prise en charge de la configuration externalisée de première classe.
Initialiseurs pratiques ApplicationContext , y compris la prise en charge des valeurs par défaut de journalisation sensibles.
Spring Boot peut configurer de grandes parties d'applications typiques en fonction du contenu de leur chemin de classe. Une seule annotation @EnableAutoConfiguration déclenche la configuration automatique du contexte Spring.
La configuration automatique tente de déduire les beans dont un utilisateur pourrait avoir besoin. Par exemple, si HSQLDB se trouve sur le chemin de classe et que l'utilisateur n'a configuré aucune connexion à la base de données, il souhaite probablement qu'une base de données en mémoire soit définie. La configuration automatique reculera toujours à mesure que l'utilisateur commencera à définir ses propres beans.
Les starters sont un ensemble de descripteurs de dépendances pratiques que vous pouvez inclure dans votre application. Vous bénéficiez d'un guichet unique pour tous les Spring et les technologies associées dont vous avez besoin sans avoir à parcourir des exemples de code et à copier-coller de nombreux descripteurs de dépendances. Par exemple, si vous souhaitez commencer à utiliser Spring et JPA pour accéder à la base de données, incluez la dépendance spring-boot-starter-data-jpa dans votre projet et vous êtes prêt à partir.
Les points de terminaison de l'actionneur vous permettent de surveiller et d'interagir avec votre application. Spring Boot Actuator fournit l'infrastructure requise pour les points de terminaison de l'actionneur. Il contient la prise en charge des annotations pour les points de terminaison des actionneurs. Ce module fournit de nombreux points de terminaison, notamment HealthEndpoint , EnvironmentEndpoint , BeansEndpoint et bien d'autres.
Cela permet une configuration automatique des points de terminaison de l'actionneur en fonction du contenu du chemin de classe et d'un ensemble de propriétés. Par exemple, si Micrometer se trouve sur le chemin de classe, il configurera automatiquement le MetricsEndpoint . Il contient une configuration pour exposer les points de terminaison via HTTP ou JMX. Tout comme Spring Boot AutoConfigure, cela reculera à mesure que l'utilisateur commencera à définir ses propres beans.
Ce module contient des éléments de base et des annotations qui peuvent être utiles lors du test de votre application.
Comme les autres modules de configuration automatique de Spring Boot, spring-boot-test-autoconfigure fournit une configuration automatique pour les tests basés sur le chemin de classe. Il comprend de nombreuses annotations permettant de configurer automatiquement une tranche de votre application qui doit être testée.
Spring Boot Loader fournit la sauce secrète qui vous permet de créer un seul fichier jar pouvant être lancé à l'aide de java -jar . Généralement, vous n'aurez pas besoin d'utiliser directement spring-boot-loader mais de travailler plutôt avec le plugin Gradle ou Maven.
Le module spring-boot-devtools fournit des fonctionnalités de développement supplémentaires, telles que les redémarrages automatiques, pour une expérience de développement d'applications plus fluide. Les outils de développement sont automatiquement désactivés lors de l'exécution d'une application entièrement packagée.
Le site spring.io contient plusieurs guides qui montrent comment utiliser Spring Boot étape par étape :
Créer une application avec Spring Boot est un guide d'introduction qui vous montre comment créer une application, l'exécuter et ajouter des services de gestion.
Construire un service Web RESTful avec Spring Boot Actuator est un guide pour créer un service Web REST et montre également comment le serveur peut être configuré.
Spring Boot est un logiciel Open Source publié sous la licence Apache 2.0.
