Constructor Detail

• HttpTestUtils

  public HttpTestUtils()

Method Detail

• connectToUrl

  public static java.net.URLConnection connectToUrl(java.lang.String u)
                                             throws java.lang.Exception

  Connects to the given url and returns the connection. Caller should connection.getInputStream().close() the result of this (especially if they are making heavy use of this method).

  Throws:

  java.lang.Exception

• assertHealthyStatusCode

  public static void assertHealthyStatusCode(int code)

• getHttpStatusCode

  public static int getHttpStatusCode(java.lang.String url)
                               throws java.lang.Exception

  Throws:

  java.lang.Exception

• assertUrlReachable

  public static void assertUrlReachable(java.lang.String url)

  Asserts that gets back any "valid" response - i.e. not an exception. This could be an unauthorized, a redirect, a 404, or anything else that implies there is web-server listening on that port.

• assertUrlUnreachable

  public static void assertUrlUnreachable(java.lang.String url)

• assertUrlUnreachableEventually

  public static void assertUrlUnreachableEventually(java.lang.String url)

• assertUrlUnreachableEventually

  public static void assertUrlUnreachableEventually(java.util.Map flags,
                                    java.lang.String url)

• assertHttpStatusCodeEquals

  public static void assertHttpStatusCodeEquals(java.lang.String url,
                                int... acceptableReturnCodes)

• assertHttpStatusCodeEventuallyEquals

  public static void assertHttpStatusCodeEventuallyEquals(java.lang.String url,
                                          int expectedCode)

• assertHttpStatusCodeEventuallyEquals

  public static void assertHttpStatusCodeEventuallyEquals(java.util.Map flags,
                                          java.lang.String url,
                                          int expectedCode)

• assertContentContainsText

  public static void assertContentContainsText(java.lang.String url,
                               java.lang.String phrase,
                               java.lang.String... additionalPhrases)

• assertContentNotContainsText

  public static void assertContentNotContainsText(java.lang.String url,
                                  java.lang.String phrase,
                                  java.lang.String... additionalPhrases)

• assertErrorContentContainsText

  public static void assertErrorContentContainsText(java.lang.String url,
                                    java.lang.String phrase,
                                    java.lang.String... additionalPhrases)

• assertErrorContentNotContainsText

  public static void assertErrorContentNotContainsText(java.lang.String url,
                                       java.lang.String phrase,
                                       java.lang.String... additionalPhrases)

• assertContentEventuallyContainsText

  public static void assertContentEventuallyContainsText(java.lang.String url,
                                         java.lang.String phrase,
                                         java.lang.String... additionalPhrases)

• assertContentEventuallyContainsText

  public static void assertContentEventuallyContainsText(java.util.Map flags,
                                         java.lang.String url,
                                         java.lang.String phrase,
                                         java.lang.String... additionalPhrases)

• assertContentMatches

  public static void assertContentMatches(java.lang.String url,
                          java.lang.String regex)

• assertContentEventuallyMatches

  public static void assertContentEventuallyMatches(java.lang.String url,
                                    java.lang.String regex)

• getErrorContent

  public static java.lang.String getErrorContent(java.lang.String url)

• getContent

  public static java.lang.String getContent(java.lang.String url)

• assertAsyncHttpStatusCodeContinuallyEquals

  public static com.google.common.util.concurrent.ListenableFuture<?> assertAsyncHttpStatusCodeContinuallyEquals(com.google.common.util.concurrent.ListeningExecutorService executor,
                                                                                                 java.lang.String url,
                                                                                                 int expectedStatusCode)

  Schedules (with the given executor) a poller that repeatedly accesses the given url, to confirm it always gives back the expected status code. Expected usage is to query the future, such as:

   Future<?> future = assertAsyncHttpStatusCodeContinuallyEquals(executor, url, 200);
   // do other stuff...
   if (future.isDone()) future.get(); // get exception if it's failed
   
   

  For stopping it, you can either do future.cancel(true), or you can just do executor.shutdownNow(). TODO Look at difference between this and WebAppMonitor, to decide if this should be kept.

• consumeAndCloseQuietly

  public static void consumeAndCloseQuietly(java.net.HttpURLConnection connection)

  Consumes the input stream entirely and then cleanly closes the connection. Ignores all exceptions completely, not even logging them! Consuming the stream fully is useful for preventing idle TCP connections. See http://docs.oracle.com/javase/8/docs/technotes/guides/net/http-keepalive.html.

• closeQuietly

  public static void closeQuietly(java.net.HttpURLConnection connection)

  Closes all streams of the connection, and disconnects it. Ignores all exceptions completely, not even logging them!