2.1. Stack of TERASOLUNA Server Framework for Java (5.x)

Caution

This version is already obsolete. Please check the latest guideline.

2.1.1. Summary of Software Framework of TERASOLUNA Server Framework for Java (5.x)

Software Framework being used in TERASOLUNA Server Framework for Java (5.x) is not a proprietary Framework but a combination of various OSS technologies around Spring Framework.

2.1.2. Main Structural Elements of Software Framework

Libraries which constitute TERASOLUNA Server Framework for Java (5.x) are as follows:

2.1.2.1. DI Container

Spring Framework is used as DI Container.

• Spring Framework 4.1

2.1.2.2. MVC Framework

Spring MVC is used as Web MVC Framework.

• Spring MVC 4.1

2.1.2.3. O/R Mapper

This guideline assumes the use of any one of the below.

• MyBatis 3.2
  • MyBatis-Spring is used as library for coordinating with Spring Framework.
• JPA2.1
  • Hibernate 4.3 is used as provider.

Note

To be precise MyBatis is a “SQL Mapper”, but it is classified as “O/R Mapper” in this guidelines.

Warning

Every project must not adopt JPA. For situations in which table design has been done and “Most of the tables are not normalized”, “The number of columns in the table is too large” etc, use of JPA is difficult.

Furthermore, this guideline does not explain the basic usage of JPA. Hence, it is pre-requisite to have JPA experience people in the team.

2.1.2.4. View

JSP is used as View.

Use the following to standardize the view layout.

• Apache Tiles 3.0

2.1.2.5. Security

Spring Security is used as the framework for Authentication and Authorization.

• Spring Security 3.2

Tip

In addition to providing a mechanism of authentication and authorization in Spring Security 3.2, the mechanism has been enhanced to protect a Web application from malicious attackers.

For mechanism to protect Web applications from malicious attackers, Refer,

• CSRF Countermeasures
• Settings to assign a secure HTTP header

2.1.2.6. Validation

• For Single item input check, BeanValidation 1.1 is used.
  • For implementation, Hibernate Validator 5.1 is used.
• For correlated items check, BeanValidation or Spring Validation is used.
  • Refer to Input Validation for determining the proper use.

2.1.2.7. Logging

• The SLF4J API is used for Logger.
  • The Logback API is used for implementation of Logger.

2.1.2.8. Common Library

• https://github.com/terasolunaorg/terasoluna-gfw
• Refer to Building blocks of Common Library for details.

2.1.3. OSS Versions

List of OSS being used in version 5.0.1.RELEASE.

Tip

From version 5.0.0.RELEASE onwards, adopted the mechanism of importing <dependencyManagement> of Spring IO platform.

By importing the <dependencyManagement> of Spring IO platform,

• Spring Framework offering library
• Spring Framework dependent OSS library
• Spring Framework compatible OSS library

dependencies resolved and OSS version to be used in the TERASOLUNA Server Framework for Java (5.x) is following the rule of Spring IO platform definition.

Furthermore, Spring IO platform version is 1.1.3.RELEASE specified in version 5.0.1.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	*
Log output	ch.qos.logback	logback-classic	1.1.3	*
Log output	ch.qos.logback	logback-core	1.1.3	*	*4
Log output	org.lazyluke	log4jdbc-remix	0.2.7
Log output	org.slf4j	jcl-over-slf4j	1.7.12	*
Log output	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	*
Input check	javax.validation	validation-api	1.1.0.Final	*
Input check	org.hibernate	hibernate-validator	5.1.3.Final	*
Input check	org.jboss.logging	jboss-logging	3.1.3.GA	*	*4
Input check	com.fasterxml	classmate	1.0.0	*	*4
Bean conversion	commons-beanutils	commons-beanutils	1.9.2	*	*3
Bean conversion	net.sf.dozer	dozer	5.5.1		*3
Bean conversion	net.sf.dozer	dozer-spring	5.5.1		*3
Bean conversion	org.apache.commons	commons-lang3	3.3.2	*	*3
Date operation	joda-time	joda-time	2.5	*
Date operation	joda-time	joda-time-jsptags	1.1.1		*3
Date operation	org.jadira.usertype	usertype.core	3.2.0.GA		*2
Date operation	org.jadira.usertype	usertype.spi	3.2.0.GA		*2
Connection pool	org.apache.commons	commons-dbcp2	2.0.1	*	*3
Connection pool	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
Utility	com.google.guava	guava	17.0	*
Utility	commons-collections	commons-collections	3.2.1	*	*3
Utility	commons-io	commons-io	2.4	*	*3
Servlet	org.apache.taglibs	taglibs-standard-jstlel	1.2.5	*
Servlet	org.apache.taglibs	taglibs-standard-spec	1.2.5	*	*4
Servlet	org.apache.taglibs	taglibs-standard-impl	1.2.5	*	*4

1. Dependent libraries, when MyBatis3 is used for data access.
2. Dependent libraries, when JPA is used for data access.
3. Libraries which are not dependent on Common Library, but recommended in case of application development using TERASOLUNA Server Framework for Java (5.x).
4. Libraries that are supported by Spring IO platform, but library that relies individually.

   (Library is not managed as dependencies in Spring IO platform)
