Brooklyn

brooklyn.test
[Groovy] Class TestUtils

java.lang.Object
  brooklyn.test.TestUtils

class TestUtils

Helper functions for tests of Tomcat, JBoss and others. Note that methods will migrate from here to Asserts in future releases.


Nested Class Summary
static class TestUtils.BooleanWithMessage

 
Method Summary
static void assertAttributeContinually(Entity entity, AttributeSensor attribute, java.lang.Object expected)

@deprecated since 0.5; use EntityTestUtils#assertAttributeEqualsContinually(Entity, AttributeSensor, Object)#assertAttributeEqualsContinually(Entity, AttributeSensor, Object)

static void assertAttributeEventually(Entity entity, AttributeSensor attribute, java.lang.Object expected)

@deprecated since 0.5; use EntityTestUtils#assertAttributeEqualsEventually(Entity, AttributeSensor, Object)#assertAttributeEqualsEventually(Entity, AttributeSensor, Object)

static void assertContinually(java.util.Map flags = [:], Supplier supplier, Predicate predicate)

@deprecated since 0.5; use Asserts#continually(Map, Supplier, Predicate)#continually(Map, Supplier, Predicate)

static void assertContinually(java.util.Map flags = [:], Supplier supplier, Predicate predicate, java.lang.String errMsg, long durationMs)

@deprecated since 0.5; use Asserts#continually(Map, Supplier, Predicate, String)#continually(Map, Supplier, Predicate, String)

static void assertContinually(java.util.Map flags = [:], Supplier supplier, Predicate predicate, java.lang.String errMsg)

@deprecated since 0.5; use Asserts#continually(Map, Supplier, Predicate, String)#continually(Map, Supplier, Predicate, String)

static void assertContinuallyFromJava(java.util.Map flags = [:], Supplier supplier, Predicate predicate)

@deprecated since 0.5; use Asserts#continually(Map, Supplier, Predicate)#continually(Map, Supplier, Predicate)

static void assertEventually(java.util.Map flags = [:], Supplier supplier, Predicate predicate)

@deprecated since 0.5; use Asserts#eventually(Map, Supplier, Predicate)#eventually(Map, Supplier, Predicate)

static void assertEventually(java.util.Map flags = [:], Supplier supplier, Predicate predicate, java.lang.String errMsg)

@deprecated since 0.5; use Asserts#eventually(Map, Supplier, Predicate, String)#eventually(Map, Supplier, Predicate, String)

static void assertEventually(java.util.Map flags = [:], java.util.concurrent.Callable c)

@deprecated since 0.5; use Asserts.succeedsEventually

static void assertEventually(java.util.Map flags = [:], java.lang.Runnable c)

@deprecated since 0.5; use Asserts#succeedsEventually(Map, Runnable)#succeedsEventually(Map, Runnable)

static void assertFails(java.lang.Runnable c)

@deprecated since 0.5; use Asserts#assertFails(Runnable)#assertFails(Runnable)

static void assertFailsWith(java.lang.Runnable c, groovy.lang.Closure exceptionChecker)

@deprecated since 0.5; use Asserts#assertFailsWith(Closure)#assertFailsWith(Closure)

static void assertFailsWith(java.lang.Runnable c, java.lang.Class validException, java.lang.Class... otherValidExceptions)

@deprecated since 0.5; use Asserts.assertFailsWith

static void assertFailsWith(java.lang.Runnable c, Predicate exceptionChecker)

@deprecated since 0.5; use Asserts#assertFailsWith(Runnable, Predicate)#assertFailsWith(Runnable, Predicate)

static void assertNonEmpty(java.lang.Iterable c)

@deprecated since 0.5; use assertFalse(Iterables.isEmpty(c))

static void assertSetsEqual(java.util.Collection c1, java.util.Collection c2)

static void assertSize(java.lang.Iterable c, int expectedSize)

@deprecated since 0.5; use assertEquals(Iterables.size(c), expectedSize)

static void assertStringContainsLiteral(java.lang.String string, java.lang.String substring)

static void assertSucceedsContinually(java.util.Map flags = [:], java.lang.Runnable job)

@deprecated since 0.5; use Asserts#succeedsContinually(Map, Runnable)#succeedsContinually(Map, Runnable)

static void assertSucceedsContinually(java.util.Map flags = [:], java.util.concurrent.Callable job)

@deprecated since 0.5; use Asserts#succeedsContinually(Map, Callable)#succeedsContinually(Map, Callable)

static void assertUrlHasText(java.util.Map flags = [:], java.lang.String url, java.lang.String... phrases)

