ブランクプロジェクト ******************************************************************************** .. only:: html .. contents:: 目次 :depth: 3 :local: 本節では、Webアプリケーション向けの開発プロジェクトを作成する方法について説明する。 本ガイドラインでは、マルチプロジェクト構成を採用することを推奨している。推奨するマルチプロジェクト構成の説明については、「\ :ref:`application-layering_project-structure`\ 」を参照されたい。 | .. _BlankProjectWhatIsBlankProject: ブランクプロジェクトとは ================================================================================ 「ブランクプロジェクト」とは、Webアプリケーション開発のための雛形プロジェクトである。 本ガイドラインでは、開発を効率化し、推奨される構成や設定をあらかじめ盛り込んだプロジェクトを「ブランクプロジェクト」として提供している。 主な特徴： * 商用環境向けの本格的なアプリケーションや、PoC・プロトタイプ・サンプルなど簡易的なアプリケーションの作成に利用可能 * Maven Archetypeとして、MyBatis3用・O/R Mapper非依存など複数の雛形が用意されている * 推奨するマルチプロジェクト構成やシングルプロジェクト構成が選択可能 * すぐに開発を始められるように、必要な設定や構成が整ったプロジェクトの雛形 .. _BlankProjectBlankProjectTypes: ブランクプロジェクトの種類 ================================================================================ ブランクプロジェクトは、使用用途に応じて以下の２種類を提供している。 .. tabularcolumns:: |p{0.20\linewidth}|p{0.80\linewidth}| .. list-table:: :header-rows: 1 :widths: 20 70 * - 種別 - 使用用途 * - | \ :ref:`マルチプロジェクト構成のブランクプロジェクト `\ - 商用環境にリリースするような本格的なアプリケーションを開発する際に使用する。 プロジェクトの雛形は、MavenのArchetypeとして以下を用意している。 * MyBatis3用の設定が盛り込まれた雛形 \ **本ガイドラインでは、マルチプロジェクト構成のプロジェクトを使用する事を推奨している。**\ * - | \ :ref:`シングルプロジェクト構成のブランクプロジェクト `\ - PoC(Proof of Concept)、プロトタイプ、サンプルなどの簡易的なアプリケーションを作成する際に使用する。 プロジェクトの雛形は、MavenのArchetypeとして以下を用意している。 * \ :ref:`MyBatis3用の設定が盛り込まれた雛形 `\ * \ :ref:`O/R Mapperに依存しない雛形 `\ .. note:: \ **本ガイドラインにおける「マルチプロジェクト」の用語定義について**\ Maven Archetypeで作成したプロジェクトは、正確にはマルチモジュール構成のプロジェクトとなる。 本ガイドラインでは、マルチモジュール構成のプロジェクトをマルチプロジェクトと呼んでいる。 | .. _BlankProjectCreateBlankProject: ブランクプロジェクトの作成 ================================================================================ 開発プロジェクトを、 \ :url_maven:`Maven Archetype Plugin `\ の\ :url_maven:`archetype:generate `\ を使用して作成する。 \ **前提条件**\ 以降の説明では、 * \ :url_maven:`Maven `\ (\ ``mvn``\ コマンド)が使用可能であること * インターネットに繋がっていること * インターネットにプロキシ経由で繋ぐ場合は、\ :url_maven:`Mavenのプロキシ設定 `\ が行われていること を前提としている。 前提条件が整っていない場合は、まずこれらのセットアップを行ってほしい。 オフライン環境での作業については、「\ :doc:`../Appendix/AppDevInOfflineEnv`\ 」を参照されたい。 | .. _BlankProjectSelectingArchetype: Archetypeの選択 -------------------------------------------------------------------------------- ブランクプロジェクトを作成するためのArchetypeとして、以下を用意している。 .. tabs:: .. group-tab:: Java Config .. tabs:: .. group-tab:: JSP .. tabularcolumns:: |p{0.05\linewidth}|p{0.30\linewidth}|p{0.65\linewidth}| .. list-table:: :header-rows: 1 :widths: 5 30 65 * - 項番 - Archetype(ArtifactId) - 説明 * - 1. - macchinetta-web-blank-jsp-archetype - O/R Mapperに依存しないシングルプロジェクトを生成するためのArchetype。 * - 2. - macchinetta-web-blank-jsp-mybatis3-archetype - O/R MapperとしてMyBatis3を使用するためのシングルプロジェクトを生成するためのArchetype。 * - 3. - macchinetta-multi-web-blank-jsp-mybatis3-archetype - O/R MapperとしてMyBatis3を使用するためのマルチプロジェクトを生成するためのArchetype。 .. group-tab:: Thymeleaf .. tabularcolumns:: |p{0.05\linewidth}|p{0.30\linewidth}|p{0.65\linewidth}| .. list-table:: :header-rows: 1 :widths: 5 30 65 * - 項番 - Archetype(ArtifactId) - 説明 * - 1. - macchinetta-web-blank-thymeleaf-archetype - O/R Mapperに依存しないシングルプロジェクトを生成するためのArchetype。 * - 2. - macchinetta-web-blank-thymeleaf-mybatis3-archetype - O/R MapperとしてMyBatis3を使用するためのシングルプロジェクトを生成するためのArchetype。 * - 3. - macchinetta-multi-web-blank-thymeleaf-mybatis3-archetype - O/R MapperとしてMyBatis3を使用するためのマルチプロジェクトを生成するためのArchetype。 .. group-tab:: XML Config .. tabs:: .. group-tab:: JSP .. tabularcolumns:: |p{0.05\linewidth}|p{0.30\linewidth}|p{0.65\linewidth}| .. list-table:: :header-rows: 1 :widths: 5 30 65 * - 項番 - Archetype(ArtifactId) - 説明 * - 1. - macchinetta-web-blank-xmlconfig-jsp-archetype - O/R Mapperに依存しないシングルプロジェクトを生成するためのArchetype。 * - 2. - macchinetta-web-blank-xmlconfig-jsp-mybatis3-archetype - O/R MapperとしてMyBatis3を使用するためのシングルプロジェクトを生成するためのArchetype。 * - 3. - macchinetta-multi-web-blank-xmlconfig-jsp-mybatis3-archetype - O/R MapperとしてMyBatis3を使用するためのマルチプロジェクトを生成するためのArchetype。 .. group-tab:: Thymeleaf .. tabularcolumns:: |p{0.05\linewidth}|p{0.30\linewidth}|p{0.65\linewidth}| .. list-table:: :header-rows: 1 :widths: 5 30 65 * - 項番 - Archetype(ArtifactId) - 説明 * - 1. - macchinetta-web-blank-xmlconfig-thymeleaf-archetype - O/R Mapperに依存しないシングルプロジェクトを生成するためのArchetype。 * - 2. - macchinetta-web-blank-xmlconfig-thymeleaf-mybatis3-archetype - O/R MapperとしてMyBatis3を使用するためのシングルプロジェクトを生成するためのArchetype。 * - 3. - macchinetta-multi-web-blank-xmlconfig-thymeleaf-mybatis3-archetype - O/R MapperとしてMyBatis3を使用するためのマルチプロジェクトを生成するためのArchetype。 この中から適切なArchetype(ArtifactId)を選択する。 | プロジェクトの作成 -------------------------------------------------------------------------------- プロジェクトを作成するフォルダに移動する。 .. code-block:: console cd C:\work | \ :url_maven:`Maven Archetype Plugin `\ の\ :url_maven:`archetype:generate `\ を使用して、プロジェクトを作成する。 .. code-block:: console mvn archetype:generate -B^ -DarchetypeGroupId=com.github.macchinetta.blank^ -DarchetypeArtifactId=macchinetta-multi-web-blank-jsp-mybatis3-archetype^ -DarchetypeVersion=1.11.1.RELEASE^ -DgroupId=com.example.todo^ -DartifactId=todo^ -Dversion=1.0.0-SNAPSHOT .. tabularcolumns:: |p{0.25\linewidth}|p{0.60\linewidth}|p{0.15\linewidth}| .. list-table:: :header-rows: 1 :widths: 25 60 15 * - パラメータ - 説明 - カスタマイズ要否 * - | \-B - batch mode (対話を省略) - 否 * - | \-DarchetypeGroupId - ブランクプロジェクトのgroupIdを指定する。 - 否 * - | \-DarchetypeArtifactId - ブランクプロジェクトのarchetypeId(雛形を特定するためのID)を指定する。 \ :ref:`BlankProjectSelectingArchetype`\ で選択したArchetype(ArtifactId)を指定する。 上記例では、\ ``macchinetta-multi-web-blank-jsp-mybatis3-archetype``\ を指定している。 - \ **要**\ * - | \-DarchetypeVersion - ブランクプロジェクトのバージョンを指定する。 - 否 * - | \-DgroupId - 作成するプロジェクトのgroupIdを指定する。 上記例では、\ ``com.example.todo``\ を指定している。 - \ **要**\ * - | \-DartifactId - 作成するプロジェクトのartifactIdを指定する。 上記例では、\ ``todo``\ を指定している。 - \ **要**\ * - | \-Dversion - 作成するプロジェクトのバージョンを指定する。 上記例では、\ ``1.0.0-SNAPSHOT``\ を指定している。 - \ **要**\ | .. tip:: Bash上で\ ``mvn archetype:generate``\ を実行する場合は、以下のように"\ ``^``\ "を"\ ``\``\ "に置き換えて実行すればよい。 .. code-block:: bash mvn archetype:generate -B\ -DarchetypeGroupId=com.github.macchinetta.blank\ -DarchetypeArtifactId=macchinetta-web-blank-jsp-archetype\ -DarchetypeVersion=1.11.1.RELEASE\ -DgroupId=com.example.todo\ -DartifactId=todo\ -Dversion=1.0.0-SNAPSHOT | プロジェクトの作成が成功した場合、以下のようなログが出力される。 | (以下は、MyBatis3用(JavaConfig, JSP)のArchetypeを使用して作成した場合の出力例) .. code-block:: console C:\work>mvn archetype:generate -B^ More? -DarchetypeGroupId=com.github.macchinetta.blank^ More? -DarchetypeArtifactId=macchinetta-multi-web-blank-jsp-mybatis3-archetype^ More? -DarchetypeVersion=1.11.1.RELEASE^ More? -DgroupId=com.example.todo^ More? -DartifactId=todo^ More? -Dversion=1.0.0-SNAPSHOT [INFO] Scanning for projects... [INFO] [INFO] ------------------< org.apache.maven:standalone-pom >------------------- [INFO] Building Maven Stub Project (No POM) 1 [INFO] --------------------------------[ pom ]--------------------------------- [INFO] [INFO] >>> archetype:3.3.1:generate (default-cli) > generate-sources @ standalone-pom >>> [INFO] [INFO] <<< archetype:3.3.1:generate (default-cli) < generate-sources @ standalone-pom <<< [INFO] [INFO] [INFO] --- archetype:3.3.1:generate (default-cli) @ standalone-pom --- [INFO] Generating project in Batch mode [INFO] Archetype repository not defined. Using the one from [com.github.macchinetta.blank:macchinetta-multi-web-blank-jsp-mybatis3-archetype:1.11.1.RELEASE] found in catalog local [INFO] ---------------------------------------------------------------------------- [INFO] Using following parameters for creating project from Archetype: macchinetta-multi-web-blank-jsp-mybatis3-archetype:1.11.1.RELEASE [INFO] ---------------------------------------------------------------------------- [INFO] Parameter: groupId, Value: com.example.todo [INFO] Parameter: artifactId, Value: todo [INFO] Parameter: version, Value: 1.0.0-SNAPSHOT [INFO] Parameter: package, Value: com.example.todo [INFO] Parameter: packageInPathFormat, Value: com/example/todo [INFO] Parameter: package, Value: com.example.todo [INFO] Parameter: ProjectName, Value: todo [INFO] Parameter: groupId, Value: com.example.todo [INFO] Parameter: artifactId, Value: todo [INFO] Parameter: version, Value: 1.0.0-SNAPSHOT [INFO] Project created from Archetype in dir: C:\work\todo [INFO] ------------------------------------------------------------------------ [INFO] BUILD SUCCESS [INFO] ------------------------------------------------------------------------ [INFO] Total time: 1.174 s [INFO] Finished at: 2025-02-10T16:40:44+09:00 [INFO] ------------------------------------------------------------------------ | プロジェクトの作成が成功した場合、Mavenのプロジェクトが作成される。 .. tabs:: .. group-tab:: シングルプロジェクト .. code-block:: text todo ├ pom.xml └ src .. group-tab:: マルチプロジェクト .. code-block:: text todo ├ pom.xml ├ todo-domain ├ todo-env ├ todo-initdb ├ todo-selenium └ todo-web | Maven Archetypeで作成したプロジェクトの詳細な説明については、「\ :ref:`BlankProjectProjectConfiguration`\ 」を参照されたい。 .. caution:: O/R Mapperを使用するブランクプロジェクトの場合、H2 Databaseがdependencyとして定義されているが、この設定は簡易的なアプリケーションを簡単に作成するためのものであり、実際のアプリケーション開発で使用されることは想定していない。 以下の定義は、実際のアプリケーション開発を行う際は削除すること。 .. code-block:: xml com.h2database h2 runtime 詳細は、「\ :ref:`BlankProjectDataSourceSetting`\ 」を参照されたい。 | .. _BlankProjectBlankProjectIntoSts: ブランクプロジェクトのSTSへのインポート ================================================================================ STSのインストールと設定が未実施の場合は、「\ :doc:`../Appendix/SpringToolSuite`\ 」を参照してインストールと設定を行う。 作成したブランクプロジェクトをSTSへインポートする。 STSのメニューから、[File] -> [Import] -> [Maven] -> [Existing Maven Projects] -> [Next]を選択し、archetypeで作成したプロジェクトを選択する。 .. figure:: ./images_BlankProject/capture_NewMVCProjectImport.png :alt: New MVC Project Import :width: 60% | Root Directoryに\ ``C:\work\todo``\ を設定し、Projectsにtodoのpom.xmlが選択された状態で、[Finish]を押下する。 .. figure:: ./images_BlankProject/capture_NewMVCProjectCreate.png :alt: New MVC Project Import :width: 60% | インポートが完了すると、Package Explorerに次のようなプロジェクトが表示される。 .. tabs:: .. group-tab:: Java Config .. tabs:: .. group-tab:: JSP .. figure:: images_BlankProject/capture_image004_JavaConfig_JSP.png :alt: workspace :width: 40% .. group-tab:: Thymeleaf .. figure:: images_BlankProject/capture_image004_JavaConfig_Thymeleaf.png :alt: workspace :width: 40% .. group-tab:: XML Config .. tabs:: .. group-tab:: JSP .. figure:: images_BlankProject/capture_image004_XMLConfig_JSP.png :alt: workspace :width: 40% .. group-tab:: Thymeleaf .. figure:: images_BlankProject/capture_image004_XMLConfig_Thymeleaf.png :alt: workspace :width: 40% プロジェクトのJavaバージョンを変更したい場合は\ :ref:`SpringToolSuiteJavaVersion`\ を参照されたい。 | .. note:: インポート後にビルドエラーが発生する場合は、プロジェクト名を右クリックし、「Maven」->「Update Project...」をクリックし、「OK」ボタンをクリックすることでエラーが解消されるケースがある。 .. figure:: ./images_BlankProject/capture_update-project.png :width: 70% | ブランクプロジェクトの実装内容に関しては、後述の「\ :ref:`BlankProjectCheckConfigurationFile`\ 」を参照されたい。 | .. _BlankProjectVerifyOperationOfBlankProject: ブランクプロジェクトの動作確認 ================================================================================ ブランクプロジェクトを右クリックして「Run As」->「Run on Server」を選択する。 .. figure:: ./images_BlankProject/capture_image031.png :width: 70% | APサーバー(Tomcat v\ |tomcat_major_version|\.\ |tomcat_minor_version|\ Server at localhost)を選択し、「Next」をクリックする。 .. figure:: ./images_BlankProject/capture_image032.png :width: 70% | todoが「Configured」に含まれていることを確認して「Finish」をクリックしてサーバーを起動する。 .. figure:: ./images_BlankProject/capture_image033.png :width: 70% | 起動すると以下のようなログが出力される。 "\ ``/``\ "というパスに対して\ ``com.example.todo.app.welcome.HelloController``\ のhomeメソッドがマッピングされていることが分かる。 .. code-block:: text date:2022-11-25 17:22:36 thread:main X-Track: level:INFO logger:o.springframework.web.servlet.DispatcherServlet message:Initializing Servlet 'appServlet' date:2022-11-25 17:22:37 thread:main X-Track: level:TRACE logger:o.s.w.s.m.m.a.RequestMappingHandlerMapping message: c.e.t.a.w.HelloController: {GET [/]}: home(Locale,Model) date:2022-11-25 17:22:37 thread:main X-Track: level:DEBUG logger:o.s.w.s.m.m.a.RequestMappingHandlerMapping message:1 mappings in 'requestMappingHandlerMapping' date:2022-11-25 17:22:37 thread:main X-Track: level:INFO logger:o.springframework.web.servlet.DispatcherServlet message:Completed initialization in 753 ms | ブラウザで\ :url_localhost:`/todo`\ にアクセスすると、以下のように表示される。 .. figure:: ./images_BlankProject/capture_image034.png :width: 60% コンソールを見ると、 * 共通ライブラリから提供している\ ``TraceLoggingInterceptor``\ のTRACEログ * Controllerで実装されているINFOログ が出力されていることがわかる。 .. code-block:: text date:2025-01-28 14:00:49 thread:http-nio-8080-exec-2 X-Track:aae50332dd844ee28c44067d96e1f09f level:TRACE logger:o.t.gfw.web.logging.TraceLoggingInterceptor message:[START CONTROLLER] HelloController.home(Locale,Model) date:2025-01-28 14:00:49 thread:http-nio-8080-exec-2 X-Track:aae50332dd844ee28c44067d96e1f09f level:INFO logger:com.example.todo.app.welcome.HelloController message:Welcome home! The client locale is ja. date:2025-01-28 14:00:49 thread:http-nio-8080-exec-2 X-Track:aae50332dd844ee28c44067d96e1f09f level:TRACE logger:o.t.gfw.web.logging.TraceLoggingInterceptor message:[END CONTROLLER ] HelloController.home(Locale,Model)-> view=welcome/home, model={serverTime=2025年1月28日 14:00:49 JST} date:2025-01-28 14:00:49 thread:http-nio-8080-exec-2 X-Track:aae50332dd844ee28c44067d96e1f09f level:TRACE logger:o.t.gfw.web.logging.TraceLoggingInterceptor message:[HANDLING TIME ] HelloController.home(Locale,Model)-> 87,161,900 ns \ ``TraceLoggingInterceptor``\ については「\ :ref:`LoggingTraceLoggingInterceptor`\ 」を参照されたい。 | .. _BlankProjectProjectConfiguration: ブランクプロジェクトの構成 ================================================================================ ブランクプロジェクトはガイドラインで推奨している以下の構成となっている。 * レイヤ毎のプロジェクト構成 * 環境依存性の排除を考慮したプロジェクト構成 * CI(Continuous Integration)を意識したプロジェクト構成 ブランクプロジェクトの設定ファイルにはガイドラインで推奨している基本的な設定が含まれている。 ブランクプロジェクトにはコンポーネントの簡易実装が含まれているので、以下のいずれかの対応を行うこと。 * アプリケーション要件にあわせて修正 * 不要なコンポーネントは削除 .. note:: \ **REST API用のプロジェクトを作成する場合の手順について**\ 「 \ :ref:`BlankProjectCreateBlankProject`\ 」で作成したプロジェクトは、伝統的なWebアプリケーション(リクエストパラメータを受け取ってHTMLを応答するアプリケーション)を構築する際に必要となる推奨設定となっている。 そのため、JSONやXMLを扱うREST APIを構築する際には不要な設定が存在する。 REST APIを構築するためのプロジェクトを作成する場合は、「\ :doc:`../ArchitectureInDetail/WebServiceDetail/REST`\ の \ :ref:`RESTHowToUseApplicationSettings`\ 」を参照し、REST API向けの設定を適用すること。 | .. note:: 以降の説明で\ ``[artifactId]``\ と表現している部分は、プロジェクト作成時に指定した\ ``artifactId``\ に置き換えて読み進めてほしい。 | .. _BlankProjectSingleProjectStructure: シングルプロジェクトの構成 -------------------------------------------------------------------------------- シングルプロジェクトには以下の種類のプロジェクトがある。 - \ :ref:`BlankProjectProjectNotRelyingOnOrMapper`\ - \ :ref:`BlankProjectForMyBatis3Project`\ 自分が使用する種類のプロジェクトの節を参照されたい。 .. _BlankProjectProjectNotRelyingOnOrMapper: O/R Mapperに依存しないプロジェクトの場合 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. tabs:: .. group-tab:: Java Config .. tabs:: .. group-tab:: JSP .. code-block:: text [artifactId] ├ pom.xml ... (1) └ src ├ main │ ├ java │ │ └ com │ │ └ example │ │ └ project │ │ ├ app ... (2) │ │ │ └ welcome │ │ │ └ HelloController.java ... (3) │ │ ├ domain ... (4) │ │ │ ├ model ... (5) │ │ │ ├ repository ... (6) │ │ │ └ service ... (7) │ │ └ config ... (8) │ │ ├ app │ │ │ ├ ApplicationContextConfig.java ... (9) │ │ │ ├ [artifactId]CodeListConfig.java ... (10) │ │ │ ├ [artifactId]DomainConfig.java ... (11) │ │ │ └ [artifactId]InfraConfig.java ... (12) │ │ └ web │ │ ├ SpringMvcConfig.java ... (13) │ │ └ SpringSecurityConfig.java ... (14) │ ├ resources │ │ ├ i18n ... (15) │ │ │ └ application-messages.properties ... (16) │ │ ├ logback.xml ... (17) │ │ └ ValidationMessages.properties ... (18) .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 * - 項番 - 説明 * - | (1) - シングルプロジェクト全体の構成を定義するPOM(Project Object Model)ファイル。 このファイルでは、主に以下の定義を行う。 * 依存ライブラリのバージョン * ビルド用のプラグインの設定(ビルド方法の設定) * - | (2) - アプリケーション層のクラスを格納するパッケージ。 * - | (3) - Welcomeページを表示するためのリクエストを受け取るためのControllerクラス。 * - | (4) - ドメイン層のクラスを格納するパッケージ。 * - | (5) - Domain Objectを格納するパッケージ。 * - | (6) - Repositoryを格納するパッケージ。 Domain Object用のRepositoryを格納するためのパッケージを作成する * - | (7) - Serviceを格納するパッケージ。 * - | (8) - Spring関連の設定ファイルを格納するディレクトリ。 * - | (9) - Webアプリケーション用のアプリケーションコンテキストを作成するためのBean定義ファイル。 このファイルには、以下のBeanを定義する。 * Webアプリケーション全体で使用するコンポーネント * ドメイン層のコンポーネント(ドメイン層のコンポーネントが定義されているBean定義ファイルをimportする) * - | (10) - コードリストを定義するためのBean定義ファイル。 * - | (11) - ドメイン層のコンポーネントを定義するためのBean定義ファイル。 このファイルには、以下のBeanを定義する。 * ドメイン層のコンポーネント(Service, Repositoryなど) * インフラストラクチャ層のコンポーネント(インフラストラクチャ層のコンポーネントが定義されているBean定義ファイルをimportする) * Spring Frameworkから提供されているトランザクション管理用のコンポーネント * - | (12) - インフラストラクチャ層のコンポーネントを定義するためのBean定義ファイル。 このファイルには、O/R MapperなどのBean定義を行う。 * - | (13) - \ ``DispatcherServlet``\ 用のアプリケーションコンテキストを作成するためのBean定義ファイル。 このファイルには、以下のBeanを定義する。 * Spring MVCのコンポーネント * アプリケーション層のコンポーネント REST APIを構築する場合は、ファイル名を\ ``SpringMvcApiConfig.java``\ といった感じの名前にしておくと、 アプリケーションの種類が識別しやすくなる。 * - | (14) - Spring Securityのコンポーネントを定義するためのBean定義ファイル。 このファイルは、Webアプリケーション用のアプリケーションコンテキストを作成する際に読み込む。 * - | (15) - アプリケーション層で使用するメッセージ定義ファイルを格納するディレクトリ。 * - | (16) - | アプリケーション層で使用するメッセージを定義するプロパティファイル。 | 作成時点では、いくつかの汎用的なメッセージが定義されている。 | \ **アプリケーションの要件(メッセージ規約など)にあわせて必ず修正すること。**\ | メッセージ定義については、「\ :doc:`../ArchitectureInDetail/WebApplicationDetail/MessageManagement`\ 」を参照されたい。 * - | (17) - Logback(ログ出力)の設定ファイル。 ログ出力については、「\ :doc:`../ArchitectureInDetail/GeneralFuncDetail/Logging`\ 」を参照されたい。 * - | (18) - システムが利用するデフォルトのメッセージを定義するプロパティファイル。 このファイルについては、「\ :ref:`ValidationMessageDef`\ 」を参照されたい。 .. group-tab:: Thymeleaf .. code-block:: text [artifactId] ├ pom.xml ... (1) └ src ├ main │ ├ java │ │ └ com │ │ └ example │ │ └ project │ │ ├ app ... (2) │ │ │ ├ welcome │ │ │ │ └ HelloController.java ... (3) │ │ │ └ common │ │ │ └ error │ │ │ └ CommonErrorController.java ... (4) │ │ ├ domain ... (5) │ │ │ ├ model ... (6) │ │ │ ├ repository ... (7) │ │ │ └ service ... (8) │ │ └ config ... (9) │ │ ├ app │ │ │ ├ ApplicationContextConfig.java ... (10) │ │ │ ├ [artifactId]CodeListConfig.java ... (11) │ │ │ ├ [artifactId]DomainConfig.java ... (12) │ │ │ └ [artifactId]InfraConfig.java ... (13) │ │ └ web │ │ ├ SpringMvcConfig.java ... (14) │ │ └ SpringSecurityConfig.java ... (15) │ ├ resources │ │ ├ i18n ... (16) │ │ │ └ application-messages.properties ... (17) │ │ ├ logback.xml ... (18) │ │ └ ValidationMessages.properties ... (19) .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 * - 項番 - 説明 * - | (1) - シングルプロジェクト全体の構成を定義するPOM(Project Object Model)ファイル。 このファイルでは、主に以下の定義を行う。 * 依存ライブラリのバージョン * ビルド用のプラグインの設定(ビルド方法の設定) * - | (2) - アプリケーション層のクラスを格納するパッケージ。 * - | (3) - Welcomeページを表示するためのリクエストを受け取るためのControllerクラス。 * - | (4) - | エラー画面を表示するためのControllerクラス。 * - | (5) - ドメイン層のクラスを格納するパッケージ。 * - | (6) - Domain Objectを格納するパッケージ。 * - | (7) - Repositoryを格納するパッケージ。 Domain Object用のRepositoryを格納するためのパッケージを作成する * - | (8) - Serviceを格納するパッケージ。 * - | (9) - Spring関連の設定ファイルを格納するディレクトリ。 * - | (10) - Webアプリケーション用のアプリケーションコンテキストを作成するためのBean定義ファイル。 このファイルには、以下のBeanを定義する。 * Webアプリケーション全体で使用するコンポーネント * ドメイン層のコンポーネント(ドメイン層のコンポーネントが定義されているBean定義ファイルをimportする) * - | (11) - コードリストを定義するためのBean定義ファイル。 * - | (12) - ドメイン層のコンポーネントを定義するためのBean定義ファイル。 このファイルには、以下のBeanを定義する。 * ドメイン層のコンポーネント(Service, Repositoryなど) * インフラストラクチャ層のコンポーネント(インフラストラクチャ層のコンポーネントが定義されているBean定義ファイルをimportする) * Spring Frameworkから提供されているトランザクション管理用のコンポーネント * - | (13) - インフラストラクチャ層のコンポーネントを定義するためのBean定義ファイル。 このファイルには、O/R MapperなどのBean定義を行う。 * - | (14) - \ ``DispatcherServlet``\ 用のアプリケーションコンテキストを作成するためのBean定義ファイル。 このファイルには、以下のBeanを定義する。 * Spring MVCのコンポーネント * アプリケーション層のコンポーネント REST APIを構築する場合は、ファイル名を\ ``SpringMvcApiConfig.java``\ といった感じの名前にしておくと、 アプリケーションの種類が識別しやすくなる。 * - | (15) - Spring Securityのコンポーネントを定義するためのBean定義ファイル。 このファイルは、Webアプリケーション用のアプリケーションコンテキストを作成する際に読み込む。 * - | (16) - アプリケーション層で使用するメッセージ定義ファイルを格納するディレクトリ。 * - | (17) - | アプリケーション層で使用するメッセージを定義するプロパティファイル。 | 作成時点では、いくつかの汎用的なメッセージが定義されている。 | \ **アプリケーションの要件(メッセージ規約など)にあわせて必ず修正すること。**\ | メッセージ定義については、「\ :doc:`../ArchitectureInDetail/WebApplicationDetail/MessageManagement`\ 」を参照されたい。 * - | (18) - Logback(ログ出力)の設定ファイル。 ログ出力については、「\ :doc:`../ArchitectureInDetail/GeneralFuncDetail/Logging`\ 」を参照されたい。 * - | (19) - システムが利用するデフォルトのメッセージを定義するプロパティファイル。 このファイルについては、「\ :ref:`ValidationMessageDef`\ 」を参照されたい。 .. group-tab:: XML Config .. tabs:: .. group-tab:: JSP .. code-block:: text [artifactId] ├ pom.xml ... (1) └ src ├ main │ ├ java │ │ └ com │ │ └ example │ │ └ project │ │ ├ app ... (2) │ │ │ ├ welcome │ │ │ │ └ HelloController.java ... (3) │ │ └ domain ... (4) │ │ ├ model ... (5) │ │ ├ repository ... (6) │ │ └ service ... (7) │ ├ resources │ │ ├ i18n ... (8) │ │ │ └ application-messages.properties ... (9) │ │ ├ META-INF │ │ │ └ spring ... (10) │ │ │ ├ applicationContext.xml ... (11) │ │ │ ├ spring-mvc.xml ... (12) │ │ │ ├ spring-security.xml ... (13) │ │ │ ├ [artifactId]-codelist.xml ... (14) │ │ │ ├ [artifactId]-domain.xml ... (15) │ │ │ └ [artifactId]-infra.xml ... (16) │ │ ├ logback.xml ... (17) │ │ └ ValidationMessages.properties ... (18) .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 * - 項番 - 説明 * - | (1) - シングルプロジェクト全体の構成を定義するPOM(Project Object Model)ファイル。 このファイルでは、主に以下の定義を行う。 * 依存ライブラリのバージョン * ビルド用のプラグインの設定(ビルド方法の設定) * - | (2) - アプリケーション層のクラスを格納するパッケージ。 * - | (3) - Welcomeページを表示するためのリクエストを受け取るためのControllerクラス。 * - | (4) - ドメイン層のクラスを格納するパッケージ。 * - | (5) - Domain Objectを格納するパッケージ。 * - | (6) - Repositoryを格納するパッケージ。 Domain Object用のRepositoryを格納するためのパッケージを作成する * - | (7) - Serviceを格納するパッケージ。 * - | (8) - アプリケーション層で使用するメッセージ定義ファイルを格納するディレクトリ。 * - | (9) - | アプリケーション層で使用するメッセージを定義するプロパティファイル。 | 作成時点では、いくつかの汎用的なメッセージが定義されている。 | \ **アプリケーションの要件(メッセージ規約など)にあわせて必ず修正すること。**\ | メッセージ定義については、「\ :doc:`../ArchitectureInDetail/WebApplicationDetail/MessageManagement`\ 」を参照されたい。 * - | (10) - Spring関連の設定ファイルを格納するディレクトリ。 * - | (11) - Webアプリケーション用のアプリケーションコンテキストを作成するためのBean定義ファイル。 このファイルには、以下のBeanを定義する。 * Webアプリケーション全体で使用するコンポーネント * ドメイン層のコンポーネント(ドメイン層のコンポーネントが定義されているBean定義ファイルをimportする) * - | (12) - \ ``DispatcherServlet``\ 用のアプリケーションコンテキストを作成するためのBean定義ファイル。 このファイルには、以下のBeanを定義する。 * Spring MVCのコンポーネント * アプリケーション層のコンポーネント REST APIを構築する場合は、ファイル名を\ ``spring-mvc-api.xml``\ といった感じの名前にしておくと、 アプリケーションの種類が識別しやすくなる。 * - | (13) - Spring Securityのコンポーネントを定義するためのBean定義ファイル。 このファイルは、Webアプリケーション用のアプリケーションコンテキストを作成する際に読み込む。 * - | (14) - コードリストを定義するためのBean定義ファイル。 * - | (15) - ドメイン層のコンポーネントを定義するためのBean定義ファイル。 このファイルには、以下のBeanを定義する。 * ドメイン層のコンポーネント(Service, Repositoryなど) * インフラストラクチャ層のコンポーネント(インフラストラクチャ層のコンポーネントが定義されているBean定義ファイルをimportする) * Spring Frameworkから提供されているトランザクション管理用のコンポーネント * - | (16) - インフラストラクチャ層のコンポーネントを定義するためのBean定義ファイル。 このファイルには、O/R MapperなどのBean定義を行う。 * - | (17) - Logback(ログ出力)の設定ファイル。 ログ出力については、「\ :doc:`../ArchitectureInDetail/GeneralFuncDetail/Logging`\ 」を参照されたい。 * - | (18) - システムが利用するデフォルトのメッセージを定義するプロパティファイル。 このファイルについては、「\ :ref:`ValidationMessageDef`\ 」を参照されたい。 .. group-tab:: Thymeleaf .. code-block:: text [artifactId] ├ pom.xml ... (1) └ src ├ main │ ├ java │ │ └ com │ │ └ example │ │ └ project │ │ ├ app ... (2) │ │ │ ├ welcome │ │ │ │ └ HelloController.java ... (3) │ │ │ └ common │ │ │ └ error │ │ │ └ CommonErrorController.java ... (4) │ │ └ domain ... (5) │ │ ├ model ... (6) │ │ ├ repository ... (7) │ │ └ service ... (8) │ ├ resources │ │ ├ i18n ... (9) │ │ │ └ application-messages.properties ... (10) │ │ ├ META-INF │ │ │ └ spring ... (11) │ │ │ ├ applicationContext.xml ... (12) │ │ │ ├ spring-mvc.xml ... (13) │ │ │ ├ spring-security.xml ... (14) │ │ │ ├ [artifactId]-codelist.xml ... (15) │ │ │ ├ [artifactId]-domain.xml ... (16) │ │ │ └ [artifactId]-infra.xml ... (17) │ │ ├ logback.xml ... (18) │ │ └ ValidationMessages.properties ... (19) .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 * - 項番 - 説明 * - | (1) - シングルプロジェクト全体の構成を定義するPOM(Project Object Model)ファイル。 このファイルでは、主に以下の定義を行う。 * 依存ライブラリのバージョン * ビルド用のプラグインの設定(ビルド方法の設定) * - | (2) - アプリケーション層のクラスを格納するパッケージ。 * - | (3) - Welcomeページを表示するためのリクエストを受け取るためのControllerクラス。 * - | (4) - | エラー画面を表示するためのControllerクラス。 * - | (5) - ドメイン層のクラスを格納するパッケージ。 * - | (6) - Domain Objectを格納するパッケージ。 * - | (7) - Repositoryを格納するパッケージ。 Domain Object用のRepositoryを格納するためのパッケージを作成する * - | (8) - Serviceを格納するパッケージ。 * - | (9) - アプリケーション層で使用するメッセージ定義ファイルを格納するディレクトリ。 * - | (10) - | アプリケーション層で使用するメッセージを定義するプロパティファイル。 | 作成時点では、いくつかの汎用的なメッセージが定義されている。 | \ **アプリケーションの要件(メッセージ規約など)にあわせて必ず修正すること。**\ | メッセージ定義については、「\ :doc:`../ArchitectureInDetail/WebApplicationDetail/MessageManagement`\ 」を参照されたい。 * - | (11) - Spring関連の設定ファイルを格納するディレクトリ。 * - | (12) - Webアプリケーション用のアプリケーションコンテキストを作成するためのBean定義ファイル。 このファイルには、以下のBeanを定義する。 * Webアプリケーション全体で使用するコンポーネント * ドメイン層のコンポーネント(ドメイン層のコンポーネントが定義されているBean定義ファイルをimportする) * - | (13) - \ ``DispatcherServlet``\ 用のアプリケーションコンテキストを作成するためのBean定義ファイル。 このファイルには、以下のBeanを定義する。 * Spring MVCのコンポーネント * アプリケーション層のコンポーネント REST APIを構築する場合は、ファイル名を\ ``spring-mvc-api.xml``\ といった感じの名前にしておくと、 アプリケーションの種類が識別しやすくなる。 * - | (14) - Spring Securityのコンポーネントを定義するためのBean定義ファイル。 このファイルは、Webアプリケーション用のアプリケーションコンテキストを作成する際に読み込む。 * - | (15) - コードリストを定義するためのBean定義ファイル。 * - | (16) - ドメイン層のコンポーネントを定義するためのBean定義ファイル。 このファイルには、以下のBeanを定義する。 * ドメイン層のコンポーネント(Service, Repositoryなど) * インフラストラクチャ層のコンポーネント(インフラストラクチャ層のコンポーネントが定義されているBean定義ファイルをimportする) * Spring Frameworkから提供されているトランザクション管理用のコンポーネント * - | (17) - インフラストラクチャ層のコンポーネントを定義するためのBean定義ファイル。 このファイルには、O/R MapperなどのBean定義を行う。 * - | (18) - Logback(ログ出力)の設定ファイル。 ログ出力については、「\ :doc:`../ArchitectureInDetail/GeneralFuncDetail/Logging`\ 」を参照されたい。 * - | (19) - システムが利用するデフォルトのメッセージを定義するプロパティファイル。 このファイルについては、「\ :ref:`ValidationMessageDef`\ 」を参照されたい。 | .. tabs:: .. group-tab:: JSP .. code-block:: text │ └ webapp │ ├ WEB-INF │ │ ├ views ... (1) │ │ │ ├ common │ │ │ │ ├ error ... (2) │ │ │ │ │ ├ accessDeniedError.jsp │ │ │ │ │ ├ businessError.jsp │ │ │ │ │ ├ dataAccessError.jsp │ │ │ │ │ ├ invalidCsrfTokenError.jsp │ │ │ │ │ ├ missingCsrfTokenError.jsp │ │ │ │ │ ├ resourceNotFoundError.jsp │ │ │ │ │ ├ systemError.jsp │ │ │ │ │ ├ transactionTokenError.jsp │ │ │ │ │ └ unhandledSystemError.html │ │ │ │ └ include.jsp ... (3) │ │ │ ├ layout ... (4) │ │ │ │ └ footer.jsp │ │ │ └ welcome │ │ │ └ home.jsp ... (5) │ │ └ web.xml ... (6) │ └ resources ... (7) │ └ app │ └ css │ └ styles.css ... (8) .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 :class: longtable * - | 項番 - | 説明 * - | (1) - Viewを構築するテンプレートファイル(JSPなど)を格納するディレクトリ。 * - | (2) - | エラー画面を表示するためのJSP及びHTMLを格納するディレクトリ。 | 作成時点では、アプリケーション実行時に発生する可能性があるエラーに対応するJSP(HTML)が格納されている。 | \ **アプリケーションの要件(UI規約など)にあわせて必ず修正すること。**\ * - | (3) - | インクルード用の共通JSPファイル。 | このファイルは、全てのJSPファイルの先頭にインクルードされる。 | インクルード用の共通JSPファイルについては、「\ :ref:`view_jsp_include-label`\ 」を参照されたい。 * - | (4) - 共通化するJSPファイルを格納する格納するディレクトリ。 * - | (5) - Welcomeページを表示するJSPファイル。 * - | (6) - Webアプリケーションの構成定義ファイル。 * - | (7) - 静的なリソースファイルを格納するディレクトリ。 | このディレクトリは、リクエストの内容によって応答する内容がかわらないファイルを格納する。 | 具体的には以下のファイルを格納する。 * JavaScriptファイル * CSSファイル * 画像ファイル * HTMLファイル Spring MVCが提供する静的リソースの管理メカニズムを適用しやすくするために、専用のディレクトリを設ける構成を採用している。 * - | (8) - アプリケーション全体に適用する画面スタイルを定義するCSSファイル。 .. group-tab:: Thymeleaf .. code-block:: text │ └ webapp │ ├ WEB-INF │ │ ├ views ... (1) │ │ │ ├ common │ │ │ │ └ error ... (2) │ │ │ │ ├ accessDeniedError.html │ │ │ │ ├ businessError.html │ │ │ │ ├ dataAccessError.html │ │ │ │ ├ invalidCsrfTokenError.html │ │ │ │ ├ missingCsrfTokenError.html │ │ │ │ ├ resourceNotFoundError.html │ │ │ │ ├ systemError.html │ │ │ │ ├ transactionTokenError.html │ │ │ │ └ unhandledSystemError.html │ │ │ └ welcome │ │ │ └ home.html ... (3) │ │ └ web.xml ... (4) │ └ resources ... (5) │ └ app │ └ css │ └ styles.css ... (6) .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 :class: longtable * - | 項番 - | 説明 * - | (1) - Viewを構築するテンプレートファイル(HTMLなど)を格納するディレクトリ。 * - | (2) - | エラー画面を表示するためのテンプレートHTML及び静的なHTMLを格納するディレクトリ。 | 作成時点では、アプリケーション実行時に発生する可能性があるエラーに対応するテンプレートHTML及び静的なHTMLが格納されている。 | \ **アプリケーションの要件(UI規約など)にあわせて必ず修正すること。**\ * - | (3) - Welcomeページを表示するテンプレートHTMLファイル。 * - | (4) - Webアプリケーションの構成定義ファイル。 * - | (5) - 静的なリソースファイルを格納するディレクトリ。 | このディレクトリは、リクエストの内容によって応答する内容がかわらないファイルを格納する。 | 具体的には以下のファイルを格納する。 * JavaScriptファイル * CSSファイル * 画像ファイル * HTMLファイル Spring MVCが提供する静的リソースの管理メカニズムを適用しやすくするために、専用のディレクトリを設ける構成を採用している。 * - | (6) - アプリケーション全体に適用する画面スタイルを定義するCSSファイル。 | .. _BlankProjectForMyBatis3Project: MyBatis3用のプロジェクトの場合 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. tabs:: .. group-tab:: Java Config .. tabs:: .. group-tab:: JSP .. code-block:: text [artifactId] ├ pom.xml ... (1) └ src ├ main │ ├ java │ │ └ com │ │ └ example │ │ └ project │ │ ├ app ... (2) │ │ │ └ welcome │ │ │ └ HelloController.java ... (3) │ │ ├ domain ... (4) │ │ │ ├ model ... (5) │ │ │ ├ repository ... (6) │ │ │ └ service ... (7) │ │ └ config ... (8) │ │ ├ app │ │ │ ├ mybatis │ │ │ │ └ MybatisConfig.java ... (9) │ │ │ ├ ApplicationContextConfig.java ... (10) │ │ │ ├ [artifactId]CodeListConfig.java ... (11) │ │ │ ├ [artifactId]DomainConfig.java ... (12) │ │ │ ├ [artifactId]InfraConfig.java ... (13) │ │ │ └ [artifactId]EnvConfig.java ... (14) │ │ └ web │ │ ├ SpringMvcConfig.java ... (15) │ │ └ SpringSecurityConfig.java ... (16) │ ├ resources │ │ ├ i18n ... (17) │ │ │ └ application-messages.properties ... (18) │ │ ├ database ... (19) │ │ │ ├ H2-dataload.sql │ │ │ └ H2-schema.sql │ │ ├ com │ │ │ └ example │ │ │ └ project │ │ │ └ domain │ │ │ └ repository ... (20) │ │ │ └ sample │ │ │ └ SampleRepository.xml ... (21) │ │ ├ META-INF │ │ │ └ spring │ │ │ └ [artifactId]-infra.properties ... (22) │ │ ├ logback.xml ... (23) │ │ └ ValidationMessages.properties ... (24) .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 * - 項番 - 説明 * - | (1) - シングルプロジェクト全体の構成を定義するPOM(Project Object Model)ファイル。 このファイルでは、主に以下の定義を行う。 * 依存ライブラリのバージョン * ビルド用のプラグインの設定(ビルド方法の設定) * - | (2) - アプリケーション層のクラスを格納するパッケージ。 * - | (3) - Welcomeページを表示するためのリクエストを受け取るためのControllerクラス。 * - | (4) - ドメイン層のクラスを格納するパッケージ。 * - | (5) - Domain Objectを格納するパッケージ。 * - | (6) - Repositoryを格納するパッケージ。 Domain Object用のRepositoryを格納するためのパッケージを作成する * - | (7) - Serviceを格納するパッケージ。 * - | (8) - Spring関連の設定ファイルを格納するディレクトリ。 * - | (9) - MyBatis3の設定ファイル。 作成時点では、いくつかの推奨設定が定義されている。 * - | (10) - Webアプリケーション用のアプリケーションコンテキストを作成するためのBean定義ファイル。 このファイルには、以下のBeanを定義する。 * Webアプリケーション全体で使用するコンポーネント * ドメイン層のコンポーネント(ドメイン層のコンポーネントが定義されているBean定義ファイルをimportする) * - | (11) - コードリストを定義するためのBean定義ファイル。 * - | (12) - ドメイン層のコンポーネントを定義するためのBean定義ファイル。 このファイルには、以下のBeanを定義する。 * ドメイン層のコンポーネント(Service, Repositoryなど) * インフラストラクチャ層のコンポーネント(インフラストラクチャ層のコンポーネントが定義されているBean定義ファイルをimportする) * Spring Frameworkから提供されているトランザクション管理用のコンポーネント * - | (13) - インフラストラクチャ層のコンポーネントを定義するためのBean定義ファイル。 このファイルには、O/R MapperなどのBean定義を行う。 * - | (14) - 環境依存するコンポーネントを定義するBean定義ファイル。 このファイルには、以下のBeanを定義する。 * データソース * 共通ライブラリから提供している\ ``ClockFactory``\ (環境によって異なる実装を使用する場合) * Spring Frameworkから提供されているトランザクション管理用のコンポーネント (環境によって異なる実装を使用する場合) * - | (15) - \ ``DispatcherServlet``\ 用のアプリケーションコンテキストを作成するためのBean定義ファイル。 このファイルには、以下のBeanを定義する。 * Spring MVCのコンポーネント * アプリケーション層のコンポーネント REST APIを構築する場合は、ファイル名を\ ``SpringMvcApiConfig.java``\ といった感じの名前にしておくと、 アプリケーションの種類が識別しやすくなる。 * - | (16) - Spring Securityのコンポーネントを定義するためのBean定義ファイル。 このファイルは、Webアプリケーション用のアプリケーションコンテキストを作成する際に読み込む。 * - | (17) - アプリケーション層で使用するメッセージ定義ファイルを格納するディレクトリ。 * - | (18) - | アプリケーション層で使用するメッセージを定義するプロパティファイル。 | 作成時点では、いくつかの汎用的なメッセージが定義されている。 | \ **アプリケーションの要件(メッセージ規約など)にあわせて必ず修正すること。**\ | メッセージ定義については、「\ :doc:`../ArchitectureInDetail/WebApplicationDetail/MessageManagement`\ 」を参照されたい。 * - | (19) - | インメモリデータベース(H2 Database)をセットアップするためのSQLを格納するディレクトリ。 | このディレクトリは、ちょっとした動作検証を行う時のために用意しているディレクトリである。 | \ **実際のアプリケーション開発で使用することは想定していないので、基本的にはこのディレクトリは削除すること。**\ * - | (20) - MyBatis3のMapperファイルを格納するディレクトリ。 * - | (21) - | MyBatis3のMapperファイルのサンプルファイル。 | Maven Archetypeで作成したプロジェクトでは、サンプル実装がコメントアウトされた状態になっている。 | \ **実際のアプリケーション開発で使用することは想定していないので、基本的にはこのファイルは削除すること。**\ * - | (22) - 環境依存する設定値を定義するプロパティファイル。 作成時点では、データソースの設定値(接続情報とコネクションプールの設定値)が定義されている。 * - | (23) - Logback(ログ出力)の設定ファイル。 ログ出力については、「\ :doc:`../ArchitectureInDetail/GeneralFuncDetail/Logging`\ 」を参照されたい。 * - | (24) - システムが利用するデフォルトのメッセージを定義するプロパティファイル。 このファイルについては、「\ :ref:`ValidationMessageDef`\ 」を参照されたい。 .. group-tab:: Thymeleaf .. code-block:: text [artifactId] ├ pom.xml ... (1) └ src ├ main │ ├ java │ │ └ com │ │ └ example │ │ └ project │ │ ├ app ... (2) │ │ │ ├ welcome │ │ │ │ └ HelloController.java ... (3) │ │ │ └ common │ │ │ └ error │ │ │ └ CommonErrorController.java ... (4) │ │ ├ domain ... (5) │ │ │ ├ model ... (6) │ │ │ ├ repository ... (7) │ │ │ └ service ... (8) │ │ └ config ... (9) │ │ ├ app │ │ │ ├ mybatis │ │ │ │ └ MybatisConfig.java ... (10) │ │ │ ├ ApplicationContextConfig.java ... (11) │ │ │ ├ [artifactId]CodeListConfig.java ... (12) │ │ │ ├ [artifactId]DomainConfig.java ... (13) │ │ │ ├ [artifactId]InfraConfig.java ... (14) │ │ │ └ [artifactId]EnvConfig.java ... (15) │ │ └ web │ │ ├ SpringMvcConfig.java ... (16) │ │ └ SpringSecurityConfig.java ... (17) │ ├ resources │ │ ├ i18n ... (18) │ │ │ └ application-messages.properties ... (19) │ │ ├ database ... (20) │ │ │ ├ H2-dataload.sql │ │ │ └ H2-schema.sql │ │ ├ com │ │ │ └ example │ │ │ └ project │ │ │ └ domain │ │ │ └ repository ... (21) │ │ │ └ sample │ │ │ └ SampleRepository.xml ... (22) │ │ ├ META-INF │ │ │ └ spring │ │ │ └ [artifactId]-infra.properties ... (23) │ │ ├ logback.xml ... (24) │ │ └ ValidationMessages.properties ... (25) .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 * - 項番 - 説明 * - | (1) - シングルプロジェクト全体の構成を定義するPOM(Project Object Model)ファイル。 このファイルでは、主に以下の定義を行う。 * 依存ライブラリのバージョン * ビルド用のプラグインの設定(ビルド方法の設定) * - | (2) - アプリケーション層のクラスを格納するパッケージ。 * - | (3) - Welcomeページを表示するためのリクエストを受け取るためのControllerクラス。 * - | (4) - | エラー画面を表示するためのControllerクラス。 * - | (5) - ドメイン層のクラスを格納するパッケージ。 * - | (6) - Domain Objectを格納するパッケージ。 * - | (7) - Repositoryを格納するパッケージ。 Domain Object用のRepositoryを格納するためのパッケージを作成する * - | (8) - Serviceを格納するパッケージ。 * - | (9) - Spring関連の設定ファイルを格納するディレクトリ。 * - | (10) - MyBatis3の設定ファイル。 作成時点では、いくつかの推奨設定が定義されている。 * - | (11) - Webアプリケーション用のアプリケーションコンテキストを作成するためのBean定義ファイル。 このファイルには、以下のBeanを定義する。 * Webアプリケーション全体で使用するコンポーネント * ドメイン層のコンポーネント(ドメイン層のコンポーネントが定義されているBean定義ファイルをimportする) * - | (12) - コードリストを定義するためのBean定義ファイル。 * - | (13) - ドメイン層のコンポーネントを定義するためのBean定義ファイル。 このファイルには、以下のBeanを定義する。 * ドメイン層のコンポーネント(Service, Repositoryなど) * インフラストラクチャ層のコンポーネント(インフラストラクチャ層のコンポーネントが定義されているBean定義ファイルをimportする) * Spring Frameworkから提供されているトランザクション管理用のコンポーネント * - | (14) - インフラストラクチャ層のコンポーネントを定義するためのBean定義ファイル。 このファイルには、O/R MapperなどのBean定義を行う。 * - | (15) - 環境依存するコンポーネントを定義するBean定義ファイル。 このファイルには、以下のBeanを定義する。 * データソース * 共通ライブラリから提供している\ ``ClockFactory``\ (環境によって異なる実装を使用する場合) * Spring Frameworkから提供されているトランザクション管理用のコンポーネント (環境によって異なる実装を使用する場合) * - | (16) - \ ``DispatcherServlet``\ 用のアプリケーションコンテキストを作成するためのBean定義ファイル。 このファイルには、以下のBeanを定義する。 * Spring MVCのコンポーネント * アプリケーション層のコンポーネント REST APIを構築する場合は、ファイル名を\ ``SpringMvcApiConfig.java``\ といった感じの名前にしておくと、 アプリケーションの種類が識別しやすくなる。 * - | (17) - Spring Securityのコンポーネントを定義するためのBean定義ファイル。 このファイルは、Webアプリケーション用のアプリケーションコンテキストを作成する際に読み込む。 * - | (18) - アプリケーション層で使用するメッセージ定義ファイルを格納するディレクトリ。 * - | (19) - | アプリケーション層で使用するメッセージを定義するプロパティファイル。 | 作成時点では、いくつかの汎用的なメッセージが定義されている。 | \ **アプリケーションの要件(メッセージ規約など)にあわせて必ず修正すること。**\ | メッセージ定義については、「\ :doc:`../ArchitectureInDetail/WebApplicationDetail/MessageManagement`\ 」を参照されたい。 * - | (20) - | インメモリデータベース(H2 Database)をセットアップするためのSQLを格納するディレクトリ。 | このディレクトリは、ちょっとした動作検証を行う時のために用意しているディレクトリである。 | \ **実際のアプリケーション開発で使用することは想定していないので、基本的にはこのディレクトリは削除すること。**\ * - | (21) - MyBatis3のMapperファイルを格納するディレクトリ。 * - | (22) - | MyBatis3のMapperファイルのサンプルファイル。 | Maven Archetypeで作成したプロジェクトでは、サンプル実装がコメントアウトされた状態になっている。 | \ **実際のアプリケーション開発で使用することは想定していないので、基本的にはこのファイルは削除すること。**\ * - | (23) - 環境依存する設定値を定義するプロパティファイル。 作成時点では、データソースの設定値(接続情報とコネクションプールの設定値)が定義されている。 * - | (24) - Logback(ログ出力)の設定ファイル。 ログ出力については、「\ :doc:`../ArchitectureInDetail/GeneralFuncDetail/Logging`\ 」を参照されたい。 * - | (25) - システムが利用するデフォルトのメッセージを定義するプロパティファイル。 このファイルについては、「\ :ref:`ValidationMessageDef`\ 」を参照されたい。 .. group-tab:: XML Config .. tabs:: .. group-tab:: JSP .. code-block:: text [artifactId] ├ pom.xml ... (1) └ src ├ main │ ├ java │ │ └ com │ │ └ example │ │ └ project │ │ ├ app ... (2) │ │ │ └ welcome │ │ │ └ HelloController.java ... (3) │ │ └ domain ... (4) │ │ ├ model ... (5) │ │ ├ repository ... (6) │ │ └ service ... (7) │ ├ resources │ │ ├ META-INF │ │ │ ├ spring ... (8) │ │ │ │ ├ applicationContext.xml ... (9) │ │ │ │ ├ spring-mvc.xml ... (10) │ │ │ │ ├ spring-security.xml ... (11) │ │ │ │ ├ [artifactId]-codelist.xml ... (12) │ │ │ │ ├ [artifactId]-domain.xml ... (13) │ │ │ │ ├ [artifactId]-infra.xml ... (14) │ │ │ │ ├ [artifactId]-env.xml ... (15) │ │ │ │ └ [artifactId]-infra.properties ... (16) │ │ │ └ mybatis ... (17) │ │ │ └ mybatis-config.xml ... (18) │ │ ├ i18n ... (19) │ │ │ └ application-messages.properties ... (20) │ │ ├ com │ │ │ └ example │ │ │ └ project │ │ │ └ domain │ │ │ └ repository ... (21) │ │ │ └ sample │ │ │ └ SampleRepository.xml ... (22) │ │ ├ database ... (23) │ │ │ ├ H2-dataload.sql │ │ │ └ H2-schema.sql │ │ ├ logback.xml ... (24) │ │ └ ValidationMessages.properties ... (25) .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 * - 項番 - 説明 * - | (1) - シングルプロジェクト全体の構成を定義するPOM(Project Object Model)ファイル。 このファイルでは、主に以下の定義を行う。 * 依存ライブラリのバージョン * ビルド用のプラグインの設定(ビルド方法の設定) * - | (2) - アプリケーション層のクラスを格納するパッケージ。 * - | (3) - Welcomeページを表示するためのリクエストを受け取るためのControllerクラス。 * - | (4) - ドメイン層のクラスを格納するパッケージ。 * - | (5) - Domain Objectを格納するパッケージ。 * - | (6) - Repositoryを格納するパッケージ。 Domain Object用のRepositoryを格納するためのパッケージを作成する * - | (7) - Serviceを格納するパッケージ。 * - | (8) - Spring関連の設定ファイルを格納するディレクトリ。 * - | (9) - Webアプリケーション用のアプリケーションコンテキストを作成するためのBean定義ファイル。 このファイルには、以下のBeanを定義する。 * Webアプリケーション全体で使用するコンポーネント * ドメイン層のコンポーネント(ドメイン層のコンポーネントが定義されているBean定義ファイルをimportする) * - | (10) - \ ``DispatcherServlet``\ 用のアプリケーションコンテキストを作成するためのBean定義ファイル。 このファイルには、以下のBeanを定義する。 * Spring MVCのコンポーネント * アプリケーション層のコンポーネント REST APIを構築する場合は、ファイル名を\ ``spring-mvc-api.xml``\ といった感じの名前にしておくと、 アプリケーションの種類が識別しやすくなる。 * - | (11) - Spring Securityのコンポーネントを定義するためのBean定義ファイル。 このファイルは、Webアプリケーション用のアプリケーションコンテキストを作成する際に読み込む。 * - | (12) - コードリストを定義するためのBean定義ファイル。 * - | (13) - ドメイン層のコンポーネントを定義するためのBean定義ファイル。 このファイルには、以下のBeanを定義する。 * ドメイン層のコンポーネント(Service, Repositoryなど) * インフラストラクチャ層のコンポーネント(インフラストラクチャ層のコンポーネントが定義されているBean定義ファイルをimportする) * Spring Frameworkから提供されているトランザクション管理用のコンポーネント * - | (14) - インフラストラクチャ層のコンポーネントを定義するためのBean定義ファイル。 このファイルには、O/R MapperなどのBean定義を行う。 * - | (15) - 環境依存するコンポーネントを定義するBean定義ファイル。 このファイルには、以下のBeanを定義する。 * データソース * 共通ライブラリから提供している\ ``ClockFactory``\ (環境によって異なる実装を使用する場合) * Spring Frameworkから提供されているトランザクション管理用のコンポーネント (環境によって異なる実装を使用する場合) * - | (16) - 環境依存する設定値を定義するプロパティファイル。 作成時点では、データソースの設定値(接続情報とコネクションプールの設定値)が定義されている。 * - | (17) - MyBatis3の設定ファイルを格納するディレクトリ。 * - | (18) - MyBatis3の設定ファイル。 作成時点では、いくつかの推奨設定が定義されている。 * - | (19) - アプリケーション層で使用するメッセージ定義ファイルを格納するディレクトリ。 * - | (20) - | アプリケーション層で使用するメッセージを定義するプロパティファイル。 | 作成時点では、いくつかの汎用的なメッセージが定義されている。 | \ **アプリケーションの要件(メッセージ規約など)にあわせて必ず修正すること。**\ | メッセージ定義については、「\ :doc:`../ArchitectureInDetail/WebApplicationDetail/MessageManagement`\ 」を参照されたい。 * - | (21) - MyBatis3のMapperファイルを格納するディレクトリ。 * - | (22) - | MyBatis3のMapperファイルのサンプルファイル。 | Maven Archetypeで作成したプロジェクトでは、サンプル実装がコメントアウトされた状態になっている。 | \ **実際のアプリケーション開発で使用することは想定していないので、基本的にはこのファイルは削除すること。**\ * - | (23) - | インメモリデータベース(H2 Database)をセットアップするためのSQLを格納するディレクトリ。 | このディレクトリは、ちょっとした動作検証を行う時のために用意しているディレクトリである。 | \ **実際のアプリケーション開発で使用することは想定していないので、基本的にはこのディレクトリは削除すること。**\ * - | (24) - Logback(ログ出力)の設定ファイル。 ログ出力については、「\ :doc:`../ArchitectureInDetail/GeneralFuncDetail/Logging`\ 」を参照されたい。 * - | (25) - システムが利用するデフォルトのメッセージを定義するプロパティファイル。 このファイルについては、「\ :ref:`ValidationMessageDef`\ 」を参照されたい。 .. group-tab:: Thymeleaf .. code-block:: text [artifactId] ├ pom.xml ... (1) └ src ├ main │ ├ java │ │ └ com │ │ └ example │ │ └ project │ │ ├ app ... (2) │ │ │ ├ welcome │ │ │ │ └ HelloController.java ... (3) │ │ │ └ common │ │ │ └ error │ │ │ └ CommonErrorController.java ... (4) │ │ └ domain ... (5) │ │ ├ model ... (6) │ │ ├ repository ... (7) │ │ └ service ... (8) │ ├ resources │ │ ├ META-INF │ │ │ ├ spring ... (9) │ │ │ │ ├ applicationContext.xml ... (10) │ │ │ │ ├ spring-mvc.xml ... (11) │ │ │ │ ├ spring-security.xml ... (12) │ │ │ │ ├ [artifactId]-codelist.xml ... (13) │ │ │ │ ├ [artifactId]-domain.xml ... (14) │ │ │ │ ├ [artifactId]-infra.xml ... (15) │ │ │ │ ├ [artifactId]-env.xml ... (16) │ │ │ │ └ [artifactId]-infra.properties ... (17) │ │ │ └ mybatis ... (18) │ │ │ └ mybatis-config.xml ... (19) │ │ ├ i18n ... (20) │ │ │ └ application-messages.properties ... (21) │ │ ├ com │ │ │ └ example │ │ │ └ project │ │ │ └ domain │ │ │ └ repository ... (22) │ │ │ └ sample │ │ │ └ SampleRepository.xml ... (23) │ │ ├ database ... (24) │ │ │ ├ H2-dataload.sql │ │ │ └ H2-schema.sql │ │ ├ logback.xml ... (25) │ │ └ ValidationMessages.properties ... (26) .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 * - 項番 - 説明 * - | (1) - シングルプロジェクト全体の構成を定義するPOM(Project Object Model)ファイル。 このファイルでは、主に以下の定義を行う。 * 依存ライブラリのバージョン * ビルド用のプラグインの設定(ビルド方法の設定) * - | (2) - アプリケーション層のクラスを格納するパッケージ。 * - | (3) - Welcomeページを表示するためのリクエストを受け取るためのControllerクラス。 * - | (4) - | エラー画面を表示するためのControllerクラス。 * - | (5) - ドメイン層のクラスを格納するパッケージ。 * - | (6) - Domain Objectを格納するパッケージ。 * - | (7) - Repositoryを格納するパッケージ。 Domain Object用のRepositoryを格納するためのパッケージを作成する * - | (8) - Serviceを格納するパッケージ。 * - | (9) - Spring関連の設定ファイルを格納するディレクトリ。 * - | (10) - Webアプリケーション用のアプリケーションコンテキストを作成するためのBean定義ファイル。 このファイルには、以下のBeanを定義する。 * Webアプリケーション全体で使用するコンポーネント * ドメイン層のコンポーネント(ドメイン層のコンポーネントが定義されているBean定義ファイルをimportする) * - | (11) - \ ``DispatcherServlet``\ 用のアプリケーションコンテキストを作成するためのBean定義ファイル。 このファイルには、以下のBeanを定義する。 * Spring MVCのコンポーネント * アプリケーション層のコンポーネント REST APIを構築する場合は、ファイル名を\ ``spring-mvc-api.xml``\ といった感じの名前にしておくと、 アプリケーションの種類が識別しやすくなる。 * - | (12) - Spring Securityのコンポーネントを定義するためのBean定義ファイル。 このファイルは、Webアプリケーション用のアプリケーションコンテキストを作成する際に読み込む。 * - | (13) - コードリストを定義するためのBean定義ファイル。 * - | (14) - ドメイン層のコンポーネントを定義するためのBean定義ファイル。 このファイルには、以下のBeanを定義する。 * ドメイン層のコンポーネント(Service, Repositoryなど) * インフラストラクチャ層のコンポーネント(インフラストラクチャ層のコンポーネントが定義されているBean定義ファイルをimportする) * Spring Frameworkから提供されているトランザクション管理用のコンポーネント * - | (15) - インフラストラクチャ層のコンポーネントを定義するためのBean定義ファイル。 このファイルには、O/R MapperなどのBean定義を行う。 * - | (16) - 環境依存するコンポーネントを定義するBean定義ファイル。 このファイルには、以下のBeanを定義する。 * データソース * 共通ライブラリから提供している\ ``ClockFactory``\ (環境によって異なる実装を使用する場合) * Spring Frameworkから提供されているトランザクション管理用のコンポーネント (環境によって異なる実装を使用する場合) * - | (17) - 環境依存する設定値を定義するプロパティファイル。 作成時点では、データソースの設定値(接続情報とコネクションプールの設定値)が定義されている。 * - | (18) - MyBatis3の設定ファイルを格納するディレクトリ。 * - | (19) - MyBatis3の設定ファイル。 作成時点では、いくつかの推奨設定が定義されている。 * - | (20) - アプリケーション層で使用するメッセージ定義ファイルを格納するディレクトリ。 * - | (21) - | アプリケーション層で使用するメッセージを定義するプロパティファイル。 | 作成時点では、いくつかの汎用的なメッセージが定義されている。 | \ **アプリケーションの要件(メッセージ規約など)にあわせて必ず修正すること。**\ | メッセージ定義については、「\ :doc:`../ArchitectureInDetail/WebApplicationDetail/MessageManagement`\ 」を参照されたい。 * - | (22) - MyBatis3のMapperファイルを格納するディレクトリ。 * - | (23) - | MyBatis3のMapperファイルのサンプルファイル。 | Maven Archetypeで作成したプロジェクトでは、サンプル実装がコメントアウトされた状態になっている。 | \ **実際のアプリケーション開発で使用することは想定していないので、基本的にはこのファイルは削除すること。**\ * - | (24) - | インメモリデータベース(H2 Database)をセットアップするためのSQLを格納するディレクトリ。 | このディレクトリは、ちょっとした動作検証を行う時のために用意しているディレクトリである。 | \ **実際のアプリケーション開発で使用することは想定していないので、基本的にはこのディレクトリは削除すること。**\ * - | (25) - Logback(ログ出力)の設定ファイル。 ログ出力については、「\ :doc:`../ArchitectureInDetail/GeneralFuncDetail/Logging`\ 」を参照されたい。 * - | (26) - システムが利用するデフォルトのメッセージを定義するプロパティファイル。 このファイルについては、「\ :ref:`ValidationMessageDef`\ 」を参照されたい。 | .. tabs:: .. group-tab:: JSP .. code-block:: text │ └ webapp │ ├ WEB-INF │ │ ├ views ... (1) │ │ │ ├ common │ │ │ │ ├ error ... (2) │ │ │ │ │ ├ accessDeniedError.jsp │ │ │ │ │ ├ businessError.jsp │ │ │ │ │ ├ dataAccessError.jsp │ │ │ │ │ ├ invalidCsrfTokenError.jsp │ │ │ │ │ ├ missingCsrfTokenError.jsp │ │ │ │ │ ├ resourceNotFoundError.jsp │ │ │ │ │ ├ systemError.jsp │ │ │ │ │ ├ transactionTokenError.jsp │ │ │ │ │ └ unhandledSystemError.html │ │ │ │ └ include.jsp ... (3) │ │ │ ├ layout ... (4) │ │ │ │ └ footer.jsp │ │ │ └ welcome │ │ │ └ home.jsp ... (5) │ │ └ web.xml ... (6) │ └ resources ... (7) │ └ app │ └ css │ └ styles.css ... (8) .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 :class: longtable * - | 項番 - | 説明 * - | (1) - Viewを構築するテンプレートファイル(JSPなど)を格納するディレクトリ。 * - | (2) - | エラー画面を表示するためのJSP及びHTMLを格納するディレクトリ。 | 作成時点では、アプリケーション実行時に発生する可能性があるエラーに対応するJSP(HTML)が格納されている。 | \ **アプリケーションの要件(UI規約など)にあわせて必ず修正すること。**\ * - | (3) - | インクルード用の共通JSPファイル。 | このファイルは、全てのJSPファイルの先頭にインクルードされる。 | インクルード用の共通JSPファイルについては、「\ :ref:`view_jsp_include-label`\ 」を参照されたい。 * - | (4) - 共通化するJSPファイルを格納する格納するディレクトリ。 * - | (5) - Welcomeページを表示するJSPファイル。 * - | (6) - Webアプリケーションの構成定義ファイル。 * - | (7) - 静的なリソースファイルを格納するディレクトリ。 | このディレクトリは、リクエストの内容によって応答する内容がかわらないファイルを格納する。 | 具体的には以下のファイルを格納する。 * JavaScriptファイル * CSSファイル * 画像ファイル * HTMLファイル Spring MVCが提供する静的リソースの管理メカニズムを適用しやすくするために、専用のディレクトリを設ける構成を採用している。 * - | (8) - アプリケーション全体に適用する画面スタイルを定義するCSSファイル。 .. group-tab:: Thymeleaf .. code-block:: text │ └ webapp │ ├ WEB-INF │ │ ├ views ... (1) │ │ │ ├ common │ │ │ │ └ error ... (2) │ │ │ │ ├ accessDeniedError.html │ │ │ │ ├ businessError.html │ │ │ │ ├ dataAccessError.html │ │ │ │ ├ invalidCsrfTokenError.html │ │ │ │ ├ missingCsrfTokenError.html │ │ │ │ ├ resourceNotFoundError.html │ │ │ │ ├ systemError.html │ │ │ │ ├ transactionTokenError.html │ │ │ │ └ unhandledSystemError.html │ │ │ └ welcome │ │ │ └ home.html ... (3) │ │ └ web.xml ... (4) │ └ resources ... (5) │ └ app │ └ css │ └ styles.css ... (6) .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 :class: longtable * - | 項番 - | 説明 * - | (1) - Viewを構築するテンプレートファイル(HTMLなど)を格納するディレクトリ。 * - | (2) - | エラー画面を表示するためのテンプレートHTML及び静的なHTMLを格納するディレクトリ。 | 作成時点では、アプリケーション実行時に発生する可能性があるエラーに対応するテンプレートHTML及び静的なHTMLが格納されている。 | \ **アプリケーションの要件(UI規約など)にあわせて必ず修正すること。**\ * - | (3) - Welcomeページを表示するテンプレートHTMLファイル。 * - | (4) - Webアプリケーションの構成定義ファイル。 * - | (5) - 静的なリソースファイルを格納するディレクトリ。 | このディレクトリは、リクエストの内容によって応答する内容がかわらないファイルを格納する。 | 具体的には以下のファイルを格納する。 * JavaScriptファイル * CSSファイル * 画像ファイル * HTMLファイル Spring MVCが提供する静的リソースの管理メカニズムを適用しやすくするために、専用のディレクトリを設ける構成を採用している。 * - | (6) - アプリケーション全体に適用する画面スタイルを定義するCSSファイル。 | .. _BlankProjectMultiProjectConfiguration: マルチプロジェクトの構成 -------------------------------------------------------------------------------- まず、マルチプロジェクト全体の構成について説明する。 .. code-block:: text [artifactId] ├ pom.xml ... (1) ├ [artifactId]-web ... (2) ├ [artifactId]-domain ... (3) ├ [artifactId]-env ... (4) ├ [artifactId]-initdb ... (5) └ [artifactId]-selenium ... (6) .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 :class: longtable * - | 項番 - | 説明 * - | (1) - マルチプロジェクト全体の構成を定義するPOM(Project Object Model)ファイル。 このファイルでは、主に以下の定義を行う。 * 依存ライブラリのバージョン * ビルド用のプラグインの設定(ビルド方法の設定) マルチプロジェクトの階層関係については、「\ :ref:`BlankProjectDependenciesBetweenBlankProjectAndSharedLibraries`\ 」を参照されたい。 * - | (2) - アプリケーション層(Web層)のコンポーネントを管理するモジュール。 このモジュールでは、主に以下のコンポーネントやファイルを管理する。 * Controllerクラス * 相関チェック用のValidatorクラス * Formクラス(REST APIの場合はResourceクラス) * View(JSP/Thymeleaf) * CSSファイル * JavaScriptファイル * アプリケーション層のコンポーネント用のJUnit * アプリケーション層のコンポーネントを定義するためのBean定義ファイル * Webアプリケーションの構成定義ファイル(web.xml) * メッセージ定義ファイル * - | (3) - ドメイン層のコンポーネントを管理するモジュール。 このモジュールでは、主に以下のコンポーネントやファイルを管理する。 * Entityなどのドメインオブジェクト * Repository * Service * DTO * ドメイン層のコンポーネント用のJUnit * ドメイン層のコンポーネントを定義するためのBean定義ファイル * - | (4) - 環境依存性をもつ設定ファイルを管理するモジュール。 このモジュールでは、主に以下のファイルを管理する。 * 環境依存するコンポーネントを定義するためのBean定義ファイル * 環境依存するプロパティ値を定義するプロパティファイル * - | (5) - データベースを初期化するためのSQLファイルを管理するモジュール このモジュールでは、主に以下のファイルを管理する。 * テーブルなどのデータベースオブジェクトを作成するためのSQLファイル * マスタデータなどの初期データを投入するためのSQLファイル * E2E(End To End)テストで使用するテストデータを投入するためのSQLファイル * - | (6) - Seleniumを使用したE2Eテスト用のコンポーネントを管理するモジュール。 このモジュールでは、主に以下のファイルを管理する。 * Seleniumを操作してテストを行うJUnit * Assert時に使用する期待値ファイル(必要に応じて) | .. _BlankProjectWebModuleConfiguration: webモジュールの構成 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ アプリケーション層(Web層)のコンポーネントを管理するモジュールの構成について説明する。 .. code-block:: text [artifactId]-web ├ pom.xml ... (1) .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 * - | 項番 - | 説明 * - | (1) - webモジュールの構成を定義するPOM(Project Object Model)ファイル。このファイルでは、以下の定義を行う。 * 依存ライブラリとビルド用プラグインの定義 * warファイルを作成するための定義 .. note:: \ **REST API用のプロジェクトを作成する際のwebモジュールのモジュール名について**\ REST APIを構築する場合は、モジュール名を\ ``[artifactId]-api``\ といった感じの名前にしておくと、アプリケーションの種類が識別しやすくなる。 | .. tabs:: .. group-tab:: Java Config .. tabs:: .. group-tab:: JSP .. code-block:: text └ src ├ main │ ├ java │ │ └ com │ │ └ example │ │ └ project │ │ ├ app ... (1) │ │ │ └ welcome │ │ │ └ HelloController.java ... (2) │ │ └ config │ │ ├ app │ │ │ └ ApplicationContextConfig.java ... (3) │ │ └ web │ │ ├ SpringMvcConfig.java ... (4) │ │ └ SpringSecurityConfig.java ... (5) │ ├ resources │ │ ├ META-INF │ │ │ └ spring ... (6) │ │ │ └ application.properties ... (7) │ │ └ i18n ... (8) │ │ └ application-messages.properties ... (9) .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 :class: longtable * - | 項番 - | 説明 * - | (1) - アプリケーション層のクラスを格納するためのパッケージ。 REST APIを構築する場合は、パッケージ名を\ ``api``\ といった感じの名前にしておくと、 コンポーネントの種類が識別しやすくなる。 * - | (2) - Welcomeページを表示するためのリクエストを受け取るためのControllerクラス。 * - | (3) - Webアプリケーション用のアプリケーションコンテキストを作成するためのBean定義ファイル。 このファイルには、以下のBeanを定義する。 * Webアプリケーション全体で使用するコンポーネント * ドメイン層のコンポーネント(ドメイン層のコンポーネントが定義されているBean定義ファイルをimportする) * - | (4) - \ ``DispatcherServlet``\ 用のアプリケーションコンテキストを作成するためのBean定義ファイル。 このファイルには、以下のBeanを定義する。 * Spring MVCのコンポーネント * アプリケーション層のコンポーネント REST APIを構築する場合は、ファイル名を\ ``SpringMvcApiConfig.java``\ といった感じの名前にしておくと、 アプリケーションの種類が識別しやすくなる。 * - | (5) - Spring Securityのコンポーネントを定義するためのBean定義ファイル。 このファイルは、Webアプリケーション用のアプリケーションコンテキストを作成する際に読み込む。 * - | (6) - Spring FrameworkのBean定義ファイルとプロパティファイルを格納するディレクトリ。 * - | (7) - アプリケーション層で使用する設定値を定義するプロパティファイル。 作成時点では、空のファイルである。 * - | (8) - アプリケーション層で使用するメッセージ定義ファイルを格納するディレクトリ。 * - | (9) - | アプリケーション層で使用するメッセージを定義するプロパティファイル。 | 作成時点では、いくつかの汎用的なメッセージが定義されている。 | \ **アプリケーションの要件(メッセージ規約など)にあわせて必ず修正すること。**\ | メッセージ定義については、「\ :doc:`../ArchitectureInDetail/WebApplicationDetail/MessageManagement`\ 」を参照されたい。 .. group-tab:: Thymeleaf .. code-block:: text └ src ├ main │ ├ java │ │ └ com │ │ └ example │ │ └ project │ │ ├ app ... (1) │ │ │ ├ common │ │ │ │ └ error │ │ │ │ └ CommonErrorController.java ... (2) │ │ │ └ welcome │ │ │ └ HelloController.java ... (3) │ │ └ config │ │ ├ app │ │ │ └ ApplicationContextConfig.java ... (4) │ │ └ web │ │ ├ SpringMvcConfig.java ... (5) │ │ └ SpringSecurityConfig.java ... (6) │ ├ resources │ │ ├ META-INF │ │ │ └ spring ... (7) │ │ │ └ application.properties ... (8) │ │ └ i18n ... (9) │ │ └ application-messages.properties ... (10) .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 :class: longtable * - | 項番 - | 説明 * - | (1) - アプリケーション層のクラスを格納するためのパッケージ。 REST APIを構築する場合は、パッケージ名を\ ``api``\ といった感じの名前にしておくと、 コンポーネントの種類が識別しやすくなる。 * - | (2) - エラー画面を表示するためのControllerクラス。 * - | (3) - Welcomeページを表示するためのリクエストを受け取るためのControllerクラス。 * - | (4) - Webアプリケーション用のアプリケーションコンテキストを作成するためのBean定義ファイル。 このファイルには、以下のBeanを定義する。 * Webアプリケーション全体で使用するコンポーネント * ドメイン層のコンポーネント(ドメイン層のコンポーネントが定義されているBean定義ファイルをimportする) * - | (5) - \ ``DispatcherServlet``\ 用のアプリケーションコンテキストを作成するためのBean定義ファイル。 このファイルには、以下のBeanを定義する。 * Spring MVCのコンポーネント * アプリケーション層のコンポーネント REST APIを構築する場合は、ファイル名を\ ``spring-mvc-api.xml``\ といった感じの名前にしておくと、 アプリケーションの種類が識別しやすくなる。 * - | (6) - Spring Securityのコンポーネントを定義するためのBean定義ファイル。 このファイルは、Webアプリケーション用のアプリケーションコンテキストを作成する際に読み込む。 * - | (7) - Spring FrameworkのBean定義ファイルとプロパティファイルを格納するディレクトリ。 * - | (8) - アプリケーション層で使用する設定値を定義するプロパティファイル。 作成時点では、空のファイルである。 * - | (9) - アプリケーション層で使用するメッセージ定義ファイルを格納するディレクトリ。 * - | (10) - | アプリケーション層で使用するメッセージを定義するプロパティファイル。 | 作成時点では、いくつかの汎用的なメッセージが定義されている。 | \ **アプリケーションの要件(メッセージ規約など)にあわせて必ず修正すること。**\ | メッセージ定義については、「\ :doc:`../ArchitectureInDetail/WebApplicationDetail/MessageManagement`\ 」を参照されたい。 .. group-tab:: XML Config .. tabs:: .. group-tab:: JSP .. code-block:: text └ src ├ main │ ├ java │ │ └ com │ │ └ example │ │ └ project │ │ └ app ... (1) │ │ └ welcome │ │ └ HelloController.java ... (2) │ ├ resources │ │ ├ META-INF │ │ │ └ spring ... (3) │ │ │ ├ application.properties ... (4) │ │ │ ├ applicationContext.xml ... (5) │ │ │ ├ spring-mvc.xml ... (6) │ │ │ └ spring-security.xml ... (7) │ │ ├ i18n ... (8) │ │ │ └ application-messages.properties ... (9) .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 :class: longtable * - | 項番 - | 説明 * - | (1) - アプリケーション層のクラスを格納するためのパッケージ。 REST APIを構築する場合は、パッケージ名を\ ``api``\ といった感じの名前にしておくと、 コンポーネントの種類が識別しやすくなる。 * - | (2) - Welcomeページを表示するためのリクエストを受け取るためのControllerクラス。 * - | (3) - Spring FrameworkのBean定義ファイルとプロパティファイルを格納するディレクトリ。 * - | (4) - アプリケーション層で使用する設定値を定義するプロパティファイル。 作成時点では、空のファイルである。 * - | (5) - Webアプリケーション用のアプリケーションコンテキストを作成するためのBean定義ファイル。 このファイルには、以下のBeanを定義する。 * Webアプリケーション全体で使用するコンポーネント * ドメイン層のコンポーネント(ドメイン層のコンポーネントが定義されているBean定義ファイルをimportする) * - | (6) - \ ``DispatcherServlet``\ 用のアプリケーションコンテキストを作成するためのBean定義ファイル。 このファイルには、以下のBeanを定義する。 * Spring MVCのコンポーネント * アプリケーション層のコンポーネント REST APIを構築する場合は、ファイル名を\ ``spring-mvc-api.xml``\ といった感じの名前にしておくと、 アプリケーションの種類が識別しやすくなる。 * - | (7) - Spring Securityのコンポーネントを定義するためのBean定義ファイル。 このファイルは、Webアプリケーション用のアプリケーションコンテキストを作成する際に読み込む。 * - | (8) - アプリケーション層で使用するメッセージ定義ファイルを格納するディレクトリ。 * - | (9) - | アプリケーション層で使用するメッセージを定義するプロパティファイル。 | 作成時点では、いくつかの汎用的なメッセージが定義されている。 | \ **アプリケーションの要件(メッセージ規約など)にあわせて必ず修正すること。**\ | メッセージ定義については、「\ :doc:`../ArchitectureInDetail/WebApplicationDetail/MessageManagement`\ 」を参照されたい。 .. group-tab:: Thymeleaf .. code-block:: text └ src ├ main │ ├ java │ │ └ com │ │ └ example │ │ └ project │ │ └ app ... (1) │ │ ├ common │ │ │ └ error │ │ │ └ CommonErrorController.java ... (2) │ │ └ welcome │ │ └ HelloController.java ... (3) │ ├ resources │ │ ├ META-INF │ │ │ └ spring ... (4) │ │ │ ├ application.properties ... (5) │ │ │ ├ applicationContext.xml ... (6) │ │ │ ├ spring-mvc.xml ... (7) │ │ │ └ spring-security.xml ... (8) │ │ ├ i18n ... (9) │ │ │ └ application-messages.properties ... (10) .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 :class: longtable * - | 項番 - | 説明 * - | (1) - アプリケーション層のクラスを格納するためのパッケージ。 REST APIを構築する場合は、パッケージ名を\ ``api``\ といった感じの名前にしておくと、 コンポーネントの種類が識別しやすくなる。 * - | (2) - エラー画面を表示するためのControllerクラス。 * - | (3) - Welcomeページを表示するためのリクエストを受け取るためのControllerクラス。 * - | (4) - Spring FrameworkのBean定義ファイルとプロパティファイルを格納するディレクトリ。 * - | (5) - アプリケーション層で使用する設定値を定義するプロパティファイル。 作成時点では、空のファイルである。 * - | (6) - Webアプリケーション用のアプリケーションコンテキストを作成するためのBean定義ファイル。 このファイルには、以下のBeanを定義する。 * Webアプリケーション全体で使用するコンポーネント * ドメイン層のコンポーネント(ドメイン層のコンポーネントが定義されているBean定義ファイルをimportする) * - | (7) - \ ``DispatcherServlet``\ 用のアプリケーションコンテキストを作成するためのBean定義ファイル。 このファイルには、以下のBeanを定義する。 * Spring MVCのコンポーネント * アプリケーション層のコンポーネント REST APIを構築する場合は、ファイル名を\ ``spring-mvc-api.xml``\ といった感じの名前にしておくと、 アプリケーションの種類が識別しやすくなる。 * - | (8) - Spring Securityのコンポーネントを定義するためのBean定義ファイル。 このファイルは、Webアプリケーション用のアプリケーションコンテキストを作成する際に読み込む。 * - | (9) - アプリケーション層で使用するメッセージ定義ファイルを格納するディレクトリ。 * - | (10) - | アプリケーション層で使用するメッセージを定義するプロパティファイル。 | 作成時点では、いくつかの汎用的なメッセージが定義されている。 | \ **アプリケーションの要件(メッセージ規約など)にあわせて必ず修正すること。**\ | メッセージ定義については、「\ :doc:`../ArchitectureInDetail/WebApplicationDetail/MessageManagement`\ 」を参照されたい。 .. note:: アプリケーションコンテキストとBean定義ファイルの関連については、「\ :ref:`BlankProjectRelationshipBetweenApplicationContextConfigurationAndBeanDefinitionFiles`\ 」を参照されたい。 | .. tabs:: .. group-tab:: JSP .. code-block:: text │ └ webapp │ ├ WEB-INF │ │ ├ views ... (1) │ │ │ ├ common │ │ │ │ ├ error ... (2) │ │ │ │ │ ├ accessDeniedError.jsp │ │ │ │ │ ├ businessError.jsp │ │ │ │ │ ├ dataAccessError.jsp │ │ │ │ │ ├ invalidCsrfTokenError.jsp │ │ │ │ │ ├ missingCsrfTokenError.jsp │ │ │ │ │ ├ resourceNotFoundError.jsp │ │ │ │ │ ├ systemError.jsp │ │ │ │ │ ├ transactionTokenError.jsp │ │ │ │ │ └ unhandledSystemError.html │ │ │ │ └ include.jsp ... (3) │ │ │ ├ layout ... (4) │ │ │ │ ├ header.jsp │ │ │ │ └ footer.jsp │ │ │ └ welcome │ │ │ └ home.jsp ... (5) │ │ └ web.xml ... (6) │ └ resources ... (7) │ └ app │ └ css │ └ styles.css ... (8) └ test ├ java └ resources .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 :class: longtable * - | 項番 - | 説明 * - | (1) - Viewを構築するテンプレートファイル(JSPなど)を格納するディレクトリ。 * - | (2) - | エラー画面を表示するためのJSP及びHTMLを格納するディレクトリ。 | 作成時点では、アプリケーション実行時に発生する可能性があるエラーに対応するJSP(HTML)が格納されている。 | \ **アプリケーションの要件(UI規約など)にあわせて必ず修正すること。**\ * - | (3) - | インクルード用の共通JSPファイル。 | このファイルは、全てのJSPファイルの先頭にインクルードされる。 | インクルード用の共通JSPファイルについては、「\ :ref:`view_jsp_include-label`\ 」を参照されたい。 * - | (4) - 共通化するJSPファイルを格納する格納するディレクトリ。 * - | (5) - Welcomeページを表示するJSPファイル。 * - | (6) - Webアプリケーションの構成定義ファイル。 * - | (7) - 静的なリソースファイルを格納するディレクトリ。 | このディレクトリは、リクエストの内容によって応答する内容がかわらないファイルを格納する。 | 具体的には以下のファイルを格納する。 * JavaScriptファイル * CSSファイル * 画像ファイル * HTMLファイル Spring MVCが提供する静的リソースの管理メカニズムを適用しやすくするために、専用のディレクトリを設ける構成を採用している。 * - | (8) - アプリケーション全体に適用する画面スタイルを定義するCSSファイル。 .. group-tab:: Thymeleaf .. code-block:: text │ └ webapp │ ├ WEB-INF │ │ ├ views ... (1) │ │ │ ├ common │ │ │ │ └ error ... (2) │ │ │ │ ├ accessDeniedError.html │ │ │ │ ├ businessError.html │ │ │ │ ├ dataAccessError.html │ │ │ │ ├ invalidCsrfTokenError.html │ │ │ │ ├ missingCsrfTokenError.html │ │ │ │ ├ resourceNotFoundError.html │ │ │ │ ├ systemError.html │ │ │ │ ├ transactionTokenError.html │ │ │ │ └ unhandledSystemError.html │ │ │ ├ layout ... (3) │ │ │ │ ├ header.html │ │ │ │ └ template.html │ │ │ └ welcome │ │ │ └ home.html ... (4) │ │ └ web.xml ... (5) │ └ resources ... (6) │ └ app │ └ css │ └ styles.css ... (7) └ test ├ java └ resources .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 :class: longtable * - | 項番 - | 説明 * - | (1) - Viewを構築するテンプレートファイル(HTMLなど)を格納するディレクトリ。 * - | (2) - | エラー画面を表示するためのテンプレートHTML及び静的なHTMLを格納するディレクトリ。 | 作成時点では、アプリケーション実行時に発生する可能性があるエラーに対応するテンプレートHTML及び静的なHTMLが格納されている。 | \ **アプリケーションの要件(UI規約など)にあわせて必ず修正すること。**\ * - | (3) - | Thymeleafのテンプレートレイアウト用のHTMLファイルを格納するディレクトリ。 | Thymeleafのテンプレートレイアウト用のHTMLファイルの記載内容については、「\ :doc:`../ArchitectureInDetail/WebApplicationDetail/TemplateLayout`\ 」を参照されたい。 * - | (4) - Welcomeページを表示するテンプレートHTMLファイル。 * - | (5) - Webアプリケーションの構成定義ファイル。 * - | (6) - 静的なリソースファイルを格納するディレクトリ。 | このディレクトリは、リクエストの内容によって応答する内容がかわらないファイルを格納する。 | 具体的には以下のファイルを格納する。 * JavaScriptファイル * CSSファイル * 画像ファイル * HTMLファイル Spring MVCが提供する静的リソースの管理メカニズムを適用しやすくするために、専用のディレクトリを設ける構成を採用している。 * - | (7) - アプリケーション全体に適用する画面スタイルを定義するCSSファイル。 | .. _BlankProjectDomainModuleConfiguration: domainモジュールの構成 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ ドメイン層のコンポーネントを管理するモジュールの構成について説明する。 MyBatis3用のプロジェクトの場合 """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .. code-block:: text [artifactId]-domain ├ pom.xml ... (1) .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 * - | 項番 - | 説明 * - | (1) - domainモジュールの構成を定義するPOM(Project Object Model)ファイル。 このファイルでは、以下の定義を行う。 * 依存ライブラリとビルド用プラグインの定義 * jarファイルを作成するための定義 | .. tabs:: .. group-tab:: Java Config .. code-block:: text └ src ├ main │ ├ java │ │ └ com │ │ └ example │ │ └ project │ │ ├ domain ... (1) │ │ │ ├ model │ │ │ ├ repository │ │ │ └ service │ │ └ config │ │ └ app │ │ ├ [artifactId]CodeListConfig.java ... (2) │ │ ├ [artifactId]DomainConfig.java ... (3) │ │ └ [artifactId]InfraConfig.java ... (4) │ └ resources │ └ META-INF │ └ spring ... (5) .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 * - | 項番 - | 説明 * - | (1) - ドメイン層のクラスを格納するためのパッケージ。 * - | (2) - コードリストを定義するためのBean定義ファイル。 * - | (3) - ドメイン層のコンポーネントを定義するためのBean定義ファイル。 このファイルには、以下のBeanを定義する。 * ドメイン層のコンポーネント(Service, Repositoryなど) * インフラストラクチャ層のコンポーネント(インフラストラクチャ層のコンポーネントが定義されているBean定義ファイルをimportする) * Spring Frameworkから提供されているトランザクション管理用のコンポーネント * - | (4) - インフラストラクチャ層のコンポーネントを定義するためのBean定義ファイル。 このファイルには、O/R MapperなどのBean定義を行う。 * - | (5) - Spring Frameworkのプロパティファイルを格納するディレクトリ。 .. group-tab:: XML Config .. code-block:: text └ src ├ main │ ├ java │ │ └ com │ │ └ example │ │ └ project │ │ └ domain ... (1) │ │ ├ model │ │ ├ repository │ │ └ service │ └ resources │ └ META-INF │ └ spring ... (2) │ ├ [artifactId]-codelist.xml ... (3) │ ├ [artifactId]-domain.xml ... (4) │ └ [artifactId]-infra.xml ... (5) .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 * - | 項番 - | 説明 * - | (1) - ドメイン層のクラスを格納するためのパッケージ。 * - | (2) - Spring FrameworkのBean定義ファイルとプロパティファイルを格納するディレクトリ。 * - | (3) - コードリストを定義するためのBean定義ファイル。 * - | (4) - ドメイン層のコンポーネントを定義するためのBean定義ファイル。 このファイルには、以下のBeanを定義する。 * ドメイン層のコンポーネント(Service, Repositoryなど) * インフラストラクチャ層のコンポーネント(インフラストラクチャ層のコンポーネントが定義されているBean定義ファイルをimportする) * Spring Frameworkから提供されているトランザクション管理用のコンポーネント * - | (5) - インフラストラクチャ層のコンポーネントを定義するためのBean定義ファイル。 このファイルには、O/R MapperなどのBean定義を行う。 | .. tabs:: .. group-tab:: Java Config .. code-block:: text └ test └ java └ com └ example └ project ├ domain │ ├ repository │ └ service └ config └ TestContextConfig.java ... (1) .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 * - | 項番 - | 説明 * - | (1) - ドメイン層のユニットテスト用のコンポーネントを定義するためのBean定義ファイル。 .. group-tab:: XML Config .. code-block:: text └ test ├ java │ └ com │ └ example │ └ project │ └ domain │ ├ repository │ └ service └ resources └ test-context.xml ... (1) .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 * - | 項番 - | 説明 * - | (1) - ドメイン層のユニットテスト用のコンポーネントを定義するためのBean定義ファイル。 .. tabs:: .. group-tab:: Java Config .. code-block:: text └ src ├ main │ ├ java │ │ └ com │ │ └ example │ │ └ project │ │ ├ domain │ │ └ config │ │ └ mybatis ... (1) │ │ └ MybatisConfig.java ... (2) │ └ resources │ ├ META-INF │ │ └ spring (...) │ └ com │ └ example │ └ project │ └ domain │ └ repository ... (3) │ └ sample │ └ SampleRepository.xml ... (4) .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 * - | 項番 - | 説明 * - | (1) - MyBatis3の設定ファイルを格納するディレクトリ。 * - | (2) - MyBatis3の設定ファイル。 作成時点では、いくつかの推奨設定が定義されている。 * - | (3) - MyBatis3のMapperファイルを格納するディレクトリ。 * - | (4) - | MyBatis3のMapperファイルのサンプルファイル。 | Maven Archetypeで作成したプロジェクトでは、サンプル実装がコメントアウトされた状態になっている。 | \ **実際のアプリケーション開発で使用することは想定していないので、基本的にはこのファイルは削除すること。**\ .. group-tab:: XML Config .. code-block:: text └ src ├ main │ ├ java (...) │ └ resources │ ├ META-INF │ │ ├ mybatis ... (1) │ │ │ └ mybatis-config.xml ... (2) │ │ └ spring (...) │ └ com │ └ example │ └ project │ └ domain │ └ repository ... (3) │ └ sample │ └ SampleRepository.xml ... (4) .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 * - | 項番 - | 説明 * - | (1) - MyBatis3の設定ファイルを格納するディレクトリ。 * - | (2) - MyBatis3の設定ファイル。 作成時点では、いくつかの推奨設定が定義されている。 * - | (3) - MyBatis3のMapperファイルを格納するディレクトリ。 * - | (4) - | MyBatis3のMapperファイルのサンプルファイル。 | Maven Archetypeで作成したプロジェクトでは、サンプル実装がコメントアウトされた状態になっている。 | \ **実際のアプリケーション開発で使用することは想定していないので、基本的にはこのファイルは削除すること。**\ | .. _BlankProjectEnvModuleConfiguration: envモジュールの構成 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 環境依存性をもつ設定ファイルを管理するモジュールの構成について説明する。 .. code-block:: text [artifactId]-env ├ configs ... (1) │ ├ production-server ... (2) │ │ ├ java │ │ └ resources │ └ test-server │ ├ java │ └ resources ├ pom.xml ... (3) .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 * - | 項番 - | 説明 * - | (1) - 環境依存する設定ファイルを管理するためのディレクトリ。 環境毎にサブディレクトリを作成し、環境依存する設定ファイルを管理する。 * - | (2) - 環境毎の設定ファイルを管理するためのディレクトリ。 作成時点では、最もシンプルな構成として、以下のディレクトリ(雛形のディレクトリ)が用意されている。 * production-server (商用環境向けの設定ファイルを格納するディレクトリ) * test-server (テスト環境向けの設定ファイルを格納するディレクトリ) * - | (3) - envモジュールの構成を定義するPOM(Project Object Model)ファイル。 このファイルでは、以下の定義を行う。 * 依存ライブラリとビルド用プラグインの定義 * 環境毎のjarファイルを作成するためのProfileの定義 | .. tabs:: .. group-tab:: Java Config .. code-block:: text └ src └ main ├ java │ └ com │ └ example │ └ project │ └ config │ └ app │ └ [artifactId]EnvConfig.java ... (1) └ resources ... (2) ├ META-INF │ └ spring │ └ [artifactId]-infra.properties ... (3) ├ database ... (4) │ ├ H2-dataload.sql │ └ H2-schema.sql └ logback.xml ... (5) .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 * - | 項番 - | 説明 * - | (1) - 環境依存するコンポーネントを定義するBean定義ファイル。 このファイルには、以下のBeanを定義する。 * データソース * 共通ライブラリから提供している\ ``ClockFactory``\ (環境によって異なる実装を使用する場合) * Spring Frameworkから提供されているトランザクション管理用のコンポーネント (環境によって異なる実装を使用する場合) * - | (2) - 開発用の設定ファイルを管理するためのディレクトリ。 * - | (3) - 環境依存する設定値を定義するプロパティファイル。 作成時点では、データソースの設定値(接続情報とコネクションプールの設定値)が定義されている。 * - | (4) - | インメモリデータベース(H2 Database)をセットアップするためのSQLを格納するディレクトリ。 | このディレクトリは、ちょっとした動作検証を行う時のために用意しているディレクトリである。 | \ **実際のアプリケーション開発で使用することは想定していないので、基本的にはこのディレクトリは削除すること。**\ * - | (5) - Logback(ログ出力)の設定ファイル。 ログ出力については、「\ :doc:`../ArchitectureInDetail/GeneralFuncDetail/Logging`\ 」を参照されたい。 .. group-tab:: XML Config .. code-block:: text └ src └ main └ resources ... (1) ├ META-INF │ └ spring │ ├ [artifactId]-env.xml ... (2) │ └ [artifactId]-infra.properties ... (3) ├ database ... (4) │ ├ H2-dataload.sql │ └ H2-schema.sql └ logback.xml ... (5) .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 * - | 項番 - | 説明 * - | (1) - 開発用の設定ファイルを管理するためのディレクトリ。 * - | (2) - 環境依存するコンポーネントを定義するBean定義ファイル。 このファイルには、以下のBeanを定義する。 * データソース * 共通ライブラリから提供している\ ``ClockFactory``\ (環境によって異なる実装を使用する場合) * Spring Frameworkから提供されているトランザクション管理用のコンポーネント (環境によって異なる実装を使用する場合) * - | (3) - 環境依存する設定値を定義するプロパティファイル。 作成時点では、データソースの設定値(接続情報とコネクションプールの設定値)が定義されている。 * - | (4) - | インメモリデータベース(H2 Database)をセットアップするためのSQLを格納するディレクトリ。 | このディレクトリは、ちょっとした動作検証を行う時のために用意しているディレクトリである。 | \ **実際のアプリケーション開発で使用することは想定していないので、基本的にはこのディレクトリは削除すること。**\ * - | (5) - Logback(ログ出力)の設定ファイル。 ログ出力については、「\ :doc:`../ArchitectureInDetail/GeneralFuncDetail/Logging`\ 」を参照されたい。 | .. _BlankProjectInitdbModuleConfiguration: initdbモジュールの構成 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ データベースを初期化するためのSQLファイルを管理するモジュールの構成について説明する。 .. code-block:: text [artifactId]-initdb ├ pom.xml ... (1) └ src └ main └ sqls ... (2) .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 * - | 項番 - | 説明 * - | (1) - initdbモジュールの構成を定義するPOM(Project Object Model)ファイル。 このファイルでは、以下の定義を行う。 * ビルド用プラグイン(\ :url_mojohaus:`SQL Maven Plugin `\ )の定義 作成時点では、PostgreSQL用の雛形設定が定義されている。 * - | (2) - データベースを初期化するためのSQLファイルを格納するためのディレクトリ。 | 作成時点では、空のディレクトリである。 | 作成例については、\ :url_atrs:`サンプルアプリケーションのinitdbプロジェクト `\ を参照されたい。 \ :url_mojohaus:`SQL Maven Plugin `\ の\ :url_mojohaus:`sql:execute `\ を使用して、SQLを実行できる。 .. code-block:: console mvn sql:execute | .. _BlankProjectSeleniumModuleConfiguration: seleniumモジュールの構成 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Seleniumを使用したE2E(End To End)テスト用のコンポーネントを管理するモジュールの構成について説明する。 .. tabs:: .. group-tab:: Java Config .. code-block:: text [artifactId]-selenium ├ pom.xml ... (1) └ src └ test ... (2) ├ java │ └ com │ └ example │ ├ project │ │ └ selenium │ │ └ welcome │ │ └ HelloIT.java ... (3) │ └ config │ └ SeleniumContextConfig.java ... (4) └ resources └ META-INF └ spring └ selenium.properties ... (5) .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 * - | 項番 - | 説明 * - | (1) - seleniumモジュールの構成を定義するPOM(Project Object Model)ファイル。 このファイルでは、以下の定義を行う。 * 依存ライブラリとビルド用プラグインの定義 * jarファイルを作成するための定義 * - | (2) - テスト用のコンポーネントと設定ファイルを格納するディレクトリ。 作成例については、\ :url_gfw_func:`共通ライブラリのテストアプリケーションのseleniumプロジェクト `\ を参照されたい。 * - | (3) - Selenium WebDriverを使用したサンプルテストクラス。 作成時点では、Welcomeページのタイトルを検証するテストケースが実装されている。 * - | (4) - テスト用のコンポーネントを定義するためのBean定義ファイル。 作成時点では、サンプルのテストを実行するために必要な設定がされている。 * - | (5) - テストで使用する設定値を定義するプロパティファイル。 作成時点では、アプリケーションサーバのURLは\ ``http://localhost:8080/``\ である。 .. group-tab:: XML Config .. code-block:: text [artifactId]-selenium ├ pom.xml ... (1) └ src └ test ... (2) ├ java │ └ com │ └ example │ └ project │ └ selenium │ └ welcome │ └ HelloIT.java ... (3) └ resources └ META-INF └ spring ├ selenium.properties ... (4) └ seleniumContext.xml ... (5) .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 * - | 項番 - | 説明 * - | (1) - seleniumモジュールの構成を定義するPOM(Project Object Model)ファイル。 このファイルでは、以下の定義を行う。 * 依存ライブラリとビルド用プラグインの定義 * jarファイルを作成するための定義 * - | (2) - テスト用のコンポーネントと設定ファイルを格納するディレクトリ。 作成例については、\ :url_gfw_func:`共通ライブラリのテストアプリケーションのseleniumプロジェクト `\ を参照されたい。 * - | (3) - Selenium WebDriverを使用したサンプルテストクラス。 作成時点では、Welcomeページのタイトルを検証するテストケースが実装されている。 * - | (4) - テストで使用する設定値を定義するプロパティファイル。 作成時点では、アプリケーションサーバのURLは\ ``http://localhost:8080/``\ である。 * - | (5) - テスト用のコンポーネントを定義するためのBean定義ファイル。 作成時点では、サンプルのテストを実行するために必要な設定がされている。 | .. _BlankProjectCheckConfigurationFile: 設定ファイルの確認 ================================================================================ 設定ファイルの内容については「\ :ref:`BlankProjectCreateBlankProject`\ 」でartifactIdの値にtodoを設定して作成したブランクプロジェクトに含まれる設定ファイルの内容を使用している。 | web.xml -------------------------------------------------------------------------------- \ :file:`web.xml`\ には、WebアプリケーションとしてTodoアプリをデプロイするための設定を行う。 作成したブランクプロジェクトの\ :file:`src/main/webapp/WEB-INF/web.xml`\ は、以下のような設定となっている。 .. tabs:: .. group-tab:: Java Config .. tabs:: .. group-tab:: JSP .. code-block:: xml logbackDisableServletContainerInitializer true contextClass org.springframework.web.context.support.AnnotationConfigWebApplicationContext ch.qos.logback.classic.servlet.LogbackServletContextListener org.springframework.web.context.ContextLoaderListener contextConfigLocation com.example.todo.config.app.ApplicationContextConfig com.example.todo.config.web.SpringSecurityConfig org.terasoluna.gfw.web.logging.HttpSessionEventLoggingListener MDCClearFilter org.terasoluna.gfw.web.logging.mdc.MDCClearFilter MDCClearFilter /* exceptionLoggingFilter org.springframework.web.filter.DelegatingFilterProxy exceptionLoggingFilter /* XTrackMDCPutFilter org.terasoluna.gfw.web.logging.mdc.XTrackMDCPutFilter XTrackMDCPutFilter /* CharacterEncodingFilter org.springframework.web.filter.CharacterEncodingFilter encoding UTF-8 forceEncoding true CharacterEncodingFilter /* springSecurityFilterChain org.springframework.web.filter.DelegatingFilterProxy springSecurityFilterChain /* appServlet org.springframework.web.servlet.DispatcherServlet contextClass org.springframework.web.context.support.AnnotationConfigWebApplicationContext contextConfigLocation com.example.todo.config.web.SpringMvcConfig 1 appServlet / *.jsp false UTF-8 false /WEB-INF/views/common/include.jsp 500 /WEB-INF/views/common/error/systemError.jsp 404 /WEB-INF/views/common/error/resourceNotFoundError.jsp java.lang.Exception /WEB-INF/views/common/error/unhandledSystemError.html 30 true COOKIE .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 :class: longtable * - 項番 - 説明 * - | (1) - | Servlet6.0を使用するための宣言。 * - | (2) - | \ ``logbackDisableServletContainerInitializer``\ の値をtrueに設定し、Logbackの自動初期化を無効化している。 | \ ``ch.qos.logback.classic.servlet.LogbackServletContextListener``\ を登録することで、Logbackの初期化を明示的に行っている。 * - | (3) - | Webアプリケーション用のアプリケーションコンテキストをJava Configで構成するように指定する。 * - | (4) - | サーブレットコンテキストリスナーの定義。 ブランクプロジェクトでは、 * アプリケーション全体で使用される\ ``ApplicationContext``\ を作成するための\ ``ContextLoaderListener``\ * HttpSessionに対する操作をログ出力するための \ ``HttpSessionEventLoggingListener``\ が設定済みである。 * - | (5) - | サーブレットフィルタの定義。 ブランクプロジェクトでは、 * 共通ライブラリから提供しているサーブレットフィルタ * Spring Frameworkから提供されている文字エンコーディングを指定するための\ ``CharacterEncodingFilter``\ * Spring Securityから提供されている認証・認可用のサーブレットフィルタ が設定済みである。 * - | (6) - | Spring MVCのエントリポイントとなるDispatcherServletの定義。 | | DispatcherServletの中で使用する\ ``ApplicationContext``\ を、(4)で作成した\ ``ApplicationContext``\ の子として作成する。 | (4)で作成した\ ``ApplicationContext``\ を親にすることで、(4)で読み込まれたコンポーネントも使用することができる。 * - | (7) - | JSPの共通定義。 ブランクプロジェクトでは、 * JSP内でEL式が使用可能な状態 * JSPのページエンコーディングとしてUTF-8 * JSP内でスクリプティングが使用可能な状態 * 各JSPの先頭でインクルードするJSPとして、\ :file:`/WEB-INF/views/common/include.jsp`\ が設定済みである。 * - | (8) - | エラーページの定義。 ブランクプロジェクトでは、 * サーブレットコンテナにHTTPステータスコードとして、\ ``404``\ 又は\ ``500``\ が応答 * サーブレットコンテナに例外が通知 された際の遷移先が定義済みである。 * - | (9) - | セッション管理の定義。 ブランクプロジェクトでは、 * セッションタイムアウトとして、30分 が定義済みである。 .. group-tab:: Thymeleaf .. code-block:: xml logbackDisableServletContainerInitializer true contextClass org.springframework.web.context.support.AnnotationConfigWebApplicationContext ch.qos.logback.classic.servlet.LogbackServletContextListener org.springframework.web.context.ContextLoaderListener contextConfigLocation com.example.todo.config.app.ApplicationContextConfig com.example.todo.config.web.SpringSecurityConfig org.terasoluna.gfw.web.logging.HttpSessionEventLoggingListener MDCClearFilter org.terasoluna.gfw.web.logging.mdc.MDCClearFilter MDCClearFilter /* exceptionLoggingFilter org.springframework.web.filter.DelegatingFilterProxy exceptionLoggingFilter /* XTrackMDCPutFilter org.terasoluna.gfw.web.logging.mdc.XTrackMDCPutFilter XTrackMDCPutFilter /* CharacterEncodingFilter org.springframework.web.filter.CharacterEncodingFilter encoding UTF-8 forceEncoding true CharacterEncodingFilter /* springSecurityFilterChain org.springframework.web.filter.DelegatingFilterProxy springSecurityFilterChain /* appServlet org.springframework.web.servlet.DispatcherServlet contextClass org.springframework.web.context.support.AnnotationConfigWebApplicationContext contextConfigLocation com.example.todo.config.web.SpringMvcConfig 1 appServlet / 500 /common/error/systemError 404 /common/error/resourceNotFoundError java.lang.Exception /WEB-INF/views/common/error/unhandledSystemError.html 30 true COOKIE .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 :class: longtable * - 項番 - 説明 * - | (1) - | Servlet6.0を使用するための宣言。 * - | (2) - | \ ``logbackDisableServletContainerInitializer``\ の値をtrueに設定し、Logbackの自動初期化を無効化している。 | \ ``ch.qos.logback.classic.servlet.LogbackServletContextListener``\ を登録することで、Logbackの初期化を明示的に行っている。 * - | (3) - | Webアプリケーション用のアプリケーションコンテキストをJava Configで構成するように指定する。 * - | (4) - | サーブレットコンテキストリスナーの定義。 ブランクプロジェクトでは、 * アプリケーション全体で使用される\ ``ApplicationContext``\ を作成するための\ ``ContextLoaderListener``\ * HttpSessionに対する操作をログ出力するための \ ``HttpSessionEventLoggingListener``\ が設定済みである。 * - | (5) - | サーブレットフィルタの定義。 ブランクプロジェクトでは、 * 共通ライブラリから提供しているサーブレットフィルタ * Spring Frameworkから提供されている文字エンコーディングを指定するための\ ``CharacterEncodingFilter``\ * Spring Securityから提供されている認証・認可用のサーブレットフィルタ が設定済みである。 * - | (6) - | Spring MVCのエントリポイントとなるDispatcherServletの定義。 | | DispatcherServletの中で使用する\ ``ApplicationContext``\ を、(4)で作成した\ ``ApplicationContext``\ の子として作成する。 | (4)で作成した\ ``ApplicationContext``\ を親にすることで、(4)で読み込まれたコンポーネントも使用することができる。 * - | (7) - | エラーページの定義。 ブランクプロジェクトでは、 * サーブレットコンテナにHTTPステータスコードとして、\ ``404``\ 又は\ ``500``\ が応答 * サーブレットコンテナに例外が通知 された際の遷移先が定義済みである。 * - | (8) - | セッション管理の定義。 ブランクプロジェクトでは、 * セッションタイムアウトとして、30分 が定義済みである。 | .. group-tab:: XML Config .. tabs:: .. group-tab:: JSP .. code-block:: xml logbackDisableServletContainerInitializer true ch.qos.logback.classic.servlet.LogbackServletContextListener org.springframework.web.context.ContextLoaderListener contextConfigLocation classpath*:META-INF/spring/applicationContext.xml classpath*:META-INF/spring/spring-security.xml org.terasoluna.gfw.web.logging.HttpSessionEventLoggingListener MDCClearFilter org.terasoluna.gfw.web.logging.mdc.MDCClearFilter MDCClearFilter /* exceptionLoggingFilter org.springframework.web.filter.DelegatingFilterProxy exceptionLoggingFilter /* XTrackMDCPutFilter org.terasoluna.gfw.web.logging.mdc.XTrackMDCPutFilter XTrackMDCPutFilter /* CharacterEncodingFilter org.springframework.web.filter.CharacterEncodingFilter encoding UTF-8 forceEncoding true CharacterEncodingFilter /* springSecurityFilterChain org.springframework.web.filter.DelegatingFilterProxy springSecurityFilterChain /* appServlet org.springframework.web.servlet.DispatcherServlet contextConfigLocation classpath*:META-INF/spring/spring-mvc.xml 1 appServlet / *.jsp false UTF-8 false /WEB-INF/views/common/include.jsp 500 /WEB-INF/views/common/error/systemError.jsp 404 /WEB-INF/views/common/error/resourceNotFoundError.jsp java.lang.Exception /WEB-INF/views/common/error/unhandledSystemError.html 30 true COOKIE .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 :class: longtable * - 項番 - 説明 * - | (1) - | Servlet6.0を使用するための宣言。 * - | (2) - | \ ``logbackDisableServletContainerInitializer``\ の値をtrueに設定し、Logbackの自動初期化を無効化している。 | \ ``ch.qos.logback.classic.servlet.LogbackServletContextListener``\ を登録することで、Logbackの初期化を明示的に行っている。 * - | (3) - | サーブレットコンテキストリスナーの定義。 ブランクプロジェクトでは、 * アプリケーション全体で使用される\ ``ApplicationContext``\ を作成するための\ ``ContextLoaderListener``\ * HttpSessionに対する操作をログ出力するための \ ``HttpSessionEventLoggingListener``\ が設定済みである。 * - | (4) - | サーブレットフィルタの定義。 ブランクプロジェクトでは、 * 共通ライブラリから提供しているサーブレットフィルタ * Spring Frameworkから提供されている文字エンコーディングを指定するための\ ``CharacterEncodingFilter``\ * Spring Securityから提供されている認証・認可用のサーブレットフィルタ が設定済みである。 * - | (5) - | Spring MVCのエントリポイントとなるDispatcherServletの定義。 | | DispatcherServletの中で使用する\ ``ApplicationContext``\ を、(3)で作成した\ ``ApplicationContext``\ の子として作成する。 | (3)で作成した\ ``ApplicationContext``\ を親にすることで、(3)で読み込まれたコンポーネントも使用することができる。 * - | (6) - | JSPの共通定義。 ブランクプロジェクトでは、 * JSP内でEL式が使用可能な状態 * JSPのページエンコーディングとしてUTF-8 * JSP内でスクリプティングが使用可能な状態 * 各JSPの先頭でインクルードするJSPとして、\ :file:`/WEB-INF/views/common/include.jsp`\ が設定済みである。 * - | (7) - | エラーページの定義。 ブランクプロジェクトでは、 * サーブレットコンテナにHTTPステータスコードとして、\ ``404``\ 又は\ ``500``\ が応答 * サーブレットコンテナに例外が通知 された際の遷移先が定義済みである。 * - | (8) - | セッション管理の定義。 ブランクプロジェクトでは、 * セッションタイムアウトとして、30分 が定義済みである。 .. group-tab:: Thymeleaf .. code-block:: xml logbackDisableServletContainerInitializer true ch.qos.logback.classic.servlet.LogbackServletContextListener org.springframework.web.context.ContextLoaderListener contextConfigLocation classpath*:META-INF/spring/applicationContext.xml classpath*:META-INF/spring/spring-security.xml org.terasoluna.gfw.web.logging.HttpSessionEventLoggingListener MDCClearFilter org.terasoluna.gfw.web.logging.mdc.MDCClearFilter MDCClearFilter /* exceptionLoggingFilter org.springframework.web.filter.DelegatingFilterProxy exceptionLoggingFilter /* XTrackMDCPutFilter org.terasoluna.gfw.web.logging.mdc.XTrackMDCPutFilter XTrackMDCPutFilter /* CharacterEncodingFilter org.springframework.web.filter.CharacterEncodingFilter encoding UTF-8 forceEncoding true CharacterEncodingFilter /* springSecurityFilterChain org.springframework.web.filter.DelegatingFilterProxy springSecurityFilterChain /* appServlet org.springframework.web.servlet.DispatcherServlet contextConfigLocation classpath*:META-INF/spring/spring-mvc.xml 1 appServlet / 500 /common/error/systemError 404 /common/error/resourceNotFoundError java.lang.Exception /WEB-INF/views/common/error/unhandledSystemError.html 30 true COOKIE .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 :class: longtable * - 項番 - 説明 * - | (1) - | Servlet6.0を使用するための宣言。 * - | (2) - | \ ``logbackDisableServletContainerInitializer``\ の値をtrueに設定し、Logbackの自動初期化を無効化している。 | \ ``ch.qos.logback.classic.servlet.LogbackServletContextListener``\ を登録することで、Logbackの初期化を明示的に行っている。 * - | (3) - | サーブレットコンテキストリスナーの定義。 ブランクプロジェクトでは、 * アプリケーション全体で使用される\ ``ApplicationContext``\ を作成するための\ ``ContextLoaderListener``\ * HttpSessionに対する操作をログ出力するための \ ``HttpSessionEventLoggingListener``\ が設定済みである。 * - | (4) - | サーブレットフィルタの定義。 ブランクプロジェクトでは、 * 共通ライブラリから提供しているサーブレットフィルタ * Spring Frameworkから提供されている文字エンコーディングを指定するための\ ``CharacterEncodingFilter``\ * Spring Securityから提供されている認証・認可用のサーブレットフィルタ が設定済みである。 * - | (5) - | Spring MVCのエントリポイントとなるDispatcherServletの定義。 | | DispatcherServletの中で使用する\ ``ApplicationContext``\ を、(3)で作成した\ ``ApplicationContext``\ の子として作成する。 | (3)で作成した\ ``ApplicationContext``\ を親にすることで、(3)で読み込まれたコンポーネントも使用することができる。 * - | (6) - | エラーページの定義。 ブランクプロジェクトでは、 * サーブレットコンテナにHTTPステータスコードとして、\ ``404``\ 又は\ ``500``\ が応答 * サーブレットコンテナに例外が通知 された際の遷移先が定義済みである。 * - | (7) - | セッション管理の定義。 ブランクプロジェクトでは、 * セッションタイムアウトとして、30分 が定義済みである。 | Bean定義ファイル -------------------------------------------------------------------------------- 作成したブランクプロジェクトには、以下のBean定義ファイルとプロパティファイルが作成される。 .. tabs:: .. group-tab:: Java Config * \ :file:`src/main/java/com/example/todo/config/app/ApplicationContextConfig.java`\ * \ :file:`src/main/java/com/example/todo/config/app/TodoCodeListConfig.java`\ * \ :file:`src/main/java/com/example/todo/config/app/TodoDomainConfig.java`\ * \ :file:`src/main/java/com/example/todo/config/app/TodoInfraConfig.java`\ * \ :file:`src/main/resources/META-INF/spring/todo-infra.properties`\ * \ :file:`src/main/java/com/example/todo/config/app/TodoEnvConfig.java`\ * \ :file:`src/main/java/com/example/todo/config/web/SpringMvcConfig.java`\ * \ :file:`src/main/java/com/example/todo/config/web/SpringSecurityConfig.java`\ O/R Mapperに依存しないブランクプロジェクトを作成した場合は、\ ``todo-infra.properties``\ と\ ``TodoEnvConfig.java``\ は作成されない。 .. group-tab:: XML Config * \ :file:`src/main/resources/META-INF/spring/applicationContext.xml`\ * \ :file:`src/main/resources/META-INF/spring/todo-codelist.xml`\ * \ :file:`src/main/resources/META-INF/spring/todo-domain.xml`\ * \ :file:`src/main/resources/META-INF/spring/todo-infra.xml`\ * \ :file:`src/main/resources/META-INF/spring/todo-infra.properties`\ * \ :file:`src/main/resources/META-INF/spring/todo-env.xml`\ * \ :file:`src/main/resources/META-INF/spring/spring-mvc.xml`\ * \ :file:`src/main/resources/META-INF/spring/spring-security.xml`\ O/R Mapperに依存しないブランクプロジェクトを作成した場合は、\ ``todo-infra.properties``\ と\ ``todo-env.xml``\ は作成されない。 本ガイドラインでは、上記のようにBean定義ファイルを役割ごとに分割することを推奨している。 分割することで、各Bean定義ファイルの所在が明確になる。 また、保守性や可読性が向上することで設定ファイルの管理や変更が容易になるため、プロジェクト全体の品質向上につながる。 | applicationContext -------------------------------------------------------------------------------- .. tabs:: .. group-tab:: Java Config \ :file:`ApplicationContextConfig.java`\ には、Todoアプリ全体に関わる設定を行う。 | 作成したブランクプロジェクトの\ :file:`src/main/java/com/example/todo/config/app/ApplicationContextConfig.java`\ は、以下のような設定となっている。 .. code-block:: java package com.example.todo.config.app; import java.util.HashMap; import java.util.LinkedHashMap; import java.util.Map; import org.springframework.beans.factory.annotation.Value; import org.springframework.context.MessageSource; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; import org.springframework.context.annotation.EnableAspectJAutoProxy; import org.springframework.context.annotation.Import; import org.springframework.context.support.PropertySourcesPlaceholderConfigurer; import org.springframework.context.support.ResourceBundleMessageSource; import org.springframework.core.io.Resource; import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder; import org.springframework.security.crypto.password.DelegatingPasswordEncoder; import org.springframework.security.crypto.password.PasswordEncoder; import org.springframework.security.crypto.password.Pbkdf2PasswordEncoder; import org.terasoluna.gfw.common.exception.ExceptionCodeResolver; import org.terasoluna.gfw.common.exception.ExceptionLogger; import org.terasoluna.gfw.common.exception.SimpleMappingExceptionCodeResolver; import org.terasoluna.gfw.web.exception.ExceptionLoggingFilter; /** * Application context. */ @Configuration @EnableAspectJAutoProxy @Import({TodoDomainConfig.class}) // (1) public class ApplicationContextConfig { /** * Configure {@link PasswordEncoder} bean. * @return Bean of configured {@link DelegatingPasswordEncoder} */ @Bean("passwordEncoder") public PasswordEncoder passwordEncoder() { Map idToPasswordEncoder = new HashMap<>(); idToPasswordEncoder.put("pbkdf2", pbkdf2PasswordEncoder()); idToPasswordEncoder.put("bcrypt", bCryptPasswordEncoder()); /* When using commented out PasswordEncoders, you need to add bcprov-jdk18on.jar to the dependency. idToPasswordEncoder.put("argon2", argon2PasswordEncoder()); idToPasswordEncoder.put("scrypt", sCryptPasswordEncoder()); */ return new DelegatingPasswordEncoder("pbkdf2", idToPasswordEncoder); } /** * Configure {@link Pbkdf2PasswordEncoder} bean. * @return Bean of configured {@link Pbkdf2PasswordEncoder} */ @Bean public Pbkdf2PasswordEncoder pbkdf2PasswordEncoder() { return Pbkdf2PasswordEncoder.defaultsForSpringSecurity_v5_8(); } /** * Configure {@link BCryptPasswordEncoder} bean. * @return Bean of configured {@link BCryptPasswordEncoder} */ @Bean public BCryptPasswordEncoder bCryptPasswordEncoder() { return new BCryptPasswordEncoder(); } /* When using commented out PasswordEncoders, you need to add bcprov-jdk18on.jar to the dependency. @Bean public Argon2PasswordEncoder argon2PasswordEncoder() { return Argon2PasswordEncoder.defaultsForSpringSecurity_v5_8(); } @Bean public SCryptPasswordEncoder sCryptPasswordEncoder() { return SCryptPasswordEncoder.defaultsForSpringSecurity_v5_8(); } */ /** * Configure {@link PropertySourcesPlaceholderConfigurer} bean. * @param properties Property files to be read * @return Bean of configured {@link PropertySourcesPlaceholderConfigurer} */ // (2) @Bean public static PropertySourcesPlaceholderConfigurer propertySourcesPlaceholderConfigurer( @Value("classpath*:/META-INF/spring/*.properties") Resource... properties) { PropertySourcesPlaceholderConfigurer bean = new PropertySourcesPlaceholderConfigurer(); bean.setLocations(properties); return bean; } /** * Configure {@link MessageSource} bean. * @return Bean of configured {@link ResourceBundleMessageSource} */ @Bean("messageSource") public MessageSource messageSource() { ResourceBundleMessageSource bean = new ResourceBundleMessageSource(); bean.setBasenames("i18n/application-messages"); return bean; } /** * Configure {@link ExceptionCodeResolver} bean. * @return Bean of configured {@link SimpleMappingExceptionCodeResolver} */ @Bean("exceptionCodeResolver") public ExceptionCodeResolver exceptionCodeResolver() { LinkedHashMap map = new LinkedHashMap<>(); map.put("ResourceNotFoundException", "e.xx.fw.5001"); map.put("InvalidTransactionTokenException", "e.xx.fw.7001"); map.put("BusinessException", "e.xx.fw.8001"); map.put(".DataAccessException", "e.xx.fw.9002"); SimpleMappingExceptionCodeResolver bean = new SimpleMappingExceptionCodeResolver(); bean.setExceptionMappings(map); bean.setDefaultExceptionCode("e.xx.fw.9001"); return bean; } /** * Configure {@link ExceptionLogger} bean. * @return Bean of configured {@link ExceptionLogger} */ @Bean("exceptionLogger") public ExceptionLogger exceptionLogger() { ExceptionLogger bean = new ExceptionLogger(); bean.setExceptionCodeResolver(exceptionCodeResolver()); return bean; } /** * Configure {@link ExceptionLoggingFilter} bean. * @return Bean of configured {@link ExceptionLoggingFilter} */ @Bean("exceptionLoggingFilter") public ExceptionLoggingFilter exceptionLoggingFilter() { ExceptionLoggingFilter bean = new ExceptionLoggingFilter(); bean.setExceptionLogger(exceptionLogger()); return bean; } } .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 * - 項番 - 説明 * - | (1) - | ドメイン層に関するBean定義ファイルをimportする。 * - | (2) - | プロパティファイルの読み込み設定を行う。 | \ ``src/main/resources/META-INF/spring``\ 直下の任意のプロパティファイルを読み込む。 | この設定により、プロパティファイルの値をBean定義ファイル内で\ ``${propertyName}``\ 形式で埋め込んだり、Javaクラスに\ ``@Value("${propertyName}")``\ でインジェクションすることができる。 .. group-tab:: XML Config \ :file:`applicationContext.xml`\ には、Todoアプリ全体に関わる設定を行う。 | 作成したブランクプロジェクトの\ :file:`src/main/resources/META-INF/spring/applicationContext.xml`\ は、以下のような設定となっている。 .. code-block:: xml i18n/application-messages .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 * - 項番 - 説明 * - | (1) - | ドメイン層に関するBean定義ファイルをimportする。 * - | (2) - | プロパティファイルの読み込み設定を行う。 | \ ``src/main/resources/META-INF/spring``\ 直下の任意のプロパティファイルを読み込む。 | この設定により、プロパティファイルの値をBean定義ファイル内で\ ``${propertyName}``\ 形式で埋め込んだり、Javaクラスに\ ``@Value("${propertyName}")``\ でインジェクションすることができる。 | [artifactId]-domain -------------------------------------------------------------------------------- .. tabs:: .. group-tab:: Java Config \ :file:`TodoDomainConfig.java`\ には、Todoアプリのドメイン層に関わる設定を行う。 | 作成したブランクプロジェクトの\ :file:`src/main/java/com/example/todo/config/app/TodoDomainConfig.java`\ は、以下のような設定となっている。 .. code-block:: java package com.example.todo.config.app; import org.springframework.aop.Advisor; import org.springframework.aop.aspectj.AspectJExpressionPointcut; import org.springframework.aop.support.DefaultPointcutAdvisor; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.ComponentScan; import org.springframework.context.annotation.Configuration; import org.springframework.context.annotation.Import; import org.terasoluna.gfw.common.exception.ExceptionLogger; import org.terasoluna.gfw.common.exception.ResultMessagesLoggingInterceptor; /** * Bean definitions for domain layer. */ @Configuration @ComponentScan(basePackages = {"com.example.todo.domain"}) // (1) @Import({TodoInfraConfig.class, TodoCodeListConfig.class}) // (2) public class TodoDomainConfig { /** * Configure {@link ResultMessagesLoggingInterceptor} bean. * @param exceptionLogger Bean defined by ApplicationContextConfig#exceptionLogger * @see com.example.todo.config.app.ApplicationContextConfig#exceptionLogger() * @return Bean of configured {@link ResultMessagesLoggingInterceptor} */ @Bean("resultMessagesLoggingInterceptor") public ResultMessagesLoggingInterceptor resultMessagesLoggingInterceptor( ExceptionLogger exceptionLogger) { ResultMessagesLoggingInterceptor bean = new ResultMessagesLoggingInterceptor(); bean.setExceptionLogger(exceptionLogger); return bean; } /** * Configure messages logging AOP advisor. * @param resultMessagesLoggingInterceptor Bean defined by #resultMessagesLoggingInterceptor * @see #resultMessagesLoggingInterceptor(ExceptionLogger) * @return Advisor configured for PointCut */ @Bean public Advisor resultMessagesLoggingInterceptorAdvisor( ResultMessagesLoggingInterceptor resultMessagesLoggingInterceptor) { AspectJExpressionPointcut pointcut = new AspectJExpressionPointcut(); pointcut.setExpression("@within(org.springframework.stereotype.Service)"); return new DefaultPointcutAdvisor(pointcut, resultMessagesLoggingInterceptor); } } .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 * - 項番 - 説明 * - | (1) - | ドメイン層のクラスを管理するcom.example.todo.domainパッケージ配下をcomponent-scan対象とする。 | これにより、com.example.todo.domainパッケージ配下のクラスに ``@Repository`` , ``@Service`` などのアノテーションを付けることで、Spring Framerowkが管理するBeanとして登録される。 | 登録されたクラス(Bean)は、ControllerやServiceクラスにDIする事で、利用する事が出来る。 * - | (2) - | インフラストラクチャ層に関するBean定義ファイルをimportする。 O/R Mapperに依存するブランクプロジェクトを作成した場合は、\ ``@Transactional``\ アノテーションによるトランザクション管理を有効にするために、\ ``@EnableTransactionManagement``\ アノテーションが設定されている。 .. code-block:: java @EnableTransactionManagement .. group-tab:: XML Config \ :file:`todo-domain.xml`\ には、Todoアプリのドメイン層に関わる設定を行う。 | 作成したブランクプロジェクトの\ :file:`src/main/resources/META-INF/spring/todo-domain.xml`\ は、以下のような設定となっている。 .. code-block:: xml .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 * - 項番 - 説明 * - | (1) - | インフラストラクチャ層に関するBean定義ファイルをimportする。 * - | (2) - | ドメイン層のクラスを管理するcom.example.todo.domainパッケージ配下をcomponent-scan対象とする。 | これにより、com.example.todo.domainパッケージ配下のクラスに\ ``@Repository``\ ,\ ``@Service``\ などのアノテーションを付けることで、Spring Framerowkが管理するBeanとして登録される。 | 登録されたクラス(Bean)は、ControllerやServiceクラスにDIする事で、利用する事が出来る。 O/R Mapperに依存するブランクプロジェクトを作成した場合は、\ ``@Transactional``\ アノテーションによるトランザクション管理を有効にするために、\ ````\ タグが設定されている。 .. code-block:: xml | [artifactId]-infra -------------------------------------------------------------------------------- .. tabs:: .. group-tab:: Java Config \ :file:`TodoInfraConfig.java`\ には、Todoアプリのインフラストラクチャ層に関わる設定を行う。 作成したブランクプロジェクトの\ :file:`src/main/java/com/example/todo/config/app/TodoInfraConfig.java`\ は、以下のような設定となっている。 \ :file:`TodoInfraConfig.java`\は、インフラストラクチャ層によって設定が大きく異なるため、ブランクプロジェクト毎に説明を行う。作成したブランクプロジェクト以外の説明は読み飛ばしてもよい。 .. group-tab:: XML Config \ :file:`todo-infra.xml`\ には、Todoアプリのインフラストラクチャ層に関わる設定を行う。 作成したブランクプロジェクトの\ :file:`src/main/resources/META-INF/spring/todo-infra.xml`\ は、以下のような設定となっている。 \ :file:`todo-infra.xml`\は、インフラストラクチャ層によって設定が大きく異なるため、ブランクプロジェクト毎に説明を行う。作成したブランクプロジェクト以外の説明は読み飛ばしてもよい。 | O/R Mapperに依存しないブランクプロジェクトを作成した場合の[artifactId]-infra ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ O/R Mapperに依存しないブランクプロジェクトを作成した場合、以下のように空定義のファイルが作成される。 .. tabs:: .. group-tab:: Java Config .. code-block:: java package com.example.todo.config.app; import org.springframework.context.annotation.Configuration; /** * Bean definitions for infrastructure layer. */ @Configuration public class TodoInfraConfig { } .. group-tab:: XML Config .. code-block:: xml | MyBatis3用のブランクプロジェクトを作成した場合の[artifactId]-infra ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ MyBatis3用のブランクプロジェクトを作成した場合、以下のような設定となっている。 .. tabs:: .. group-tab:: Java Config .. code-block:: java package com.example.todo.config.app; import javax.sql.DataSource; import org.mybatis.spring.SqlSessionFactoryBean; import org.mybatis.spring.annotation.MapperScan; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; import org.springframework.context.annotation.Import; import com.example.todo.config.app.mybatis.MybatisConfig; /** * Bean definitions for infrastructure layer. */ @Configuration @MapperScan("com.example.todo.domain.repository") // (1) @Import({TodoEnvConfig.class}) // (2) public class TodoInfraConfig { /** * Configure {@link SqlSessionFactoryBean} bean. * @param dataSource DataSource * @see com.example.todo.config.app.TodoEnvConfig#dataSource() * @return Bean of configured {@link SqlSessionFactoryBean} */ // (3) @Bean("sqlSessionFactory") public SqlSessionFactoryBean sqlSessionFactory(DataSource dataSource) { SqlSessionFactoryBean bean = new SqlSessionFactoryBean(); // (4) bean.setDataSource(dataSource); // (5) bean.setConfiguration(MybatisConfig.configuration()); return bean; } } .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 * - 項番 - 説明 * - | (1) - | Mapperインタフェースをスキャンするために\ ``@MapperScan``\ を定義し、Mapperインタフェースが格納されている基底パッケージを指定する。 | * - | (2) - | 環境依存するコンポーネント(データソースやトランザクションマネージャなど)を定義するBean定義ファイルをimportする。 | | 指定されたパッケージ配下に格納されている Mapperインタフェースがスキャンされ、スレッドセーフなMapperオブジェクト(MapperインタフェースのProxyオブジェクト)が自動的に生成される。 | * - | (3) - | \ ``SqlSessionFactory``\ を生成するためのコンポーネントとして、\ ``SqlSessionFactoryBean``\ をbean定義する。 | * - | (4) - | \ ``dataSource``\ プロパティに、設定済みのデータソースのbeanを指定する。 | | MyBatis3の処理の中でSQLを発行する際は、ここで指定したデータソースからコネクションが取得される。 * - | (5) - | \ ``configuration``\ プロパティに、MyBatisの設定をしたConfigurationクラスを指定する。 | | ここで指定したクラスは\ ``SqlSessionFactory``\ を生成する時に読み込まれる。 .. group-tab:: XML Config .. code-block:: xml .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 * - 項番 - 説明 * - | (1) - | 環境依存するコンポーネント(データソースやトランザクションマネージャなど)を定義するBean定義ファイルをimportする。 * - | (2) - | \ ``SqlSessionFactory``\ を生成するためのコンポーネントとして、\ ``SqlSessionFactoryBean``\ をbean定義する。 * - | (3) - | \ ``dataSource``\ プロパティに、設定済みのデータソースのbeanを指定する。 | | MyBatis3の処理の中でSQLを発行する際は、ここで指定したデータソースからコネクションが取得される。 * - | (4) - | \ ``configLocation``\ プロパティに、MyBatis設定ファイルのパスを指定する。 | | ここで指定したファイルは\ ``SqlSessionFactory``\ を生成する時に読み込まれる。 * - | (5) - | Mapperインタフェースをスキャンするために\ ````\ を定義し、\ ``base-package``\ 属性には、Mapperインタフェースが格納されている基底パッケージを指定する。 | | 指定されたパッケージ配下に格納されている Mapperインタフェースがスキャンされ、スレッドセーフなMapperオブジェクト(MapperインタフェースのProxyオブジェクト)が自動的に生成される。 .. note:: \ :file:`mybatis-config.xml`\ は、MyBatis3自体の動作設定を行う設定ファイルである。 ブランクプロジェクトでは、デフォルトで以下の設定が行われている。 .. code-block:: xml | .. _BlankProjectInfraProperties: [artifactId]-infra.properties -------------------------------------------------------------------------------- \ :file:`todo-infra.properties`\ には、Todoアプリのインフラストラクチャ層における環境依存値の設定を行う。 O/R Mapperに依存しないブランクプロジェクトを作成した際は、\ :file:`todo-infra.properties`\ は作成されない。 作成したブランクプロジェクトの\ :file:`src/main/resources/META-INF/spring/todo-infra.properties`\ は、以下のような設定となっている。 .. code-block:: properties # (1) database=H2 database.url=jdbc:h2:mem:todo;DB_CLOSE_DELAY=-1 database.username=sa database.password= database.driverClassName=org.h2.Driver # (2) # connection pool cp.maxActive=96 cp.maxIdle=16 cp.minIdle=0 cp.maxWait=60000 .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 * - 項番 - 説明 * - | (1) - | データベースに関する設定を行う。 | 本章では、データベースのセットアップの手間を省くため、H2 Databaseを使用する。 * - | (2) - | コネクションプールに関する設定。 これらの設定値は、\ :file:`todo-env.xml`\ または\ :file:`TodoEnvConfig.java`\ から参照されている。 [artifactId]-env -------------------------------------------------------------------------------- .. tabs:: .. group-tab:: Java Config \ :file:`TodoEnvConfig.java`\ には、デプロイする環境によって設定が異なるコンポーネントの設定を行う。 作成したブランクプロジェクトの\ ``src/main/java/com/example/todo/config/app/TodoEnvConfig.java``\ は、以下のような設定となっている。 ここでは、MyBatis3用のブランクプロジェクトに格納されるファイルを例に説明する。なお、データベースにアクセスしないブランクプロジェクトを作成した際は、\ :file:`TodoEnvConfig.java`\ は作成されない。 .. code-block:: java package com.example.todo.config.app; import java.time.Duration; import javax.sql.DataSource; import org.apache.commons.dbcp2.BasicDataSource; import org.springframework.beans.factory.annotation.Value; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; import org.springframework.core.io.ClassPathResource; import org.springframework.jdbc.datasource.DataSourceTransactionManager; import org.springframework.jdbc.datasource.init.DataSourceInitializer; import org.springframework.jdbc.datasource.init.ResourceDatabasePopulator; import org.springframework.transaction.TransactionManager; import org.terasoluna.gfw.common.time.ClockFactory; import org.terasoluna.gfw.common.time.DefaultClockFactory; /** * Define settings for the environment. */ @Configuration public class TodoEnvConfig { /** * DataSource.driverClassName property. */ @Value("${database.driverClassName}") private String driverClassName; /** * DataSource.url property. */ @Value("${database.url}") private String url; /** * DataSource.username property. */ @Value("${database.username}") private String username; /** * DataSource.password property. */ @Value("${database.password}") private String password; /** * DataSource.maxTotal property. */ @Value("${cp.maxActive}") private Integer maxActive; /** * DataSource.maxIdle property. */ @Value("${cp.maxIdle}") private Integer maxIdle; /** * DataSource.minIdle property. */ @Value("${cp.minIdle}") private Integer minIdle; /** * DataSource.maxWaitMillis property. */ @Value("${cp.maxWait}") private Integer maxWait; /** * Property databaseName. */ @Value("${database}") private String database; /** * Configure {@link ClockFactory}. * @return Bean of configured {@link DefaultClockFactory} */ @Bean("dateFactory") public ClockFactory dateFactory() { return new DefaultClockFactory(); } /** * Configure {@link DataSource} bean. * @return Bean of configured {@link BasicDataSource} */ // (1) @Bean(name = "dataSource", destroyMethod = "close") public DataSource dataSource() { BasicDataSource bean = new BasicDataSource(); bean.setDriverClassName(driverClassName); bean.setUrl(url); bean.setUsername(username); bean.setPassword(password); bean.setDefaultAutoCommit(false); bean.setMaxTotal(maxActive); bean.setMaxIdle(maxIdle); bean.setMinIdle(minIdle); bean.setMaxWait(Duration.ofMillis(maxWait)); return bean; } /** * Configuration to set up database during initialization. * @param dataSource DataSource to be initialized * @return Bean of configured {@link DataSourceInitializer} */ // (2) @Bean public DataSourceInitializer dataSourceInitializer(DataSource dataSource) { DataSourceInitializer bean = new DataSourceInitializer(); bean.setDataSource(dataSource); // (3) ResourceDatabasePopulator databasePopulator = new ResourceDatabasePopulator(); databasePopulator.addScript(new ClassPathResource("/database/" + database + "-schema.sql")); databasePopulator .addScript(new ClassPathResource("/database/" + database + "-dataload.sql")); databasePopulator.setSqlScriptEncoding("UTF-8"); databasePopulator.setIgnoreFailedDrops(true); bean.setDatabasePopulator(databasePopulator); return bean; } // @formatter:off /** * Configure {@link TransactionManager} bean. * @param dataSource DataSource used for transaction management * @return Bean of configured {@link DataSourceTransactionManager} */ // (4) @Bean("transactionManager") public TransactionManager transactionManager(DataSource dataSource) { DataSourceTransactionManager bean = new DataSourceTransactionManager(); bean.setDataSource(dataSource); bean.setRollbackOnCommitFailure(true); return bean; } // @formatter:on } .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 * - 項番 - 説明 * - | (1) - | 実データソースの設定。 * - | (2) - | データベース初期化の設定。 | データベースを初期化するSQLファイルを実行するための設定を行っている。 | | この設定は通常、開発中のみでしか使用しない(環境に依存する設定)ため、\ ``TodoEnvConfig.java`` \ に定義されている。 * - | (3) - | データベースを初期化するSQLファイルの設定。 | データベースを初期化するための、DDL文が記載されているSQLファイルとDML文が記載されているSQLファイルを指定している。 | | ブランクプロジェクトの設定では\ ``todo-infra.properties``\ に\ ``database=H2``\ と定義されているため、\ ``H2-schema.sql``\ 及び\ ``H2-dataload.sql``\ が実行される。 * - | (4) - | トランザクションマネージャの設定。 | id属性には、\ ``transactionManager``\ を指定する。 | | ブランクプロジェクトでは、JDBCのAPIを使用してトランザクションを制御するクラス(\ ``org.springframework.jdbc.datasource.DataSourceTransactionManager``\ )が設定されている。 .. group-tab:: XML Config \ :file:`todo-env.xml`\ には、デプロイする環境によって設定が異なるコンポーネントの設定を行う。 作成したブランクプロジェクトの\ ``src/main/resources/META-INF/spring/todo-env.xml``\ は、以下のような設定となっている。 ここでは、MyBatis3用のブランクプロジェクトに格納されるファイルを例に説明する。なお、データベースにアクセスしないブランクプロジェクトを作成した際は、\ :file:`todo-env.xml`\ は作成されない。 .. code-block:: xml .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 * - 項番 - 説明 * - | (1) - | 実データソースの設定。 * - | (2) - | データベース初期化の設定。 | データベースを初期化するSQLファイルを実行するための設定を行っている。 | | この設定は通常、開発中のみでしか使用しない(環境に依存する設定)ため、\ ``todo-env.xml``\ に定義されている。 * - | (3) - | データベースを初期化するSQLファイルの設定。 | データベースを初期化するための、DDL文が記載されているSQLファイルとDML文が記載されているSQLファイルを指定している。 | | ブランクプロジェクトの設定では\ ``todo-infra.properties``\ に\ ``database=H2``\ と定義されているため、\ ``H2-schema.sql``\ 及び\ ``H2-dataload.sql``\ が実行される。 * - | (4) - | トランザクションマネージャの設定。 | id属性には、\ ``transactionManager``\ を指定する。 | 別の名前を指定する場合は、\ ````\ タグにもトランザクションマネージャ名を指定する必要がある。 | | ブランクプロジェクトでは、JDBCのAPIを使用してトランザクションを制御するクラス(\ ``org.springframework.jdbc.datasource.DataSourceTransactionManager``\ )が設定されている。 | spring-mvc -------------------------------------------------------------------------------- .. tabs:: .. group-tab:: Java Config \ :file:`SpringMvcConfig.java`\ には、Spring MVCに関する定義を行う。 | 作成したブランクプロジェクトの\ :file:`src/main/java/com/example/todo/config/web/SpringMvcConfig.java`\ は、以下のような設定となっている。 .. tabs:: .. group-tab:: JSP .. code-block:: java package com.example.todo.config.web; import java.util.List; import java.util.Properties; import java.util.regex.Pattern; import org.springframework.aop.Advisor; import org.springframework.aop.aspectj.AspectJExpressionPointcut; import org.springframework.aop.support.DefaultPointcutAdvisor; import org.springframework.beans.factory.annotation.Value; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.ComponentScan; import org.springframework.context.annotation.Configuration; import org.springframework.context.annotation.EnableAspectJAutoProxy; import org.springframework.context.support.PropertySourcesPlaceholderConfigurer; import org.springframework.core.io.Resource; import org.springframework.data.web.PageableHandlerMethodArgumentResolver; import org.springframework.http.HttpStatus; import org.springframework.security.web.method.annotation.AuthenticationPrincipalArgumentResolver; import org.springframework.security.web.servlet.support.csrf.CsrfRequestDataValueProcessor; import org.springframework.web.method.support.HandlerMethodArgumentResolver; import org.springframework.web.servlet.HandlerInterceptor; import org.springframework.web.servlet.config.annotation.DefaultServletHandlerConfigurer; import org.springframework.web.servlet.config.annotation.EnableWebMvc; import org.springframework.web.servlet.config.annotation.InterceptorRegistry; import org.springframework.web.servlet.config.annotation.ResourceHandlerRegistry; import org.springframework.web.servlet.config.annotation.ViewResolverRegistry; import org.springframework.web.servlet.config.annotation.WebMvcConfigurer; import org.springframework.web.servlet.support.RequestDataValueProcessor; import org.terasoluna.gfw.common.exception.ExceptionCodeResolver; import org.terasoluna.gfw.common.exception.ExceptionLogger; import org.terasoluna.gfw.web.codelist.CodeListInterceptor; import org.terasoluna.gfw.web.exception.HandlerExceptionResolverLoggingInterceptor; import org.terasoluna.gfw.web.exception.SystemExceptionResolver; import org.terasoluna.gfw.web.logging.TraceLoggingInterceptor; import org.terasoluna.gfw.web.mvc.support.CompositeRequestDataValueProcessor; import org.terasoluna.gfw.web.token.transaction.TransactionTokenInterceptor; import org.terasoluna.gfw.web.token.transaction.TransactionTokenRequestDataValueProcessor; /** * Configure SpringMVC. */ @ComponentScan(basePackages = {"com.example.todo.app"}) // (1) @EnableAspectJAutoProxy @EnableWebMvc // (7) @Configuration public class SpringMvcConfig implements WebMvcConfigurer { /** * Configure {@link PropertySourcesPlaceholderConfigurer} bean. * @param properties Property files to be read * @return Bean of configured {@link PropertySourcesPlaceholderConfigurer} */ // (2) @Bean public static PropertySourcesPlaceholderConfigurer propertySourcesPlaceholderConfigurer( @Value("classpath*:/META-INF/spring/*.properties") Resource... properties) { PropertySourcesPlaceholderConfigurer bean = new PropertySourcesPlaceholderConfigurer(); bean.setLocations(properties); return bean; } /** * {@inheritDoc} */ // (3) @Override public void addArgumentResolvers(List argumentResolvers) { argumentResolvers.add(pageableHandlerMethodArgumentResolver()); argumentResolvers.add(authenticationPrincipalArgumentResolver()); } /** * Configure {@link PageableHandlerMethodArgumentResolver} bean. * @return Bean of configured {@link PageableHandlerMethodArgumentResolver} */ @Bean public PageableHandlerMethodArgumentResolver pageableHandlerMethodArgumentResolver() { return new PageableHandlerMethodArgumentResolver(); } /** * Configure {@link AuthenticationPrincipalArgumentResolver} bean. * @return Bean of configured {@link AuthenticationPrincipalArgumentResolver} */ @Bean public AuthenticationPrincipalArgumentResolver authenticationPrincipalArgumentResolver() { return new AuthenticationPrincipalArgumentResolver(); } /** * {@inheritDoc} */ @Override public void configureDefaultServletHandling(DefaultServletHandlerConfigurer configurer) { configurer.enable(); } /** * {@inheritDoc} */ // (4) @Override public void addResourceHandlers(final ResourceHandlerRegistry registry) { registry.addResourceHandler("/resources/**") .addResourceLocations("/resources/", "classpath:META-INF/resources/") .setCachePeriod(60 * 60); } /** * {@inheritDoc} */ // (5) @Override public void addInterceptors(InterceptorRegistry registry) { addInterceptor(registry, traceLoggingInterceptor()); addInterceptor(registry, transactionTokenInterceptor()); addInterceptor(registry, codeListInterceptor()); } /** * Common processes used in #addInterceptors. * @param registry {@link InterceptorRegistry} * @param interceptor {@link HandlerInterceptor} */ private void addInterceptor(InterceptorRegistry registry, HandlerInterceptor interceptor) { registry.addInterceptor(interceptor).addPathPatterns("/**") .excludePathPatterns("/resources/**"); } /** * Configure {@link TraceLoggingInterceptor} bean. * @return Bean of configured {@link TraceLoggingInterceptor} */ @Bean public TraceLoggingInterceptor traceLoggingInterceptor() { return new TraceLoggingInterceptor(); } /** * Configure {@link TransactionTokenInterceptor} bean. * @return Bean of configured {@link TransactionTokenInterceptor} */ @Bean public TransactionTokenInterceptor transactionTokenInterceptor() { return new TransactionTokenInterceptor(); } /** * Configure {@link CodeListInterceptor} bean. * @return Bean of configured {@link CodeListInterceptor} */ @Bean public CodeListInterceptor codeListInterceptor() { CodeListInterceptor codeListInterceptor = new CodeListInterceptor(); codeListInterceptor.setCodeListIdPattern(Pattern.compile("CL_.+")); return codeListInterceptor; } /** * {@inheritDoc} */ // (6) @Override public void configureViewResolvers(ViewResolverRegistry registry) { registry.beanName(); registry.jsp("/WEB-INF/views/", ".jsp"); } /** * Configure {@link RequestDataValueProcessor} bean. * @return Bean of configured {@link CompositeRequestDataValueProcessor} */ @Bean("requestDataValueProcessor") public RequestDataValueProcessor requestDataValueProcessor() { return new CompositeRequestDataValueProcessor(csrfRequestDataValueProcessor(), transactionTokenRequestDataValueProcessor()); } /** * Configure {@link CsrfRequestDataValueProcessor} bean. * @return Bean of configured {@link CsrfRequestDataValueProcessor} */ @Bean public CsrfRequestDataValueProcessor csrfRequestDataValueProcessor() { return new CsrfRequestDataValueProcessor(); } /** * Configure {@link TransactionTokenRequestDataValueProcessor} bean. * @return Bean of configured {@link TransactionTokenRequestDataValueProcessor} */ @Bean public TransactionTokenRequestDataValueProcessor transactionTokenRequestDataValueProcessor() { return new TransactionTokenRequestDataValueProcessor(); } /** * Configure {@link SystemExceptionResolver} bean. * @param exceptionCodeResolver Bean defined by ApplicationContextConfig#exceptionCodeResolver * @see com.example.todo.config.app.ApplicationContextConfig#exceptionCodeResolver() * @return Bean of configured {@link SystemExceptionResolver} */ @Bean("systemExceptionResolver") public SystemExceptionResolver systemExceptionResolver( ExceptionCodeResolver exceptionCodeResolver) { SystemExceptionResolver bean = new SystemExceptionResolver(); bean.setExceptionCodeResolver(exceptionCodeResolver); bean.setOrder(3); Properties exceptionMappings = new Properties(); exceptionMappings.setProperty("ResourceNotFoundException", "common/error/resourceNotFoundError"); exceptionMappings.setProperty("BusinessException", "common/error/businessError"); exceptionMappings.setProperty("InvalidTransactionTokenException", "common/error/transactionTokenError"); exceptionMappings.setProperty(".DataAccessException", "common/error/dataAccessError"); bean.setExceptionMappings(exceptionMappings); Properties statusCodes = new Properties(); statusCodes.setProperty("common/error/resourceNotFoundError", String.valueOf(HttpStatus.NOT_FOUND.value())); statusCodes.setProperty("common/error/businessError", String.valueOf(HttpStatus.CONFLICT.value())); statusCodes.setProperty("common/error/transactionTokenError", String.valueOf(HttpStatus.CONFLICT.value())); statusCodes.setProperty("common/error/dataAccessError", String.valueOf(HttpStatus.INTERNAL_SERVER_ERROR.value())); bean.setStatusCodes(statusCodes); bean.setDefaultErrorView("common/error/systemError"); bean.setDefaultStatusCode(HttpStatus.INTERNAL_SERVER_ERROR.value()); return bean; } /** * Configure messages logging AOP. * @param exceptionLogger Bean defined by ApplicationContextConfig#exceptionLogger * @see com.example.todo.config.app.ApplicationContextConfig#exceptionLogger() * @return Bean of configured {@link HandlerExceptionResolverLoggingInterceptor} */ @Bean("handlerExceptionResolverLoggingInterceptor") public HandlerExceptionResolverLoggingInterceptor handlerExceptionResolverLoggingInterceptor( ExceptionLogger exceptionLogger) { HandlerExceptionResolverLoggingInterceptor bean = new HandlerExceptionResolverLoggingInterceptor(); bean.setExceptionLogger(exceptionLogger); return bean; } /** * Configure messages logging AOP advisor. * @param handlerExceptionResolverLoggingInterceptor Bean defined by * #handlerExceptionResolverLoggingInterceptor * @see #handlerExceptionResolverLoggingInterceptor(ExceptionLogger) * @return Advisor configured for PointCut */ @Bean public Advisor handlerExceptionResolverLoggingInterceptorAdvisor( HandlerExceptionResolverLoggingInterceptor handlerExceptionResolverLoggingInterceptor) { AspectJExpressionPointcut pointcut = new AspectJExpressionPointcut(); pointcut.setExpression( "execution(* org.springframework.web.servlet.HandlerExceptionResolver.resolveException(..))"); return new DefaultPointcutAdvisor(pointcut, handlerExceptionResolverLoggingInterceptor); } } .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 :class: longtable * - 項番 - 説明 * - | (1) - | Spring MVCで使用するコンポーネントを探すパッケージを定義する。 | アプリケーション層のクラスを管理するcom.example.todo.appパッケージ配下をcomponent-scan対象とする。 * - | (2) - | プロパティファイルの読み込み設定を行う。 | src/main/resources/META-INF/spring直下の任意のプロパティファイルを読み込む。 | この設定により、プロパティファイルの値をBean定義ファイル内で\ ``${propertyName}``\ 形式で埋め込んだり、Javaクラスに\ ``@Value("${propertyName}")``\ でインジェクションすることができる。 * - | (3) - | Spring MVCのアノテーションベースのデフォルト設定を行う。 * - | (4) - | 静的リソース(css, images, jsなど)アクセスのための設定を行う。 | \ ``mapping``\ 属性にURLのパスを、\ ``location``\ 属性に物理的なパスの設定を行う。 | この設定の場合\ ``/resources/app/css/styles.css``\ に対してリクエストが来た場合、\ ``WEB-INF/resources/app/css/styles.css``\ を探し、見つからなければクラスパス上(\ ``src/main/resources``\ やjar内)の\ ``META-INF/resources/app/css/styles.css``\ を探す。 | どこにも\ ``styles.css``\ が格納されていない場合は、404エラーを返す。 | ここでは\ ``cache-period``\ 属性で静的リソースのキャッシュ時間(3600秒=60分)も設定している。 | \ ``cache-period="3600"``\ と設定しても良いが、60分であることを明示するために\ :url_spring_reference:`SpEL `\ を使用して\ ``cache-period="#{60 * 60}"``\ と書く方が分かりやすい。 * - | (5) - | コントローラ処理のTraceログを出力するインターセプタを設定する。 | \ ``/resources``\ 配下を除く任意のパスに適用されるように設定する。 * - | (6) - | \ ``registry.beanName()``\ については、\ :ref:`viewresolver-label` \ を参照されたい。 | \ ``registry.jsp("/WEB-INF/views/", ".jsp")``\ により、JSP用の\ ``ViewResolver``\ を指定し、JSPファイルの配置場所を定義する。 | この設定により、例えばコントローラからView名として\ ``hello``\ が返却された場合には\ ``/WEB-INF/views/hello.jsp``\ が実行される。 * - | (7) - | \ ``@EnableWebMvc``\ アノテーションを定義することにより、Spring MVCのデフォルト設定が行われる。デフォルトの設定については、\ :url_spring_reference:`Spring Framework Documentation -Enable MVC Configuration- `\ を参照されたい。 .. group-tab:: Thymeleaf .. code-block:: java package com.example.todo.config.web; import java.util.HashSet; import java.util.List; import java.util.Properties; import java.util.Set; import java.util.regex.Pattern; import org.springframework.aop.Advisor; import org.springframework.aop.aspectj.AspectJExpressionPointcut; import org.springframework.aop.support.DefaultPointcutAdvisor; import org.springframework.beans.factory.annotation.Value; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.ComponentScan; import org.springframework.context.annotation.Configuration; import org.springframework.context.annotation.EnableAspectJAutoProxy; import org.springframework.context.support.PropertySourcesPlaceholderConfigurer; import org.springframework.core.io.Resource; import org.springframework.data.web.PageableHandlerMethodArgumentResolver; import org.springframework.http.HttpStatus; import org.springframework.security.web.method.annotation.AuthenticationPrincipalArgumentResolver; import org.springframework.security.web.servlet.support.csrf.CsrfRequestDataValueProcessor; import org.springframework.web.method.support.HandlerMethodArgumentResolver; import org.springframework.web.servlet.HandlerInterceptor; import org.springframework.web.servlet.config.annotation.DefaultServletHandlerConfigurer; import org.springframework.web.servlet.config.annotation.EnableWebMvc; import org.springframework.web.servlet.config.annotation.InterceptorRegistry; import org.springframework.web.servlet.config.annotation.ResourceHandlerRegistry; import org.springframework.web.servlet.config.annotation.ViewResolverRegistry; import org.springframework.web.servlet.config.annotation.WebMvcConfigurer; import org.springframework.web.servlet.support.RequestDataValueProcessor; import org.terasoluna.gfw.common.exception.ExceptionCodeResolver; import org.terasoluna.gfw.common.exception.ExceptionLogger; import org.terasoluna.gfw.web.codelist.CodeListInterceptor; import org.terasoluna.gfw.web.exception.HandlerExceptionResolverLoggingInterceptor; import org.terasoluna.gfw.web.exception.SystemExceptionResolver; import org.terasoluna.gfw.web.logging.TraceLoggingInterceptor; import org.terasoluna.gfw.web.mvc.support.CompositeRequestDataValueProcessor; import org.terasoluna.gfw.web.token.transaction.TransactionTokenInterceptor; import org.terasoluna.gfw.web.token.transaction.TransactionTokenRequestDataValueProcessor; import org.thymeleaf.dialect.IDialect; import org.thymeleaf.extras.springsecurity6.dialect.SpringSecurityDialect; import org.thymeleaf.spring6.SpringTemplateEngine; import org.thymeleaf.spring6.templateresolver.SpringResourceTemplateResolver; import org.thymeleaf.spring6.view.ThymeleafViewResolver; import org.thymeleaf.templateresolver.ITemplateResolver; /** * Configure SpringMVC. */ @ComponentScan(basePackages = {"com.example.todo.app"}) // (1) @EnableAspectJAutoProxy @EnableWebMvc // (8) @Configuration public class SpringMvcConfig implements WebMvcConfigurer { /** * Configure {@link PropertySourcesPlaceholderConfigurer} bean. * @param properties Property files to be read * @return Bean of configured {@link PropertySourcesPlaceholderConfigurer} */ // (2) @Bean public static PropertySourcesPlaceholderConfigurer propertySourcesPlaceholderConfigurer( @Value("classpath*:/META-INF/spring/*.properties") Resource... properties) { PropertySourcesPlaceholderConfigurer bean = new PropertySourcesPlaceholderConfigurer(); bean.setLocations(properties); return bean; } /** * {@inheritDoc} */ // (3) @Override public void addArgumentResolvers(List argumentResolvers) { argumentResolvers.add(pageableHandlerMethodArgumentResolver()); argumentResolvers.add(authenticationPrincipalArgumentResolver()); } /** * Configure {@link PageableHandlerMethodArgumentResolver} bean. * @return Bean of configured {@link PageableHandlerMethodArgumentResolver} */ @Bean public PageableHandlerMethodArgumentResolver pageableHandlerMethodArgumentResolver() { return new PageableHandlerMethodArgumentResolver(); } /** * Configure {@link AuthenticationPrincipalArgumentResolver} bean. * @return Bean of configured {@link AuthenticationPrincipalArgumentResolver} */ @Bean public AuthenticationPrincipalArgumentResolver authenticationPrincipalArgumentResolver() { return new AuthenticationPrincipalArgumentResolver(); } /** * {@inheritDoc} */ @Override public void configureDefaultServletHandling(DefaultServletHandlerConfigurer configurer) { configurer.enable(); } /** * {@inheritDoc} */ // (4) @Override public void addResourceHandlers(final ResourceHandlerRegistry registry) { registry.addResourceHandler("/resources/**") .addResourceLocations("/resources/", "classpath:META-INF/resources/") .setCachePeriod(60 * 60); } /** * {@inheritDoc} */ // (5) @Override public void addInterceptors(InterceptorRegistry registry) { addInterceptor(registry, traceLoggingInterceptor()); addInterceptor(registry, transactionTokenInterceptor()); addInterceptor(registry, codeListInterceptor()); } /** * Common processes used in #addInterceptors. * @param registry {@link InterceptorRegistry} * @param interceptor {@link HandlerInterceptor} */ private void addInterceptor(InterceptorRegistry registry, HandlerInterceptor interceptor) { registry.addInterceptor(interceptor).addPathPatterns("/**") .excludePathPatterns("/resources/**"); } /** * Configure {@link TraceLoggingInterceptor} bean. * @return Bean of configured {@link TraceLoggingInterceptor} */ @Bean public TraceLoggingInterceptor traceLoggingInterceptor() { return new TraceLoggingInterceptor(); } /** * Configure {@link TransactionTokenInterceptor} bean. * @return Bean of configured {@link TransactionTokenInterceptor} */ @Bean public TransactionTokenInterceptor transactionTokenInterceptor() { return new TransactionTokenInterceptor(); } /** * Configure {@link CodeListInterceptor} bean. * @return Bean of configured {@link CodeListInterceptor} */ @Bean public CodeListInterceptor codeListInterceptor() { CodeListInterceptor codeListInterceptor = new CodeListInterceptor(); codeListInterceptor.setCodeListIdPattern(Pattern.compile("CL_.+")); return codeListInterceptor; } /** * {@inheritDoc} */ // (9) @Override public void configureViewResolvers(ViewResolverRegistry registry) { registry.beanName(); registry.viewResolver(thymeleafViewResolver()); } /** * Configure Thymeleaf bean. * @return Bean of configured ThymeleafViewResolver */ // (6) @Bean public ThymeleafViewResolver thymeleafViewResolver() { ThymeleafViewResolver bean = new ThymeleafViewResolver(); bean.setTemplateEngine(templateEngine()); bean.setCharacterEncoding("UTF-8"); bean.setForceContentType(true); bean.setContentType("text/html;charset=UTF-8"); return bean; } /** * Configure ITemplateResolver Bean. * @return Bean of configured SpringResourceTemplateResolver */ // (7) @Bean("templateResolver") public ITemplateResolver templateResolver() { SpringResourceTemplateResolver bean = new SpringResourceTemplateResolver(); bean.setPrefix("/WEB-INF/views/"); bean.setSuffix(".html"); bean.setTemplateMode("HTML"); bean.setCharacterEncoding("UTF-8"); return bean; } /** * Configure SpringTemplateEngine Bean. * @return Bean of configured SpringTemplateEngine */ @Bean("templateEngine") public SpringTemplateEngine templateEngine() { SpringTemplateEngine bean = new SpringTemplateEngine(); bean.setTemplateResolver(templateResolver()); bean.setEnableSpringELCompiler(true); Set set = new HashSet<>(); set.add(new SpringSecurityDialect()); bean.setAdditionalDialects(set); return bean; } /** * Configure {@link RequestDataValueProcessor} bean. * @return Bean of configured {@link CompositeRequestDataValueProcessor} */ @Bean("requestDataValueProcessor") public RequestDataValueProcessor requestDataValueProcessor() { return new CompositeRequestDataValueProcessor(csrfRequestDataValueProcessor(), transactionTokenRequestDataValueProcessor()); } /** * Configure {@link CsrfRequestDataValueProcessor} bean. * @return Bean of configured {@link CsrfRequestDataValueProcessor} */ @Bean public CsrfRequestDataValueProcessor csrfRequestDataValueProcessor() { return new CsrfRequestDataValueProcessor(); } /** * Configure {@link TransactionTokenRequestDataValueProcessor} bean. * @return Bean of configured {@link TransactionTokenRequestDataValueProcessor} */ @Bean public TransactionTokenRequestDataValueProcessor transactionTokenRequestDataValueProcessor() { return new TransactionTokenRequestDataValueProcessor(); } /** * Configure {@link SystemExceptionResolver} bean. * @param exceptionCodeResolver Bean defined by ApplicationContextConfig#exceptionCodeResolver * @see com.example.todo.config.app.ApplicationContextConfig#exceptionCodeResolver() * @return Bean of configured {@link SystemExceptionResolver} */ @Bean("systemExceptionResolver") public SystemExceptionResolver systemExceptionResolver( ExceptionCodeResolver exceptionCodeResolver) { SystemExceptionResolver bean = new SystemExceptionResolver(); bean.setExceptionCodeResolver(exceptionCodeResolver); bean.setOrder(3); Properties exceptionMappings = new Properties(); exceptionMappings.setProperty("ResourceNotFoundException", "common/error/resourceNotFoundError"); exceptionMappings.setProperty("BusinessException", "common/error/businessError"); exceptionMappings.setProperty("InvalidTransactionTokenException", "common/error/transactionTokenError"); exceptionMappings.setProperty(".DataAccessException", "common/error/dataAccessError"); bean.setExceptionMappings(exceptionMappings); Properties statusCodes = new Properties(); statusCodes.setProperty("common/error/resourceNotFoundError", String.valueOf(HttpStatus.NOT_FOUND.value())); statusCodes.setProperty("common/error/businessError", String.valueOf(HttpStatus.CONFLICT.value())); statusCodes.setProperty("common/error/transactionTokenError", String.valueOf(HttpStatus.CONFLICT.value())); statusCodes.setProperty("common/error/dataAccessError", String.valueOf(HttpStatus.INTERNAL_SERVER_ERROR.value())); bean.setStatusCodes(statusCodes); bean.setDefaultErrorView("common/error/systemError"); bean.setDefaultStatusCode(HttpStatus.INTERNAL_SERVER_ERROR.value()); return bean; } /** * Configure messages logging AOP. * @param exceptionLogger Bean defined by ApplicationContextConfig#exceptionLogger * @see com.example.todo.config.app.ApplicationContextConfig#exceptionLogger() * @return Bean of configured {@link HandlerExceptionResolverLoggingInterceptor} */ @Bean("handlerExceptionResolverLoggingInterceptor") public HandlerExceptionResolverLoggingInterceptor handlerExceptionResolverLoggingInterceptor( ExceptionLogger exceptionLogger) { HandlerExceptionResolverLoggingInterceptor bean = new HandlerExceptionResolverLoggingInterceptor(); bean.setExceptionLogger(exceptionLogger); return bean; } /** * Configure messages logging AOP advisor. * @param handlerExceptionResolverLoggingInterceptor Bean defined by * #handlerExceptionResolverLoggingInterceptor * @see #handlerExceptionResolverLoggingInterceptor(ExceptionLogger) * @return Advisor configured for PointCut */ @Bean public Advisor handlerExceptionResolverLoggingInterceptorAdvisor( HandlerExceptionResolverLoggingInterceptor handlerExceptionResolverLoggingInterceptor) { AspectJExpressionPointcut pointcut = new AspectJExpressionPointcut(); pointcut.setExpression( "execution(* org.springframework.web.servlet.HandlerExceptionResolver.resolveException(..))"); return new DefaultPointcutAdvisor(pointcut, handlerExceptionResolverLoggingInterceptor); } } .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 :class: longtable * - 項番 - 説明 * - | (1) - | Spring MVCで使用するコンポーネントを探すパッケージを定義する。 | アプリケーション層のクラスを管理するcom.example.todo.appパッケージ配下をcomponent-scan対象とする。 * - | (2) - | プロパティファイルの読み込み設定を行う。 | src/main/resources/META-INF/spring直下の任意のプロパティファイルを読み込む。 | この設定により、プロパティファイルの値をBean定義ファイル内で\ ``${propertyName}``\ 形式で埋め込んだり、Javaクラスに\ ``@Value("${propertyName}")``\ でインジェクションすることができる。 * - | (3) - | Spring MVCのアノテーションベースのデフォルト設定を行う。 * - | (4) - | 静的リソース(css, images, jsなど)アクセスのための設定を行う。 | \ ``mapping``\ 属性にURLのパスを、\ ``location``\ 属性に物理的なパスの設定を行う。 | この設定の場合\ ``/resources/app/css/styles.css``\ に対してリクエストが来た場合、\ ``WEB-INF/resources/app/css/styles.css``\ を探し、見つからなければクラスパス上(\ ``src/main/resources``\ やjar内)の\ ``META-INF/resources/app/css/styles.css``\ を探す。 | どこにも\ ``styles.css``\ が格納されていない場合は、404エラーを返す。 | ここでは\ ``cache-period``\ 属性で静的リソースのキャッシュ時間(3600秒=60分)も設定している。 | \ ``cache-period="3600"``\ と設定しても良いが、60分であることを明示するために\ :url_spring_reference:`SpEL `\ を使用して \ ``cache-period="#{60 * 60}"``\ と書く方が分かりやすい。 * - | (5) - | コントローラ処理のTraceログを出力するインターセプタを設定する。 | \ ``/resources``\ 配下を除く任意のパスに適用されるように設定する。 * - | (6) - | \ ``ViewResolver``\ の設定を行う。 | 画面のレンダリングをThymeleafに委譲し、\ ``forceContentType``\ 属性により\ ``contentType``\ 属性に指定したコンテンツタイプ（\ ``text/html;charset=UTF-8``\ ）をレスポンスに設定している。 * - | (7) - | \ ``TemplateResolver``\ の設定を行う。 | この設定により、例えばコントローラからView名として\ ``hello``\ が返却された場合には\ ``/WEB-INF/views/hello.html``\ がテンプレートとして処理される。 * - | (8) - \ ``@EnableWebMvc``\ アノテーションを定義することにより、Spring MVCのデフォルト設定が行われる。デフォルトの設定については、\ :url_spring_reference:`Spring Framework Documentation -Enable MVC Configuration- `\ を参照されたい。 * - | (9) - | \ ``registry.beanName()``\ については、\ :ref:`viewresolver-label` \ を参照されたい。 | \ ``registry.viewResolver(thymeleafViewResolver())``\ により、Thymeleaf用の\ ``ViewResolver``\ を指定する。 .. group-tab:: XML Config \ :file:`spring-mvc.xml`\ には、Spring MVCに関する定義を行う。 | 作成したブランクプロジェクトの\ :file:`src/main/resources/META-INF/spring/spring-mvc.xml`\ は、以下のような設定となっている。 .. tabs:: .. group-tab:: JSP .. code-block:: xml .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 :class: longtable * - 項番 - 説明 * - | (1) - | プロパティファイルの読み込み設定を行う。 | src/main/resources/META-INF/spring直下の任意のプロパティファイルを読み込む。 | この設定により、プロパティファイルの値をBean定義ファイル内で\ ``${propertyName}``\ 形式で埋め込んだり、Javaクラスに\ ``@Value("${propertyName}")``\ でインジェクションすることができる。 * - | (2) - | \ ````\ 要素を定義することにより、Spring MVCのアノテーションベースのデフォルト設定を行う。 | デフォルトの設定については、\ :url_spring_reference:`Spring Framework Documentation -Enable MVC Configuration- `\ を参照されたい。 * - | (3) - | Spring MVCで使用するコンポーネントを探すパッケージを定義する。 | アプリケーション層のクラスを管理するcom.example.todo.appパッケージ配下をcomponent-scan対象とする。 * - | (4) - | 静的リソース(css, images, jsなど)アクセスのための設定を行う。 | \ ``mapping``\ 属性にURLのパスを、\ ``location``\ 属性に物理的なパスの設定を行う。 | この設定の場合\ ``/resources/app/css/styles.css``\ に対してリクエストが来た場合、\ ``WEB-INF/resources/app/css/styles.css``\ を探し、見つからなければクラスパス上(\ ``src/main/resources``\ やjar内)の\ ``META-INF/resources/app/css/styles.css``\ を探す。 | どこにも\ ``styles.css``\ が格納されていない場合は、404エラーを返す。 | ここでは\ ``cache-period``\ 属性で静的リソースのキャッシュ時間(3600秒=60分)も設定している。 | \ ``cache-period="3600"``\ と設定しても良いが、60分であることを明示するために\ :url_spring_reference:`SpEL `\ を使用して\ ``cache-period="#{60 * 60}"``\ と書く方が分かりやすい。 * - | (5) - | コントローラ処理のTraceログを出力するインターセプタを設定する。 | \ ``/resources``\ 配下を除く任意のパスに適用されるように設定する。 * - | (6) - | \ ````\ については、\ :ref:`viewresolver-label` \ を参照されたい。 | \ ````\ により、JSP用の\ ``ViewResolver``\ を指定し、JSPファイルの配置場所を定義する。 | この設定により、例えばコントローラからView名として\ ``hello``\ が返却された場合には\ ``/WEB-INF/views/hello.jsp``\ が実行される。 .. group-tab:: Thymeleaf .. code-block:: xml .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 :class: longtable * - 項番 - 説明 * - | (1) - | プロパティファイルの読み込み設定を行う。 | src/main/resources/META-INF/spring直下の任意のプロパティファイルを読み込む。 | この設定により、プロパティファイルの値をBean定義ファイル内で\ ``${propertyName}``\ 形式で埋め込んだり、Javaクラスに\ ``@Value("${propertyName}")``\ でインジェクションすることができる。 * - | (2) - | \ ````\ 要素を定義することにより、Spring MVCのアノテーションベースのデフォルト設定を行う。 | デフォルトの設定については、\ :url_spring_reference:`Spring Framework Documentation -Enable MVC Configuration- `\ を参照されたい。 * - | (3) - | Spring MVCで使用するコンポーネントを探すパッケージを定義する。 | アプリケーション層のクラスを管理するcom.example.todo.appパッケージ配下をcomponent-scan対象とする。 * - | (4) - | 静的リソース(css, images, jsなど)アクセスのための設定を行う。 | \ ``mapping``\ 属性にURLのパスを、\ ``location``\ 属性に物理的なパスの設定を行う。 | この設定の場合\ ``/resources/app/css/styles.css``\ に対してリクエストが来た場合、\ ``WEB-INF/resources/app/css/styles.css``\ を探し、見つからなければクラスパス上(\ ``src/main/resources``\ やjar内)の\ ``META-INF/resources/app/css/styles.css``\ を探す。 | どこにも\ ``styles.css``\ が格納されていない場合は、404エラーを返す。 | ここでは\ ``cache-period``\ 属性で静的リソースのキャッシュ時間(3600秒=60分)も設定している。 | \ ``cache-period="3600"``\ と設定しても良いが、60分であることを明示するために\ :url_spring_reference:`SpEL `\ を使用して \ ``cache-period="#{60 * 60}"``\ と書く方が分かりやすい。 * - | (5) - | コントローラ処理のTraceログを出力するインターセプタを設定する。 | \ ``/resources``\ 配下を除く任意のパスに適用されるように設定する。 * - | (6) - | \ ````\ については、\ :ref:`viewresolver-label` \ を参照されたい。 | \ ````\ により、Thymeleaf用の\ ``ViewResolver``\ の設定を行う。 | 画面のレンダリングをThymeleafに委譲し、\ ``forceContentType``\ 属性により\ ``contentType``\ 属性に指定したコンテンツタイプ（\ ``text/html;charset=UTF-8``\ ）をレスポンスに設定している。 * - | (7) - | \ ``TemplateResolver``\ の設定を行う。 | Viewファイルの拡張子と配置場所を定義する。 | この設定により、例えばコントローラからView名として\ ``hello``\ が返却された場合には\ ``/WEB-INF/views/hello.html``\ がテンプレートとして処理される。 * - | (8) - | Springを用いたThymeleafの実装を定義する。 | spring-security -------------------------------------------------------------------------------- .. tabs:: .. group-tab:: Java Config \ :file:`SpringSecurityConfig.java`\ には、Spring Securityに関する定義を行う。 | 作成したブランクプロジェクトの\ :file:`src/main/java/com/example/todo/config/web/SpringSecurityConfig.java`\ は、以下のような設定となっている。 | なお、本章ではSpring Securityの設定ファイルの説明は割愛する。Spring Securityの設定ファイルについては、「\ :doc:`../Tutorial/TutorialSecurity`\ 」を参照されたい。 .. tabs:: .. group-tab:: JSP .. code-block:: Java package com.example.todo.config.web; import static org.springframework.security.web.util.matcher.AntPathRequestMatcher.antMatcher; import java.util.LinkedHashMap; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; import org.springframework.security.access.AccessDeniedException; import org.springframework.security.config.Customizer; import org.springframework.security.config.annotation.web.builders.HttpSecurity; import org.springframework.security.config.annotation.web.configuration.EnableWebSecurity; import org.springframework.security.config.annotation.web.configuration.WebSecurityCustomizer; import org.springframework.security.web.SecurityFilterChain; import org.springframework.security.web.access.AccessDeniedHandler; import org.springframework.security.web.access.AccessDeniedHandlerImpl; import org.springframework.security.web.access.DelegatingAccessDeniedHandler; import org.springframework.security.web.access.expression.DefaultWebSecurityExpressionHandler; import org.springframework.security.web.authentication.AnonymousAuthenticationFilter; import org.springframework.security.web.csrf.InvalidCsrfTokenException; import org.springframework.security.web.csrf.MissingCsrfTokenException; import org.terasoluna.gfw.security.web.logging.UserIdMDCPutFilter; /** * Bean definition to configure SpringSecurity. */ @Configuration @EnableWebSecurity public class SpringSecurityConfig { /** * Configure ignore security pattern. * @return Bean of configured {@link WebSecurityCustomizer} */ // (1) @Bean public WebSecurityCustomizer webSecurityCustomizer() { return web -> web.ignoring().requestMatchers(antMatcher("/resources/**")); } /** * Configure {@link SecurityFilterChain} bean. * @param http Builder class for setting up authentication and authorization * @return Bean of configured {@link SecurityFilterChain} * @throws Exception Exception that occurs when setting HttpSecurity */ // (2) @Bean public SecurityFilterChain filterChain(HttpSecurity http) throws Exception { // (3) http.formLogin(Customizer.withDefaults()); // (4) http.logout(Customizer.withDefaults()); http.exceptionHandling(ex -> ex.accessDeniedHandler(accessDeniedHandler())); // (6) http.addFilterAfter(userIdMDCPutFilter(), AnonymousAuthenticationFilter.class); // (7) http.sessionManagement(Customizer.withDefaults()); http.authorizeHttpRequests(authz -> authz.requestMatchers(antMatcher("/**")).permitAll()); return http.build(); } /** * Configure {@link AccessDeniedHandler} bean. * @return Bean of configured {@link AccessDeniedHandler} */ // (5) @Bean("accessDeniedHandler") public AccessDeniedHandler accessDeniedHandler() { LinkedHashMap, AccessDeniedHandler> errorHandlers = new LinkedHashMap<>(); // Invalid CSRF authenticator error handler AccessDeniedHandlerImpl invalidCsrfTokenErrorHandler = new AccessDeniedHandlerImpl(); invalidCsrfTokenErrorHandler .setErrorPage("/WEB-INF/views/common/error/invalidCsrfTokenError.jsp"); errorHandlers.put(InvalidCsrfTokenException.class, invalidCsrfTokenErrorHandler); // Missing CSRF authenticator error handler AccessDeniedHandlerImpl missingCsrfTokenErrorHandler = new AccessDeniedHandlerImpl(); missingCsrfTokenErrorHandler .setErrorPage("/WEB-INF/views/common/error/missingCsrfTokenError.jsp"); errorHandlers.put(MissingCsrfTokenException.class, missingCsrfTokenErrorHandler); // Default error handler AccessDeniedHandlerImpl defaultErrorHandler = new AccessDeniedHandlerImpl(); defaultErrorHandler.setErrorPage("/WEB-INF/views/common/error/accessDeniedError.jsp"); return new DelegatingAccessDeniedHandler(errorHandlers, defaultErrorHandler); } /** * Configure {@link DefaultWebSecurityExpressionHandler} bean. * @return Bean of configured {@link DefaultWebSecurityExpressionHandler} */ @Bean("webSecurityExpressionHandler") public DefaultWebSecurityExpressionHandler webSecurityExpressionHandler() { return new DefaultWebSecurityExpressionHandler(); } /** * Configure {@link UserIdMDCPutFilter} bean. * @return Bean of configured {@link UserIdMDCPutFilter} */ // (6) @Bean("userIdMDCPutFilter") public UserIdMDCPutFilter userIdMDCPutFilter() { return new UserIdMDCPutFilter(); } } .. group-tab:: Thymeleaf .. code-block:: Java package com.example.todo.config.web; import static org.springframework.security.web.util.matcher.AntPathRequestMatcher.antMatcher; import java.util.LinkedHashMap; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; import org.springframework.security.access.AccessDeniedException; import org.springframework.security.config.Customizer; import org.springframework.security.config.annotation.web.builders.HttpSecurity; import org.springframework.security.config.annotation.web.configuration.EnableWebSecurity; import org.springframework.security.config.annotation.web.configuration.WebSecurityCustomizer; import org.springframework.security.web.SecurityFilterChain; import org.springframework.security.web.access.AccessDeniedHandler; import org.springframework.security.web.access.AccessDeniedHandlerImpl; import org.springframework.security.web.access.DelegatingAccessDeniedHandler; import org.springframework.security.web.access.expression.DefaultWebSecurityExpressionHandler; import org.springframework.security.web.authentication.AnonymousAuthenticationFilter; import org.springframework.security.web.csrf.InvalidCsrfTokenException; import org.springframework.security.web.csrf.MissingCsrfTokenException; import org.terasoluna.gfw.security.web.logging.UserIdMDCPutFilter; /** * Bean definition to configure SpringSecurity. */ @Configuration @EnableWebSecurity public class SpringSecurityConfig { /** * Configure ignore security pattern. * @return Bean of configured {@link WebSecurityCustomizer} */ // (1) @Bean public WebSecurityCustomizer webSecurityCustomizer() { return web -> web.ignoring().requestMatchers(antMatcher("/resources/**")); } /** * Configure {@link SecurityFilterChain} bean. * @param http Builder class for setting up authentication and authorization * @return Bean of configured {@link SecurityFilterChain} * @throws Exception Exception that occurs when setting HttpSecurity */ // (2) @Bean public SecurityFilterChain filterChain(HttpSecurity http) throws Exception { // (3) http.formLogin(Customizer.withDefaults()); // (4) http.logout(Customizer.withDefaults()); http.exceptionHandling(ex -> ex.accessDeniedHandler(accessDeniedHandler())); // (6) http.addFilterAfter(userIdMDCPutFilter(), AnonymousAuthenticationFilter.class); // (7) http.sessionManagement(Customizer.withDefaults()); http.authorizeHttpRequests(authz -> authz.requestMatchers(antMatcher("/**")).permitAll()); return http.build(); } /** * Configure {@link AccessDeniedHandler} bean. * @return Bean of configured {@link AccessDeniedHandler} */ // (5) @Bean("accessDeniedHandler") public AccessDeniedHandler accessDeniedHandler() { LinkedHashMap, AccessDeniedHandler> errorHandlers = new LinkedHashMap<>(); // Invalid CSRF authenticator error handler AccessDeniedHandlerImpl invalidCsrfTokenErrorHandler = new AccessDeniedHandlerImpl(); invalidCsrfTokenErrorHandler.setErrorPage("/common/error/invalidCsrfTokenError"); errorHandlers.put(InvalidCsrfTokenException.class, invalidCsrfTokenErrorHandler); // Missing CSRF authenticator error handler AccessDeniedHandlerImpl missingCsrfTokenErrorHandler = new AccessDeniedHandlerImpl(); missingCsrfTokenErrorHandler.setErrorPage("/common/error/missingCsrfTokenError"); errorHandlers.put(MissingCsrfTokenException.class, missingCsrfTokenErrorHandler); // Default error handler AccessDeniedHandlerImpl defaultErrorHandler = new AccessDeniedHandlerImpl(); defaultErrorHandler.setErrorPage("/common/error/accessDeniedError"); return new DelegatingAccessDeniedHandler(errorHandlers, defaultErrorHandler); } /** * Configure {@link DefaultWebSecurityExpressionHandler} bean. * @return Bean of configured {@link DefaultWebSecurityExpressionHandler} */ @Bean("webSecurityExpressionHandler") public DefaultWebSecurityExpressionHandler webSecurityExpressionHandler() { return new DefaultWebSecurityExpressionHandler(); } /** * Configure {@link UserIdMDCPutFilter} bean. * @return Bean of configured {@link UserIdMDCPutFilter} */ // (6) @Bean("userIdMDCPutFilter") public UserIdMDCPutFilter userIdMDCPutFilter() { return new UserIdMDCPutFilter(); } } .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 * - 項番 - 説明 * - | (1) - | 本フレームワークでは、静的リソース(js, css, imageファイルなど)は(\ ``/resources/**``\ )配下に配置されることを前提としている。 | そのため、ブランクプロジェクトのデフォルトの設定では、\ ``WebSecurityCustomizer``\ で(\ ``/resources/**``\ )配下をSpring Securityの対象外にしている。 * - | (2) - \ ``HttpSecurity``\ を使用してHTTPアクセスに対して認証・認可を制御する。 * - \ (3) - \ ``http.formLogin()``\ を使用して、フォーム認証を使用したログインに関する動作を制御する。 \ 使用方法については、「\ :ref:`form-login`\ 」 を参照されたい。 * - \ (4) - \ ``http.logout()``\ タグ を使用して、ログアウトに関する動作を制御する。 \ 使用方法については、「\ :ref:`SpringSecurityAuthenticationLogout`\ 」を参照されたい。 * - | (5) - \ ``AccessDeniedHandler``\ を使用して、アクセスを拒否した後の動作を制御する。 ブランクプロジェクトのデフォルトの設定では、 * 不正なCSRFトークンを検知した場合(\ ``InvalidCsrfTokenException``\ が発生した場合)の遷移先 * トークンストアからCSRFトークンが取得できない場合(\ ``MissingCsrfTokenException``\ が発生した場合)の遷移先 * 認可処理でアクセスが拒否された場合(上記以外の\ ``AccessDeniedException``\ が発生した場合)の遷移先 が設定済みである。 * - | (6) - Spring Securityの認証ユーザ名をロガーのMDCに格納するためのサーブレットフィルタを有効化する。 この設定を有効化すると、ログに認証ユーザ名が出力されるため、トレーサビリティを向上することができる。 * - | (7) - \ ``http.sessionManagement()``\ を使用して、Spring Securityのセッション管理方法を制御する。 使用方法については、「\ :ref:`SpringSecuritySessionManagementSetup`\ 」を参照されたい。 .. group-tab:: XML Config \ :file:`spring-security.xml`\ には、Spring Securityに関する定義を行う。 | 作成したブランクプロジェクトの\ :file:`src/main/resources/META-INF/spring/spring-security.xml`\ は、以下のような設定となっている。 | なお、本章ではSpring Securityの設定ファイルの説明は割愛する。Spring Securityの設定ファイルについては、「\ :doc:`../Tutorial/TutorialSecurity`\ 」を参照されたい。 .. tabs:: .. group-tab:: JSP .. code-block:: xml .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 :class: longtable * - 項番 - 説明 * - | (1) - | .. group-tab:: Thymeleaf .. code-block:: xml .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 * - 項番 - 説明 * - | (1) - | 本フレームワークでは、静的リソース(js, css, imageファイルなど)は(\ ``/resources/**``\ )配下に配置されることを前提としている。 | そのため、ブランクプロジェクトのデフォルトの設定では、````\ タグを使用して(\ ``/resources/**``\ )配下をSpring Securityの対象外にしている。 * - \ (2) - \ ````\ タグを使用して、フォーム認証を使用したログインに関する動作を制御する。 \ 使用方法については、「\ :ref:`form-login`\ 」 を参照されたい。 * - \ (3) - \ ````\ タグ を使用して、ログアウトに関する動作を制御する。 \ 使用方法については、「\ :ref:`SpringSecurityAuthenticationLogout`\ 」 を参照されたい。 * - | (4) - \ ````\ タグを使用して、アクセスを拒否した後の動作を制御する。 ブランクプロジェクトのデフォルトの設定では、 * 不正なCSRFトークンを検知した場合(\ ``InvalidCsrfTokenException``\ が発生した場合)の遷移先 * トークンストアからCSRFトークンが取得できない場合(\ ``MissingCsrfTokenException``\ が発生した場合)の遷移先 * 認可処理でアクセスが拒否された場合(上記以外の\ ``AccessDeniedException``\ が発生した場合)の遷移先 が設定済みである。 * - | (5) - Spring Securityの認証ユーザ名をロガーのMDCに格納するためのサーブレットフィルタを有効化する。 この設定を有効化すると、ログに認証ユーザ名が出力されるため、トレーサビリティを向上することができる。 * - | (6) - \ ````\ タグを使用して、Spring Securityのセッション管理方法を制御する。 使用方法については、「\ :ref:`SpringSecuritySessionManagementSetup`\ 」を参照されたい。 * - | (7) - \ ````\ タグを使用して、認証処理を制御する。 使用方法については、「\ :ref:`AuthenticationProviderConfiguration`\ 」を参照されたい。 | logback.xml -------------------------------------------------------------------------------- \ :file:`logback.xml`\ には、ログ出力に関する定義を行う。 ブランクプロジェクトでは、ログをSLF4J + Logbackで出力するように設定されている。 | 作成したブランクプロジェクトの\ :file:`src/main/resources/logback.xml`\ は、以下のような設定となっている。 .. code-block:: xml '}\tlevel:%-5level\tlogger:%-48logger{48}\tmessage:%replace(%replace(%msg){'[\p{IsControl}&&[^\t\r\n]]',''}){'(\r\n|\r|\n)','$1 '}%n%replace(%replace(%replace(%xEx){'[\p{IsControl}&&[^\t\r\n]]',''}){'(\r\n|\r|\n)','$1 '}){' $',''}%nopex]]> ${app.log.dir:-log}/todo-application.log ${app.log.dir:-log}/todo-application-%d{yyyyMMdd}.log 7 UTF-8 '}\tlevel:%-5level\tlogger:%-48logger{48}\tmessage:%replace(%replace(%msg){'[\p{IsControl}&&[^\t\r\n]]',''}){'(\r\n|\r|\n)','$1 '}%n%replace(%replace(%replace(%xEx){'[\p{IsControl}&&[^\t\r\n]]',''}){'(\r\n|\r|\n)','$1 '}){' $',''}%nopex]]> ${app.log.dir:-log}/todo-monitoring.log ${app.log.dir:-log}/todo-monitoring-%d{yyyyMMdd}.log 7 UTF-8 '}\tlevel:%-5level\tmessage:%replace(%replace(%msg){'[\p{IsControl}&&[^\t\r\n]]',''}){'(\r\n|\r|\n)','$1 '}%n%replace(%replace(%replace(%xEx){'[\p{IsControl}&&[^\t\r\n]]',''}){'(\r\n|\r|\n)','$1 '}){' $',''}%nopex]]> .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 * - 項番 - 説明 * - | (1) - | 標準出力でログを出力するアペンダを設定。 * - | (2) - | com.example.todoパッケージ以下はdebugレベル以上を出力するように設定。 * - | (3) - | spring-mvc.xmlまたはSpringMvcConfig.javaに設定した\ ``TraceLoggingInterceptor``\ に出力されるようにtraceレベルで設定。 O/R Mapperを使用するブランクプロジェクトを作成した場合は、それぞれのO/R Mapperのログを出力するロガーが有効な状態となっている。 * MyBatis3用のブランクプロジェクト .. code-block:: xml | インクルードJSP -------------------------------------------------------------------------------- JSPの場合、インクルードJSPには、全てのJSPに適用するJSPの設定や、タグライブラリの設定を行う。 作成したブランクプロジェクトの\ :file:`src/main/webapp/WEB-INF/views/common/include.jsp`\ は、以下のような設定となっている。 .. code-block:: jsp <%@ page session="false"%> <%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c"%> <%@ taglib uri="http://java.sun.com/jsp/jstl/fmt" prefix="fmt"%> <%@ taglib uri="http://www.springframework.org/tags" prefix="spring"%> <%@ taglib uri="http://www.springframework.org/tags/form" prefix="form"%> <%@ taglib uri="http://www.springframework.org/security/tags" prefix="sec"%> <%@ taglib uri="http://terasoluna.org/tags" prefix="t"%> <%@ taglib uri="http://terasoluna.org/functions" prefix="f"%> .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 * - 項番 - 説明 * - | (1) - | JSP実行時にセッションを作成しないようにするための定義。 * - | (2) - | 標準タグライブラリの定義。 * - | (3) - | Spring MVC用タグライブラリの定義。 * - | (4) - | Spring Security用タグライブラリの定義(本章では使用しない。) * - | (5) - | 共通ライブラリで提供されている、EL関数、タグライブラリの定義。 | Welcomeページを表示するためのController -------------------------------------------------------------------------------- .. tabs:: .. group-tab:: JSP * \ ``com.example.todo.app.welcome.HelloController``\ .. code-block:: java package com.example.todo.app.welcome; import java.time.LocalDateTime; import java.time.format.DateTimeFormatter; import java.time.format.FormatStyle; import java.util.Locale; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import org.springframework.stereotype.Controller; import org.springframework.ui.Model; import org.springframework.web.bind.annotation.GetMapping; /** * Handles requests for the application home page. */ @Controller // (4) public class HelloController { private static final Logger logger = LoggerFactory.getLogger(HelloController.class); /** * Simply selects the home view to render by returning its name. */ @GetMapping(value = "/") // (5) public String home(Locale locale, Model model) { logger.info("Welcome home! The client locale is {}.", locale); LocalDateTime dateTime = LocalDateTime.now(); DateTimeFormatter formatter = DateTimeFormatter .ofLocalizedDateTime(FormatStyle.LONG, FormatStyle.MEDIUM).withLocale(locale); String formattedDate = dateTime.format(formatter); model.addAttribute("serverTime", formattedDate); // (6) return "welcome/home"; // (7) } } .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 * - 項番 - 説明 * - | (4) - \ ``@Controller``\ アノテーションを付けることで、DIコンテナにより、コントローラクラスが自動で読み込まれる。前述「Spring MVCの設定ファイルの説明(2)」の設定により、component-scanの対象となっている。 * - | (5) - HTTPメソッドがGETで、"\ ``/``\ "というResource（もしくはRequest URL）にアクセスする際に実行される。 * - | (6) - Viewに渡したいオブジェクトを\ ``Model``\ に設定する。 * - | (7) - View名を返却する。前述「Spring MVCの設定ファイルの説明(3)」の設定により、\ ``WEB-INF/views/welcome/home.jsp``\ がレンダリングされる。 .. group-tab:: Thymeleaf * \ ``com.example.todo.app.welcome.HelloController``\ .. code-block:: java package com.example.todo.app.welcome; import java.time.LocalDateTime; import java.time.format.DateTimeFormatter; import java.time.format.FormatStyle; import java.util.Locale; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import org.springframework.stereotype.Controller; import org.springframework.ui.Model; import org.springframework.web.bind.annotation.GetMapping; /** * Handles requests for the application home page. */ @Controller // (6) public class HelloController { private static final Logger logger = LoggerFactory.getLogger(HelloController.class); /** * Simply selects the home view to render by returning its name. */ @GetMapping(value = "/") // (7) public String home(Locale locale, Model model) { logger.info("Welcome home! The client locale is {}.", locale); LocalDateTime dateTime = LocalDateTime.now(); DateTimeFormatter formatter = DateTimeFormatter .ofLocalizedDateTime(FormatStyle.LONG, FormatStyle.MEDIUM).withLocale(locale); String formattedDate = dateTime.format(formatter); model.addAttribute("serverTime", formattedDate); // (8) return "welcome/home"; // (9) } } .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 * - 項番 - 説明 * - | (6) - \ ``@Controller``\ アノテーションを付けることで、DIコンテナにより、コントローラクラスが自動で読み込まれる。前述「Spring MVCの設定ファイルの説明(2)」の設定により、component-scanの対象となっている。 * - | (7) - HTTPメソッドがGETで、"\ ``/``\ "というResource（もしくはRequest URL）にアクセスする際に実行される。 * - | (8) - Viewに渡したいオブジェクトを\ ``Model``\ に設定する。 * - | (9) - View名を返却する。前述「Spring MVCの設定ファイルの説明(4)」の設定により、\ ``WEB-INF/views/welcome/home.html``\ がレンダリングされる。 | Welcomeページを表示するためのView -------------------------------------------------------------------------------- .. tabs:: .. group-tab:: JSP * \ ``src/main/webapp/WEB-INF/views/welcome/home.jsp``\ .. code-block:: jsp Home

Hello world!

The time on the server is ${serverTime}.

.. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 * - 項番 - 説明 * - | (8) - | 前述の「Controllerの説明(6)」でModelに設定したオブジェクト(serverTime)は、HttpServletRequestに格納される。 | そのため、JSPで\ ``${serverTime}``\ と記述することで、Controllerで設定した値を画面に出力することができる。 .. warning:: \ **${XXX}の記述は、XSS対象になる可能性があるので、文字列を出力する場合はHTMLエスケープする必要がある。**\ 詳細は\ :doc:`../Security/XSS`\ を参照されたい。 .. group-tab:: Thymeleaf * \ ``src/main/webapp/WEB-INF/views/welcome/home.html``\ .. code-block:: html Home

Hello world!

The time on the server is 2018/01/01 00:00:00 JST.

.. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 * - 項番 - 説明 * - | (10) - | スタンダードダイアレクトが提供する属性を使用したとき、EclipseなどのIDEでの警告を抑止するため、ネームスペースを付与する。 * - | (11) - | 前述の「Controllerの説明(8)」でModelに設定したオブジェクト(serverTime)は、HttpServletRequestに格納される。 | そのため、テンプレートHTMLで\ ``${serverTime}``\ と記述し、Thymeleafの\ ``th:text``\ 属性を使用することで、Controllerで設定した値を画面に出力することができる。 | | \ ``th:text``\ 属性はHTMLエスケープをして出力を行うため、自動的にXSS対策をとることができる。 | 詳細については\ :ref:`xss_how_to_use_ouput_escaping`\ を参照されたい。 | .. _BlankProjectCustomizingBlankProject: ブランクプロジェクトのカスタマイズ ================================================================================ Maven Archetypeで作成したプロジェクトには、アプリケーション毎にカスタマイズが必要な箇所がいくつか存在する。 カスタマイズが必要な箇所を以下に示す。 - \ :ref:`BlankProjectProjectInformation`\ - \ :ref:`BlankProjectMessageId`\ - \ :ref:`BlankProjectMessageWording`\ - \ :ref:`BlankProjectErrorScreen`\ - \ :ref:`BlankProjectDeleteInMemoryDatabase`\ - \ :ref:`BlankProjectDataSourceSetting`\ 上記以外のカスタマイズポイントとしては、 * \ :doc:`../Security/Authentication`\ ・\ :doc:`../Security/Authorization`\ の設定 * \ :doc:`../ArchitectureInDetail/WebApplicationDetail/FileUpload`\ を有効化するための設定 * \ :doc:`../ArchitectureInDetail/WebApplicationDetail/Internationalization`\ を有効化するための設定 * \ :doc:`../ArchitectureInDetail/GeneralFuncDetail/Logging`\ の定義 * \ :doc:`../ArchitectureInDetail/WebApplicationDetail/ExceptionHandling`\ の定義 * \ :doc:`../ArchitectureInDetail/WebServiceDetail/REST`\ 向けの設定の適用 などがある。 これらのカスタマイズについては、各節のHow to useを参照し、必要に応じてカスタマイズしてほしい。 .. note:: 以降の説明で\ ``[artifactId]``\ と表現している部分は、プロジェクト作成時に指定した\ ``artifactId``\ に置き換えて読み進めてほしい。 | .. _BlankProjectProjectInformation: プロジェクト情報 -------------------------------------------------------------------------------- Maven Archetypeで作成したプロジェクトのPOMファイル(\ ``pom.xml``\)では、 * プロジェクト名(\ ``name``\ 要素) * プロジェクト説明(\ ``description``\ 要素) * プロジェクトURL(\ ``url``\ 要素) * プロジェクト創設年(\ ``inceptionYear``\ 要素) * プロジェクトライセンス(\ ``licenses``\ 要素) * プロジェクト組織(\ ``organization``\ 要素) * 開発者(\ ``developers``\ 要素) * ソース管理システム(\ ``scm``\ 要素) | といったプロジェクト情報が、Archetype自身のプロジェクト情報が設定されている状態となっている。 | 例として、ブランクプロジェクトで設定している内容を以下に示す。 | \ **プロジェクト情報には、適切な値を設定すること。**\ .. code-block:: xml Macchinetta Server Framework (1.x) Web Blank Multi Project Web Blank Multi Project using Macchinetta Server Framework (1.x) http://macchinetta.github.io 2017 Apache License, Version 2.0 http://www.apache.org/licenses/LICENSE-2.0.txt manual Macchinetta Framework Team http://macchinetta.github.io Macchinetta Macchinetta http://macchinetta.github.io scm:git:git://github.com/Macchinetta/macchinetta-web-multi-blank.git scm:git:ssh://github.com/Macchinetta/macchinetta-web-multi-blank.git https://github.com/Macchinetta/macchinetta-web-multi-blank | カスタマイズ対象のファイルとカスタマイズ方法を以下に示す。 .. tabularcolumns:: |p{0.10\linewidth}|p{0.45\linewidth}|p{0.45\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 45 45 * - 項番 - 対象ファイル - カスタマイズ方法 * - 1. - マルチプロジェクト全体の構成を定義するPOM(Project Object Model)ファイル \ ``[artifactId]/pom.xml``\ - プロジェクト情報に適切な値を指定する。 | .. _BlankProjectMavenCompilerPlugin: maven-compiler-plugin -------------------------------------------------------------------------------- Maven Archetypeで作成したプロジェクトのPOMファイル(\ ``pom.xml``\)では、以下の様にmaven-compiler-pluginが設定されている。 .. code-block:: xml org.apache.maven.plugins maven-compiler-plugin true org.mapstruct mapstruct-processor ${mapstruct.version} -Amapstruct.defaultComponentModel=spring \ ``configuration``\ については以下の通り .. tabularcolumns:: |p{0.10\linewidth}|p{0.45\linewidth}|p{0.45\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 45 * - 項番 - 概要 * - 1. - | Java8から追加された\ ``-parameters``\ オプション(メソッド・パラメータにリフレクション用のメタデータを生成するモード) | Spring の各機能は\ ``-parameters``\ が設定されていることを前提としており、\ ``-parameters``\ を設定していない場合、\ ``@RequestParam``\ や\ ``@PathVariable``\ の属性省略ができなくなる、XMLConfigでBean定義する際に変数を名前で解決することができなくなる等の問題が発生する。 * - 2. - MapStructを使用するための設定。詳しくは\ :ref:`mapstruct-setting`\ を参照されたい。 * - 3. - MapStructとLombokを併用するための設定。詳しくは\ :ref:`mapstruct_lombok`\ を参照されたい。 | .. _BlankProjectMessageId: x.xx.fw.9999形式のメッセージID -------------------------------------------------------------------------------- Maven Archetypeで作成したプロジェクトでは、\ ``x.xx.fw.9999``\ 形式のメッセージIDを、 * エラー画面に表示するメッセージ * 例外発生時に出力するエラーログ を生成する際に使用している。実際の使用箇所(サンプリング)を以下に示す。 \ **[application-messages.properties]**\ .. code-block:: properties e.xx.fw.5001 = Resource not found. .. tabs:: .. group-tab:: JSP \ **[JSP]**\ .. code-block:: jsp
[${f:h(exceptionCode)}]
.. group-tab:: Thymeleaf \ **[HTML]**\ .. code-block:: html
[e.xx.fw.5001] Resource not found.
\ **[applicationContext.xml]**\ .. code-block:: xml \ ``x.xx.fw.9999``\ 形式のメッセージIDは、本ガイドラインの「\ :doc:`../ArchitectureInDetail/WebApplicationDetail/MessageManagement`\ 」で紹介しているメッセージID体系であるが、プロジェクト区分の値が暫定値「\ ``xx``\ 」の状態になっている。 * \ **本ガイドラインで紹介しているメッセージID体系を利用する場合は、プロジェクト区分に適切な値を指定すること。**\ 本ガイドラインで紹介しているメッセージID体系については、「\ :ref:`message-management_result-rule`\ 」を参照されたい。 * 本ガイドラインで紹介しているメッセージID体系を利用しない場合は、以下に示す修正対象ファイル内で使用しているメッセージIDを全て置き換える必要がある。 | カスタマイズ対象のファイルとカスタマイズ方法を以下に示す。 .. tabs:: .. group-tab:: Java Config .. tabs:: .. group-tab:: JSP .. tabularcolumns:: |p{0.10\linewidth}|p{0.45\linewidth}|p{0.45\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 45 45 * - 項番 - 対象ファイル - カスタマイズ方法 * - 1. - メッセージ定義ファイル \ ``[artifactId]/[artifactId]-web/src/main/resources/i18n/application-messages.properties``\ - プロパティキーに指定しているメッセージIDのプロジェクト区分の暫定値「\ ``xx``\ 」を、適切な値に修正する。 * - 2. - エラー画面用のJSP \ ``[artifactId]/[artifactId]-web/src/main/webapp/WEB-INF/views/common/error/*.jsp``\ - \ ````\ 要素の\ ``code``\ 属性に指定しているメッセージIDのプロジェクト区分の暫定値「\ ``xx``\ 」を、適切な値に修正する。 * - 3. - Webアプリケーション用のアプリケーションコンテキストを作成するためのBean定義ファイル \ ``[artifactId]/[artifactId]-web/src/main/java/com/example/todo/config/app/ApplicationContextConfig.java``\ - BeanIDが\ ``exceptionCodeResolver``\ のBean定義内で指定している例外コード(メッセージID)のプロジェクト区分の暫定値「\ ``xx``\ 」を、適切な値に修正する。 .. group-tab:: Thymeleaf .. tabularcolumns:: |p{0.10\linewidth}|p{0.45\linewidth}|p{0.45\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 45 45 * - 項番 - 対象ファイル - カスタマイズ方法 * - 1. - メッセージ定義ファイル \ ``[artifactId]/[artifactId]-web/src/main/resources/i18n/application-messages.properties``\ - プロパティキーに指定しているメッセージIDのプロジェクト区分の暫定値「\ ``xx``\ 」を、適切な値に修正する。 * - 2. - エラー画面用のThymeleafのテンプレートHTML \ ``[artifactId]/[artifactId]-web/src/main/webapp/WEB-INF/views/common/error/*.html（unhandledSystemError.htmlを除く）``\ - \ ``
``\ 要素の\ ``th:text``\ 属性に指定しているメッセージIDのプロジェクト区分の暫定値「\ ``xx``\ 」を、適切な値に修正する。 * - 3. - Webアプリケーション用のアプリケーションコンテキストを作成するためのBean定義ファイル \ ``[artifactId]/[artifactId]-web/src/main/java/com/example/todo/config/app/ApplicationContextConfig.java``\ - BeanIDが\ ``exceptionCodeResolver``\ のBean定義内で指定している例外コード(メッセージID)のプロジェクト区分の暫定値「\ ``xx``\ 」を、適切な値に修正する。 .. group-tab:: XML Config .. tabs:: .. group-tab:: JSP .. tabularcolumns:: |p{0.10\linewidth}|p{0.45\linewidth}|p{0.45\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 45 45 * - 項番 - 対象ファイル - カスタマイズ方法 * - 1. - メッセージ定義ファイル \ ``[artifactId]/[artifactId]-web/src/main/resources/i18n/application-messages.properties``\ - プロパティキーに指定しているメッセージIDのプロジェクト区分の暫定値「\ ``xx``\ 」を、適切な値に修正する。 * - 2. - エラー画面用のJSP \ ``[artifactId]/[artifactId]-web/src/main/webapp/WEB-INF/views/common/error/*.jsp``\ - \ ````\ 要素の\ ``code``\ 属性に指定しているメッセージIDのプロジェクト区分の暫定値「\ ``xx``\ 」を、適切な値に修正する。 * - 3. - Webアプリケーション用のアプリケーションコンテキストを作成するためのBean定義ファイル \ ``[artifactId]/[artifactId]-web/src/main/resources/META-INF/spring/applicationContext.xml``\ - BeanIDが\ ``exceptionCodeResolver``\ のBean定義内で指定している例外コード(メッセージID)のプロジェクト区分の暫定値「\ ``xx``\ 」を、適切な値に修正する。 .. group-tab:: Thymeleaf .. tabularcolumns:: |p{0.10\linewidth}|p{0.45\linewidth}|p{0.45\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 45 45 * - 項番 - 対象ファイル - カスタマイズ方法 * - 1. - メッセージ定義ファイル \ ``[artifactId]/[artifactId]-web/src/main/resources/i18n/application-messages.properties``\ - プロパティキーに指定しているメッセージIDのプロジェクト区分の暫定値「\ ``xx``\ 」を、適切な値に修正する。 * - 2. - エラー画面用のThymeleafのテンプレートHTML \ ``[artifactId]/[artifactId]-web/src/main/webapp/WEB-INF/views/common/error/*.html（unhandledSystemError.htmlを除く）``\ - \ ``
``\ 要素の\ ``th:text``\ 属性に指定しているメッセージIDのプロジェクト区分の暫定値「\ ``xx``\ 」を、適切な値に修正する。 * - 3. - Webアプリケーション用のアプリケーションコンテキストを作成するためのBean定義ファイル \ ``[artifactId]/[artifactId]-web/src/main/resources/META-INF/spring/applicationContext.xml``\ - BeanIDが\ ``exceptionCodeResolver``\ のBean定義内で指定している例外コード(メッセージID)のプロジェクト区分の暫定値「\ ``xx``\ 」を、適切な値に修正する。 | .. _BlankProjectMessageWording: メッセージ文言 -------------------------------------------------------------------------------- | Maven Archetypeで作成したプロジェクトでは、いくつかのメッセージ定義を提供しているが、メッセージ文言は簡易的なメッセージになっている。 | 例として、ブランクプロジェクトのメッセージ(サンプリング)を以下に示す。 | \ **アプリケーション要件(メッセージ規約など)に合わせて修正すること。**\ \ **[application-messages.properties]**\ .. code-block:: properties e.xx.fw.5001 = Resource not found. # omitted # typemismatch typeMismatch="{0}" is invalid. # omitted | カスタマイズ対象のファイルとカスタマイズ方法を以下に示す。 .. tabularcolumns:: |p{0.10\linewidth}|p{0.45\linewidth}|p{0.45\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 45 45 * - 項番 - 対象ファイル - カスタマイズ方法 * - 1. - メッセージ定義ファイル \ ``[artifactId]/[artifactId]-web/src/main/resources/i18n/application-messages.properties``\ - アプリケーション要件に応じたメッセージに修正する。 | 入力チェックでエラーとなった際に表示するメッセージ(Bean Validationのメッセージ)についても、アプリケーション要件に応じて修正(デフォルトメッセージの上書き)が必要になる。 | デフォルトメッセージの上書き方法については、「\ :ref:`ValidationMessageDef`\ 」を参照されたい。 | .. _BlankProjectErrorScreen: エラー画面 -------------------------------------------------------------------------------- Maven Archetypeで作成したプロジェクトでは、エラーの種類毎にエラー画面を表示するためのJSP及びHTMLを提供しているが、 * 画面レイアウト * 画面タイトル * メッセージの文言 | などが簡易的な実装になっている。 | 例として、ブランクぽプロジェクトの実装(サンプリング)を以下に示す。 | \ **エラー画面を表示するためのJSPとHTMLについては、アプリケーション要件(UI規約など)に合わせて修正すること。**\ .. tabs:: .. group-tab:: JSP \ **[JSP]**\ .. code-block:: jsp Resource Not Found Error!

Resource Not Found Error!

[${f:h(exceptionCode)}]


| カスタマイズ対象のファイルとカスタマイズ方法を以下に示す。 .. tabularcolumns:: |p{0.10\linewidth}|p{0.45\linewidth}|p{0.45\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 45 45 * - 項番 - 対象ファイル - カスタマイズ方法 * - 1. - エラー画面用のJSP \ ``[artifactId]/[artifactId]-web/src/main/webapp/WEB-INF/views/common/error/*.jsp``\ - アプリケーション要件(UI規約など)に合わせて修正する。 エラー画面を表示するJSPをカスタマイズする際は、「\ :doc:`../ArchitectureInDetail/WebApplicationDetail/ExceptionHandling`\ の \ :ref:`exception-handling-how-to-use-codingpoint-jsp-label`\ 」を参照されたい。 * - 2. - エラー画面用のHTML \ ``[artifactId]/[artifactId]-web/src/main/webapp/WEB-INF/views/common/error/unhandledSystemError.html``\ - アプリケーション要件(UI規約など)に合わせて修正する。 .. group-tab:: Thymeleaf \ **[HTML]**\ .. code-block:: html Resource Not Found Error!

Resource Not Found Error!

[e.xx.fw.5001] Resource not found.
  • error detail message


| カスタマイズ対象のファイルとカスタマイズ方法を以下に示す。 .. tabularcolumns:: |p{0.10\linewidth}|p{0.45\linewidth}|p{0.45\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 45 45 * - 項番 - 対象ファイル - カスタマイズ方法 * - 1. - エラー画面用のテンプレートHTML \ ``[artifactId]/[artifactId]-web/src/main/webapp/WEB-INF/views/common/error/*.html（unhandledSystemError.htmlを除く）``\ - アプリケーション要件(UI規約など)に合わせて修正する。 エラー画面を表示するテンプレートHTMLをカスタマイズする際は、「\ :doc:`../ArchitectureInDetail/WebApplicationDetail/ExceptionHandling`\ の \ :ref:`exception-handling-how-to-use-codingpoint-jsp-label`\ 」を参照されたい。 * - 2. - エラー画面用の静的なHTML \ ``[artifactId]/[artifactId]-web/src/main/webapp/WEB-INF/views/common/error/unhandledSystemError.html``\ - アプリケーション要件(UI規約など)に合わせて修正する。 | .. _BlankProjectCopyrightInScreenFooter: 画面フッターの著作権 -------------------------------------------------------------------------------- | Maven Archetypeで作成したプロジェクトでは、画面フッター部の著作権が暫定値「\ ``Copyright © 20XX CompanyName``\ 」の状態になっているため、適切な値を指定すること。 | 例として、ブランクプロジェクトの実装（サンプリング）を以下に示す。 .. tabs:: .. group-tab:: JSP \ **[home.jsp]**\ .. code-block:: jsp

Hello world!

The time on the server is ${serverTime}.

\ **[footer.jsp]**\ .. code-block:: jsp

Copyright © 20XX CompanyName

| カスタマイズ対象のファイルとカスタマイズ方法を以下に示す。 .. tabularcolumns:: |p{0.10\linewidth}|p{0.45\linewidth}|p{0.45\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 45 45 * - 項番 - 対象ファイル - カスタマイズ方法 * - 1. - フッターJSP \ ``[artifactId]/[artifactId]-web/src/main/webapp/WEB-INF/views/layout/footer.jsp``\ - 著作権の暫定値「\ ``Copyright © 20XX CompanyName``\ 」を適切な値に修正する。 .. group-tab:: Thymeleaf \ **[template.html]**\ .. code-block:: html

projectName

Hello world!

The time on the server is 2018/01/01 00:00:00 JST.

Copyright © 20XX CompanyName

| カスタマイズ対象のファイルとカスタマイズ方法を以下に示す。 .. tabularcolumns:: |p{0.10\linewidth}|p{0.45\linewidth}|p{0.45\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 45 45 * - 項番 - 対象ファイル - カスタマイズ方法 * - 1. - Thymeleafのテンプレートレイアウト用のHTMLファイル \ ``[artifactId]/[artifactId]-web/src/main/webapp/WEB-INF/views/layout/template.html``\ - 著作権の暫定値「\ ``Copyright © 20XX CompanyName``\ 」を適切な値に修正する。 | .. _BlankProjectDeleteInMemoryDatabase: インメモリデータベース(H2 Database)の削除 -------------------------------------------------------------------------------- Maven Archetypeで作成したプロジェクトには、インメモリデータベース(H2 Database)をセットアップするための設定が行われているが、これはちょっとした動作検証(プロトタイプ作成やPpC(Proof of Concept))を行うための設定である。そのため、本格的なアプリケーション開発を行う場合は、不要な設定になる。 \ **本格的なアプリケーション開発を行う場合は、インメモリデータベース(H2 Database)をセットアップするための定義とSQLを管理するためのディレクトリを削除すること。**\ .. tabs:: .. group-tab:: Java Config \ **[artifactId]EnvConfig.java**\ .. code-block:: java @Value("${database}") private String database; @Bean public DataSourceInitializer dataSourceInitializer(DataSource dataSource) { DataSourceInitializer bean = new DataSourceInitializer(); bean.setDataSource(dataSource); ResourceDatabasePopulator databasePopulator = new ResourceDatabasePopulator(); databasePopulator.addScript(new ClassPathResource("/database/" + database + "-schema.sql")); databasePopulator.addScript(new ClassPathResource("/database/" + database + "-dataload.sql")); databasePopulator.setSqlScriptEncoding("UTF-8"); databasePopulator.setIgnoreFailedDrops(true); bean.setDatabasePopulator(databasePopulator); return bean; } .. code-block:: text └ src └ main └ resources ├ META-INF (...) ├ database │ ├ H2-dataload.sql │ └ H2-schema.sql | カスタマイズ対象のファイルとカスタマイズ方法を以下に示す。 .. tabularcolumns:: |p{0.10\linewidth}|p{0.45\linewidth}|p{0.45\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 45 45 * - 項番 - 対象ファイル - カスタマイズ方法 * - 1. - 環境依存するコンポーネントを定義するBean定義ファイル \ ``[artifactId]-env/src/main/java/com/example/todo/config/app/[artifactId]EnvConfig.java``\ - \ ``DataSourceInitializer``\ Beanを削除する。 * - 2. - インメモリデータベース(H2 Database)をセットアップするためのSQLを格納するディレクトリ \ ``[artifactId]/[artifactId]-env/src/main/resources/database/``\ - ディレクトリを削除する。 .. group-tab:: XML Config \ **[artifactId]-env.xml**\ .. code-block:: xml .. code-block:: text └ src └ main └ resources ├ META-INF (...) ├ database │ ├ H2-dataload.sql │ └ H2-schema.sql | カスタマイズ対象のファイルとカスタマイズ方法を以下に示す。 .. tabularcolumns:: |p{0.10\linewidth}|p{0.45\linewidth}|p{0.45\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 45 45 * - 項番 - 対象ファイル - カスタマイズ方法 * - 1. - 環境依存するコンポーネントを定義するBean定義ファイル \ ``[artifactId]-env/src/main/resources/META-INF/spring/[artifactId]-env.xml``\ - \ ````\ 要素を削除する。 * - 2. - インメモリデータベース(H2 Database)をセットアップするためのSQLを格納するディレクトリ \ ``[artifactId]/[artifactId]-env/src/main/resources/database/``\ - ディレクトリを削除する。 | .. _BlankProjectDataSourceSetting: データソース設定 -------------------------------------------------------------------------------- Maven Archetypeで作成したプロジェクトでは、インメモリデータベース(H2 Database)にアクセスするためのデータソース設定が行われている。 \ **[artifactId]/[artifactId]-domain/pom.xml**\ .. code-block:: xml com.h2database h2 runtime \ **[artifactId]-infra.properties**\ .. code-block:: properties database=H2 database.url=jdbc:h2:mem:todo;DB_CLOSE_DELAY=-1 database.username=sa database.password= database.driverClassName=org.h2.Driver # connection pool cp.maxActive=96 cp.maxIdle=16 cp.minIdle=0 cp.maxWait=60000 上記の\ ``[artifactId]-infra.properties``\の内容についての説明は「 \ :ref:`BlankProjectInfraProperties`\ 」を参照されたい。 .. tabs:: .. group-tab:: Java Config \ **[artifactId]EnvConfig.java**\ .. code-block:: java @Value("${database.url}") private String url; @Value("${database.username}") private String username; @Value("${database.password}") private String password; @Value("${cp.maxActive}") private Integer maxActive; @Value("${cp.maxIdle}") private Integer maxIdle; @Value("${cp.minIdle}") private Integer minIdle; @Value("${cp.maxWait}") private Integer maxWait; @Bean(name = "dataSource", destroyMethod = "close") public DataSource dataSource() { BasicDataSource bean = new BasicDataSource(); // (1) bean.setDriverClassName(driverClassName); // (2) bean.setUrl(url); // (3) bean.setUsername(username); // (4) bean.setPassword(password); // (5) bean.setDefaultAutoCommit(false); // (6) bean.setMaxTotal(maxActive); bean.setMaxIdle(maxIdle); bean.setMinIdle(minIdle); bean.setMaxWait(Duration.ofMillis(maxWait)); return bean; } .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 * - 項番 - 説明 * - | (1) - データソースの実装クラスを指定する。例では、Apache Commons DBCPから提供されているデータソースクラス(\ ``org.apache.commons.dbcp2.BasicDataSource``\ )を指定する。 * - | (2) - JDBCドライバクラスを指定する。 * - | (3) - 接続URLを指定する。 【環境に合わせて変更が必要】 * - | (4) - 接続ユーザ名を指定する。【環境に合わせて変更が必要】 * - | (5) - 接続ユーザのパスワードを指定する。【環境に合わせて変更が必要】 * - | (6) - 自動コミットフラグのデフォルト値を指定する。falseを指定する。トランザクション管理下であれば、強制的にfalseになる。 .. group-tab:: XML Config \ **[artifactId]-env.xml**\ .. code-block:: xml .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 * - 項番 - 説明 * - | (1) - データソースの実装クラスを指定する。例では、Apache Commons DBCPから提供されているデータソースクラス(\ ``org.apache.commons.dbcp2.BasicDataSource``\ )を指定する。 * - | (2) - JDBCドライバクラスを指定する。 * - | (3) - 接続URLを指定する。 【環境に合わせて変更が必要】 * - | (4) - 接続ユーザ名を指定する。【環境に合わせて変更が必要】 * - | (5) - 接続ユーザのパスワードを指定する。【環境に合わせて変更が必要】 * - | (6) - 自動コミットフラグのデフォルト値を指定する。falseを指定する。トランザクション管理下であれば、強制的にfalseになる。 \ **本格的なアプリケーション開発を行う場合は、アプリケーション稼働時に利用するデータベースにアクセスするためのデータソース設定に変更すること。**\ インメモリデータベース(H2 Database)にアクセスするためのデータソース設定は、ちょっとした動作検証(プロトタイプ作成やPoC(Proof of Concept))を行うための設定である。 そのため、本格的なアプリケーション開発を行う場合は、アプリケーション稼働時に利用するデータベースにアクセスするためのデータソース設定に変更する必要がある。 Maven Archetypeで作成したプロジェクトでは、Apache Commons DBCPを使用する設定となっているが、アプリケーションサーバから提供されているデータソースを使用して、JNDI(Java Naming and Directory Interface)経由でデータソースにアクセスする方法を採用するケースも多い。 開発環境ではApache Commons DBCPのデータソースを使用して、テスト環境及び商用環境ではアプリケーションサーバから提供されているデータソースを使用するといった使い分けを行うケースもある。 データソースの設定方法については、「\ :doc:`../ArchitectureInDetail/DataAccessDetail/DataAccessCommon`\ の \ :ref:`data-access-common_howtouse_datasource`\ 」を参照されたい。 | カスタマイズ対象のファイルとカスタマイズ方法を以下に示す。 .. tabularcolumns:: |p{0.10\linewidth}|p{0.45\linewidth}|p{0.45\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 45 45 * - 項番 - 対象ファイル - カスタマイズ方法 * - 1. - POMファイル * \ ``[artifactId]/pom.xml``\ * \ ``[artifactId]/[artifactId]-web/pom.xml``\ - インメモリデータベース(H2 Database)のJDBCドライバを依存ライブラリから削除する。 アプリケーション稼働時に利用するデータベースにアクセスするためのJDBCドライバを依存ライブラリに追加する。 * - 2. - 環境依存する設定値を定義するプロパティファイル \ ``[artifactId]/[artifactId]-env/src/main/resources/META-INF/spring/[artifactId]-infra.properties``\ - データソースとしてApache Commons DBCPを使用する場合は、以下のプロパティにアプリケーション稼働時に利用するデータベースにアクセスするための接続情報を指定する。 * \ ``database``\ * \ ``database.url``\ * \ ``database.username``\ * \ ``database.password``\ * \ ``database.driverClassName``\ アプリケーションサーバから提供されているデータソースを使用する場合は、以下のプロパティ以外は不要なプロパティになるので削除する。 * \ ``database``\ * - 3. - 環境依存するコンポーネントを定義するBean定義ファイル .. tabs:: .. group-tab:: Java Config \ ``[artifactId]/[artifactId]-env/src/main/java/com/example/project/config/app/[artifactId]EnvConfig.java``\ .. group-tab:: XML Config \ ``[artifactId]/[artifactId]-env/src/main/resources/META-INF/spring/[artifactId]-env.xml``\ - アプリケーションサーバから提供されているデータソースを使用する場合は、JNDI経由で取得したデータソースを使用するように設定を変更する。 データソースの設定方法については、「\ :doc:`../ArchitectureInDetail/DataAccessDetail/DataAccessCommon`\ の \ :ref:`data-access-common_howtouse_datasource`\ 」を参照されたい。 .. note:: \ **環境依存する設定値を定義するプロパティファイルのdatabaseプロパティについて**\ O/R MapperとしてMyBatisを使用する場合は、\ ``database``\ プロパティは不要なプロパティである。削除してもよいが、使用しているデータベースを明示するために設定を残しておいてもよい。 .. tip:: \ **JDBCドライバの追加方法について**\ 使用するデータベースがPostgreSQLとOracleの場合は、POMファイル内のコメントアウトを外せばよい。JDBCドライバのバージョンについては、使用するデータベースのバージョンに対応するバージョンに修正すること。 ただしOracleを使用する場合は、コメントを外す前に、MavenのローカルリポジトリにOracleのJDBCドライバをインストールしておく必要がある。 以下は、PostgreSQLを使用する場合の設定例である。 * \ ``[artifactId]/pom.xml``\ .. code-block:: xml org.postgresql postgresql ${postgresql.version} ${YOUR_POSTGRES_VERSION} ${YOUR_ORACLE_VERSION} * \ ``[artifactId]/[artifactId]-web/pom.xml``\ .. code-block:: xml org.postgresql postgresql runtime .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 * - 項番 - 説明 * - | (1) - JDBCドライバはコンパイルには使用せず、アプリケーション実行時のみ使用するため、\ ``runtime``\ スコープを指定している。 単体テストで使用する場合などは、適切なスコープに変更して使用されたい。 | .. _BlankProjectAppendix: Appendix ================================================================================ .. _BlankProjectDependenciesBetweenBlankProjectAndSharedLibraries: ブランクプロジェクトと共通ライブラリ群との依存関係 -------------------------------------------------------------------------------- Maven Archetypeで作成したブランクプロジェクトと共通ライブラリ群との依存関係を以下に示す。 .. figure:: images_BlankProject/BlankProjectHierarchicalStructure.png :width: 75% .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 :class: longtable * - | 項番 - | 説明 * - | (1) - Maven Archetypeで作成したプロジェクト。 Maven Archetypeで作成したプロジェクトはマルチモジュール構成となっており、親プロジェクトと各サブモジュールは相互参照の関係になっている。 version \ |release|\ 用のMaven Archetypeで作成したプロジェクトでは、親プロジェクトとして「org.terasoluna.gfw:terasoluna-gfw-parent:\ |release|\ 」を指定している。 * - | (2) - TERASOLUNA Server Framework for Java (5.x) Parentプロジェクト。 TERASOLUNA Server Framework for Java (5.x) Parentプロジェクトでは、 * TERASOLUNA Framework For Java (5.x) Dependenciesのインポート * ビルド用のプラグインの設定 を行っている。 * - | (3) - TERASOLUNA Framework For Java (5.x) Dependenciesプロジェクト。 TERASOLUNA Framework For Java (5.x) Dependenciesプロジェクトでは、 * Spring Boot Dependenciesのインポート * Spring Boot経由で管理されているライブラリのカスタマイズ(バージョンの調整) * Spring Bootで管理されていないTERASOLUNA Server Framework for Java (5.x)推奨ライブラリのバージョン管理 を行っている。 利用しているSpring Bootのバージョンは\ :ref:`frameworkstack_using_oss_version`\ 参照のこと。 * - | (4) - Spring Boot Dependenciesプロジェクト。 | .. _BlankProjectRelationshipBetweenApplicationContextConfigurationAndBeanDefinitionFiles: アプリケーションコンテキストの構成とBean定義ファイルの関係 -------------------------------------------------------------------------------- Spring Frameworkのアプリケーションコンテキスト(DIコンテナ)の構成とBean定義ファイルの関係を以下に示す。 .. figure:: images_BlankProject/BlankProjectApplicationContext.png :width: 100% .. tabs:: .. group-tab:: Java Config .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 :class: longtable * - | 項番 - | 説明 * - | (1) - Webアプリケーション用のアプリケーションコンテキスト。 上記図で示す通り、 * [artifactId]-web/src/main/java/com/example/project/config/app/ApplicationContextConfig.java * [artifactId]-domain/src/main/java/com/example/project/config/app/[artifactId]DomainConfig.java * [artifactId]-domain/src/main/java/com/example/project/config/app/[artifactId]InfraConfig.java * [artifactId]-env/src/main/java/com/example/project/config/app/[artifactId]EnvConfig.java * [artifactId]-domain/src/main/java/com/example/project/config/app/[artifactId]CodelistConfig.java * [artifactId]-web/src/main/java/com/example/project/config/app/SpringSecurityConfig.java で定義したコンポーネントがWebアプリケーション用のアプリケーションコンテキスト(DIコンテナ)に登録される。 Webアプリケーション用のアプリケーションコンテキストに登録されているコンポーネントは、各\ ``DispatcherServlet``\ 用のアプリケーションコンテキストから参照する事ができる仕組みとなっている。 * - | (2) - \ ``DispatcherServlet``\ 用のアプリケーションコンテキスト。 上記図で示す通り、 * [artifactId]-web/src/main/java/com/example/project/config/web/SpringMvcConfig.java で定義したコンポーネントが\ ``DispatcherServlet``\ 用のアプリケーションコンテキスト(DIコンテナ)に登録される。 \ ``DispatcherServlet``\ 用のアプリケーションコンテキストに存在しないコンポーネントは、Webアプリケーション用のアプリケーションコンテキスト(親コンテキスト)を参照して取得する仕組みになっているため、ドメイン層のコンポーネントをアプリケーション層のコンポーネントに対してインジェクションする事ができる。 .. group-tab:: XML Config .. tabularcolumns:: |p{0.10\linewidth}|p{0.90\linewidth}| .. list-table:: :header-rows: 1 :widths: 10 90 :class: longtable * - | 項番 - | 説明 * - | (1) - Webアプリケーション用のアプリケーションコンテキスト。 上記図で示す通り、 * [artifactId]-web/src/main/resources/META-INF/spring/applicationContext.xml * [artifactId]-domain/src/main/resources/META-INF/spring/[artifactId]-domain.xml * [artifactId]-domain/src/main/resources/META-INF/spring/[artifactId]-infra.xml * [artifactId]-env/src/main/resources/META-INF/spring/[artifactId]-env.xml * [artifactId]-domain/src/main/resources/META-INF/spring/[artifactId]-codelist.xml * [artifactId]-web/src/main/resources/META-INF/spring/spring-security.xml で定義したコンポーネントがWebアプリケーション用のアプリケーションコンテキスト(DIコンテナ)に登録される。 Webアプリケーション用のアプリケーションコンテキストに登録されているコンポーネントは、各\ ``DispatcherServlet``\ 用のアプリケーションコンテキストから参照する事ができる仕組みとなっている。 * - | (2) - \ ``DispatcherServlet``\ 用のアプリケーションコンテキスト。 上記図で示す通り、 * [artifactId]-web/src/main/resources/META-INF/spring/spring-mvc.xml で定義したコンポーネントが\ ``DispatcherServlet``\ 用のアプリケーションコンテキスト(DIコンテナ)に登録される。 \ ``DispatcherServlet``\ 用のアプリケーションコンテキストに存在しないコンポーネントは、Webアプリケーション用のアプリケーションコンテキスト(親コンテキスト)を参照して取得する仕組みになっているため、ドメイン層のコンポーネントをアプリケーション層のコンポーネントに対してインジェクションする事ができる。 .. caution:: **同じコンポーネントを両方のアプリケーションコンテキストに登録した時の動作について** Webアプリケーション用のアプリケーションコンテキストと ``DispatcherServlet`` 用のアプリケーションコンテキストの両方に同じコンポーネントが登録されている場合は、同じアプリケーションコンテキスト（ ``DispatcherServlet`` 用のアプリケーションコンテキスト）内に登録されているコンポーネントがインジェクションされる点を補足しておく。 特に、ドメイン層のコンポーネント（ServiceやRepositoryなど）を ``DispatcherServlet`` 用のアプリケーションコンテキストに登録してしまうと、トランザクション制御を行うコンポーネント（AOP）が有効にならないため、データベースへの操作がコミットされない不具合が発生してしまう。 | 複数のアプリケーションを持つ開発プロジェクトについて -------------------------------------------------------------------------------- 複数のアプリケーションを持つ開発プロジェクトについては、以下のようなマルチプロジェクト構成にすることを推奨する。 .. tabularcolumns:: |p{0.20\linewidth}|p{0.80\linewidth}| .. list-table:: :header-rows: 1 :widths: 20 80 * - プロジェクト名 - 説明 * - bar-parent - parent-pom（親POM）と呼ばれるプロジェクト。 pom.xmlファイルだけを持ち、その他のソースコードや設定ファイルは一切持たない、シンプルなプロジェクト。 他のプロジェクトのpom上で、このbar-parentプロジェクトをタグに指定することによって、親POMに指定された共通設定情報を自身に反映させることができる。 * - bar-initdb - RDBMSのテーブル定義(DDL)と初期データをINSERTするためのSQL文を格納する。 これもmavenプロジェクトとして管理する。 pom.xmlに\ :url_mojohaus:`sql-maven-plugin `\ の設定を定義することにより、ビルドライフサイクルの過程で任意のRDBMSに対するDDL文や初期データINSERT文の実行を自動化することができる。 * - bar-common - プロジェクト共通ライブラリを格納する。 ここはweb非依存にし、webに関わるクラスはbar-common-webに配置する。 * - bar-common-web - プロジェクト共通webライブラリを格納する。 * - bar-domain-a - aドメインに関わるドメイン層のjavaクラス、単体テストケース等を格納するプロジェクト。 最終的に*.jarファイル化する。 * - bar-domain-b - bドメインに関わるドメイン層のクラス。 * - bar-web-a - アプリケーション層のjavaクラス、jsp/html、設定ファイル、単体テストケース等を格納するプロジェクト。 最終的にWebアプリケーションとして*.warファイル化する。 bar-web-aは、bar-commonとbar-envへの依存性を持つ。 * - bar-web-b - もう一つのサブシステムとしてのWebアプリケーション。 構造はbar-web-aと同じ。 * - bar-env - 環境依存性のある設定ファイルだけを集めるプロジェクト。 * - bar-web-a-selenium - web-aプロジェクトのための、\ :url_selenium:`Selenium WebDriver `\ によるテストケースを格納するプロジェクト。 * - bar-web-b-selenium - web-bプロジェクトのための、\ :url_selenium:`Selenium WebDriver `\ によるテストケースを格納するプロジェクト。 | .. raw:: latex \newpage