dlmarion commented on a change in pull request #2340: URL: https://github.com/apache/accumulo/pull/2340#discussion_r741323905
########## 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); Review comment: Fixed in 94a6163, I should have waited to have you review until the checks were done. ########## File path: core/src/main/java/org/apache/accumulo/core/client/AccumuloClient.java ########## @@ -338,6 +338,13 @@ ConditionalWriter createConditionalWriter(String tableName, ConditionalWriterCon @Override void close(); + /** + * Sets a user-defined ClientThreadPools implementation + * + * @param impl Review comment: Fixed in 94a6163, I should have waited to have you review until the checks were done. ########## 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: I was trying to reduce the number of places users would have to modify their pre-2.1.0 code. This way would allow them to create their own implementation when they create the client instead of specifying for each scanner/writer/etc. Additionally, by creating their own ThreadPool's, they can set their own uncaught exception handler. ########## File path: core/src/main/java/org/apache/accumulo/core/clientImpl/bulk/BulkImport.java ########## @@ -229,6 +228,7 @@ private Path checkPath(FileSystem fs, String dir) throws IOException, AccumuloEx } @Override + @Deprecated(since = "2.1.0") public ImportMappingOptions executor(Executor service) { Review comment: It's available in the ClienttThreadPools implementation. ########## File path: core/src/main/java/org/apache/accumulo/core/clientImpl/bulk/BulkImport.java ########## @@ -229,6 +228,7 @@ private Path checkPath(FileSystem fs, String dir) throws IOException, AccumuloEx } @Override + @Deprecated(since = "2.1.0") public ImportMappingOptions executor(Executor service) { Review comment: It's available in the ClientThreadPools implementation. ########## 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: see 2effcce. ########## File path: core/src/main/java/org/apache/accumulo/core/clientImpl/bulk/BulkImport.java ########## @@ -229,6 +228,7 @@ private Path checkPath(FileSystem fs, String dir) throws IOException, AccumuloEx } @Override + @Deprecated(since = "2.1.0") public ImportMappingOptions executor(Executor service) { Review comment: Resolved in 6c996df -- 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]