@deprecated since 0.4.0 use HttpTestUtils.assertUrlEventuallyHasText or HttpTestUtils.assertUrlHasText (NB: this method has "eventually" logic, with default timeout of 30s, despite the absence of that in the name)

static void assertUrlStatusCodeEventually(java.lang.String url, int expected)

@deprecated since 0.5; use HttpTestUtils#assertHttpStatusCodeEquals(String, int)#assertHttpStatusCodeEquals(String, int)

static java.net.URLConnection connectToURL(java.lang.String url)

Connects to the given url and returns the connection.

static void executeUntilSucceeds(java.util.Map flags = [:], groovy.lang.Closure c)

@deprecated since 0.5; use Asserts#succeedsEventually(Map, Callable)#succeedsEventually(Map, Callable)

static void executeUntilSucceeds(java.util.Map flags = [:], java.util.concurrent.Callable c)

@deprecated since 0.5; use Asserts#succeedsEventually(Map, Callable)#succeedsEventually(Map, Callable)

static void executeUntilSucceeds(java.util.Map flags = [:], java.lang.Runnable r)

@deprecated since 0.5; use Asserts#succeedsEventually(Map, Runnable)#succeedsEventually(Map, Runnable)

static void executeUntilSucceedsElseShutdown(java.util.Map flags = [:], Entity entity, groovy.lang.Closure c)

@deprecated since 0.5; use Asserts#succeedsEventually(Map, Callable)#succeedsEventually(Map, Callable), and tear-down with AfterMethod.

static void executeUntilSucceedsWithFinallyBlock(java.util.Map flags = [:], groovy.lang.Closure c, groovy.lang.Closure finallyBlock = {})

@deprecated since 0.5; use Asserts#succeedsEventually(Map, Callable)#succeedsEventually(Map, Callable), and tear-down with AfterMethod.

static void executeUntilSucceedsWithFinallyBlock(java.util.Map flags = [:], java.util.concurrent.Callable c, groovy.lang.Closure finallyBlock = {})

Convenience method for cases where we need to test until something is true.

static void executeUntilSucceedsWithShutdown(java.util.Map flags = [:], Entity entity, groovy.lang.Closure c)

convenience for entities to ensure they shutdown afterwards.

static java.io.File getResource(java.lang.String path, java.lang.ClassLoader loader)

@deprecated since 0.5; use ResourceUtils

static boolean isPortInUse(int port, long retryAfterMillis = 0)

True if two attempts to connect to the port succeed.

static groovy.time.TimeDuration toTimeDuration(java.lang.Object duration)

@deprecated since 0.5; use long and java.util.concurrent.TimeUnit

static groovy.time.TimeDuration toTimeDuration(java.lang.Object duration, groovy.time.TimeDuration defaultVal)

@deprecated since 0.5; use long and java.util.concurrent.TimeUnit

static java.lang.Throwable unwrapThrowable(java.lang.Throwable t)

static int urlRespondsStatusCode(java.lang.String url)

Connects to the given HTTP URL and asserts that the response had status code 200.

static boolean urlRespondsWithStatusCode200(java.lang.String url)

Connects to the given HTTP URL and asserts that the response had status code 200.

 
Methods inherited from class java.lang.Object
java.lang.Object#wait(), java.lang.Object#wait(long), java.lang.Object#wait(long, int), java.lang.Object#equals(java.lang.Object), java.lang.Object#toString(), java.lang.Object#hashCode(), java.lang.Object#getClass(), java.lang.Object#notify(), java.lang.Object#notifyAll()
 

Method Detail

assertAttributeContinually

@Deprecated
static void assertAttributeContinually(Entity entity, AttributeSensor attribute, java.lang.Object expected)
deprecated:
since 0.5; use EntityTestUtils#assertAttributeEqualsContinually(Entity, AttributeSensor, Object)#assertAttributeEqualsContinually(Entity, AttributeSensor, Object)


assertAttributeEventually

@Deprecated
static void assertAttributeEventually(Entity entity, AttributeSensor attribute, java.lang.Object expected)
deprecated:
since 0.5; use EntityTestUtils#assertAttributeEqualsEventually(Entity, AttributeSensor, Object)#assertAttributeEqualsEventually(Entity, AttributeSensor, Object)


assertContinually

@Deprecated
static void assertContinually(java.util.Map flags = [:], Supplier supplier, Predicate predicate)
deprecated:
since 0.5; use Asserts#continually(Map, Supplier, Predicate)#continually(Map, Supplier, Predicate)


