This project provides functional tests of Macchinetta Server Framework (1.x) Development Guideline.

Preconditions are as follow:

• JDK 8 or JDK 7 installed (JAVA_HOME defined as environment variable)
• "JCE Unlimited Strength Jurisdiction Policy Files" (for JDK 8 or JDK 7) installed
• Maven installed (Can run mvn command)
• Firefox(for personal or ESR) installed (ESR is used on our CI environment)

If PostgreSQL use as database , you need to create database of PostgreSQL into local machine. (PostgreSQL can download via here site).

Note:

If H2 use as database, you can skip this step.

By default, database owner is postgres user, and password of postgres user is 'P0stgres'.

$ createdb -U postgres spring-functionaltest --locale=C --encoding=UTF8 --template=template0
$ createdb -U postgres spring-functionaltest-open --locale=C --encoding=UTF8 --template=template0
$ createdb -U postgres spring-functionaltest-close --locale=C --encoding=UTF8 --template=template0

Clone the Macchinetta/spring-functionaltest repository into local machine.

$ git clone https://github.com/Macchinetta/spring-functionaltest.git

Place iTextAsian-1.0.jar and ojdbc7-12.1.0.2.0.jar on spring-functionaltest-env/3rdparty. You have to get these jar files in some way.

$ mv iTextAsian-1.0.jar spring-functionaltest-env/3rdparty/com/lowagie/iTextAsian/1.0
$ mv ojdbc7-12.1.0.2.0.jar spring-functionaltest-env/3rdparty/com/oracle/ojdbc7/12.1.0.2.0/

If you'd like to use another version, it's necessary to change some configurations.

Build artifacts using maven commands as follows.

$ cd {your repository directory}
$ git checkout {target branch}
$ mvn -U install -am -pl spring-functionaltest-web

Note:

When using JDK 7, build as follows.
you must compile with the target version 1.7 in accordance with the runtime environment JVM and exclude the source code that depends on JDK 1.8 .
You can set the target version using java-version property, and you can exclude using build-for-jdk7 Maven Profile in addition to the default profile.

$ mvn -U install -am -pl spring-functionaltest-web -Djava-version=1.7 -P local,build-for-jdk7

$ cd {your repository directory}
$ git checkout {target branch}
$ mvn -U install -am -pl spring-functionaltest-web -P tomcat8-postgresql,warpack-env,warpack-jstl,warpack-cxf,warpack-transaction,travis

Note:

If you not use default user(postgres) or password(P0stgres), you should modify settings in terasoluna-gfw-functionaltest-env/configs/travis/ContainerConfigXML/context.xml.

If PostgreSQL use as database, initialize database before run functional test.

$ mvn -U sql:execute -pl spring-functionaltest-initdb -P local-postgres
$ mvn -U sql:execute -pl spring-functionaltest-initdb -P local-postgres-open
$ mvn -U sql:execute -pl spring-functionaltest-initdb -P local-postgres-close

Note:

If you not use default user(postgres) or password(P0stgres), you should specify -Ddb.username={your user} or -Ddb.password={your password} or both.

Startup Tomcat8 and deploy war file using CARGO maven plugin.

$ cd {your repository directory}
$ mvn -U cargo:run -pl spring-functionaltest-web

$ cd {your repository directory}
$ mvn -U cargo:run -pl spring-functionaltest-web -P travis

Note:

Shutdown trigger is "Ctrl + C" on console.

Run tests using Selenium(WebDriver) on JUnit.

$ cd {your repository directory}
$ mvn -U test -pl spring-functionaltest-selenium

Note:

If functional test is failed, try again using latest Selenium(specify with -Dselenium.version={latest version}).

Note:

When using JDK 7, please build as follows.

$ mvn -U test -pl spring-functionaltest-selenium -Djava-version=1.7 -P build-for-jdk7

If latest or any branch snapshot of Common Library want to use, install latest or any branch snapshot before build and test.

$ git clone https://github.com/terasolunaorg/terasoluna-gfw.git

$ cd {your repository directory of terasoluna-gfw}
$ git checkout {target branch}
$ mvn -U clean install

Using the maven profile , build the war in accordance with the environment that you want to deploy.

$ cd {your repository directory}
$ git checkout {target branch}
$ mvn -U package -am -pl spring-functionaltest-web -P weblogic-oracle,warpack-env

Profiles that are available are as follows.

Using the spring profile , enable to switch the bean definition in accordance with the environment that you want to run.

<context-param>
    <param-name>spring.profiles.active</param-name>
    <param-value>nonMailServer,nonMqServer</param-value>
</context-param>

Profiles that are available are as follows.