T
- the type of elements handled by this coder.public class WritableCoder<T extends Writable> extends CustomCoder<T>
WritableCoder
is a Coder
for a Java class that implements Writable
.
To use, specify the coder type on a PCollection:
PCollection<MyRecord> records =
foo.apply(...).setCoder(WritableCoder.of(MyRecord.class));
Modifier and Type | Class and Description |
---|---|
static class |
WritableCoder.WritableCoderProviderRegistrar
|
Coder.Context, Coder.NonDeterministicException
Constructor and Description |
---|
WritableCoder(java.lang.Class<T> type) |
Modifier and Type | Method and Description |
---|---|
T |
decode(java.io.InputStream inStream)
Decodes a value of type
T from the given input stream in the given context. |
void |
encode(T value,
java.io.OutputStream outStream)
Encodes the given value of type
T onto the given output stream. |
boolean |
equals(@Nullable java.lang.Object other) |
java.util.List<Coder<?>> |
getCoderArguments()
|
static CoderProvider |
getCoderProvider()
|
int |
hashCode() |
static <T extends Writable> |
of(java.lang.Class<T> clazz)
Returns a
WritableCoder instance for the provided element class. |
void |
verifyDeterministic()
Throw
Coder.NonDeterministicException if the coding is not deterministic. |
consistentWithEquals, decode, encode, getEncodedElementByteSize, getEncodedTypeDescriptor, isRegisterByteSizeObserverCheap, registerByteSizeObserver, structuralValue, verifyDeterministic, verifyDeterministic
public WritableCoder(java.lang.Class<T> type)
public static <T extends Writable> WritableCoder<T> of(java.lang.Class<T> clazz)
WritableCoder
instance for the provided element class.T
- the element typepublic void encode(T value, java.io.OutputStream outStream) throws java.io.IOException
Coder
T
onto the given output stream. Multiple elements can
be encoded next to each other on the output stream, each coder should encode information to
know how many bytes to read when decoding. A common approach is to prefix the encoding with the
element's encoded length.encode
in class Coder<T extends Writable>
java.io.IOException
- if writing to the OutputStream
fails for some reasonCoderException
- if the value could not be encoded for some reasonpublic T decode(java.io.InputStream inStream) throws java.io.IOException
Coder
T
from the given input stream in the given context. Returns the
decoded value. Multiple elements can be encoded next to each other on the input stream, each
coder should encode information to know how many bytes to read when decoding. A common approach
is to prefix the encoding with the element's encoded length.decode
in class Coder<T extends Writable>
java.io.IOException
- if reading from the InputStream
fails for some reasonCoderException
- if the value could not be decoded for some reasonpublic java.util.List<Coder<?>> getCoderArguments()
CustomCoder
Coder
for a parameterized type, returns the list of Coder
s being
used for each of the parameters in the same order they appear within the parameterized type's
type signature. If this cannot be done, or this Coder
does not encode/decode a
parameterized type, returns the empty list..
Returns an empty list. A CustomCoder
has no default argument coders
.
getCoderArguments
in class CustomCoder<T extends Writable>
public void verifyDeterministic() throws Coder.NonDeterministicException
CustomCoder
Coder.NonDeterministicException
if the coding is not deterministic.
In order for a Coder
to be considered deterministic, the following must be true:
Object.equals()
or Comparable.compareTo()
, if supported) have the same encoding.
Coder
always produces a canonical encoding, which is the same for an instance
of an object even if produced on different computers at different times.
verifyDeterministic
in class CustomCoder<T extends Writable>
Coder.NonDeterministicException
- if this coder is not deterministic.public boolean equals(@Nullable java.lang.Object other)
equals
in class java.lang.Object
public int hashCode()
hashCode
in class java.lang.Object
public static CoderProvider getCoderProvider()
CoderProvider
which uses the WritableCoder
for Hadoop writable types
.
This method is invoked reflectively from DefaultCoder
.