AvroCoder (avro 2.46.0 API)

java.lang.Object
- org.apache.beam.sdk.coders.Coder<T>
- - org.apache.beam.sdk.coders.CustomCoder<T>
  - - org.apache.beam.sdk.extensions.avro.coders.AvroCoder<T>

Type Parameters:

T - the type of elements handled by this coder

All Implemented Interfaces:

java.io.Serializable

Direct Known Subclasses:

AvroGenericCoder
```
public class AvroCoder<T>
extends org.apache.beam.sdk.coders.CustomCoder<T>
```
A Coder using Avro binary format.
Each instance of AvroCoder<T> encapsulates an Avro schema for objects of type T.
The Avro schema may be provided explicitly via of(Class, Schema) or omitted via of(Class), in which case it will be inferred using Avro's ReflectData.
For complete details about schema generation and how it can be controlled please see the org.apache.avro.reflect package. Only concrete classes with a no-argument constructor can be mapped to Avro records. All inherited fields that are not static or transient are included. Fields are not permitted to be null unless annotated by Nullable or a Union schema containing "null".
To use, specify the Coder type on a PCollection:
```
 PCollection<MyCustomElement> records =
     input.apply(...)
          .setCoder(AvroCoder.of(MyCustomElement.class));
 
```
or annotate the element class using @DefaultCoder.
```
 @DefaultCoder(AvroCoder.class)
 public class MyCustomElement {
     ...
 }
 
```
The implementation attempts to determine if the Avro encoding of the given type will satisfy the criteria of Coder.verifyDeterministic() by inspecting both the type and the Schema provided or generated by Avro. Only coders that are deterministic can be used in GroupByKey operations.
See Also:

Serialized Form

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static class AvroCoder.JodaTimestampConversion
Conversion for DateTime.
- Nested classes/interfaces inherited from class org.apache.beam.sdk.coders.Coder
  org.apache.beam.sdk.coders.Coder.Context, org.apache.beam.sdk.coders.Coder.NonDeterministicException

Nested Classes
Modifier and Type	Class and Description
`static class`	`AvroCoder.JodaTimestampConversion` Conversion for DateTime.

Constructor Summary

Constructors
Modifier	Constructor and Description
`protected`	`AvroCoder(java.lang.Class<T> type, org.apache.avro.Schema schema)`
`protected`	`AvroCoder(java.lang.Class<T> type, org.apache.avro.Schema schema, boolean useReflectApi)`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`T`	`decode(java.io.InputStream inStream)`
`void`	`encode(T value, java.io.OutputStream outStream)`
`boolean`	`equals(@Nullable java.lang.Object other)`
`static org.apache.beam.sdk.coders.CoderProvider`	`getCoderProvider()` Returns a `CoderProvider` which uses the `AvroCoder` if possible for all types.
`org.apache.beam.sdk.values.TypeDescriptor<T>`	`getEncodedTypeDescriptor()`
`org.apache.avro.Schema`	`getSchema()` Returns the schema used by this coder.
`java.lang.Class<T>`	`getType()` Returns the type this coder encodes/decodes.
`int`	`hashCode()`
`static <T> AvroCoder<T>`	`of(java.lang.Class<T> clazz)` Returns an `AvroCoder` instance for the provided element class.
`static <T> AvroCoder<T>`	`of(java.lang.Class<T> type, boolean useReflectApi)` Returns an `AvroCoder` instance for the given class, respecting whether to use Avro's Reflect* or Specific* suite for encoding and decoding.
`static <T> AvroCoder<T>`	`of(java.lang.Class<T> type, org.apache.avro.Schema schema)` Returns an `AvroCoder` instance for the provided element type using the provided Avro schema.
`static <T> AvroCoder<T>`	`of(java.lang.Class<T> type, org.apache.avro.Schema schema, boolean useReflectApi)` Returns an `AvroCoder` instance for the given class and schema, respecting whether to use Avro's Reflect* or Specific* suite for encoding and decoding.
`static AvroGenericCoder`	`of(org.apache.avro.Schema schema)` Returns an `AvroGenericCoder` instance for the Avro schema.
`static <T> AvroCoder<T>`	`of(org.apache.beam.sdk.values.TypeDescriptor<T> type)` Returns an `AvroCoder` instance for the provided element type.
`static <T> AvroCoder<T>`	`of(org.apache.beam.sdk.values.TypeDescriptor<T> type, boolean useReflectApi)` Returns an `AvroCoder` instance for the provided element type, respecting whether to use Avro's Reflect* or Specific* suite for encoding and decoding.
`boolean`	`useReflectApi()`
`void`	`verifyDeterministic()`

Methods inherited from class org.apache.beam.sdk.coders.CustomCoder
getCoderArguments

Methods inherited from class org.apache.beam.sdk.coders.Coder
consistentWithEquals, decode, encode, getEncodedElementByteSize, isRegisterByteSizeObserverCheap, registerByteSizeObserver, structuralValue, verifyDeterministic, verifyDeterministic

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - AvroCoder
```
protected AvroCoder(java.lang.Class<T> type,
                    org.apache.avro.Schema schema)
```
  - AvroCoder
