Skip to content

Commit

Permalink
SerializedExecutor sketch for consideration.
Browse files Browse the repository at this point in the history
Based on the EventProcessor, but recast as an Executor that accepts Runnables.
The idea would be to use this on RPC reception points to immediately hand off
work. Each Fragment would have a SerializedExecutor associated with it, serving
as a queue to deliver events to when the RPC thread receives them.
  • Loading branch information
cwestin authored and jacques-n committed Nov 2, 2015
1 parent ce593eb commit 839f8da
Showing 1 changed file with 110 additions and 0 deletions.
110 changes: 110 additions & 0 deletions common/src/main/java/org/apache/drill/common/SerializedExecutor.java
Original file line number Diff line number Diff line change
@@ -0,0 +1,110 @@
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.apache.drill.common;

import java.util.LinkedList;
import java.util.concurrent.Executor;

/**
* Serializes execution of multiple submissions to a single target, while
* still using a thread pool to execute those submissions. Provides an
* implicit queueing capability for a single target that requires any commands
* that execute against it to be serialized.
*/
public class SerializedExecutor implements Executor {
private boolean isProcessing = false;
private final LinkedList<Runnable> queuedRunnables = new LinkedList<>();
private final Executor underlyingExecutor;

/**
* Constructor.
*
* @param underlyingExecutor underlying executor to use to execute commands
* submitted to this SerializedExecutor
*/
public SerializedExecutor(Executor underlyingExecutor) {
this.underlyingExecutor = underlyingExecutor;
}

/**
* An exception occurred in the last command executed; this reports that
* to the subclass of SerializedExecutor.
*
* <p>The default implementation of this method throws an exception, which
* is considered an error (see below). Implementors have two alternatives:
* Arrange not to throw from your commands' run(), or if they do,
* provide an override of this method that handles any exception that
* is thrown.</p>
*
* <p>It is an error for this to throw an exception, and doing so will
* terminate the thread with an IllegalStateException. Derivers must
* handle any reported exceptions in other ways.</p>
*
* @param command the command that caused the exception
* @param t the exception
*/
protected void runException(Runnable command, Throwable t) {
throw new IllegalStateException("unhandled exception thrown by command");
}

private class RunnableProcessor implements Runnable {
private Runnable command;

public RunnableProcessor(Runnable command) {
this.command = command;
}

@Override
public void run() {
while (true) {
try {
command.run();
} catch(Exception | AssertionError e) {
try {
runException(command, e);
} catch(Exception | AssertionError ee) {
throw new IllegalStateException("Exception handler threw an exception", ee);
}
}

synchronized (queuedRunnables) {
if (queuedRunnables.isEmpty()) {
isProcessing = false;
break;
}

command = queuedRunnables.removeFirst();
}
}
}
}

@Override
public void execute(Runnable command) {
synchronized (queuedRunnables) {
if (isProcessing) {
queuedRunnables.addLast(command);
return;
}

isProcessing = true;
}

underlyingExecutor.execute(new RunnableProcessor(command));
}
}

0 comments on commit 839f8da

Please sign in to comment.