io.axoniq.axonserver.connector.query

Interface QueryChannel

All Known Implementing Classes:

QueryChannelImpl

public interface QueryChannel

Communication channel with AxonServer for Query related interactions.

Method Summary

Modifier and Type	Method and Description
CompletableFuture<Void>	prepareDisconnect() Prepares this QueryChannel to disconnect, by unsubscribing all registered query handlers.
ResultStream<QueryResponse>	query(QueryRequest query) Sends the given query to AxonServer for routing to the appropriate handlers.
Registration	registerQueryHandler(QueryHandler handler, QueryDefinition... queryTypes) Registers the given handler to handle incoming queries defined through the given queryTypes.
SubscriptionQueryResult	subscriptionQuery(QueryRequest query, SerializedObject updateType, int bufferSize, int fetchSize) Sends out a subscription query to AxonServer for routing to the appropriate handler.

Method Detail

registerQueryHandler

Registration registerQueryHandler(QueryHandler handler,
                                  QueryDefinition... queryTypes)

Registers the given handler to handle incoming queries defined through the given queryTypes. Duplicate handlers can be registered.

Parameters:

handler - the handler to handle incoming queries with

queryTypes - the QueryDefinitions to register the handler for

Returns:

a registration which allows the query handler to be deregistered

query

ResultStream<QueryResponse> query(QueryRequest query)

Sends the given query to AxonServer for routing to the appropriate handlers.

Parameters:

query - the QueryRequest to send

Returns:

a ResultStream providing the results of query execution

subscriptionQuery

SubscriptionQueryResult subscriptionQuery(QueryRequest query,
                                          SerializedObject updateType,
                                          int bufferSize,
                                          int fetchSize)

Sends out a subscription query to AxonServer for routing to the appropriate handler. Allows for receiving an initial query result followed by a stream of updates.

Parameters:

query - the subscription QueryRequest to send

updateType - the type of updates expected from this subscription query

bufferSize - the number of updates to be buffered by the update result stream

fetchSize - the number of updates to be consumed from the update stream prior to refilling it

Returns:

the SubscriptionQueryResult containing the initial result and update stream

prepareDisconnect

CompletableFuture<Void> prepareDisconnect()

Prepares this QueryChannel to disconnect, by unsubscribing all registered query handlers. Will wait with a certain cut off until all acknowledgments of unsubscribing have been received.

This method should be used if a connected client wants to disconnect from AxonServer.

Returns:

a CompletableFuture of Void to react when all query handlers have been unsubscribed