対象ファイル
src/main/resources/application.properties
はじめに
今回は boot_two_sale プロジェクトの設定ファイルである application.properties を分析した。
Spring Boot アプリケーションの実行環境、ポート番号、JSP ビューのプレフィックス/サフィックス、Oracle データベース接続情報、および MyBatis の詳細動作環境を設定するためのプロパティファイルの構成について整理してみた。
概要 / 基本情報 / 詳細な解説テーブル
application.properties は、Spring Boot アプリケーションの実行環境、ポート番号、JSP ビューのプレフィックス/サフィックス、Oracle データベース接続情報、および MyBatis の詳細動作環境を設定するためのプロパティファイルである。
-
ファイルパス:
src/main/resources/application.properties - 対象環境: Spring Boot 4.0.2 / Oracle Database (xe) / MyBatis
- 主要プロパティ項目: アプリケーション名, サーバーポート, MVC View Resolver, DataSource (Oracle), MyBatis Mapper & Configuration
設定項目の詳細構造
-
Application & Server: アプリケーション識別名 (
boot_two_sale) と内蔵 Tomcat の稼働ポート (9994) を指定。 -
View Resolver: コントローラから返却される論理ビュー名を物理的な JSP パス (
/WEB-INF/views/*.jsp) に変換するプレフィックス・サフィックスを設定。 -
Database Connection (Oracle): Oracle JDBC ドライバクラス名、接続 URL (
1.245.91.227:1521/xe)、認証情報 (track24/1234) を定義。 -
MyBatis Configuration: Mapper XML の物理パス指定、キャッシュ無効化、およびクエリ結果が
nullの場合に発生するエラーを防ぐためのjdbc-type-for-nullを設定。
気になった部分・改善ポイント (Refactoring Notes)
- 環境設定の外部化管理: データベースの接続情報やポート番号が一箇所に集約されており、環境変更時のメンテナンス性が優れている。
- セキュリティ・機密情報の分離考慮: ソースコード内に直接記載されているデータベースのパスワードなどの機密情報は、将来的に環境変数や外部設定ファイルを用いた暗号化・分離管理の検討が推奨される。
構成要素のまとめ
| プロパティキー | 設定値 / 例 | 役割・説明 |
|---|---|---|
spring.application.name |
boot_two_sale |
アプリケーションの識別名を定義 |
server.port |
9994 |
Web サーバー（内蔵 Tomcat）の起動ポート番号を指定 |
spring.mvc.view.prefix / suffix
|
/WEB-INF/views/ / .jsp
|
コントローラが返却する論理ビュー名を物理的 JSP パスに解決 |
spring.datasource.url |
jdbc:oracle:thin:@...:1521/xe |
Oracle データベースへの Thin ドライバ接続用 URL |
mybatis.mapper-locations |
classpath:mybatis/mapper/**/**.xml |
MyBatis の SQL マッピング XML ファイルの配置場所を指定 |
mybatis.configuration.jdbc-type-for-null |
NULL |
検索結果が null の場合に備え、JDBC の型マッピングエラーを防止 |
今回学んだこと
今回 application.properties の設定内容を整理したことで、レガシーな Servlet/JSP 環境から Spring Boot へ移行する際のインフラ・フレームワーク間つなぎ込みの要点を深く理解することができた。特に MyBatis と Oracle 連携時における null 値のハンドリング（jdbc-type-for-null）や、MVC のビュー解決機構の仕組みは、今後のアプリ開発やトラブルシューティングにおいて大いに役立つ。次回は、これらを活用するコントローラ層やサービス層の実装について詳しく確認していく予定だ。