Since we wrote this post we didn't laze around. Check our latest announcement.
The Arquillian team is proud to announce the 1.0.0.Alpha2 release of the Arquillian Spring Framework Extension component!
This release contain many improvements on the existing extension, but also some new features.
Some of the highlights in this release
Warp Spring MVC Extension
Spring Embedded Container
Separated the integration capabilities
Testing Spring MVC with Warp
Arquillian Warp is a powerful tool that let you run the functional tests against your web front end and at the same time verify the internal state of your application. With this release we are introducing the Warp extension for testing Spring MVC applications that run in a real servlet container.
Let’s dive into an example of how to test a Spring MVC application using Arquillian Warp. First we need to prepare the application descriptor.
web.xml
<web-app xmlns="http://java.sun.com/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
version="3.0">
<servlet>
<servlet-name>welcome</servlet-name>
<servlet-class>org.jboss.arquillian.warp.extension.spring.servlet.WarpDispatcherServlet</servlet-class>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>welcome</servlet-name>
<url-pattern>*.do</url-pattern>
</servlet-mapping>
</web-app>
You’ll notice that instead of using Spring’s DispatcherServlet we instead use the WarpDispatcherServlet.
And the testing code:
LoginControllerTestCase.java
@WarpTest
@RunWith(Arquillian.class)
public class LoginControllerTestCase {
@Drone
WebDriver browser;
@ArquillianResource
URL contextPath;
@Test
@RunAsClient
public void testLoginValidationErrors() {
browser.navigate().to(contextPath + "login.do");
Warp.execute(new ClientAction() {
@Override
public void action() {
browser.findElement(By.id("loginForm")).submit();
}
}).verify(new LoginControllerValidationErrorsVerification());
}
@Test
@RunAsClient
public void testLoginSuccess() {
browser.navigate().to(contextPath + "login.do");
browser.findElement(By.id("login")).sendKeys("warp");
browser.findElement(By.id("password")).sendKeys("warp");
Warp.execute(new ClientAction() {
@Override
public void action() {
browser.findElement(By.id("loginForm")).submit();
}
}).verify(new LoginSuccessVerification());
}
public static class LoginControllerValidationErrorsVerification extends ServerAssertion {
private static final long serialVersionUID = 1L;
@SpringMvcResource
private ModelAndView modelAndView;
@SpringMvcResource
private Errors errors;
@AfterServlet
public void testGetLogin() {
assertEquals("login", modelAndView.getViewName());
assertNotNull(modelAndView.getModel().get("userCredentials"));
assertEquals("Two errors were expected.", 2, errors.getAllErrors().size());
assertTrue("The login hasn't been validated.", errors.hasFieldErrors("login"));
assertTrue("The password hasn't been validated.", errors.hasFieldErrors("password"));
}
}
public static class LoginSuccessVerification extends ServerAssertion {
private static final long serialVersionUID = 1L;
@SpringMvcResource
private ModelAndView modelAndView;
@SpringMvcResource
private Errors errors;
@AfterServlet
public void testGetLogin() {
assertEquals("welcome", modelAndView.getViewName());
assertFalse(errors.hasErrors());
}
}
}
In the above example we are using Arquillian Drone to navigate to the login page of our application and then filling in the login form with our user credentials.
The internal state of the DispatcherServlet is caught in a SpringMvcResult object which can be injected into the ServerAssertion. We can also inject other required objects like the ModelAndView.
Spring Embedded Container
Each development cycle may end in repeatedly re-running the integration tests, each time taking significant amount of time. The embedded container was thought to aid this situation. Running the tests embedded will decrease the execution time from seconds to milliseconds. It will help testing business objects, but since it’s not a full servlet container you won’t be able to use it for testing servlet requests in a web application.
Migrating from 1.0.0.Alpha1
1.0.0.Alpha2 comes with a couple significant changes from the previous version.
- The Spring integration functionality has been separated out to its own module and is now part of the arquillian-service-integration-spring-inject module, and additional the arquillian-service-integration-spring-inject and the arquillian-service-integration-spring-javaconfig that does not target any specific Spring version, but rather provide functionality like XML or Java-based configuration.
- The arquillian-service-deployer-spring module’s can still be used for autopackging the Spring artifacts.
- The @SpringAnnotatedConfiguration has been renamed to @SpringAnnotationConfiguration.
Roadmap
The next release is planned to include Spring transaction support and will introduce even better Warp integration on the client side in order make REST testing even simpler.
We look forward to hearing your feedback about this release in the community forums!
What is Arquillian?
Arquillian is open source software that empowers you to test JVM-based applications more effectively. Created to defend the software galaxy from bugs, Arquillian brings your test to the runtime so you can focus on testing your application's behavior rather than managing the runtime. Using Arquillian, you can develop a comprehensive suite of tests from the convenience of your IDE and run them in any IDE, build tool or continuous integration environment.
Release details
Published artifacts
org.jboss.arquillian.extension
-
org.jboss.arquillian.extension
»
arquillian-service-deployer-spring-common
jar
javadoc
pom
-
org.jboss.arquillian.extension
»
arquillian-service-deployer-spring-2.5
jar
javadoc
pom
-
org.jboss.arquillian.extension
»
arquillian-service-deployer-spring-3
jar
javadoc
pom
-
org.jboss.arquillian.extension
»
arquillian-service-integration-spring
jar
javadoc
pom
-
org.jboss.arquillian.extension
»
arquillian-container-spring
jar
javadoc
pom
-
org.jboss.arquillian.extension
»
arquillian-service-integration-spring-inject
jar
javadoc
pom
-
org.jboss.arquillian.extension
»
arquillian-service-integration-spring-javaconfig
jar
javadoc
pom
-
org.jboss.arquillian.extension
»
arquillian-service-integration-spring-2.5-int-tests
jar
javadoc
pom
-
org.jboss.arquillian.extension
»
arquillian-service-integration-spring-3-int-tests
jar
javadoc
pom
-
org.jboss.arquillian.extension
»
arquillian-warp-spring
jar
javadoc
pom
Release notes and resolved issues
5
Spring Embedded Container + Warp
- Feature Request
-
- ARQ-219 - Implement an embedded Spring container
- ARQ-945 - Extract Spring Integration out of Spring Deployer
- ARQ-978 - Provide Warp with extension for testing SpringMVC.
- Task
-
- ARQ-1019 - Spring Extension: Update the Arquiilian Core to 1.0.1
Thanks to the following list of contributors:
Jakub Narloch, Aslak Knutsen
