sodonnel commented on a change in pull request #2653: URL: https://github.com/apache/ozone/pull/2653#discussion_r712459758
########## File path: hadoop-ozone/client/src/main/java/org/apache/hadoop/ozone/client/io/BlockInputStreamFactory.java ########## @@ -0,0 +1,78 @@ +/* + * 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.hadoop.ozone.client.io; + +import org.apache.hadoop.hdds.client.BlockID; +import org.apache.hadoop.hdds.client.ReplicationConfig; +import org.apache.hadoop.hdds.scm.XceiverClientFactory; +import org.apache.hadoop.hdds.scm.pipeline.Pipeline; +import org.apache.hadoop.hdds.scm.storage.BlockExtendedInputStream; +import org.apache.hadoop.hdds.security.token.OzoneBlockTokenIdentifier; +import org.apache.hadoop.ozone.om.helpers.OmKeyLocationInfo; +import org.apache.hadoop.security.token.Token; + +import java.util.function.Function; + +/** + * Interface used by classes which need to obtain BlockStream instances. + */ +public interface BlockInputStreamFactory { + + /** + * Create a new BlockInputStream from the given parameters. + * @param blockId The blockID + * @param blockLen The Block Length + * @param pipeline The pipeline used to read from the block + * @param token The block access token + * @param verifyChecksum Whether to verify checksums or not + * @param xceiverFactory Factor to create the xceiver in the client + * @param refreshFunction Function to refresh the pipeline if needed. + * @return A BlockInputStream instance + */ + BlockExtendedInputStream create(BlockID blockId, long blockLen, + Pipeline pipeline, Token<OzoneBlockTokenIdentifier> token, + boolean verifyChecksum, XceiverClientFactory xceiverFactory, + Function<BlockID, Pipeline> refreshFunction); + + /** + * Create a new BlockInputStream based on the replication Config. If the + * replication Config indicates the block is EC, then it will create an + * ECBlockInputStream, otherwise a BlockInputStream will be returned. + * @param repConfig The replication Config + * @param blockInfo The blockInfo representing the block. + * @param pipeline The pipeline to be used for reading the block + * @param token The block Access Token + * @param verifyChecksum Whether to verify checksums or not. + * @param xceiverFactory Factory to create the xceiver in the client + * @param refreshFunction Function to refresh the pipeline if needed + * @return BlockExtendedInputStream of the correct type. + */ + BlockExtendedInputStream create(ReplicationConfig repConfig, + OmKeyLocationInfo blockInfo, Pipeline pipeline, + Token<OzoneBlockTokenIdentifier> token, boolean verifyChecksum, + XceiverClientFactory xceiverFactory, + Function<BlockID, Pipeline> refreshFunction); + Review comment: Sorry, I thought I had removed this. It is removed now! -- 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] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
