1.2. このドキュメントが示すこと¶
本ガイドラインではSpring、Spring MVCやJPA、MyBatisを中心としたフルスタックフレームワークを利用して、 保守性の高いWebアプリケーション開発をするためのベストプラクティスを提供する。
本ガイドラインを読むことで、ソフトウェア開発(主にコーディング)が円滑に進むことを期待する。
1.3. このドキュメントの対象読者¶
本ガイドラインはソフトウェア開発経験のあるアーキテクトやプログラマ向けに書かれており、 以下の知識があることを前提としている。
- Spring FrameworkのDIやAOPに関する基礎的な知識がある
- Servlet/JSPを使用してWebアプリケーションを開発したことがある
- SQLに関する知識がある
- Mavenを使用してWebアプリケションをビルドしたことがある
これからJavaを勉強し始めるという人向けではない。
Spring Frameworkに関して、本ドキュメントを読むための基礎知識があるかどうかを測るために Spring Framework理解度チェックテストを参照されたい。 この理解度テストが4割回答できない場合は、別途以下のような入門書籍で学習することを推奨する。
1.4. このドキュメントの構成¶
- TERASOLUNA Global Frameworkのアーキテクチャ概要
- Spring MVCの概要や、TERASOLUNA Global Frameworkの基本的な考え方を説明する。
- チュートリアル(Todoアプリケーション)
- 簡単なアプリケーション開発を通して、TERASOLUNA Global Frameworkによるアプリケーション開発を体験する。
- TERASOLUNA Global Frameworkによるアプリケーション開発
- TERASOLUNA Global Frameworkを利用してアプリケーション開発する上で必ず押さえておかなくてはならない知識や作法について説明する。
- TERASOLUNA Global Frameworkの機能詳細
- 一般的にアプリケーション開発で必要となる機能をTERASOLUNA Global Frameworkを利用してどう実装するか、何に気を付けるべきかを機能ごとに説明する。
- TERASOLUNA Global Frameworkによるセキュリティ対策
- Spring Securityを中心としたセキュリティ対策について説明する。
- Appendix
- TERASOLUNA Global Frameworkを利用する場合の付加情報を説明する。
1.5. このドキュメントの読み方¶
まずは”TERASOLUNA Global Frameworkのアーキテクチャ概要” から読み進めていただきたい。特にSpring MVCの経験がない場合は”はじめてのSpring MVCアプリケーション”を実施すること。 “アプリケーションのレイヤ化”は本ガイドラインで共通する用語と概念の説明を行っているため、必ず一読されたい。
次に”チュートリアル(Todoアプリケーション)”に進む。 このチュートリアルでは”習うより慣れろ”を目的として、 詳細な説明の前にまず手を動かして、TERASOLUNA Global Frameworkによるアプリケーション開発を体感していただきたい。
チュートリアルを実践したのちに、”TERASOLUNA Global Frameworkによるアプリケーション開発”でアプリケーション開発の詳細を学ぶ。 特に”アプリケーション層の実装”でSpring MVCによる開発のノウハウを凝集して説明しているため、 何度も読み返すことを推奨する。 本章を読み終えた後にもう一度”チュートリアル(Todoアプリケーション)”を振り返るとより理解が深まる。
ここまではTERASOLUNA Global Frameworkを使用するすべての開発者が読むことを強く推奨する。
“TERASOLUNA Global Frameworkの機能詳細”、”TERASOLUNA Global Frameworkによるセキュリティ対策”については 目的に応じて必要なタイミングで参照すればよい。ただし、”入力チェック”はアプリケーション開発で通常は必要となるため、基本的には読んでおくこと。
テクニカルリーダーはこれらをすべて読み内容を把握した上で プロジェクトにおいて、どのような方針を定めるか検討していただきたい。