org.javalite.activeweb

Class ControllerSpec

java.lang.Object

org.javalite.test.jspec.JSpecSupport

org.javalite.activeweb.SpecHelper

org.javalite.activeweb.RequestSpecHelper

org.javalite.activeweb.ControllerSpec

Direct Known Subclasses:

DBControllerSpec

public class ControllerSpec
extends RequestSpecHelper

Super class for controller tests. This class is used by unit tests that test a single controller. Controllers are tested by simulating a web request to a controller (no physical network is involved, and no container initialized).

Subclasses must follow a simple naming convention: subclass name must be made of two words: controller short class name and word "Spec". Example, of there is a controller:

 public class GreeterController extends AppController{
   ...
 }
 

then the test will look like this:

 public class GreeterControllerSpec extends ControllerSpec{
 ...
 }
 

ActiveWeb controller specs allow for true TDD, since they do not have a compiler dependency on controllers. You can describe full behavior of your controller before a controller class even exists. Simplest example:

 public GreeterControllerSpec extends ControllerSpec{
  @Test
  public void shouldRespondWithGreetingMessage(){
      request().get("index");
      a(responseCode()).shouldBeEqual(200);
      a(assigns().get("message")).shouldBeEqual("Hello, earthlings!");
  }
 }
 

In a code snippet above, a request with HTTP GET method is simulated to the GreeterController, index() action. Controller is expected to assign an object called "message" with value "Hello, earthlings!" to a view. This class will not open a connection to a test DB. If you need a connection, use DBControllerSpec.

Author:

Igor Polevoy

See Also:

org.javalite.activeweb.DBControllerSpec}.

Constructor Summary

Constructors

Constructor and Description
ControllerSpec()

Method Summary

Methods

Modifier and Type	Method and Description
void	atStart()
protected String	getControllerClassName()
protected String	getControllerPath() Returns a controller path - this includes packages if there are any after "app.controllers".
protected RequestBuilder	request() Use this DSL-ish method to send requests to controllers from specs.
protected RequestBuilder	request(boolean integrateViews) Version of request() that also sets integrateViews == true

Methods inherited from class org.javalite.activeweb.RequestSpecHelper

assigns, bytesContent, contentType, cookie, cookieValue, getCookies, layout, redirected, redirectValue, responseContent, statusCode, template, val, val, valBoolean, valDouble, valFloat, valInteger, valLong, vals, valString

Methods inherited from class org.javalite.activeweb.SpecHelper

afterEnd, flash, flash, registerTag, session, session, session, sessionBoolean, sessionDouble, sessionFloat, sessionHas, sessionInteger, sessionLong, sessionObject, sessionString, setInjector, setTemplateLocation

Methods inherited from class org.javalite.test.jspec.JSpecSupport

a, expect, expect, it, the

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ControllerSpec

public ControllerSpec()

Method Detail

atStart

public void atStart()

Overrides:

atStart in class SpecHelper

request

protected RequestBuilder request()

Use this DSL-ish method to send requests to controllers from specs. Attention: this method always returns a new object, please string methods one after another - fluent interfaces approach.

Returns:

instance of RequestBuilder with convenience methods.

request

protected RequestBuilder request(boolean integrateViews)

Version of request() that also sets integrateViews == true

Parameters:

integrateViews - true to also generate response content

Returns:

instance of RequestBuilder with convenience methods.

getControllerPath

protected final String getControllerPath()

Returns a controller path - this includes packages if there are any after "app.controllers".

Returns:

controller path

getControllerClassName

protected final String getControllerClassName()