com.graphql.spring.boot.test

Class GraphQLTestSubscription

java.lang.Object

com.graphql.spring.boot.test.GraphQLTestSubscription

public class GraphQLTestSubscription
extends java.lang.Object

Helper object to test GraphQL subscriptions.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	GraphQLTestSubscription.TestWebSocketClient

Constructor Summary

Constructors

Constructor and Description
GraphQLTestSubscription()

Method Summary

Modifier and Type	Method and Description
java.util.List<GraphQLResponse>	awaitAndGetAllResponses(int timeToWait) Waits a specified amount time and returns all responses received during that time.
java.util.List<GraphQLResponse>	awaitAndGetAllResponses(int timeToWait, boolean stopAfter) Waits a specified amount time and returns all responses received during that time.
GraphQLResponse	awaitAndGetNextResponse(int timeout) Awaits and returns the next response received from the subscription.
GraphQLResponse	awaitAndGetNextResponse(int timeout, boolean stopAfter) Awaits and returns the next response received from the subscription.
java.util.List<GraphQLResponse>	awaitAndGetNextResponses(int timeout, int numExpectedResponses) Awaits and returns the specified number of responses.
java.util.List<GraphQLResponse>	awaitAndGetNextResponses(int timeout, int numExpectedResponses, boolean stopAfter) Awaits and returns the specified number of responses.
java.util.List<GraphQLResponse>	getRemainingResponses() Returns the remaining responses that were not returned so far.
GraphQLTestSubscription	init() Sends the "connection_init" message to the GraphQL server without a payload.
GraphQLTestSubscription	init(java.lang.Object payload) Sends the "connection_init" message to the GraphQL server.
void	reset() Stops (if needed) and resets this instance.
GraphQLTestSubscription	start(@NonNull java.lang.String graphQLResource) Sends the "start" message to the GraphQL server.
GraphQLTestSubscription	start(@NonNull java.lang.String graphGLResource, java.lang.Object variables) Sends the "start" message to the GraphQL Subscription.
GraphQLTestSubscription	stop() Sends the "stop" message to the server.
GraphQLTestSubscription	waitAndExpectNoResponse(int timeToWait) Waits a specified amount of time and asserts that no responses were received during that time.
GraphQLTestSubscription	waitAndExpectNoResponse(int timeToWait, boolean stopAfter) Waits a specified amount of time and asserts that no responses were received during that time.

Methods inherited from class java.lang.Object

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

Constructor Detail

GraphQLTestSubscription

public GraphQLTestSubscription()

Method Detail

init

public GraphQLTestSubscription init()

Sends the "connection_init" message to the GraphQL server without a payload.

Returns:

self reference

init

public GraphQLTestSubscription init(@Nullable
                                    java.lang.Object payload)

Sends the "connection_init" message to the GraphQL server.

Parameters:

payload - The payload of the connection_init message. May be null, if not needed.

Returns:

self reference

start

public GraphQLTestSubscription start(@NonNull
                                     @NonNull java.lang.String graphQLResource)

Sends the "start" message to the GraphQL server.

Parameters:

graphQLResource - the GraphQL resource, which contains the query for the subscription start payload. The start message will be sent without variables.

Returns:

self reference

start

public GraphQLTestSubscription start(@NonNull
                                     @NonNull java.lang.String graphGLResource,
                                     @Nullable
                                     java.lang.Object variables)

Sends the "start" message to the GraphQL Subscription.

Parameters:

graphGLResource - the GraphQL resource, which contains the query for the subscription start payload.

variables - the variables needed for the query to be evaluated.

Returns:

self reference

stop

public GraphQLTestSubscription stop()

Sends the "stop" message to the server.

Returns:

self reference

reset

public void reset()

Stops (if needed) and resets this instance. This should be called in the "afterEach" method of the test class, to ensure that the bean is reusable between tests.

awaitAndGetNextResponse

public GraphQLResponse awaitAndGetNextResponse(int timeout)

Awaits and returns the next response received from the subscription. The subscription will be stopped after receiving the message (or timeout).

Parameters:

timeout - timeout in milliseconds. Test will fail if no message received from the subscription until the timeout expires.

Returns:

The received response.

awaitAndGetNextResponse

public GraphQLResponse awaitAndGetNextResponse(int timeout,
                                               boolean stopAfter)

Awaits and returns the next response received from the subscription.

Parameters:

timeout - timeout in milliseconds. Test will fail if no message received from the subscription until the timeout expires.

stopAfter - if true, the subscription will be stopped after the message was received (or timeout).

Returns:

The received response.

awaitAndGetAllResponses

public java.util.List<GraphQLResponse> awaitAndGetAllResponses(int timeToWait)

Waits a specified amount time and returns all responses received during that time. This method does not have any expectation regarding the number of messages. The subscription will be stopped after the time elapsed.

Parameters:

timeToWait - the time to wait, in milliseconds

Returns:

the list of responses received during that time.

awaitAndGetAllResponses

public java.util.List<GraphQLResponse> awaitAndGetAllResponses(int timeToWait,
                                                               boolean stopAfter)

Waits a specified amount time and returns all responses received during that time. This method does not have any expectation regarding the number of messages.

Parameters:

timeToWait - the time to wait, in milliseconds

stopAfter - if true, the subscription will be stopped after the time elapsed.

Returns:

the list of responses received during that time.

awaitAndGetNextResponses

public java.util.List<GraphQLResponse> awaitAndGetNextResponses(int timeout,
                                                                int numExpectedResponses)

Awaits and returns the specified number of responses. The subscription will be stopped after receiving the messages (or timeout).

Parameters:

timeout - timeout in milliseconds. Test will fail if the expected number of responses is not received.

numExpectedResponses - the number of expected responses. If negative, the method will wait the timeout and return all responses received during that time. In this case, no assertion is made regarding the number of responses, and the returned list may be empty. If zero, it is expected that no responses are sent during the timeout period.

Returns:

The list containing the expected number of responses. The list contains the responses in the order they were received. If more responses are received than minimally expected, getRemainingResponses() can be used to retrieved them.

awaitAndGetNextResponses

public java.util.List<GraphQLResponse> awaitAndGetNextResponses(int timeout,
                                                                int numExpectedResponses,
                                                                boolean stopAfter)

Awaits and returns the specified number of responses.

Parameters:

timeout - timeout in milliseconds. Test will fail if the expected number of responses is not received.

numExpectedResponses - the number of expected responses. If negative, the method will wait the timeout and return all responses received during that time. In this case, no assertion is made regarding the number of responses, and the returned list may be empty. If zero, it is expected that no responses are sent during the timeout period.

stopAfter - if true, the subscription will be stopped after the messages were received (or timeout).

Returns:

The list containing the expected number of responses. The list contains the responses in the order they were received. If more responses are received than minimally expected, getRemainingResponses() can be used to retrieved them.

waitAndExpectNoResponse

public GraphQLTestSubscription waitAndExpectNoResponse(int timeToWait,
                                                       boolean stopAfter)

Waits a specified amount of time and asserts that no responses were received during that time.

Parameters:

timeToWait - time to wait, in milliseconds.

stopAfter - if true, the subscription will be stopped afterwards.

waitAndExpectNoResponse

public GraphQLTestSubscription waitAndExpectNoResponse(int timeToWait)

Waits a specified amount of time and asserts that no responses were received during that time. The subscription will be stopped afterwards.

Parameters:

timeToWait - time to wait, in milliseconds.

getRemainingResponses

public java.util.List<GraphQLResponse> getRemainingResponses()

Returns the remaining responses that were not returned so far. This method should only be called after the subscription was stopped.

Returns:

the remaining responses.