assertContinually

@Deprecated
static void assertContinually(java.util.Map flags = [:], Supplier supplier, Predicate predicate, java.lang.String errMsg, long durationMs)
deprecated:
since 0.5; use Asserts#continually(Map, Supplier, Predicate, String)#continually(Map, Supplier, Predicate, String)


assertContinually

@Deprecated
static void assertContinually(java.util.Map flags = [:], Supplier supplier, Predicate predicate, java.lang.String errMsg)
deprecated:
since 0.5; use Asserts#continually(Map, Supplier, Predicate, String)#continually(Map, Supplier, Predicate, String)


assertContinuallyFromJava

@Deprecated
    // FIXME When calling from java, the generics declared in groovy messing things up!
static void assertContinuallyFromJava(java.util.Map flags = [:], Supplier supplier, Predicate predicate)
deprecated:
since 0.5; use Asserts#continually(Map, Supplier, Predicate)#continually(Map, Supplier, Predicate)


assertEventually

@Deprecated
static void assertEventually(java.util.Map flags = [:], Supplier supplier, Predicate predicate)
deprecated:
since 0.5; use Asserts#eventually(Map, Supplier, Predicate)#eventually(Map, Supplier, Predicate)


assertEventually

@Deprecated
static void assertEventually(java.util.Map flags = [:], Supplier supplier, Predicate predicate, java.lang.String errMsg)
deprecated:
since 0.5; use Asserts#eventually(Map, Supplier, Predicate, String)#eventually(Map, Supplier, Predicate, String)


assertEventually

@Deprecated
static void assertEventually(java.util.Map flags = [:], java.util.concurrent.Callable c)
deprecated:
since 0.5; use Asserts.succeedsEventually


assertEventually

@Deprecated
static void assertEventually(java.util.Map flags = [:], java.lang.Runnable c)
deprecated:
since 0.5; use Asserts#succeedsEventually(Map, Runnable)#succeedsEventually(Map, Runnable)


assertFails

@Deprecated
static void assertFails(java.lang.Runnable c)
deprecated:
since 0.5; use Asserts#assertFails(Runnable)#assertFails(Runnable)


assertFailsWith

@Deprecated
static void assertFailsWith(java.lang.Runnable c, groovy.lang.Closure exceptionChecker)
deprecated:
since 0.5; use Asserts#assertFailsWith(Closure)#assertFailsWith(Closure)


assertFailsWith

@Deprecated
static void assertFailsWith(java.lang.Runnable c, java.lang.Class validException, java.lang.Class... otherValidExceptions)
deprecated:
since 0.5; use Asserts.assertFailsWith


assertFailsWith

@Deprecated
static void assertFailsWith(java.lang.Runnable c, Predicate exceptionChecker)
deprecated:
since 0.5; use Asserts#assertFailsWith(Runnable, Predicate)#assertFailsWith(Runnable, Predicate)


assertNonEmpty

@Deprecated
static void assertNonEmpty(java.lang.Iterable c)
deprecated:
since 0.5; use assertFalse(Iterables.isEmpty(c))


assertSetsEqual

static void assertSetsEqual(java.util.Collection c1, java.util.Collection c2)


assertSize

@Deprecated
static void assertSize(java.lang.Iterable c, int expectedSize)
deprecated:
since 0.5; use assertEquals(Iterables.size(c), expectedSize)


assertStringContainsLiteral

static void assertStringContainsLiteral(java.lang.String string, java.lang.String substring)


assertSucceedsContinually

@Deprecated
static void assertSucceedsContinually(java.util.Map flags = [:], java.lang.Runnable job)
deprecated:
since 0.5; use Asserts#succeedsContinually(Map, Runnable)#succeedsContinually(Map, Runnable)


assertSucceedsContinually

@Deprecated
static void assertSucceedsContinually(java.util.Map flags = [:], java.util.concurrent.Callable job)
deprecated:
since 0.5; use Asserts#succeedsContinually(Map, Callable)#succeedsContinually(Map, Callable)


assertUrlHasText

@Deprecated
static void assertUrlHasText(java.util.Map flags = [:], java.lang.String url, java.lang.String... phrases)
deprecated:
since 0.4.0 use HttpTestUtils.assertUrlEventuallyHasText or HttpTestUtils.assertUrlHasText (NB: this method has "eventually" logic, with default timeout of 30s, despite the absence of that in the name)


assertUrlStatusCodeEventually

