|
@@ -0,0 +1,144 @@
|
|
|
+/**
|
|
|
+ * 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.io.erasurecode;
|
|
|
+
|
|
|
+import org.apache.hadoop.conf.Configuration;
|
|
|
+import org.apache.hadoop.fs.CommonConfigurationKeys;
|
|
|
+import org.apache.hadoop.io.erasurecode.rawcoder.*;
|
|
|
+
|
|
|
+/**
|
|
|
+ * A codec utility.
|
|
|
+ */
|
|
|
+public final class CodecUtil {
|
|
|
+
|
|
|
+ private CodecUtil() {}
|
|
|
+
|
|
|
+ /**
|
|
|
+ * Create RS raw encoder according to configuration.
|
|
|
+ * @param conf
|
|
|
+ * @param numDataUnits
|
|
|
+ * @param numParityUnits
|
|
|
+ * @return raw encoder
|
|
|
+ */
|
|
|
+ public static RawErasureEncoder createRSRawEncoder(
|
|
|
+ Configuration conf, int numDataUnits, int numParityUnits) {
|
|
|
+ RawErasureCoder rawCoder = createRawCoder(conf,
|
|
|
+ CommonConfigurationKeys.IO_ERASURECODE_CODEC_RS_RAWCODER_KEY,
|
|
|
+ true, numDataUnits, numParityUnits);
|
|
|
+ if (rawCoder == null) {
|
|
|
+ rawCoder = new RSRawEncoder(numDataUnits, numParityUnits);
|
|
|
+ }
|
|
|
+
|
|
|
+ return (RawErasureEncoder) rawCoder;
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * Create RS raw decoder according to configuration.
|
|
|
+ * @param conf
|
|
|
+ * @param numDataUnits
|
|
|
+ * @param numParityUnits
|
|
|
+ * @return raw decoder
|
|
|
+ */
|
|
|
+ public static RawErasureDecoder createRSRawDecoder(
|
|
|
+ Configuration conf, int numDataUnits, int numParityUnits) {
|
|
|
+ RawErasureCoder rawCoder = createRawCoder(conf,
|
|
|
+ CommonConfigurationKeys.IO_ERASURECODE_CODEC_RS_RAWCODER_KEY,
|
|
|
+ false, numDataUnits, numParityUnits);
|
|
|
+ if (rawCoder == null) {
|
|
|
+ rawCoder = new RSRawDecoder(numDataUnits, numParityUnits);
|
|
|
+ }
|
|
|
+
|
|
|
+ return (RawErasureDecoder) rawCoder;
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * Create XOR raw encoder according to configuration.
|
|
|
+ * @param conf
|
|
|
+ * @param numDataUnits
|
|
|
+ * @param numParityUnits
|
|
|
+ * @return raw encoder
|
|
|
+ */
|
|
|
+ public static RawErasureEncoder createXORRawEncoder(
|
|
|
+ Configuration conf, int numDataUnits, int numParityUnits) {
|
|
|
+ RawErasureCoder rawCoder = createRawCoder(conf,
|
|
|
+ CommonConfigurationKeys.IO_ERASURECODE_CODEC_XOR_RAWCODER_KEY,
|
|
|
+ true, numDataUnits, numParityUnits);
|
|
|
+ if (rawCoder == null) {
|
|
|
+ rawCoder = new XORRawEncoder(numDataUnits, numParityUnits);
|
|
|
+ }
|
|
|
+
|
|
|
+ return (RawErasureEncoder) rawCoder;
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * Create XOR raw decoder according to configuration.
|
|
|
+ * @param conf
|
|
|
+ * @param numDataUnits
|
|
|
+ * @param numParityUnits
|
|
|
+ * @return raw decoder
|
|
|
+ */
|
|
|
+ public static RawErasureDecoder createXORRawDecoder(
|
|
|
+ Configuration conf, int numDataUnits, int numParityUnits) {
|
|
|
+ RawErasureCoder rawCoder = createRawCoder(conf,
|
|
|
+ CommonConfigurationKeys.IO_ERASURECODE_CODEC_XOR_RAWCODER_KEY,
|
|
|
+ false, numDataUnits, numParityUnits);
|
|
|
+ if (rawCoder == null) {
|
|
|
+ rawCoder = new XORRawDecoder(numDataUnits, numParityUnits);
|
|
|
+ }
|
|
|
+
|
|
|
+ return (RawErasureDecoder) rawCoder;
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * Create raw coder using specified conf and raw coder factory key.
|
|
|
+ * @param conf
|
|
|
+ * @param rawCoderFactoryKey
|
|
|
+ * @param isEncoder
|
|
|
+ * @param numDataUnits
|
|
|
+ * @param numParityUnits
|
|
|
+ * @return raw coder
|
|
|
+ */
|
|
|
+ public static RawErasureCoder createRawCoder(Configuration conf,
|
|
|
+ String rawCoderFactoryKey, boolean isEncoder, int numDataUnits,
|
|
|
+ int numParityUnits) {
|
|
|
+
|
|
|
+ if (conf == null) {
|
|
|
+ return null;
|
|
|
+ }
|
|
|
+
|
|
|
+ Class<? extends RawErasureCoderFactory> factClass = null;
|
|
|
+ factClass = conf.getClass(rawCoderFactoryKey,
|
|
|
+ factClass, RawErasureCoderFactory.class);
|
|
|
+
|
|
|
+ if (factClass == null) {
|
|
|
+ return null;
|
|
|
+ }
|
|
|
+
|
|
|
+ RawErasureCoderFactory fact;
|
|
|
+ try {
|
|
|
+ fact = factClass.newInstance();
|
|
|
+ } catch (InstantiationException e) {
|
|
|
+ throw new RuntimeException("Failed to create raw coder", e);
|
|
|
+ } catch (IllegalAccessException e) {
|
|
|
+ throw new RuntimeException("Failed to create raw coder", e);
|
|
|
+ }
|
|
|
+
|
|
|
+ return isEncoder ? fact.createEncoder(numDataUnits, numParityUnits) :
|
|
|
+ fact.createDecoder(numDataUnits, numParityUnits);
|
|
|
+ }
|
|
|
+}
|