org.apache.parquet.schema

Class Types.Builder<THIS extends Types.Builder,P>

java.lang.Object

org.apache.parquet.schema.Types.Builder<THIS,P>

Type Parameters:

P - The type that this builder will return from named(String) when the type is built.

Direct Known Subclasses:

Types.BaseGroupBuilder, Types.BaseListBuilder, Types.BaseMapBuilder, Types.BasePrimitiveBuilder

Enclosing class:

Types

public abstract static class Types.Builder<THIS extends Types.Builder,P>
extends Object

A base builder for Type objects.

Field Summary

Fields

Modifier and Type	Field and Description
protected Type.ID	id
protected OriginalType	originalType
protected P	parent
protected Type.Repetition	repetition
protected Class<? extends P>	returnClass

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Builder(Class<P> returnClass) Construct a type builder that returns the Type that was built when the builder is finished.
protected	Builder(P parent) Construct a type builder that returns a "parent" object when the builder is finished.

Method Summary

Modifier and Type	Method and Description
THIS	as(OriginalType type) Adds a type annotation (OriginalType) to the type being built.
protected abstract Type	build(String name)
THIS	id(int id) adds an id annotation to the type being built.
P	named(String name) Builds a Type and returns the parent builder, if given, or the Type that was built.
protected THIS	repetition(Type.Repetition repetition)
protected abstract THIS	self()

Methods inherited from class java.lang.Object

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

Field Detail

parent

protected final P parent

returnClass

protected final Class<? extends P> returnClass

repetition

protected Type.Repetition repetition

originalType

protected OriginalType originalType

id

protected Type.ID id

Constructor Detail

Builder

protected Builder(P parent)

Construct a type builder that returns a "parent" object when the builder is finished. The parent will be returned by named(String) so that builders can be chained.

Parameters:

parent - a non-null object to return from named(String)

Builder

protected Builder(Class<P> returnClass)

Construct a type builder that returns the Type that was built when the builder is finished. The returnClass must be the expected Type class.

Parameters:

returnClass - a Type to return from named(String)

Method Detail

self

protected abstract THIS self()

repetition

protected final THIS repetition(Type.Repetition repetition)

as

public THIS as(OriginalType type)

Adds a type annotation (OriginalType) to the type being built.

Type annotations are used to extend the types that parquet can store, by specifying how the primitive types should be interpreted. This keeps the set of primitive types to a minimum and reuses parquet's efficient encodings. For example, strings are stored as byte arrays (binary) with a UTF8 annotation.

Parameters:

type - an OriginalType

Returns:

this builder for method chaining

id

public THIS id(int id)

adds an id annotation to the type being built.

ids are used to capture the original id when converting from models using ids (thrift, protobufs)

Parameters:

id - the id of the field

Returns:

this builder for method chaining

build

protected abstract Type build(String name)

named

public P named(String name)

Builds a Type and returns the parent builder, if given, or the Type that was built. If returning a parent object that is a GroupBuilder, the constructed type will be added to it as a field.

Note: Any configuration for this type builder should be done before calling this method.

Parameters:

name - a name for the constructed type

Returns:

the parent GroupBuilder or the constructed Type