```
protected AvroCoder(java.lang.Class<T> type,
                    org.apache.avro.Schema schema,
                    boolean useReflectApi)
```
- Method Detail
  - of
```
public static <T> AvroCoder<T> of(org.apache.beam.sdk.values.TypeDescriptor<T> type)
```
    Returns an AvroCoder instance for the provided element type.
    
    Type Parameters:
    
    T - the element type
  - of
```
public static <T> AvroCoder<T> of(org.apache.beam.sdk.values.TypeDescriptor<T> type,
                                  boolean useReflectApi)
```
    Returns an AvroCoder instance for the provided element type, respecting whether to use Avro's Reflect* or Specific* suite for encoding and decoding.
    
    Type Parameters:
    
    T - the element type
  - of
```
public static <T> AvroCoder<T> of(java.lang.Class<T> clazz)
```
    Returns an AvroCoder instance for the provided element class.
    
    Type Parameters:
    
    T - the element type
  - of
```
public static AvroGenericCoder of(org.apache.avro.Schema schema)
```
    Returns an AvroGenericCoder instance for the Avro schema. The implicit type is GenericRecord.
  - of
```
public static <T> AvroCoder<T> of(java.lang.Class<T> type,
                                  boolean useReflectApi)
```
    Returns an AvroCoder instance for the given class, respecting whether to use Avro's Reflect* or Specific* suite for encoding and decoding.
    
    Type Parameters:
    
    T - the element type
  - of
```
public static <T> AvroCoder<T> of(java.lang.Class<T> type,
                                  org.apache.avro.Schema schema)
```
    Returns an AvroCoder instance for the provided element type using the provided Avro schema.
    The schema must correspond to the type provided.
    
    Type Parameters:
    
    T - the element type
  - of
```
public static <T> AvroCoder<T> of(java.lang.Class<T> type,
                                  org.apache.avro.Schema schema,
                                  boolean useReflectApi)
```
    Returns an AvroCoder instance for the given class and schema, respecting whether to use Avro's Reflect* or Specific* suite for encoding and decoding.
    
    Type Parameters:
    
    T - the element type
  - getCoderProvider
```
public static org.apache.beam.sdk.coders.CoderProvider getCoderProvider()
```
    Returns a CoderProvider which uses the AvroCoder if possible for all types.
    It is unsafe to register this as a CoderProvider because Avro will reflectively accept dangerous types such as Object.
    This method is invoked reflectively from DefaultCoder.
  - getType
```
public java.lang.Class<T> getType()
```
    Returns the type this coder encodes/decodes.
  - useReflectApi
```
public boolean useReflectApi()
```
  - encode
```
public void encode(T value,
                   java.io.OutputStream outStream)
            throws java.io.IOException
```
    Specified by:
    
    encode in class org.apache.beam.sdk.coders.Coder<T>
    
    Throws:
    
    java.io.IOException
  - decode
```
public T decode(java.io.InputStream inStream)
         throws java.io.IOException
```
    Specified by:
    
    decode in class org.apache.beam.sdk.coders.Coder<T>
    
    Throws:
    
    java.io.IOException
  - verifyDeterministic
```
public void verifyDeterministic()
                         throws org.apache.beam.sdk.coders.Coder.NonDeterministicException
```
    Overrides:
    
    verifyDeterministic in class org.apache.beam.sdk.coders.CustomCoder<T>
    
    Throws:
    
    NonDeterministicException - when the type may not be deterministically encoded using the given Schema, the directBinaryEncoder, and the ReflectDatumWriter or GenericDatumWriter.
    
    org.apache.beam.sdk.coders.Coder.NonDeterministicException
  - getSchema
```
public org.apache.avro.Schema getSchema()
```
    Returns the schema used by this coder.
  - getEncodedTypeDescriptor
```
public org.apache.beam.sdk.values.TypeDescriptor<T> getEncodedTypeDescriptor()
```
    Overrides:
    
    getEncodedTypeDescriptor in class org.apache.beam.sdk.coders.Coder<T>
  - equals
```
public boolean equals(@Nullable java.lang.Object other)
```
    Overrides:
    
    equals in class java.lang.Object
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class java.lang.Object

Class AvroCoder<T>

Nested Class Summary

Nested classes/interfaces inherited from class org.apache.beam.sdk.coders.Coder

Constructor Summary

Method Summary

Methods inherited from class org.apache.beam.sdk.coders.CustomCoder

Methods inherited from class org.apache.beam.sdk.coders.Coder

Methods inherited from class java.lang.Object

Constructor Detail

AvroCoder

AvroCoder

Method Detail

of

of

of

of

of

of

of

getCoderProvider

getType

useReflectApi

encode

decode

verifyDeterministic

getSchema

getEncodedTypeDescriptor

equals

hashCode