spring-boot - スプリングブーツ

(Spring Boot)

Created at: 2012-10-19 23:02:57
Language: Java
License: Apache-2.0

= 春のブート画像:https://ci.spring.io/api/v1/teams/spring-boot/pipelines/spring-boot-3.1.x/jobs/build/badge["ビルドステータス", link="https://ci.spring.io/teams/spring-boot/pipelines/spring-boot-3.1.x?groups=Build"] 画像:https://badges.gitter.im/Join チャット.svg["チャット",link="https://gitter.im/spring-projects/spring-boot?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge"] 画像:https://img.shields.io/badge/Revved%20up%20by-Gradle%20Enterprise-06A0CE?logo=Gradle&labelColor=02303A["Revved up by Gradle Enterprise", link="https://ge.spring.io/scans?&search.rootProjectNames=Spring%20Boot%20Build&search.rootProjectNames=spring-boot-build"] :d ocs: https://docs.spring.io/spring-boot/docs/current-SNAPSHOT/reference :github: https://github.com/spring-projects/spring-boot

Spring Bootは、Springを利用した本番グレードのアプリケーションとサービスを最小限の手間で作成するのに役立ちます。 Springプラットフォームの意見の見解を取り、新規および既存のユーザーが必要なものにすばやくアクセスできるようにします。

Spring Boot を使用して、従来の WAR デプロイメントを使用して開始できるスタンドアロン Java アプリケーションを作成できます。 また、Springスクリプトを実行するコマンドラインツールも提供しています。

java -jar

私たちの主な目標は次のとおりです。

  • すべての Spring 開発に、根本的に高速で広くアクセス可能な入門体験を提供します。
  • 意見がありますが、要件がデフォルトから逸脱し始めたら、すぐに邪魔になりません。
  • 大規模なクラスのプロジェクトに共通するさまざまな非機能機能 (組み込みサーバー、セキュリティ、メトリック、ヘルスチェック、外部化された構成など) を提供します。
  • コード生成やXML構成の要件はまったくありません。

== インストールと開始 {docs}/html/[リファレンスドキュメント] には、詳細な {docs}/html/gettting-started.html#gettting-started-installing-spring-boot[インストール手順] と、包括的な {docs}/html/gettting-started.html#gettting-started-first-application[] ガイドが含まれています。

getting started

Javaの完全なスプリングブートアプリケーションの簡単なティーザーは次のとおりです。

[ソース、Java、インデント= 0]

import org.springframework.boot.*;
import org.springframework.boot.autoconfigure.*;
import org.springframework.web.bind.annotation.*;

@RestController
@SpringBootApplication
public class Example {

	@RequestMapping("/")
	String home() {
		return "Hello World!";
	}

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

}

== ヘルプの利用 スプリングブートで問題がありますか?私たちは助けたいです!

  • {docs}/html/[リファレンスドキュメント]、特に{docs}/html/howto.html#howto[How-to's]を確認してください -- それらは最も一般的な質問に対する解決策を提供します。
  • Spring の基本を学ぶ -- Spring Boot は他の多くの Spring プロジェクトの上に構築されています。豊富なリファレンスドキュメントについては、https://spring.io[spring.io]のWebサイトを確認してください。 Springを初めて使用する場合は、https://spring.io/guides[ガイド]のいずれかを試してください。
  • アップグレードする場合は、{github}/wiki[リリースノート]を読んで、アップグレード手順と「新機能と注目すべき」機能を確認してください。
  • 質問をする -- https://stackoverflow.com/tags/spring-boot['spring-boot'] でタグ付けされた質問がないか https://stackoverflow.com[stackoverflow.com] を監視します。 また、https://gitter.im/spring プロジェクト/spring-boot[Gitter]でコミュニティとチャットすることもできます。
  • Spring Boot のバグを {github}/issues[github.com/spring-projects/spring-boot/issues] で報告してください。

