com.mapr.ojai.store.impl

Class DelegatingResultsListener

java.lang.Object

com.mapr.ojai.store.impl.DelegatingResultsListener

All Implemented Interfaces:

org.apache.drill.exec.rpc.user.UserResultsListener

public class DelegatingResultsListener
extends java.lang.Object
implements org.apache.drill.exec.rpc.user.UserResultsListener

Delegate calls to this UserResultsListener to another UserResultListener on another thread. Allows decoupling message processing from the Drill RPC event delivery thread. This is required because if the delivery thread blocks, say because it is waiting to write to a delivery queue for a push-to-pull conversion, then no other Drill messages can be sent. This also helps avoid accidental self-deadlock that can result from attempting to send Drill another message from under a delivery call, for example, an attempt to send a query cancellation from inside a document delivery call.

Constructor Summary

Constructors

Constructor and Description
DelegatingResultsListener(java.util.concurrent.ExecutorService executorService, int id, org.apache.drill.exec.rpc.user.UserResultsListener delegateListener) Constructor.

Method Summary

Modifier and Type	Method and Description
void	dataArrived(org.apache.drill.exec.rpc.user.QueryDataBatch result, org.apache.drill.exec.rpc.ConnectionThrottle throttle) A QueryData message was received
void	queryCompleted(org.apache.drill.exec.proto.UserBitShared.QueryResult.QueryState state) The query has completed (successsful completion or cancellation).
void	queryIdArrived(org.apache.drill.exec.proto.UserBitShared.QueryId queryId) QueryId is available.
void	submissionFailed(org.apache.drill.common.exceptions.UserException ex) The query has failed.
void	terminate() Terminate any running task, and don't submit any more.

Methods inherited from class java.lang.Object

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

Constructor Detail

DelegatingResultsListener

public DelegatingResultsListener(java.util.concurrent.ExecutorService executorService,
                                 int id,
                                 org.apache.drill.exec.rpc.user.UserResultsListener delegateListener)

Constructor.

Parameters:

executorService - an executor service to submit the delegated call to

delegateListener - the delegate

Method Detail

queryIdArrived

public void queryIdArrived(org.apache.drill.exec.proto.UserBitShared.QueryId queryId)

Description copied from interface: org.apache.drill.exec.rpc.user.UserResultsListener

QueryId is available. Called when a query is successfully submitted to the server.

Specified by:

queryIdArrived in interface org.apache.drill.exec.rpc.user.UserResultsListener

Parameters:

queryId - sent by the server along Acks.OK

submissionFailed

public void submissionFailed(org.apache.drill.common.exceptions.UserException ex)

Description copied from interface: org.apache.drill.exec.rpc.user.UserResultsListener

The query has failed. Most likely called when the server returns a FAILED query state. Can also be called if dataArrived() throws an exception

Specified by:

submissionFailed in interface org.apache.drill.exec.rpc.user.UserResultsListener

Parameters:

ex - exception describing the cause of the failure

dataArrived

public void dataArrived(org.apache.drill.exec.rpc.user.QueryDataBatch result,
                        org.apache.drill.exec.rpc.ConnectionThrottle throttle)

Description copied from interface: org.apache.drill.exec.rpc.user.UserResultsListener

A QueryData message was received

Specified by:

dataArrived in interface org.apache.drill.exec.rpc.user.UserResultsListener

Parameters:

result - data batch received

throttle - connection throttle

queryCompleted

public void queryCompleted(org.apache.drill.exec.proto.UserBitShared.QueryResult.QueryState state)

Description copied from interface: org.apache.drill.exec.rpc.user.UserResultsListener

The query has completed (successsful completion or cancellation). The listener will not receive any other data or result message. Called when the server returns a terminal-non failing- state (COMPLETED or CANCELLED)

Specified by:

queryCompleted in interface org.apache.drill.exec.rpc.user.UserResultsListener

terminate

public void terminate()

Terminate any running task, and don't submit any more. This will interrupt any thread that is running a submitted task.