org.scalatestplus.play

OneServerPerTest

trait OneServerPerTest extends SuiteMixin with ServerProvider

Trait that provides a new FakeApplication and running TestServer instance for each test executed in a ScalaTest Suite.

This SuiteMixin trait overrides ScalaTest's withFixture method to create a new FakeApplication and TestServer before each test, and ensure they are cleaned up after the test has completed. The FakeApplication is available (implicitly) from method app. The TestServer's port number is available as port (and implicitly available as portNumber, wrapped in a PortNumber).

By default, this trait creates a new FakeApplication for each test using default parameter values, which is returned by the newAppForTest method defined in this trait. If your tests need a FakeApplication with non-default parameters, override newAppForTest to return it.

Here's an example that demonstrates some of the services provided by this trait:

package org.scalatestplus.play.examples.oneserverpertest

import play.api.test._ import org.scalatest._ import org.scalatestplus.play._ import play.api.{Play, Application}
class ExampleSpec extends PlaySpec with OneServerPerTest {
// Override newAppForTest if you need a FakeApplication with other than non-default parameters. implicit override def newAppForTest(testData: TestData): FakeApplication = FakeApplication(additionalConfiguration = Map("ehcacheplugin" -> "disabled"))
"The OneServerPerTest trait" must { "provide a FakeApplication" in { app.configuration.getString("ehcacheplugin") mustBe Some("disabled") } "make the FakeApplication available implicitly" in { def getConfig(key: String)(implicit app: Application) = app.configuration.getString(key) getConfig("ehcacheplugin") mustBe Some("disabled") } "start the FakeApplication" in { Play.maybeApplication mustBe Some(app) } "provide the port number" in { port mustBe Helpers.testServerPort } "provide an actual running server" in { import Helpers._ import java.net._ val url = new URL("http://localhost:" + port + "/boum") val con = url.openConnection().asInstanceOf[HttpURLConnection] try con.getResponseCode mustBe 404 finally con.disconnect() } } }

Self Type
OneServerPerTest with Suite
Linear Supertypes
ServerProvider, SuiteMixin, AnyRef, Any
Ordering
  1. Alphabetic
  2. By inheritance
Inherited
  1. OneServerPerTest
  2. ServerProvider
  3. SuiteMixin
  4. AnyRef
  5. Any
  1. Hide All
  2. Show all
Learn more about member selection
Visibility
  1. Public
  2. All

Abstract Value Members

  1. abstract def expectedTestCount(filter: Filter): Int

    Definition Classes
    SuiteMixin
  2. abstract def nestedSuites: IndexedSeq[Suite]

    Definition Classes
    SuiteMixin
  3. abstract def rerunner: Option[String]

    Definition Classes
    SuiteMixin
  4. abstract def run(testName: Option[String], args: Args): Status

    Definition Classes
    SuiteMixin
  5. abstract def runNestedSuites(args: Args): Status

    Attributes
    protected
    Definition Classes
    SuiteMixin
  6. abstract def runTest(testName: String, args: Args): Status

    Attributes
    protected
    Definition Classes
    SuiteMixin
  7. abstract def runTests(testName: Option[String], args: Args): Status

    Attributes
    protected
    Definition Classes
    SuiteMixin
  8. abstract val styleName: String

    Definition Classes
    SuiteMixin
  9. abstract def suiteId: String

    Definition Classes
    SuiteMixin
  10. abstract def suiteName: String

    Definition Classes
    SuiteMixin
  11. abstract def tags: Map[String, Set[String]]

    Definition Classes
    SuiteMixin
  12. abstract def testDataFor(testName: String, theConfigMap: ConfigMap): TestData

    Definition Classes
    SuiteMixin
  13. abstract def testNames: Set[String]

    Definition Classes
    SuiteMixin

Concrete Value Members

  1. final def !=(arg0: AnyRef): Boolean

    Definition Classes
    AnyRef
  2. final def !=(arg0: Any): Boolean

    Definition Classes
    Any
  3. final def ##(): Int

    Definition Classes
    AnyRef → Any
  4. final def ==(arg0: AnyRef): Boolean

    Definition Classes
    AnyRef
  5. final def ==(arg0: Any): Boolean

    Definition Classes
    Any
  6. implicit final def app: FakeApplication

    Implicit method that returns the FakeApplication instance for the current test.

    Implicit method that returns the FakeApplication instance for the current test.

    Definition Classes
    OneServerPerTestServerProvider
  7. final def asInstanceOf[T0]: T0

    Definition Classes
    Any
  8. def clone(): AnyRef

    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  9. final def eq(arg0: AnyRef): Boolean

    Definition Classes
    AnyRef
  10. def equals(arg0: Any): Boolean

    Definition Classes
    AnyRef → Any
  11. def finalize(): Unit

    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( classOf[java.lang.Throwable] )
  12. final def getClass(): Class[_]

    Definition Classes
    AnyRef → Any
  13. def hashCode(): Int

    Definition Classes
    AnyRef → Any
  14. final def isInstanceOf[T0]: Boolean

    Definition Classes
    Any
  15. final def ne(arg0: AnyRef): Boolean

    Definition Classes
    AnyRef
  16. def newAppForTest(testData: TestData): FakeApplication

    Creates new instance of FakeApplication with parameters set to their defaults.

    Creates new instance of FakeApplication with parameters set to their defaults. Override this method if you need a FakeApplication created with non-default parameter values.

  17. final def notify(): Unit

    Definition Classes
    AnyRef
  18. final def notifyAll(): Unit

    Definition Classes
    AnyRef
  19. lazy val port: Int

    The port used by the TestServer.

    The port used by the TestServer. By default this will be set to the result returned from Helpers.testServerPort. You can override this to provide a different port number.

    Definition Classes
    OneServerPerTestServerProvider
  20. implicit final lazy val portNumber: PortNumber

    Implicit PortNumber instance that wraps port.

    Implicit PortNumber instance that wraps port. The value returned from portNumber.value will be same as the value of port.

    returns

    the configured port number, wrapped in a PortNumber

    Definition Classes
    ServerProvider
  21. final def synchronized[T0](arg0: ⇒ T0): T0

    Definition Classes
    AnyRef
  22. def toString(): String

    Definition Classes
    AnyRef → Any
  23. final def wait(): Unit

    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  24. final def wait(arg0: Long, arg1: Int): Unit

    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  25. final def wait(arg0: Long): Unit

    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  26. def withFixture(test: (OneServerPerTest.this)#NoArgTest): Outcome

    Creates new FakeApplication and running TestServer instances before executing each test, and ensures they are cleaned up after the test completes.

    Creates new FakeApplication and running TestServer instances before executing each test, and ensures they are cleaned up after the test completes. You can access the FakeApplication from your tests as app and the TestServer's port number as port.

    test

    the no-arg test function to run with a fixture

    returns

    the Outcome of the test execution

    Definition Classes
    OneServerPerTest → SuiteMixin

Inherited from ServerProvider

Inherited from SuiteMixin

Inherited from AnyRef

Inherited from Any

Ungrouped