Eclipse Krazo

Eclipse Krazo is an implementation of action-based MVC specified by MVC 1.0 (JSR-371). It builds on top of JAX-RS and currently contains support for RESTEasy, Jersey and CXF with a well-defined SPI for other implementations.

Running the testsuite

Eclipse Krazo has configurations to run the testsuite against a bunch of application servers like WildFly, Payara, Glassfish or Liberty. The following sections describe how you test Eclipse Krazo against them. At the moment, we test against following servers:

Glassfish 5
WildFly 18.0.0
TomEE 8.0.2 Plus
Payara 5.193.1
Liberty WebProfile 8 19.0.0.11

Preconditions

JDK 8
SNAPSHOTs are up to date in your local repository

Glassfish

To run the Krazo testsuite with Eclipse Glassfish, you need to follow these steps:

Download Eclipse Glassfish from the official download page and unzip it.
Start Eclipse Glassfish via glassfish5/glassfish/bin/startserv
Go into the testsuite package of Eclipse Krazo and execute mvn clean integration-test -Ptestsuite-glassfish

WildFly

To run the Krazo testsuite with WildFly, you need to follow these steps:

Download WildFly from the WildFly download page and unzip it somewhere you'll find it again.
Start WildFly with sh standalone.sh --debug. This enables you to remote-debug the Arquillian tests.
Go into the testsuite package of Eclipse Krazo and execute mvn clean integration-test -Ptestsuite-wildfly

TomEE

To run the Krazo testsuite with TomEE, you need to follow these steps:

Download TomEE from the TomEE download page and unzip it somewhere you'll find it again.
Overwrite or enable the following settings in ${TOMEE_HOME}/conf/system.properties to get Arquillian to run:

tomee.remote.support=true
tomee.serialization.class.blacklist=-
openejb.system.apps = true

Start TomEE with sh catalina.sh jpda start. This enables you to remote-debug the Arquillian tests.
Go into the testsuite package of Eclipse Krazo and execute mvn clean integration-test -Ptestsuite-tomee

OpenLiberty

To run the Krazo testsuite with OpenLiberty, you need to follow these steps. Please note that this process has been tested with 19.x only.

Download OpenLiberty from the official download page and unzip it.
Replace the file wlp/templates/servers/defaultServer/server.xml with .travis/wlp-server-template.xml from the Eclipse Krazo repository.
Go into the testsuite package of Eclipse Krazo and execute mvn clean integration-test -Ptestsuite-glassfish -Dliberty.home=c:/somewhere/wlp/. Please make sure to replace c:/somewhere/wlp/ with the absolute path to the unpacked OpenLiberty distribution.

Troubleshooting

Tests are failing locally but not on Travis CI

In this case, ensure that your local SNAPSHOTS are the newest version of Krazo. Most of time, this solves the problem.

Daniel-Dos/krazo-tests