Package io.helidon.webserver.testsupport

Class SocketHttpClient

java.lang.Object

io.helidon.webserver.testsupport.SocketHttpClient

All Implemented Interfaces:

java.lang.AutoCloseable

public class SocketHttpClient
extends java.lang.Object
implements java.lang.AutoCloseable

The SocketHttpClient provides means to simply pass any bytes into the WebServer and to see how it deals with such case.

Constructor Summary

Constructors

Constructor	Description
SocketHttpClient(WebServer webServer)	Creates the instance linked with the provided webserver.

Method Summary

Modifier and Type	Method	Description
static void	assertConnectionIsClosed(SocketHttpClient s)	Assert that the socket associated with the provided client is closed.
static void	assertConnectionIsOpen(SocketHttpClient s)	Assert that the socket associated with the provided client is working and open.
void	close()
static java.lang.StringBuilder	longData(int bytes)	Generates at least bytes number of bytes as a sequence of decimal numbers delimited by newlines.
java.lang.String	receive()	Read the data from the socket.
void	request(io.helidon.common.http.Http.Method method)	Sends a request to the webserver.
void	request(io.helidon.common.http.Http.Method method, java.lang.String payload)	Sends a request to the webserver.
void	request(io.helidon.common.http.Http.Method method, java.lang.String path, java.lang.String payload)	Sends a request to the webserver.
void	request(io.helidon.common.http.Http.Method method, java.lang.String path, java.lang.String payload, java.lang.Iterable<java.lang.String> headers)	Sends a request to the webserver.
static java.lang.String	sendAndReceive(io.helidon.common.http.Http.Method method, java.lang.String payload, WebServer webServer)	A helper method that sends the given payload with the provided method to the webserver.
static java.lang.String	sendAndReceive(java.lang.String path, io.helidon.common.http.Http.Method method, java.lang.String payload, WebServer webServer)	A helper method that sends the given payload at the given path with the provided method and headers to the webserver.
static java.lang.String	sendAndReceive(java.lang.String path, io.helidon.common.http.Http.Method method, java.lang.String payload, java.lang.Iterable<java.lang.String> headers, WebServer webServer)	A helper method that sends the given payload at the given path with the provided method to the webserver.
protected void	sendPayload(java.io.PrintWriter pw, java.lang.String payload)	Override this to send a specific payload.

Methods inherited from class java.lang.Object

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

Constructor Detail

SocketHttpClient

public SocketHttpClient(WebServer webServer)
                 throws java.io.IOException

Creates the instance linked with the provided webserver.

Parameters:

webServer - the webserver to link this client with

Throws:

java.io.IOException - in case of an error

Method Detail

sendAndReceive

public static java.lang.String sendAndReceive(io.helidon.common.http.Http.Method method,
                                              java.lang.String payload,
                                              WebServer webServer)
                                       throws java.lang.Exception

A helper method that sends the given payload with the provided method to the webserver.

Parameters:

method - the http method

payload - the payload to send (must be without the newlines; otherwise it's not a valid payload)

webServer - the webserver where to send the payload

Returns:

the exact string returned by webserver (including HTTP/1.1 200 OK line for instance)

Throws:

java.lang.Exception - in case of an error

sendAndReceive

public static java.lang.String sendAndReceive(java.lang.String path,
                                              io.helidon.common.http.Http.Method method,
                                              java.lang.String payload,
                                              WebServer webServer)
                                       throws java.lang.Exception

A helper method that sends the given payload at the given path with the provided method and headers to the webserver.

Parameters:

path - the path to access

method - the http method

payload - the payload to send (must be without the newlines; otherwise it's not a valid payload)

webServer - the webserver where to send the payload

Returns:

the exact string returned by webserver (including HTTP/1.1 200 OK line for instance)

Throws:

java.lang.Exception - in case of an error

sendAndReceive

public static java.lang.String sendAndReceive(java.lang.String path,
                                              io.helidon.common.http.Http.Method method,
                                              java.lang.String payload,
                                              java.lang.Iterable<java.lang.String> headers,
                                              WebServer webServer)
                                       throws java.lang.Exception

A helper method that sends the given payload at the given path with the provided method to the webserver.

Parameters:

path - the path to access

method - the http method

payload - the payload to send (must be without the newlines; otherwise it's not a valid payload)

headers - HTTP request headers

webServer - the webserver where to send the payload

Returns:

the exact string returned by webserver (including HTTP/1.1 200 OK line for instance)

Throws:

java.lang.Exception - in case of an error

assertConnectionIsOpen

public static void assertConnectionIsOpen(SocketHttpClient s)
                                   throws java.io.IOException

Assert that the socket associated with the provided client is working and open.

Parameters:

s - the socket client

Throws:

java.io.IOException - in case of an IO error

assertConnectionIsClosed

public static void assertConnectionIsClosed(SocketHttpClient s)
                                     throws java.io.IOException

Assert that the socket associated with the provided client is closed.

Parameters:

s - the socket client

Throws:

java.io.IOException - in case of an IO error

longData

public static java.lang.StringBuilder longData(int bytes)

Generates at least bytes number of bytes as a sequence of decimal numbers delimited by newlines.

Parameters:

bytes - the amount of bytes to generate (might get little bit more than that)

Returns:

the generated bytes as a sequence of decimal numbers delimited by newlines

receive

public java.lang.String receive()
                         throws java.io.IOException

Read the data from the socket. If socket is closed, an empty string is returned.

Returns:

the read data

Throws:

java.io.IOException - in case of an IO error

request

public void request(io.helidon.common.http.Http.Method method)
             throws java.io.IOException

Sends a request to the webserver.

Parameters:

method - the http method

Throws:

java.io.IOException - in case of an IO error

request

public void request(io.helidon.common.http.Http.Method method,
                    java.lang.String payload)
             throws java.io.IOException

Sends a request to the webserver.

Parameters:

method - the http method

payload - the payload to send (must be without the newlines; otherwise it's not a valid payload)

Throws:

java.io.IOException - in case of an IO error

request

public void request(io.helidon.common.http.Http.Method method,
                    java.lang.String path,
                    java.lang.String payload)
             throws java.io.IOException

Sends a request to the webserver.

Parameters:

path - the path to access

method - the http method

payload - the payload to send (must be without the newlines; otherwise it's not a valid payload)

Throws:

java.io.IOException - in case of an IO error

request

public void request(io.helidon.common.http.Http.Method method,
                    java.lang.String path,
                    java.lang.String payload,
                    java.lang.Iterable<java.lang.String> headers)
             throws java.io.IOException

Sends a request to the webserver.

Parameters:

path - the path to access

method - the http method

payload - the payload to send (must be without the newlines; otherwise it's not a valid payload)

headers - the headers (e.g., Content-Type: application/json)

Throws:

java.io.IOException - in case of an IO error

sendPayload

protected void sendPayload(java.io.PrintWriter pw,
                           java.lang.String payload)

Override this to send a specific payload.

Parameters:

pw - the print writer where to write the payload

payload - the payload as provided in the receive() methods.

close

public void close()
           throws java.lang.Exception

Specified by:

close in interface java.lang.AutoCloseable

Throws:

java.lang.Exception