SpringBootReference 目录的日文翻译
http://docs.spring.io/spring-boot/docs/1.4.2.RELEASE/reference/htmlsingle/
的目录
对于章、节和项来说,我没有劲儿再说了。
-
- Copyright © 2013-2016
-
- このドキュメントについて
-
- 助けを呼ぶ (バグなどの報告について)
-
- First steps(springのファーストステップ)
-
- Springブートの使用 (ビルドシステムなどの環境)
-
- Spring起動機能について学ぶ(MVCやSQLなど)
-
- プロダクションへの移行(HTTP、SSHなど)
-
- 高度なトピック(application propertiesなど)
-
- SpringBootの紹介・Introducing Spring Boot
-
- システム要件・System Requirements
9.1 サーブレットコンテナ・Servlet containers
Spring Bootのインストール
10.1 Java開発者のインストール手順
10.1.1 Mavenインストール
10.1.2 Gradleのインストール
10.2 Spring Boot CLIのインストール
10.3 SpringBootのアップデート
最初のSpring Bootアプリケーションの開発
11.1 POMの作成
11.2 クラスパス依存関係の追加
11.3コードを書く
11.3.1 @RestControllerアノテーションと@RequestMappingアノテーション(ルーティングと文字列を返す)
11.3.2 @EnableAutoConfigurationアノテーション(Springの設定方法を「推測」し設定する)
11.3.3 メインメソッド
11.4 サンプルの実行(SpringBootの実行)
次に読むもの
Part III. Spring Bootを使う
ビルドシステム
13.1 依存の管理
13.2 Maven
13.2.1 スターターの親を継承する
13.2.2 親POMなしでSpringBootを使う
13.2.3 Javaバージョンの変更
13.2.4 Spring Boot Mavenプラグインの使用
13.3 Gradle
13.4 Ant(省略)
13.5 Starters(必要なすべてのSpringおよび関連技術の一括入手)
コードの構造化
14.1 “デフォルト”パッケージの使用(クラスにパッケージ宣言が含まれていない場合)
14.2 メインアプリケーションクラスの位置
設定クラス
15.1 追加の設定クラスのインポート
15.2 XML設定のインポート
自動設定・Auto-configuration
16.1 徐々に自動設定を置き換える
16.2 特定の自動設定を無効にする
Spring Beanと依存性注入
@SpringBootApplicationアノテーションの使用(メインクラスのアノテーションの一括設定)
アプリケーションの実行
19.1 IDEからの実行
19.2 パッケージ化されたアプリケーション(jar)として実行する
19.3 Mavenプラグインの使用
19.4 Gradleプラグインの使用
19.5ホットスワップ
開発ツール(Developer tools)
20.1デフォルトプロパティ
20.2自動再始動(クラスパス上のファイルの変更をトリガーにしてアプリケーションを再起動)
20.2.1リソースの除外
20.2.2追加パスの監視
20.2.3再起動を無効にする
20.2.4トリガーファイルの使用
20.2.5再起動クラスローダのカスタマイズ
20.2.6既知の制限事項
20.3 Live Reload?(F5を押さず更新する)
20.4グローバルなdevtoolの設定
20.5 リモートアプリケーション実行
20.5.1リモート・クライアント・アプリケーションの実行
20.5.2リモート更新
20.5.3 リモートデバッグトンネル
実稼働用にアプリケーションをパッケージ化する(実行可能なjarは本番用のデプロイメントに使用可)
次に読むもの
パートIV。Spring Bootの機能
Spring Application?
23.1 スタートアップの失敗
23.2 バナーのカスタマイズ
23.3 Springアプリケーションのカスタマイズ(SpringApplicationに渡されるコンストラクタ引数)
23.4柔軟なビルダーAPI(メソッド呼び出しの順番化)
23.5アプリケーションイベントとリスナー
23.6 Web環境の構築
23.7アプリケーション引数へのアクセス (–debugの付与など)
23.8 SpringApplicationが開始された後で特定のコードを実行する必要がある場合
23.9アプリケーション終了(終了時の処理の組み込み)
23.10管理機能 (Springブートアプリケーションをリモートで管理)
外部化された構成(異なる環境で同じアプリケーションコードで作業)
24.1ランダム値の設定 (my.number = $ {random.int})
24.2コマンドラインのプロパティへのアクセス
24.3アプリケーションプロパティファイルを読み込む
24.5プロパティのプレースホルダ(以前に定義された値を参照する)
24.6プロパティの代わりにYAMLを使う
24.6.1 YAMLのロード
24.6.2 Spring環境におけるプロパティとしてのYAMLの公開
24.6.3マルチプロファイルYAML文書(developなのかproductionなのかで処理を分けるymlの書き方)
24.6.4 YAMLの欠点
24.6.5 YAMLリストのマージ
24.7 Type-safeな構成プロパティ(プロパティの型安全)
24.7.1サードパーティの設定(サードパーティコンポーネントにプロパティをバインドする)
24.7.2リラックス・バインディング(プロパティ名が一致しなくてよい)
24.7.3プロパティの変換
24.7.4 @ConfigurationProperties検証(@Validバリデーション)
24.7.5 プロパティファイルの値を取り出す2つのアノテーション
プロファイル(アプリケーション構成の一部を分離し、特定の環境でのみ使用可能にする)
25.1アクティブ(有効)なプロファイルの追加
25.2プログラムによるプロファイルの設定
25.3プロファイル固有の設定ファイル
ロギング・logging(ログ・Log)
26.1 ログ形式
26.2 色分けされた出力
26.3 ログのファイル出力
26.4ログレベル
26.5ログシステムをカスタマイズする
26.6 Logback拡張
26.6.1プロファイル固有の設定
26.6.2環境プロパティ (Spring環境のプロパティをLogback内で使用する)
Webアプリケーションの開発
27.1「Spring Web MVCフレームワーク」
27.1.1 Spring MVC自動設定
27.1.2 Http Message Converters?(HTTPリクエストとレスポンスを変換する)
27.1.3JSONデータをシリアライズおよびデシリアライズ
27.1.4 Message Codes Resolver? (エラーメッセージをレンダリング)
27.1.5静的コンテンツの読み込み動作を変える(resource, staticなど)
27.1.6 Configurable Web Binding Initializer?(初期化の設定を変える)
27.1.7テンプレートエンジン(動的HTMLコンテンツ提供・Thymeleafなど)
27.1.8エラー処理
27.1.9 Spring HATEOAS (状態遷移を表現するRestful APIの設計)
27.1.10 CORS(クロスオリジンリソース共有、クロスドメインリクエスト)のサポート
27.2 JAX-RSとJerseyプログラミング・モデルを使用する
27.3組み込みサーブレット・コンテナ(Tomcatなど)のサポート
27.3.1サーブレット、フィルタ、およびリスナーを登録
27.3.2サーブレット・コンテキストの初期化
27.3.3 …
27.3.4組み込みサーブレット・コンテナのカスタマイズ
27.3.5 JSPの制限事項
セキュリティ
28.1 OAuth2
28.1.1認証サーバー
28.1.2リソースサーバー
28.2ユーザー情報のトークンタイプ
28.3ユーザー情報RestTemplateのカスタマイズ
28.3.1クライアント(WebアプリケーションをOAuth2クライアントにする)
28.3.2シングルサインオン
28.4アクチュエータの安全性(システムの状態やメトリクスを確認??)
SQLデータベースの操作
29.1データソースの設定
29.1.1組み込みデータベースのサポート
29.1.2本番用(プロダクション)データベースへの接続
29.1.3 JNDI(ファイルシステムやDNS、LDAP)データソースへの接続
29.2 JdbcTemplateの使用
29.3 JPAと「Spring Data」(オブジェクトをリレーショナルデータベースにマップする)
29.3.1エンティティクラス
29.3.2 SpringデータJPAリポジトリ(データにアクセスするためのインタフェース)
29.3.3 JPAデータベースの作成と削除
29.4 H2データベースのWebコンソールの使用
29.4.1 H2コンソールのパスを変更する
29.4.2 H2コンソールのセキュリティ確保
29.5 jOOQの使用(データベースからJavaコード,型安全なSQLクエリを生成する)
29.5.1コード生成
29.5.2 DSLContextの使用(JOOQの開始トリガー)
29.5.3 jOOQのカスタマイズ
NoSQLテクノロジの使用
30.1 Redis(キーバリューストア)
30.1.1 Redisへの接続
30.2 MongoDB(リレーショナルデータの代わりにJSONのようなスキーマを使用する)
30.2.1 MongoDBデータベースへの接続
30.2.2 Mongoテンプレート
30.2.3 SpringデータMongoDBリポジトリ
30.2.4埋め込みMongo
30.3 Neo4j(グラフデータベース・グラフ理論に基づいたデータ処理)
30.3.1 Neo4jデータベースへの接続
30.3.2組み込みモードの使用
30.3.3 Neo4jのセッション、有効期限
30.3.4 SpringデータNeo4jリポジトリ
30.3.5 Repository example
30.4 Gemfire(Pivotal Gemfireデータ管理プラットフォームとの連携)
30.5 Solr (Apache Solrは検索エンジン)
30.5.1 Solrへの接続
30.5.2 SpringデータSolrリポジトリ
30.6 Elasticsearch(全文検索エンジン。目的のワードを含むドキュメントデータを検索する)
30.6.1 Jestを使用したElasticsearchへの接続
30.6.2 Springデータを使用したElasticsearchへの接続
30.6.3 Spring Data Elasticsearchリポジトリ
30.7 Cassandra(分散型NoSQLデータベースでIoTと相性がいい)
30.7.1 Cassandraへの接続
30.7.2 SpringデータCassandraリポジトリ
30.8 Couchbase(対話型アプリケーション向け、分散型マルチモデルNoSQLドキュメント指向データベース)
30.8.1 Couchbaseへの接続
30.8.2 SpringデータCouchbaseリポジトリ
キャッシュ
31.1サポートされているキャッシュプロバイダ
31.1.1 Generic・汎用キャッシュ
31.1.2 JCache (JSR-107)
31.1.3 Eh Cache? 2.x
31.1.4 Hazelcast、ヘーゼルキャスト
31.1.5 Infinispan
31.1.6 Couchbase
31.1.7 Redis
31.1.8 Caffeine・カフェイン
31.1.9 Guava・グァバ
31.1.10 Simple (アプリケーションにキャッシュライブラリが存在しない場合のデフォルト)
31.1.11 None・なし
メッセージング
32.1 JMS(Java Message Service)
32.2 AMQP
RESTサービスの呼び出し
33.1 RestTemplateのカスタマイズ
電子メールを送信する
JTA(Java Transaction API)による分散トランザクション
35.1 Atomikosトランザクションマネージャの使用
35.2 Bitronixトランザクションマネージャの使用
35.3 Narayanaトランザクションマネージャの使用
35.4 Java EE管理トランザクション・マネージャの使用
35.5 XA JMS(Java Message Service)接続と非XA JMS接続の混在
35.6 代替埋込みトランザクションマネージャのサポート
Hazelcast・ヘーゼルキャスト
Spring Integrationと連携する (Springの統合)
Springのセッション保存先指定 (セッションの格納に使用するStoreTypeを選択する)
JMX (Java Management Extensions) での監視と管理
テスト
40.1テストスコープの依存関係
40.2 Springアプリケーションのテスト(テストモジュール)
40.3 Spring Bootアプリケーションのテスト
40.4 ユーティリティをテストする
SpringBootはWebSocketsのサポートを提供している
Webサービス (Spring Web Services)
独自の自動設定を作成する (カスタムstarterの作成)
43.1自動構成されたBeanの理解 (@Configurationクラスの理解)
43.2自動構成候補の特定
43.3 @Contition (自動設定クラスにおいてオーバーライドする)
43.4独自のスターターを作成する
次に読むもの
Part V. Spring Bootアクチュエータ:プロダクションのを監視および管理機能
プロダクション対応の機能を有効にする
エンドポイント(Spring Boot Actuator、デフォルトでステータス確認画面とか色々用意してくれる)
46.1エンドポイントのカスタマイズ
46.2アクチュエータMVCエンドポイントのハイパーメディア
46.3 CORS(クロスオリジンリソース共有・クロスドメイン要求の種類許可)のサポート
46.4カスタム・エンドポイント
46.5 実行中のアプリケーションの状態を確認
46.6 HealthIndicatorsによるセキュリティ(認証なしのアクセスには正常性状態のみを公開)
46.7アプリケーション情報 (git情報、文字コード、java情報など)
HTTPによる監視と管理
47.1SpringSecurityによるユーザー名やパスワードなどの機密エンドポイントの保護
47.2管理エンドポイント・パスのカスタマイズ
47.3 管理サーバー・ポートのカスタマイズ
47.4管理固有のSSLの構成
47.5管理サーバーのアドレスのカスタマイズ
47.6 HTTPエンドポイントの無効化
47.7 HTTPヘルスエンドポイントのアクセス制限(アクセス元の信頼性で処理を変える)
JMXでの監視と管理
48.1 MBean名のカスタマイズ
48.2 JMX (Java Management Extensions) エンドポイントの無効化
48.3 HTTP経由のJMXでJolokiaを使用する
リモートシェルを使用した監視と管理 (実行中のアプリケーションにsshまたはtelnetする)
49.1リモートシェルへの接続
49.2リモートシェルの拡張
メトリクス(コードの品質・情報を数値化)
50.1システムメトリック(空きメモリ量、稼働時間など)
50.2 DataSourceメトリック (アクティブな接続の数、接続プール使用状況など)
50.3キャッシュメトリック(キャッシュサイズ、ヒット率、ミス率)
50.4 Tomcatセッション・メトリック (アクティブセッションと最大セッション)
50.5独自のメトリックを記録する
50.6独自の公開メトリックを追加する
50.7 Java 8の特殊機能
50.8メトリックの書き込み、出力および集計
50.9複数のソースからのメトリックの集計
50.10 Dropwizardメトリック
50.11メッセージチャネルの統合
監査 (Spring Boot Actuatorの監査フレームワーク・認証やアクセス拒否の報告と処理分岐)
トレース
52.1 追加のイベントをトレースする
プロセス監視 (Spring Boot Actuatorによるプロセス監視に役立つファイルを作成)
53.1構成を拡張する(PIDファイルを書き込むリスナーをアクティブにする)
53.2 プログラムでリスナーをアクティブにする
次に読むもの
パートVI。 Springブートアプリケーションのデプロイ
クラウドへのデプロイ(クラウドプロバイダーのHerokuとCloud Foundry)
55.1 Cloud Foundry(他のビルドパックが指定されていない場合に再生されるデフォルトのビルドパック)
55.2 Heroku
55.3 Open Shift?(RedHatのPaaSソリューション)
55.4 BoxfuseとAmazon Webサービス
55.5 Google App Engine
Springブートアプリケーションのインストール(Unixシステム用に完全に実行可能なアプリケーションを作成)
56.1 Unix / Linuxサービス (init.dまたはsystemdを使用するサービスとして起動する)
56.2 Microsoft Windowsサービスとして起動
次に読むもの
パートVII. Spring Boot CLI(省略)
パートVIII. ビルドツールプラグイン(MavenとGradle用プラグインとサポートされていないビルドシステム)
Spring Boot Mavenプラグイン
63.1プラグインの追加
63.2実行可能なjarファイルとwarファイルのパッケージ化 (自己完結型の実行可能アーカイブにする)
Spring Boot Gradleプラグイン
64.1プラグインの追加
64.2 Gradle依存関係管理
64.3実行可能なjarファイルとwarファイルのパッケージ化
64.4インプレース(jarファイルを作成しない)でプロジェクトを実行する
64.5 Springブートプラグインの設定(プロパティを設定)
64.6リパッケージ構成
64.7カスタムGradle構成によるリパッケージ
64.8 Gradleプラグインのしくみの理解
64.9 Gradleを使用してMavenリポジトリにアーティファクトを公開する
Spring Boot AntLibモジュール (Apache Antの基本的なSpringブートサポート)
65.1 Spring Boot Antタスク
65.2 spring-boot:findmainclass (mainを宣言するクラスの場所を特定)
他のビルドシステムのサポート (Maven、Gradle、Ant以外は独自プラグインの開発を行う)
66.1アーカイブのリパッケージ (自己完結型の実行可能アーカイブにする)
66.2ネストされたライブラリ
66.3メインクラスの検索
66.4リパッケージ実装の例
次に読むもの
パートIX. 「How To」ガイド (よくある質問)
Springブートアプリケーション
68.1独自のFailureAnalyzerを作成する
68.2自動構成(auto-configuration)のトラブルシューティング
68.3起動前に環境またはApplicationContextをカスタマイズする
68.4 ApplicationContext階層の構築(親コンテキストまたはルートコンテキストの追加)
68.5非Webアプリケーションの作成
プロパティと設定
69.1ビルド時にプロパティを自動的に展開する
69.2 SpringApplicationの設定 (プロパティ)を外部化する
69.3アプリケーションの外部プロパティの場所を変更する
69.4 ‘短い’コマンドライン引数を使う (コマンドラインで設定プロパティーを設定する)
69.5外部プロパティーにYAMLを使用する(application.propertiesではなくyml)
69.6アクティブなSpringプロファイルを設定する(production, developの指定)
69.7環境によって設定を変更する
69.8外部プロパティの組込みオプションを検出する
組み込みサーブレット・コンテナ
70.1アプリケーションにサーブレット、フィルタまたはリスナーを追加する
70.2 HTTPポートを変更する
70.3割り当てられていないランダムなHTTPポートを使用する
70.4実行時にHTTPポートを検出する
70.6アクセス・ロギングの構成
70.7フロントエンドプロキシサーバーの背後での使用
70.8 Tomcatの設定
70.9 Tomcatで複数のコネクタを有効にする
70.10 TomcatのLegacyCookieProcessorを使用する (Cookie “Version 0″を有効にする)
70.11 Tomcatの代わりにJettyを使用する
70.12 Jettyを設定する
70.13 Tomcatの代わりにUndertowを使用する
70.14 Undertowの設定
70.15 Undertowで複数のリスナーを有効にする
70.16 Tomcat 7.xまたは8.0を使用する (デフォルトではTomcat 8.5)
70.17 Jetty 9.2 を使用する (デフォルトではJetty 9.3)
70.18 Jetty 8 を使用する (デフォルトではJetty 9.3)
70.19 @ServerEndpointを使用してWebSocketエンドポイントを作成する
70.20 HTTP応答圧縮を有効にする
Spring MVC
71.1 JSON RESTサービスを作成する
71.2 XML RESTサービスの作成 (JSONレスポンスではなくXMLレスポンスにする)
71.3 Jackson(JavaオブジェクトとJSONの相互変換ライブラリ) ObjectMapperをカスタマイズする
71.4 @ResponseBodyレンダリングをカスタマイズする
71.5マルチファイルアップロードの処理 (デフォルトは1ファイル最大10Mb)
71.6 Spring MVC Dispatcher Servlet? …
71.7デフォルトのMVC設定をオフにする
71.8 ViewResolversをカスタマイズする
71.9 Velocity(テンプレートエンジン)
71.10 Thymeleaf 3 テンプレートエンジンを使用する (デフォルトのstarterは2.1を使う)
HTTPクライアント
72.1プロキシを使用するRestTemplateを構成するようカスタマイズする
73.1ログ用のlogbackの設定
73.1ログ用のLog4jの設定
データアクセス
74.1データソース (DB) の設定 (環境プロパティー(application.properties)にバインドしてDeta …
74.2 2つのデータソースの設定
74.3 Spring Data Repository(Entityを継承・実装するときに使う)の使用
74.4 @Entity定義とSpring設定(@EntityScanアノテーションでの詳細設定)
74.5 JPAプロパティの設定
74.6EntityManagerFactoryをカスタムする
74.7 2つのEntityManagerの使用
74.8従来のpersistence.xml(Java EEのDB情報保管場所)を使用する
74.9 SpringデータJPAとMongoリポジトリの使用 (両方ともクラスパス上に存在する場合)
74.10 SpringデータリポジトリをRESTエンドポイントとして公開する
74.11 JPAで使用されるコンポーネントを構成する (JPAより前にコンポーネントが初期化されること)
データベースの初期化
75.1 JPAを使用したデータベースの初期化
75.2 Hibernateを使ってデータベースを初期化する
75.3 Spring JDBCを使用したデータベースの初期化
75.4 Spring Batch(springが提供するバッチ処理の仕組み)データベースの初期化
75.5上位レベルのデータベース移行ツールを使用する(FlywayとLiquibase)
Batch Application・バッチアプリケーション
76.1起動時にSpringバッチジョブを実行する (バッチ処理用に定義されたフレームワーク)
アクチュエータ・Actuator
77.1アクチュエータエンドポイントのHTTPポートまたはアドレスを変更する
77.2 ‘whitelabel’のエラーページをカスタマイズする
77.3 ActuatorとJerseyを同時に使うとき
セキュリティ
78.1 Springブートのセキュリティ設定を無効にする
78.2 AuthenticationManagerを変更してユーザーアカウントを追加する
78.3プロキシサーバーの背後で実行しているときにHTTPSを有効にする
ホットスワップ
79.1リロード静的コンテンツ
79.2コンテナを再起動せずにテンプレートをリロードする
79.3高速アプリケーションの再起動
79.4コンテナを再起動せずにJavaクラスを再ロードする
ビルド
80.1ビルド情報を生成する
80.2 git情報を生成する
80.3依存バージョンのカスタマイズ
80.4 Mavenを使って実行可能なJARを作成する
80.5依存関係としてSpringブートアプリケーションを使用する
80.6実行可能なjarが実行されるときに特定のライブラリを抽出する
80.7除外を含む実行不可能なJARの作成
80.8 Mavenで起動したSpringブートアプリケーションのリモートデバッグ
80.9 Gradleで起動したSpringブートアプリケーションのリモートデバッグ
80.10 spring-boot-antlibを使わずにAntから実行可能なアーカイブをビルドする
80.11 Java 6の使い方
従来の展開
81.1デプロイ可能なwarファイルの作成
81.2古いサーブレット・コンテナ用のデプロイ可能なwarファイルの作成
81.3既存のアプリケーションをSpringブートに変換する
81.4 WebLogicへのWARのデプロイ
81.5古い(サーブレット2.5)コンテナへのWARのデプロイ
パートX.付録
A.プロパティ一覧。一般的なアプリケーションのプロパティ
B.構成メタデータ
B.1メタデータフォーマット
B.2マニュアルヒントの提供
C.自動構成クラス
C.1. “spring-boot-autoconfigure”モジュールから
C.2. 「スプリング・ブート・アクチュエータ」モジュール
D.自動構成注釈のテスト
E.実行可能なjar形式
F. 依存のバージョン