== 問題の報告 Spring Boot は、GitHub の統合問題追跡システムを使用して、バグと機能リクエストを記録します。 問題を提起する場合は、以下の推奨事項に従ってください。

  • バグを記録する前に、{github}/issues[課題トラッカー]を検索して、誰かがすでに問題を報告していないかどうかを確認してください。
  • 問題がまだ存在しない場合は、{github}/issues/new[新しい問題を作成]します。
  • 問題レポートにはできるだけ多くの情報を提供してください。 使用しているSpring Bootのバージョン、オペレーティングシステム、およびJVMのバージョンを知りたいと思っています。
  • コードを貼り付けたり、スタックトレースを含めたりする必要がある場合は、Markdown を使用します。 +++'''+++ テキストの前後にエスケープします。
  • 可能であれば、問題を再現するテスト ケースまたはプロジェクトを作成し、問題にアタッチしてみてください。

== ソースからのビルド Spring Boot (https://repo.spring.io[repo.spring.io] のバイナリ) を使用するためにソースからビルドする必要はありませんが、最新かつ最高のものを試してみたい場合は、Spring Boot をビルドし、https://docs.gradle.org/current/userguide/gradle_wrapper.html [Gradleラッパー]を使用してローカルのMavenキャッシュに公開できます。 JDK 17 も必要です。

[インデント= 0]

$ ./gradlew publishToMavenLocal

これにより、すべてのjarファイルとドキュメントがビルドされ、ローカルのMavenキャッシュに公開されます。 テストは実行されません。 すべてをビルドする場合は、次のタスクを使用します。

build

[インデント= 0]

$ ./gradlew build

== モジュール スプリングブートにはいくつかのモジュールがあります。簡単な概要は次のとおりです。

=== スプリングブーツ Spring Bootの他の部分をサポートする機能を提供するメインライブラリ。これらが含まれます:

  • このクラスは、スタンドアロンの Spring アプリケーションを作成するために使用できる静的な便利なメソッドを提供します。 その唯一の仕事は、適切なものを作成して更新することです 春 。
    SpringApplication
    ApplicationContext
  • コンテナ(Tomcat、Jetty、またはUndertow)を選択できる組み込みWebアプリケーション。
  • ファーストクラスの外部化された構成のサポート。
  • 便利な初期化子 (適切なログ記録の既定値のサポートを含む)。
    ApplicationContext

=== スプリングブート自動設定 Spring Boot では、クラスパスの内容に基づいて、一般的なアプリケーションの大部分を構成できます。 1 つの注釈によって、Spring コンテキストの自動構成がトリガーされます。

@EnableAutoConfiguration

自動構成は、ユーザーが必要とする可能性のある Bean を推測しようとします。たとえば、がクラスパス上にあり、ユーザーがデータベース接続を構成していない場合、メモリ内データベースを定義する必要があります。 自動構成は、ユーザーが独自の Bean の定義を開始すると、常に元に戻ります。

HSQLDB

=== スプリングブートスターター スターターは、アプリケーションに含めることができる便利な依存関係記述子のセットです。 必要なすべてのSpringおよび関連テクノロジーのワンストップショップを、サンプルコードを探したり、依存関係記述子のロードをコピーして貼り付けたりすることなく入手できます。 たとえば、データベースアクセスにSpringとJPAの使用を開始する場合は、プロジェクトに依存関係を含めれば、準備は完了です。

spring-boot-starter-data-jpa

=== スプリングブートアクチュエータ アクチュエータエンドポイントを使用すると、アプリケーションを監視および操作できます。 スプリングブートアクチュエータは、アクチュエータエンドポイントに必要なインフラストラクチャを提供します。 これには、アクチュエータの端点の注釈サポートが含まれています。 このモジュールは、、など、多くのエンドポイントを提供します。

HealthEndpoint
EnvironmentEndpoint
BeansEndpoint

=== スプリングブートアクチュエータ自動設定 これにより、クラスパスの内容と一連のプロパティに基づいてアクチュエータエンドポイントの自動構成が提供されます。 たとえば、Micrometer がクラスパス上にある場合は、. これには、HTTP または JMX 経由でエンドポイントを公開するための構成が含まれています。 Spring Boot AutoConfigureと同様に、ユーザーが独自のBeanを定義し始めると、これは元に戻ります。

MetricsEndpoint

=== スプリングブートテスト このモジュールには、アプリケーションをテストするときに役立つコア項目と注釈が含まれています。

=== スプリングブートテスト自動設定 他の Spring Boot 自動設定モジュールと同様に、spring-boot-test-autoconfigure はクラスパスに基づいてテストの自動設定を提供します。 これには、テストする必要があるアプリケーションのスライスを自動的に構成できる多くの注釈が含まれています。

=== スプリングブートローダ Spring Boot Loader は、を使用して起動できる単一の jar ファイルを構築できる秘密のソースを提供します。 一般的には、直接使用する必要はありませんが、代わりに link:spring-boot-project/spring-boot-tools/spring-boot-gradle-plugin[Gradle] または link:spring-boot-project/spring-boot-tools/spring-boot-maven-plugin[Maven] プラグインを使用します。

java -jar
spring-boot-loader

=== spring-boot-devtools spring-boot-devtools モジュールは、よりスムーズなアプリケーション開発エクスペリエンスのために、自動再起動などの追加の開発時機能を提供します。 開発者ツールは、完全にパッケージ化されたアプリケーションを実行すると自動的に無効になります。

== ガイド https://spring.io/[spring.io] サイトには、Spring Boot の使い方を順を追って示すガイドがいくつか含まれています。

  • https://spring.io/guides/gs/spring-boot/[Spring Bootを使用したアプリケーションの構築]は、アプリケーションの作成、実行、およびいくつかの管理サービスの追加方法を示す入門ガイドです。
  • https://spring.io/guides/gs/actuator サービス/[Spring Boot Actuatorを使用したRESTful Webサービスの構築]は、REST Webサービスを作成するためのガイドであり、サーバーを構成する方法も示しています。
  • https://spring.io/guides/gs/convert-jar-to-war/[Spring Boot JAR アプリケーションを WAR に変換する] では、Web サーバーでアプリケーションを WAR ファイルとして実行する方法を示します。

== ライセンス Spring Boot は https://www.apache.org/licenses/LICENSE-2.0.html[Apache 2.0 ライセンス] の下でリリースされたオープンソースソフトウェアです。