Spring MVCアーキテクチャ概要 -------------------------------- .. only:: html .. contents:: 目次 :local: | Spring MVCとは、Servlet APIをベースに構築されたフレームワークであり、リクエストによって実行するアクションを決定し処理の結果をHTMLとして返却する\ **M**\ odel、\ **V**\ iew、\ **C**\ ontrolerを用いたアーキテクチャのことである。 詳しくは、\ `Spring Framework Documentation `_\ を参照されたい。 | .. _SpringMVCOverview: Overview of Spring MVC Processing Sequence ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ リクエストを受けてから、レスポンスを返すまでのSpring MVCの処理フローを、以下の図に示す。 .. figure:: ./images_SpringMVCOverview/RequestLifecycle.png :alt: request lifecycle :width: 100% 1. \ ``DispatcherServlet``\ が、リクエストを受け取る。 2. \ ``DispatcherServlet``\ は、リクエスト処理を行う\ ``Controller``\ の選択を\ ``HandlerMapping``\ に委譲する。\ ``HandlerMapping``\ は、リクエストURLにマッピングされている\ ``Controller``\ を選定し\ ``（Choose Handler）``\ 、 \ ``Controller``\ を\ ``DispatcherServlet``\ へ返却する。 3. \ ``DispatcherServlet`` は、\ ``Controller``\ のビジネスロジック処理の実行を\ ``HandlerAdapter``\ に委譲する。 4. \ ``HandlerAdapter`` は、\ ``Controller``\ のビジネスロジック処理を呼び出す。 5. \ ``Controller``\ は、ビジネスロジックを実行し、処理結果を\ ``Model``\ に設定し、ビューの論理名を\ ``HandlerAdapter``\ に返却する。 6. \ ``DispatcherServlet``\ は、ビュー名に対応する\ ``View``\ の解決を、\ ``ViewResolver``\ に委譲する。\ ``ViewResolver``\ は、ビュー名にマッピングされている\ ``View``\ を返却する。 7. \ ``DispatcherServlet``\ は、返却された\ ``View``\ にレンダリング処理を委譲する。 8. \ ``View``\ は、\ ``Model``\ の持つ情報をレンダリングしてレスポンスを返却する。 | Implementations of each component ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ これまで説明したコンポーネントのうち、拡張可能なコンポーネントを紹介する。 Implementation of HandlerMapping ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Springから提供されている\ ``HandlerMapping``\ のクラス階層を、以下に示す。 .. figure:: ./images_SpringMVCOverview/HandlerMapping-Hierarchy.png :alt: HandlerMapping Hierarchy | 通常使用するのは、\ ``org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping``\ である。 | このクラスは、Bean定義されている\ ``Contorller``\ から\ ``@RequestMapping``\ アノテーションを読み取り、 | URLと合致する\ ``Controller``\ のメソッドをHandlerクラスとして扱うクラスである。 | Spring Framework 3.1からは、\ ``RequestMappingHandlerMapping``\ は、\ ``DispatcherServlet``\ が読み込むBean定義ファイルに、 | \ ````\ の設定がある場合、デフォルトで設定される。 | (\ ````\ アノテーションで有効になる設定は、\ `Spring Framework Documentation -Enable MVC Configuration- `_\ を参照されたい。) | Implementation of HandlerAdapter ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Springから提供されている\ ``HandlerAdapter``\ のクラス階層を、以下に示す。 .. figure:: ./images_SpringMVCOverview/HandlerAdapter-Hierarchy.png :alt: HandlerAdapter Hierarchy | 通常使用するのは、\ ``org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter``\ である。 | このクラスは、\ ``HandlerMapping``\ によって選択されたHandlerクラス(\ ``Controller``\ )のメソッドを呼び出すクラスである。 | このクラスもSpring Framework 3.1からは、\ ````\ の設定がある場合、デフォルトで設定される。 | Implementation of ViewResolver ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Springおよび依存ライブラリから提供されている\ ``ViewResolver``\ のクラスを、以下に示す。 .. figure:: ./images_SpringMVCOverview/ViewResolver-Hierarchy.png :alt: ViewResolver Hierarchy Thymeleafを使う場合は、 * \ ``org.thymeleaf.spring6.view.ThymeleafViewResolver``\ ファイルダウンロード用にストリームを返す場合は * \ ``org.springframework.web.servlet.view.BeanNameViewResolver``\ のように、返す\ ``View``\ によって使い分ける必要がある。 | 複数の種類の\ ``View``\ を扱う場合、\ ``ViewResolver``\ の定義が複数必要となるケースがある。 | 複数の\ ``ViewResolver``\ を使う代表的な例として、ファイルのダウンロード処理が存在する画面アプリケーションが挙げられる。 | 画面(Thymeleaf)は、\ ``ThymeleafViewResolver``\ で\ ``View``\ を解決し、 | ファイルダウンロードは、\ ``BeanNameViewResolver``\ などを使って\ ``View``\ を解決する。 | 詳細は\ :doc:`../ArchitectureInDetail/WebApplicationDetail/FileDownload`\ を参照されたい。 | Implementation of View ^^^^^^^^^^^^^^^^^^^^^^ Springおよび依存ライブラリから提供されている\ ``View``\ のクラスを、以下に示す。 .. figure:: ./images_SpringMVCOverview/View-Hierarchy.png :alt: View Hierarchy | \ ``View``\ は、返したいレスポンスの種類によって変わる。 | Thymeleafにより生成されたHTMLを返す場合、\ ``org.thymeleaf.spring6.view.ThymeleafView``\ が使用される。 | Springおよび依存ライブラリから提供されていない\ ``View``\ を扱いたい場合、\ ``View``\ インタフェースを実装したクラスを拡張する必要がある。 | 詳細は\ :doc:`../ArchitectureInDetail/WebApplicationDetail/FileDownload`\ を参照されたい。 .. raw:: latex \newpage