2.1. TERASOLUNA Server Framework for Java (5.x)のスタック

Caution

本バージョンの内容は既に古くなっています。最新のガイドラインはこちらからご参照ください。

2.1.1. TERASOLUNA Server Framework for Java (5.x)のSoftware Framework概要

TERASOLUNA Server Framework for Java (5.x)で使用するSoftware Frameworkは独自のフレームワークではなく、Spring Frameworkを中心としたOSSの組み合わせである。

../_images/introduction-software-framework.png

2.1.2. Software Frameworkの主な構成要素

TERASOLUNA Server Framework for Java (5.x)を構成するライブラリを以下に示す。

../_images/introduction-software-stack.png

2.1.2.1. DIコンテナ

DIコンテナとしてSpring Frameworkを利用する。

2.1.2.2. MVCフレームワーク

Web MVCフレームワークとしてSpring MVCを利用する。

2.1.2.3. O/R Mapper

本ガイドラインでは、以下のいずれかを想定している。

Note

MyBatisは正確には「SQL Mapper」であるが、本ガイドラインでは「O/R Mapper」に分類する。

Warning

どんなプロジェクトでもJPAを採用できるわけではない。”テーブルがほとんど正規化されいない”、”テーブルのカラム数が多すぎる”というテーブル設計がされている場合に、JPAの利用は難しい。

また、本ガイドラインではJPAの基本的な説明は行っておらず、JPA利用経験者がチーム内にいることが前提である。

2.1.2.4. View

ViewにはJSPを利用する。

Viewのレイアウトを共通化する場合は、

を利用する。

2.1.2.5. セキュリティ

認証・認可のフレームワークとしてSpring Securityを利用する。

Tip

Spring Security 3.2 から、認証・認可の仕組みの提供に加えて、 悪意のある攻撃者からWebアプリケーションを守るための仕組みが強化されている。

悪意のある攻撃者からWebアプリケーションを守るための仕組みについては、

を参照されたい。

2.1.2.6. バリデーション

2.1.2.7. ロギング

  • ロガーのAPIはSLF4Jを使用する。
    • ロガーの実装は、Logbackを利用する。

2.1.3. 利用するOSSのバージョン

version 5.0.1.RELEASEで利用するOSSの一覧を以下に示す。

Tip

version 5.0.0.RELEASEより、 Spring IO platform<dependencyManagement>をインポートする構成を採用している。

Spring IO platformの<dependencyManagement>をインポートすることで、

  • Spring Frameworkが提供しているライブラリ
  • Spring Frameworkが依存しているOSSライブラリ
  • Spring Frameworkと相性のよいOSSライブラリ

への依存関係を解決しており、 TERASOLUNA Server Framework for Java (5.x)で使用するOSSのバージョンは、原則として、Spring IO platformの定義に準じている。

なお、version 5.0.1.RELEASEで指定しているSpring IO platformのバージョンは、1.1.3.RELEASEである。