@Deprecated
static void assertUrlStatusCodeEventually(java.lang.String url, int expected)
deprecated:
since 0.5; use HttpTestUtils#assertHttpStatusCodeEquals(String, int)#assertHttpStatusCodeEquals(String, int)


connectToURL

@Deprecated
static java.net.URLConnection connectToURL(java.lang.String url)
Connects to the given url and returns the connection.
deprecated:
Use HttpTestUtils.connectToUrl(url)


executeUntilSucceeds

@Deprecated
static void executeUntilSucceeds(java.util.Map flags = [:], groovy.lang.Closure c)
deprecated:
since 0.5; use Asserts#succeedsEventually(Map, Callable)#succeedsEventually(Map, Callable)


executeUntilSucceeds

@Deprecated
static void executeUntilSucceeds(java.util.Map flags = [:], java.util.concurrent.Callable c)
deprecated:
since 0.5; use Asserts#succeedsEventually(Map, Callable)#succeedsEventually(Map, Callable)


executeUntilSucceeds

@Deprecated
static void executeUntilSucceeds(java.util.Map flags = [:], java.lang.Runnable r)
deprecated:
since 0.5; use Asserts#succeedsEventually(Map, Runnable)#succeedsEventually(Map, Runnable)


executeUntilSucceedsElseShutdown

@Deprecated
static void executeUntilSucceedsElseShutdown(java.util.Map flags = [:], Entity entity, groovy.lang.Closure c)
deprecated:
since 0.5; use Asserts#succeedsEventually(Map, Callable)#succeedsEventually(Map, Callable), and tear-down with AfterMethod.


executeUntilSucceedsWithFinallyBlock

@Deprecated
static void executeUntilSucceedsWithFinallyBlock(java.util.Map flags = [:], groovy.lang.Closure c, groovy.lang.Closure finallyBlock = {})
deprecated:
since 0.5; use Asserts#succeedsEventually(Map, Callable)#succeedsEventually(Map, Callable), and tear-down with AfterMethod.


executeUntilSucceedsWithFinallyBlock

@Deprecated
static void executeUntilSucceedsWithFinallyBlock(java.util.Map flags = [:], java.util.concurrent.Callable c, groovy.lang.Closure finallyBlock = {})
Convenience method for cases where we need to test until something is true. The runnable will be invoked periodically until it succesfully concludes. Additionally, a finally block can be supplied.

The following flags are supported:

deprecated:
since 0.5; use Asserts#succeedsEventually(Map, Callable)#succeedsEventually(Map, Callable), and tear-down with AfterMethod.
Parameters:
flags, - accepts the flags listed above
r
finallyBlock


executeUntilSucceedsWithShutdown

@Deprecated
static void executeUntilSucceedsWithShutdown(java.util.Map flags = [:], Entity entity, groovy.lang.Closure c)
convenience for entities to ensure they shutdown afterwards.
deprecated:
since 0.5; use Asserts#succeedsEventually(Map, Callable)#succeedsEventually(Map, Callable), and tear-down with AfterMethod.


getResource

@Deprecated
static java.io.File getResource(java.lang.String path, java.lang.ClassLoader loader)
deprecated:
since 0.5; use ResourceUtils


isPortInUse

@Deprecated
static boolean isPortInUse(int port, long retryAfterMillis = 0)
True if two attempts to connect to the port succeed.
deprecated:
since 0.5; use NetworkUtils.isPortAvailable


toTimeDuration

@Deprecated
static groovy.time.TimeDuration toTimeDuration(java.lang.Object duration)
deprecated:
since 0.5; use long and java.util.concurrent.TimeUnit


toTimeDuration

@Deprecated
static groovy.time.TimeDuration toTimeDuration(java.lang.Object duration, groovy.time.TimeDuration defaultVal)
deprecated:
since 0.5; use long and java.util.concurrent.TimeUnit


unwrapThrowable

static java.lang.Throwable unwrapThrowable(java.lang.Throwable t)


urlRespondsStatusCode

@Deprecated
static int urlRespondsStatusCode(java.lang.String url)
Connects to the given HTTP URL and asserts that the response had status code 200.
deprecated:
Use HttpTestUtils.getHttpStatusCode(url)


urlRespondsWithStatusCode200

@Deprecated
static boolean urlRespondsWithStatusCode200(java.lang.String url)
Connects to the given HTTP URL and asserts that the response had status code 200.
deprecated:
Use HttpTestUtils.getHttpStatusCode(url) == 200


 

Brooklyn Multi-Cloud Application Management Platform
brooklyncentral.github.com. Apache License. © 2012.