5. Library versions that are applied in the Spring IO platform is a Beta or RC (Release Candidate)

   (Library that explicitly specify the GA version at TERASOLUNA Server Framework for Java (5.x))

2.1.4. Building blocks of Common Library

Common Library includes + alpha functionalities which are not available in Spring Ecosystem or other dependent libraries included in TERASOLUNA Server Framework for Java (5.x). Basically, application development is possible using TERASOLUNA Server Framework for Java (5.x) without this library but “convenient to have” kind of existence.

No.	Project Name	Summary	Java source-code availability
(1)	terasoluna-gfw-common	Provide general-purpose functionalities and dependency definitions irrespective of Web.	Yes
(2)	terasoluna-gfw-jodatime	Provide functionalities and dependency definitions that depend on the Joda Time.	Yes
(3)	terasoluna-gfw-web	Provide group of functionalities and dependency definitions for creating web application.	Yes
(4)	terasoluna-gfw-mybatis3	Provide dependency definitions for using MyBatis3.	No
(5)	terasoluna-gfw-jpa	Provide dependency definitions for using JPA.	No
(6)	terasoluna-gfw-security-core	Provide dependency definitions for using Spring Security (other than Web).	No
(7)	terasoluna-gfw-security-web	Provide dependency definitions for using Spring Security (related to Web) and extended classes of Spring Security.	Yes
(8)	terasoluna-gfw-recommended-dependencies	Provide dependency definitions of recommended libraries that doesn’t depends on web.	No
(9)	terasoluna-gfw-recommended-web-dependencies	Provide dependency definitions of recommended libraries that depends on web.	No
(10)	terasoluna-gfw-parent	Provide dependency libraries management and recommended settings of build plugins.	No

The project which does not contain the Java source code, only defines library dependencies.

In addition, project dependencies are as follows:

2.1.4.1. terasoluna-gfw-common

terasoluna-gfw-common provide following components.

Classification	Component Name	Description
Exception Handling	Exception Class	Provide general exception classes.
	Exception Logger	Provide logger class for logging the exception that occurred in application.
	Exception Code	Provide mechanism (classes) for resolving the exception code (message ID) that corresponds to the exception class.
	Exception Logging Interceptor	Provide interceptor class of AOP for logging the exception that occurred in domain layer.
System Date	System Date Time Factory	Provide classes for retrieving the system date time.
Codelist	CodeList	Provide classes for generating CodeList.
Database Access (Common)	Query Escape	Provide class for escape processing of value to bind into the SQL and JPQL.
	Sequencer	Provide classes for retrieving the sequence value.

2.1.4.2. terasoluna-gfw-jodatime

terasoluna-gfw-jodatime provide following components.

Classification	Component Name	Description
System Date	System Date Time Factory for Joda Time	Provide classes for retrieving the system date time using the Joda Time API.

2.1.4.3. terasoluna-gfw-web

terasoluna-gfw-web provide following components.

Classification	Component Name	Description
Double Submit Protection	Transaction Token Check	Provide mechanism (classes) for protecting Web Application from double submitting of request.
Exception Handling	Exception Handler	Provide exception handler class(sub class of class that provided by Spring MVC) for integrating with exception handling components that provided from common library.
	Exception Logging Interceptor	Provide interceptor class of AOP for logging the exception that handled by Spring MVC.
Codelist	Populate CodeList interceptor	Provide interceptor class of Spring MVC for storing CodeList information into request scope, for the purpose of retrieving CodeList from View.
File Download	General Download View	Provide abstract class for retrieving data from input stream and writing to stream for download.
Logging	ServletFilter for storing Tracking ID	Provide Servlet Filter class for setting Tracking ID into MDC(Mapped Diagnostic Context) and request scope and response header, for the purpose of improving traceability. (If does not exist a Tracking ID in request header, generate a Tracking ID by this component)
	General ServletFilter for storing MDC	Provide abstract class for storing any value into Logger’s MDC
	ServletFilter for clearing MDC	Provide ServletFilter class for clearing information that stored in Logger’s MDC.
Pagination	JSP Tag for displaying Pagination Links	Provide JSP Tag Library for displaying Pagination Links using classes that provided by Spring Data Commons.
Message Management	JSP Tag for displaying Result Messages	Provide JSP Tag Library for displaying Result Messages.
EL Functions	EL Functions for XSS countermeasures	Provide EL Functions for XSS countermeasures.
	EL Functions for URL	Provide EL Functions for URL as URL encoding.
	EL Functions for DOM conversion	Provide EL Functions for DOM conversion.
	EL Functions for Utilities	Provide EL Functions for general utilities processing.

2.1.4.4. terasoluna-gfw-security-web

terasoluna-gfw-security-web provide following components.

Classification	Component Name	Description
Logging	ServletFilter for storing name of authenticated user	Provide ServletFilter class for setting name of authenticated user into MDC, for the purpose of improving traceability.
Authentication	Authentication Success Handler that can be specified redirect path	Provide Authentication Success Handler class that redirect to specified path in the Web Application when authentication is successful.