Type GroupId ArtifactId Version Spring IO platform Remarks
Spring org.springframework spring-aop 4.1.7.RELEASE *  
Spring org.springframework spring-aspects 4.1.7.RELEASE *  
Spring org.springframework spring-beans 4.1.7.RELEASE *  
Spring org.springframework spring-context 4.1.7.RELEASE *  
Spring org.springframework spring-context-support 4.1.7.RELEASE *  
Spring org.springframework spring-core 4.1.7.RELEASE *  
Spring org.springframework spring-expression 4.1.7.RELEASE *  
Spring org.springframework spring-jdbc 4.1.7.RELEASE *  
Spring org.springframework spring-orm 4.1.7.RELEASE *  
Spring org.springframework spring-tx 4.1.7.RELEASE *  
Spring org.springframework spring-web 4.1.7.RELEASE *  
Spring org.springframework spring-webmvc 4.1.7.RELEASE *  
Spring org.springframework.data spring-data-commons 1.9.3.RELEASE *  
Spring org.springframework.security spring-security-acl 3.2.7.RELEASE *  
Spring org.springframework.security spring-security-config 3.2.7.RELEASE *  
Spring org.springframework.security spring-security-core 3.2.7.RELEASE *  
Spring org.springframework.security spring-security-taglibs 3.2.7.RELEASE *  
Spring org.springframework.security spring-security-web 3.2.7.RELEASE *  
MyBatis3 org.mybatis mybatis 3.2.8   *1
MyBatis3 org.mybatis mybatis-spring 1.2.2   *1
JPA(Hibernate) antlr antlr 2.7.7 * *2
JPA(Hibernate) dom4j dom4j 1.6.1 * *2
JPA(Hibernate) org.hibernate hibernate-core 4.3.10.Final * *2
JPA(Hibernate) org.hibernate hibernate-entitymanager 4.3.10.Final * *2
JPA(Hibernate) org.hibernate.common hibernate-commons-annotations 4.0.5.Final * *2 *4
JPA(Hibernate) org.hibernate.javax.persistence hibernate-jpa-2.1-api 1.0.0.Final * *2 *4
JPA(Hibernate) org.javassist javassist 3.18.1-GA * *2
JPA(Hibernate) org.jboss jandex 1.1.0.Final * *2 *4
JPA(Hibernate) org.jboss.logging jboss-logging-annotations 1.2.0.Final * *2 *4 *5
JPA(Hibernate) org.jboss.spec.javax.transaction jboss-transaction-api_1.2_spec 1.0.0.Final * *2 *4
JPA(Hibernate) org.springframework.data spring-data-jpa 1.7.3.RELEASE * *2
DI javax.inject javax.inject 1 *  
AOP aopalliance aopalliance 1 *  
AOP org.aspectj aspectjrt 1.8.6 *  
AOP org.aspectj aspectjweaver 1.8.6 *  
ログ出力 ch.qos.logback logback-classic 1.1.3 *  
ログ出力 ch.qos.logback logback-core 1.1.3 * *4
ログ出力 org.lazyluke log4jdbc-remix 0.2.7    
ログ出力 org.slf4j jcl-over-slf4j 1.7.12 *  
ログ出力 org.slf4j slf4j-api 1.7.12 *  
JSON com.fasterxml.jackson.core jackson-annotations 2.4.6 *  
JSON com.fasterxml.jackson.core jackson-core 2.4.6 *  
JSON com.fasterxml.jackson.core jackson-databind 2.4.6 *  
JSON com.fasterxml.jackson.datatype jackson-datatype-joda 2.4.6 *  
入力チェック javax.validation validation-api 1.1.0.Final *  
入力チェック org.hibernate hibernate-validator 5.1.3.Final *  
入力チェック org.jboss.logging jboss-logging 3.1.3.GA * *4
入力チェック com.fasterxml classmate 1.0.0 * *4
Bean変換 commons-beanutils commons-beanutils 1.9.2 * *3
Bean変換 net.sf.dozer dozer 5.5.1   *3
Bean変換 net.sf.dozer dozer-spring 5.5.1   *3
Bean変換 org.apache.commons commons-lang3 3.3.2 * *3
日付操作 joda-time joda-time 2.5 *  
日付操作 joda-time joda-time-jsptags 1.1.1   *3
日付操作 org.jadira.usertype usertype.core 3.2.0.GA   *2
日付操作 org.jadira.usertype usertype.spi 3.2.0.GA   *2
コネクションプール org.apache.commons commons-dbcp2 2.0.1 * *3
コネクションプール org.apache.commons commons-pool2 2.2 * *3
Tiles commons-digester commons-digester 2.1 * *3
Tiles org.apache.tiles tiles-api 3.0.5 * *3
Tiles org.apache.tiles tiles-core 3.0.5 * *3
Tiles org.apache.tiles tiles-jsp 3.0.5 * *3
Tiles org.apache.tiles tiles-servlet 3.0.5 * *3
Tiles org.apache.tiles tiles-template 3.0.5 * *3 *4
Tiles org.apache.tiles tiles-autotag-core-runtime 1.1.0 * *3 *4
Tiles org.apache.tiles tiles-request-servlet 1.0.6 * *3 *4
Tiles org.apache.tiles tiles-request-api 1.0.6 * *3
Tiles org.apache.tiles tiles-request-jsp 1.0.6 * *3 *4
ユーティリティ com.google.guava guava 17.0 *  
ユーティリティ commons-collections commons-collections 3.2.1 * *3
ユーティリティ commons-io commons-io 2.4 * *3
サーブレット org.apache.taglibs taglibs-standard-jstlel 1.2.5 *  
サーブレット org.apache.taglibs taglibs-standard-spec 1.2.5 * *4
サーブレット org.apache.taglibs taglibs-standard-impl 1.2.5 * *4
  1. データアクセスに、MyBatis3を使用する場合に依存するライブラリ
  2. データアクセスに、JPAを使用する場合に依存するライブラリ
  3. 共通ライブラリに依存しないが、TERASOLUNA Server Framework for Java (5.x)でアプリケーションを開発する場合に、利用することを推奨しているライブラリ
  4. Spring IO platformでサポートしているライブラリが個別に依存しているライブラリ
    (Spring IO platformとしては依存関係の管理は行っていないライブラリ)
  5. Spring IO platformで適用されるバージョンが、BetaやRC(Release Candidate)であるライブラリ
    (TERASOLUNA Server Framework for Java (5.x)側でGAのバージョンを明示的に指定しているライブラリ)

2.1.4. 共通ライブラリの構成要素

共通ライブラリは、TERASOLUNA Server Framework for Java (5.x)が含むSpring Ecosystem や、その他依存ライブラリでは足りない+αな機能を提供するライブラリである。 基本的には、このライブラリがなくてもTERASOLUNA Server Framework for Java (5.x)によるアプリケーション開発は可能であるが、”あると便利”な存在である。

