keith-turner commented on a change in pull request #2340: URL: https://github.com/apache/accumulo/pull/2340#discussion_r741996230
########## File path: core/src/main/java/org/apache/accumulo/core/client/ClientThreadPools.java ########## @@ -0,0 +1,136 @@ +/* + * 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.accumulo.core.client; + +import java.util.concurrent.ScheduledThreadPoolExecutor; +import java.util.concurrent.ThreadPoolExecutor; + +import org.apache.accumulo.core.clientImpl.ClientContext; + +public interface ClientThreadPools { + + /** + * return a shared scheduled executor for trivial tasks + * + * @param ctx + * @return ScheduledThreadPoolExecutor + */ + ScheduledThreadPoolExecutor getSharedScheduledExecutor(ClientContext context); + + /** + * ThreadPoolExecutor that runs bulk import tasks + * + * @param ctx + * @param numThreads + * @return ThreadPoolExecutor + */ + ThreadPoolExecutor getBulkImportThreadPool(ClientContext ctx, int numThreads); + + /** + * ThreadPoolExecutor that runs tasks to contact Compactors to get running compaction information + * + * @param numThreads + * @return ThreadPoolExecutor + */ + ThreadPoolExecutor getExternalCompactionActiveCompactionsPool(ClientContext ctx, int numThreads); + + /** + * ThreadPoolExecutor used for fetching data from the TabletServers + * + * @param ctx + * @return ThreadPoolExecutor + */ + ThreadPoolExecutor getScannerReadAheadPool(ClientContext ctx); + + /** + * ThreadPoolExecutor used for adding splits to a table + * + * @param ctx + * @return ThreadPoolExecutor + */ + ThreadPoolExecutor getAddSplitsThreadPool(ClientContext ctx); + + /** + * ThreadPoolExecutor used for fetching data from the TabletServers + * + * @param ctx + * @param numQueryThreads + * @param batchReaderInstance + * @return ThreadPoolExecutor + */ + ThreadPoolExecutor getBatchReaderThreadPool(ClientContext ctx, int numQueryThreads, + int batchReaderInstance); + + /** + * ScheduledThreadPoolExecutor that runs tasks for the BatchWriter to meet the users latency + * goals. + * + * @param ctx + * client context object + * @return ScheduledThreadPoolExecutor + */ + ScheduledThreadPoolExecutor getBatchWriterLatencyTasksThreadPool(ClientContext ctx); + + /** + * ThreadPoolExecutor that runs the tasks of binning mutations + * + * @param ctx + * client context object + * @return ThreadPoolExecutor + */ + ThreadPoolExecutor getBatchWriterBinningThreadPool(ClientContext ctx); + + /** + * ThreadPoolExecutor that runs the tasks of sending mutations to TabletServers + * + * @param ctx + * client context object + * @return ThreadPoolExecutor + */ + ThreadPoolExecutor getBatchWriterSendThreadPool(ClientContext ctx, int numSendThreads); + + /** + * ThreadPoolExecutor that runs clean up tasks when close is called on the ConditionalWriter + * + * @param ctx + * @return ThreadPoolExecutor + */ + ThreadPoolExecutor getConditionalWriterCleanupTaskThreadPool(ClientContext ctx); Review comment: The enums do not properly capture all of the complexity. For example I see for one enum a SynchronousQueue is used and for another enum 0 to 3 threads are used. It seems like the enum could be dropped and everything that is needed for creation pushed into the config object, maybe that becomes to complex for anyone to ever use properly though. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
