Package org.apache.hadoop.io.erasurecode.rawcoder

Class NativeXORRawEncoder

java.lang.Object

org.apache.hadoop.io.erasurecode.rawcoder.RawErasureEncoder

org.apache.hadoop.io.erasurecode.rawcoder.NativeXORRawEncoder

@Private
public class NativeXORRawEncoder
extends RawErasureEncoder

A XOR raw encoder using Intel ISA-L library.

Field Summary

Fields

Modifier and Type	Field	Description
protected java.util.concurrent.locks.ReentrantReadWriteLock	encoderLock
static org.slf4j.Logger	LOG

Constructor Summary

Constructors

Constructor	Description
NativeXORRawEncoder(ErasureCoderOptions coderOptions)

Method Summary

Modifier and Type	Method	Description
protected void	doEncode(org.apache.hadoop.io.erasurecode.rawcoder.ByteArrayEncodingState encodingState)	Perform the real encoding work using bytes array, supporting offsets and lengths.
protected void	doEncode(org.apache.hadoop.io.erasurecode.rawcoder.ByteBufferEncodingState encodingState)	Perform the real encoding work using direct ByteBuffer.
protected void	performEncodeImpl(java.nio.ByteBuffer[] inputs, int[] inputOffsets, int dataLen, java.nio.ByteBuffer[] outputs, int[] outputOffsets)
boolean	preferDirectBuffer()	Tell if direct buffer is preferred or not.
void	release()	Should be called when release this coder.

Methods inherited from class org.apache.hadoop.io.erasurecode.rawcoder.RawErasureEncoder

allowChangeInputs, allowVerboseDump, encode, encode, encode, getNumAllUnits, getNumDataUnits, getNumParityUnits

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

LOG

public static org.slf4j.Logger LOG

encoderLock

protected final java.util.concurrent.locks.ReentrantReadWriteLock encoderLock

Constructor Detail

NativeXORRawEncoder

public NativeXORRawEncoder(ErasureCoderOptions coderOptions)

Method Detail

performEncodeImpl

protected void performEncodeImpl(java.nio.ByteBuffer[] inputs,
                                 int[] inputOffsets,
                                 int dataLen,
                                 java.nio.ByteBuffer[] outputs,
                                 int[] outputOffsets)
                          throws java.io.IOException

Throws:

java.io.IOException

release

public void release()

Description copied from class: RawErasureEncoder

Should be called when release this coder. Good chance to release encoding or decoding buffers

Overrides:

release in class RawErasureEncoder

doEncode

protected void doEncode(org.apache.hadoop.io.erasurecode.rawcoder.ByteBufferEncodingState encodingState)
                 throws java.io.IOException

Description copied from class: RawErasureEncoder

Perform the real encoding work using direct ByteBuffer.

Specified by:

doEncode in class RawErasureEncoder

Parameters:

encodingState - the encoding state.

Throws:

java.io.IOException - raised on errors performing I/O.

doEncode

protected void doEncode(org.apache.hadoop.io.erasurecode.rawcoder.ByteArrayEncodingState encodingState)
                 throws java.io.IOException

Description copied from class: RawErasureEncoder

Perform the real encoding work using bytes array, supporting offsets and lengths.

Specified by:

doEncode in class RawErasureEncoder

Parameters:

encodingState - the encoding state

Throws:

java.io.IOException - raised on errors performing I/O.

preferDirectBuffer

public boolean preferDirectBuffer()

Description copied from class: RawErasureEncoder

Tell if direct buffer is preferred or not. It's for callers to decide how to allocate coding chunk buffers, using DirectByteBuffer or bytes array. It will return false by default.

Overrides:

preferDirectBuffer in class RawErasureEncoder

Returns:

true if native buffer is preferred for performance consideration, otherwise false.