項番 プロジェクト名 概要 Javaソースコード有無
(1) terasoluna-gfw-common Webに依存しない汎用的に使用できる機能と依存関係定義を提供する。
(2) terasoluna-gfw-jodatime Joda Timeに依存する機能と依存関係定義を提供する。
(3) terasoluna-gfw-web Webアプリケーションを作成する場合に使用する機能と依存関係定義を提供する。
(4) terasoluna-gfw-mybatis3 MyBatis3を使用する場合の依存関係定義を提供する。
(5) terasoluna-gfw-jpa JPAを使用する場合の依存関係定義を提供する。
(6) terasoluna-gfw-security-core Spring Securityを使用する場合の依存関係定義(Web以外)を提供する。
(7) terasoluna-gfw-security-web Spring Securityを使用する場合の依存関係定義(Web関連)とSpring Securityの拡張部品を提供する。
(8) terasoluna-gfw-recommended-dependencies Webに依存しない推奨ライブラリへの依存関係定義を提供する。
(9) terasoluna-gfw-recommended-web-dependencies Webに依存する推奨ライブラリへの依存関係定義を提供する。
(10) terasoluna-gfw-parent 依存ライブラリの管理とビルド用プラグインの推奨設定を提供する。

Javaソースコードを含まないものは、ライブラリの依存関係のみ定義しているプロジェクトである。

なお、プロジェクトの依存関係は以下の通りである。

../_images/FrameworkStackProjectDependencies.png

2.1.4.1. terasoluna-gfw-common

terasoluna-gfw-commonは以下の部品を提供している。

分類 部品名 説明
例外ハンドリング 例外クラス 汎用的に使用できる例外クラスを提供する。
  例外ロガー プリケーション内で発生した例外をログに出力するためのロガークラスを提供する。
  例外コード 例外クラスに対応する例外コード(メッセージID)を解決するための仕組み(クラス)を提供する。
  例外ログ出力インターセプタ ドメイン層で発生した例外をログ出力するためのインターセプタクラス(AOP)を提供する。
システム時刻 システム時刻ファクトリ システム時刻を取得するためのクラスを提供する。
コードリスト コードリスト コードリストを生成するためのクラスを提供する。
データベースアクセス(共通編) クエリエスケープ SQL及びJPQLにバインドする値のエスケープ処理を行うクラスを提供する。
  シーケンサ シーケンス値を取得するためのクラスを提供する。

2.1.4.2. terasoluna-gfw-jodatime

terasoluna-gfw-jodatimeは以下の部品を提供している。

分類 部品名 説明
システム時刻 Joda Time用システム時刻ファクトリ Joda TimeのAPIを利用してシステム時刻を取得するためのクラスを提供する。

2.1.4.3. terasoluna-gfw-web

terasoluna-gfw-webは以下の部品を提供している。

分類 部品名 説明
二重送信防止 トランザクショントークンチェック リクエストの二重送信からWebアプリケーションを守るための仕組み(クラス)を提供する。
例外ハンドリング 例外ハンドラ 共通ライブラリが提供する例外ハンドリングの部品と連携するための例外ハンドラクラス(Spring MVC提供のクラスのサブクラス)を提供する。
  例外ログ出力インターセプタ Spring MVCの例外ハンドラがハンドリングした例外をログ出力するためのインターセプタクラス(AOP)を提供する。
コードリスト コードリスト埋込インターセプタ Viewからコードリストを取得できるようにするために、コードリストの情報をリクエストスコープに格納するためのインターセプタクラス(Spring MVC Interceptor)を提供する。
ファイルダウンロード 汎用ダウンロードView ストリームから取得したデータを、ダウンロード用のストリームに出力するための抽象クラスを提供する。
ロギング トラッキングID格納用サーブレットフィルタ トレーサビリティを向上させるために、 クライアントから指定されたトラッキングIDを、ロガーのMDC(Mapped Diagnostic Context)、リクエストスコープ、レスポンスヘッダに設定するためのサーブレットフィルタクラスを提供する。 (クライアントからトラッキングIDの指定がない場合は、本クラスでトラッキングIDを生成する)
  汎用MDC格納用サーブレットフィルタ ロガーのMDCに任意の値を設定するための抽象クラスを提供する。
  MDCクリア用サーブレットフィルタ ロガーのMDCに格納されている情報をクリアするためのサーブレットフィルタクラスを提供する。
ページネーション ページネーションリンク表示用のJSPタグ Spring Data Commons提供のクラスと連携してページネーションリンクを表示するためのJSPタグライブラリを提供する。
メッセージ管理 結果メッセージ表示用のJSPタグ 処理結果を表示するためのJSPタグライブラリを提供する。
EL Functions XSS対策用EL関数 XSS対策用のEL関数を提供する。
  URL用EL関数 URLエンコーディングなどのURL用のEL関数を提供する。
  DOM変換用EL関数 DOM文字列に変換するためのEL関数を提供する。
  ユーティリティEL関数 汎用的なユーティリティ処理を行うためのEL関数を提供する。

2.1.4.4. terasoluna-gfw-security-web

terasoluna-gfw-security-webは以下の部品を提供している。

分類 部品名 説明
ロギング 認証ユーザ名格納用サーブレットフィルタ トレーサビリティを向上させるために、 認証ユーザ名をロガーのMDCに設定するためのサーブレットフィルタクラスを提供する。
認証 リダイレクト先の指定が可能な認証成功ハンドラ 認証が成功した際に、Webアプリケーション内の任意のパスにリダイレクトするためのハンドラクラスを提供する。