Package com.hazelcast.nio.serialization.genericrecord

Interface GenericRecordBuilder

public interface GenericRecordBuilder

Interface for creating GenericRecord instances.

Since:

5.2

Method Summary

Modifier and Type	Method	Description
GenericRecord	build()
static GenericRecordBuilder	compact(String typeName)	/** Creates a Builder that will build a GenericRecord in Compact format with the given type name and schema:
static GenericRecordBuilder	portable(ClassDefinition classDefinition)	Creates a Builder that will build a GenericRecord in Portable format with a new class definition:
GenericRecordBuilder	setArrayOfBoolean(String fieldName, boolean[] value)	It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone().
GenericRecordBuilder	setArrayOfChar(String fieldName, char[] value)	It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone().
GenericRecordBuilder	setArrayOfDate(String fieldName, LocalDate[] value)	It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone().
GenericRecordBuilder	setArrayOfDecimal(String fieldName, BigDecimal[] value)	It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone().
GenericRecordBuilder	setArrayOfFloat32(String fieldName, float[] value)	It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone().
GenericRecordBuilder	setArrayOfFloat64(String fieldName, double[] value)	It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone().
GenericRecordBuilder	setArrayOfGenericRecord(String fieldName, GenericRecord[] value)	It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone().
GenericRecordBuilder	setArrayOfInt16(String fieldName, short[] value)	It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone().
GenericRecordBuilder	setArrayOfInt32(String fieldName, int[] value)	It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone().
GenericRecordBuilder	setArrayOfInt64(String fieldName, long[] value)	It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone().
GenericRecordBuilder	setArrayOfInt8(String fieldName, byte[] value)	It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone().
GenericRecordBuilder	setArrayOfNullableBoolean(String fieldName, Boolean[] value)	It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone().
GenericRecordBuilder	setArrayOfNullableFloat32(String fieldName, Float[] value)	It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone().
GenericRecordBuilder	setArrayOfNullableFloat64(String fieldName, Double[] value)	It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone().
GenericRecordBuilder	setArrayOfNullableInt16(String fieldName, Short[] value)	It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone().
GenericRecordBuilder	setArrayOfNullableInt32(String fieldName, Integer[] value)	It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone().
GenericRecordBuilder	setArrayOfNullableInt64(String fieldName, Long[] value)	It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone().
GenericRecordBuilder	setArrayOfNullableInt8(String fieldName, Byte[] value)	It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone().
GenericRecordBuilder	setArrayOfString(String fieldName, String[] value)	It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone().
GenericRecordBuilder	setArrayOfTime(String fieldName, LocalTime[] value)	It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone().
GenericRecordBuilder	setArrayOfTimestamp(String fieldName, LocalDateTime[] value)	It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone().
GenericRecordBuilder	setArrayOfTimestampWithTimezone(String fieldName, OffsetDateTime[] value)	It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone().
GenericRecordBuilder	setBoolean(String fieldName, boolean value)	It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone().
GenericRecordBuilder	setChar(String fieldName, char value)	It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone().
GenericRecordBuilder	setDate(String fieldName, LocalDate value)	Sets a date field consisting of year, month of the year, and day of the month.
GenericRecordBuilder	setDecimal(String fieldName, BigDecimal value)	Sets a decimal which is arbitrary precision and scale floating-point number.
GenericRecordBuilder	setFloat32(String fieldName, float value)	It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone().
GenericRecordBuilder	setFloat64(String fieldName, double value)	It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone().
GenericRecordBuilder	setGenericRecord(String fieldName, GenericRecord value)	It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone().
GenericRecordBuilder	setInt16(String fieldName, short value)	It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone().
GenericRecordBuilder	setInt32(String fieldName, int value)	It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone().
GenericRecordBuilder	setInt64(String fieldName, long value)	It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone().
GenericRecordBuilder	setInt8(String fieldName, byte value)	It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone().
GenericRecordBuilder	setNullableBoolean(String fieldName, Boolean value)	It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone().
GenericRecordBuilder	setNullableFloat32(String fieldName, Float value)	It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone().
GenericRecordBuilder	setNullableFloat64(String fieldName, Double value)	It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone().
GenericRecordBuilder	setNullableInt16(String fieldName, Short value)	It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone().
GenericRecordBuilder	setNullableInt32(String fieldName, Integer value)	It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone().
GenericRecordBuilder	setNullableInt64(String fieldName, Long value)	It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone().
GenericRecordBuilder	setNullableInt8(String fieldName, Byte value)	It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone().
GenericRecordBuilder	setString(String fieldName, String value)	It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone().
GenericRecordBuilder	setTime(String fieldName, LocalTime value)	Sets a time field consisting of hour, minute, seconds, and nanos parts.
GenericRecordBuilder	setTimestamp(String fieldName, LocalDateTime value)	Sets a timestamp field consisting of year, month of the year, and day of the month, hour, minute, seconds, nanos parts.
GenericRecordBuilder	setTimestampWithTimezone(String fieldName, OffsetDateTime value)	Sets a timestamp with timezone field consisting of year, month of the year and day of the month, offset seconds, hour, minute, seconds, nanos parts.

Method Details

portable

@Nonnull
static GenericRecordBuilder portable(@Nonnull
 ClassDefinition classDefinition)

Creates a Builder that will build a GenericRecord in Portable format with a new class definition:

 ClassDefinition classDefinition = new ClassDefinitionBuilder(FACTORY_ID, CLASS_ID)
         .addStringField("name")
         .addIntField("id")
         .build();

 GenericRecord genericRecord = GenericRecordBuilder.portable(classDefinition)
         .setString("name", "foo")
         .setInt32("id", 123)
         .build();
 

Parameters:

classDefinition - of the Portable that will be created

Returns:

GenericRecordBuilder for Portable format

compact

@Nonnull
static GenericRecordBuilder compact(String typeName)

/** Creates a Builder that will build a GenericRecord in Compact format with the given type name and schema:

 GenericRecord genericRecord = GenericRecordBuilder.compact("typeName")
         .setString("name", "foo")
         .setInt32("id", 123)
         .build();
 

Parameters:

typeName - of the schema

Returns:

GenericRecordBuilder for Compact format

build

@Nonnull
GenericRecord build()

Returns:

a new constructed GenericRecord

Throws:

HazelcastSerializationException - when the GenericRecord cannot be built.

setBoolean

@Nonnull
GenericRecordBuilder setBoolean(@Nonnull
 String fieldName,
 boolean value)

It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone(). Otherwise, it is illegal to set to the same field twice.

Parameters:

fieldName - name of the field as it is defined in its schema/class definition. It should be composed of only alphanumeric characters for Portable GenericRecords.

value - to set to GenericRecord

Returns:

itself for chaining

Throws:

HazelcastSerializationException - if the field name does not exist in the schema/class definition or the type of the field does not match the one in the schema/class definition or the same field is trying to be set without using GenericRecord.newBuilderWithClone().

UnsupportedOperationException - if the setter is called after a GenericRecord is built by build().

setInt8

@Nonnull
GenericRecordBuilder setInt8(@Nonnull
 String fieldName,
 byte value)

It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone(). Otherwise, it is illegal to set to the same field twice.

Parameters:

fieldName - name of the field as it is defined in its schema/class definition. It should be composed of only alphanumeric characters for Portable GenericRecords.

value - to set to GenericRecord

Returns:

itself for chaining

Throws:

HazelcastSerializationException - if the field name does not exist in the schema/class definition or the type of the field does not match the one in the schema/class definition or the same field is trying to be set without using GenericRecord.newBuilderWithClone().

UnsupportedOperationException - if the setter is called after a GenericRecord is built by build().

setChar

@Nonnull
GenericRecordBuilder setChar(@Nonnull
 String fieldName,
 char value)

It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone(). Otherwise, it is illegal to set to the same field twice.

Supported only for Portable. Not applicable for Compact

Parameters:

fieldName - name of the field as it is defined in its class definition. It should be composed of only alphanumeric characters.

value - to set to GenericRecord

Returns:

itself for chaining

Throws:

HazelcastSerializationException - if the field name does not exist in the class definition or the type of the field does not match the one in the class definition or the same field is trying to be set without using GenericRecord.newBuilderWithClone().

UnsupportedOperationException - if the setter is called after a GenericRecord is built by build().

setInt16

@Nonnull
GenericRecordBuilder setInt16(@Nonnull
 String fieldName,
 short value)

It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone(). Otherwise, it is illegal to set to the same field twice.

Parameters:

fieldName - name of the field as it is defined in its schema/class definition. It should be composed of only alphanumeric characters for Portable GenericRecords.

value - to set to GenericRecord

Returns:

itself for chaining

Throws:

HazelcastSerializationException - if the field name does not exist in the schema/class definition or the type of the field does not match the one in the schema/class definition or the same field is trying to be set without using GenericRecord.newBuilderWithClone().

UnsupportedOperationException - if the setter is called after a GenericRecord is built by build().

setInt32

@Nonnull
GenericRecordBuilder setInt32(@Nonnull
 String fieldName,
 int value)

It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone(). Otherwise, it is illegal to set to the same field twice.

Parameters:

fieldName - name of the field as it is defined in its schema/class definition. It should be composed of only alphanumeric characters for Portable GenericRecords.

value - to set to GenericRecord

Returns:

itself for chaining

Throws:

HazelcastSerializationException - if the field name does not exist in the schema/class definition or the type of the field does not match the one in the schema/class definition or the same field is trying to be set without using GenericRecord.newBuilderWithClone().

UnsupportedOperationException - if the setter is called after a GenericRecord is built by build().

setInt64

@Nonnull
GenericRecordBuilder setInt64(@Nonnull
 String fieldName,
 long value)

It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone(). Otherwise, it is illegal to set to the same field twice.

Parameters:

fieldName - name of the field as it is defined in its schema/class definition. It should be composed of only alphanumeric characters for Portable GenericRecords.

value - to set to GenericRecord

Returns:

itself for chaining

Throws:

HazelcastSerializationException - if the field name does not exist in the schema/class definition or the type of the field does not match the one in the schema/class definition or the same field is trying to be set without using GenericRecord.newBuilderWithClone().

UnsupportedOperationException - if the setter is called after a GenericRecord is built by build().

setFloat32

@Nonnull
GenericRecordBuilder setFloat32(@Nonnull
 String fieldName,
 float value)

It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone(). Otherwise, it is illegal to set to the same field twice.

Parameters:

fieldName - name of the field as it is defined in its schema/class definition. It should be composed of only alphanumeric characters for Portable GenericRecords.

value - to set to GenericRecord

Returns:

itself for chaining

Throws:

HazelcastSerializationException - if the field name does not exist in the schema/class definition or the type of the field does not match the one in the schema/class definition or the same field is trying to be set without using GenericRecord.newBuilderWithClone().

UnsupportedOperationException - if the setter is called after a GenericRecord is built by build().

setFloat64

@Nonnull
GenericRecordBuilder setFloat64(@Nonnull
 String fieldName,
 double value)

It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone(). Otherwise, it is illegal to set to the same field twice.

Parameters:

fieldName - name of the field as it is defined in its schema/class definition. It should be composed of only alphanumeric characters for Portable GenericRecords.

value - to set to GenericRecord

Returns:

itself for chaining

Throws:

HazelcastSerializationException - if the field name does not exist in the schema/class definition or the type of the field does not match the one in the schema/class definition or the same field is trying to be set without using GenericRecord.newBuilderWithClone().

UnsupportedOperationException - if the setter is called after a GenericRecord is built by build().

setNullableBoolean

@Nonnull
GenericRecordBuilder setNullableBoolean(@Nonnull
 String fieldName,
 @Nullable
 Boolean value)

It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone(). Otherwise, it is illegal to set to the same field twice.

Supported only for Compact. Not applicable to Portable.

Parameters:

fieldName - name of the field as it is defined in its schema.

value - to set to GenericRecord

Returns:

itself for chaining

Throws:

HazelcastSerializationException - if the field name does not exist in the schema or the type of the field does not match the one in the schema or the same field is trying to be set without using GenericRecord.newBuilderWithClone().

UnsupportedOperationException - if the setter is called after a GenericRecord is built by build().

setNullableInt8

@Nonnull
GenericRecordBuilder setNullableInt8(@Nonnull
 String fieldName,
 @Nullable
 Byte value)

It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone(). Otherwise, it is illegal to set to the same field twice.

Supported only for Compact. Not applicable to Portable.

Parameters:

fieldName - name of the field as it is defined in its schema.

value - to set to GenericRecord

Returns:

itself for chaining

Throws:

HazelcastSerializationException - if the field name does not exist in the schema or the type of the field does not match the one in the schema or the same field is trying to be set without using GenericRecord.newBuilderWithClone().

UnsupportedOperationException - if the setter is called after a GenericRecord is built by build().

setNullableInt16

@Nonnull
GenericRecordBuilder setNullableInt16(@Nonnull
 String fieldName,
 @Nullable
 Short value)

It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone(). Otherwise, it is illegal to set to the same field twice.

Supported only for Compact. Not applicable to Portable.

Parameters:

fieldName - name of the field as it is defined in its schema.

value - to set to GenericRecord

Returns:

itself for chaining

Throws:

HazelcastSerializationException - if the field name does not exist in the schema or the type of the field does not match the one in the schema or the same field is trying to be set without using GenericRecord.newBuilderWithClone().

UnsupportedOperationException - if the setter is called after a GenericRecord is built by build().

setNullableInt32

@Nonnull
GenericRecordBuilder setNullableInt32(@Nonnull
 String fieldName,
 @Nullable
 Integer value)

It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone(). Otherwise, it is illegal to set to the same field twice.

Supported only for Compact. Not applicable to Portable.

Parameters:

fieldName - name of the field as it is defined in its schema.

value - to set to GenericRecord

Returns:

itself for chaining

Throws:

HazelcastSerializationException - if the field name does not exist in the schema or the type of the field does not match the one in the schema or the same field is trying to be set without using GenericRecord.newBuilderWithClone().

UnsupportedOperationException - if the setter is called after a GenericRecord is built by build().

setNullableInt64

@Nonnull
GenericRecordBuilder setNullableInt64(@Nonnull
 String fieldName,
 @Nullable
 Long value)

It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone(). Otherwise, it is illegal to set to the same field twice.

Supported only for Compact. Not applicable to Portable.

Parameters:

fieldName - name of the field as it is defined in its schema.

value - to set to GenericRecord

Returns:

itself for chaining

Throws:

HazelcastSerializationException - if the field name does not exist in the schema or the type of the field does not match the one in the schema or the same field is trying to be set without using GenericRecord.newBuilderWithClone().

UnsupportedOperationException - if the setter is called after a GenericRecord is built by build().

setNullableFloat32

@Nonnull
GenericRecordBuilder setNullableFloat32(@Nonnull
 String fieldName,
 @Nullable
 Float value)

It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone(). Otherwise, it is illegal to set to the same field twice.

Supported only for Compact. Not applicable to Portable.

Parameters:

fieldName - name of the field as it is defined in its schema.

value - to set to GenericRecord

Returns:

itself for chaining

Throws:

HazelcastSerializationException - if the field name does not exist in the schema or the type of the field does not match the one in the schema or the same field is trying to be set without using GenericRecord.newBuilderWithClone().

UnsupportedOperationException - if the setter is called after a GenericRecord is built by build().

setNullableFloat64

@Nonnull
GenericRecordBuilder setNullableFloat64(@Nonnull
 String fieldName,
 @Nullable
 Double value)

It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone(). Otherwise, it is illegal to set to the same field twice.

Supported only for Compact. Not applicable to Portable.

Parameters:

fieldName - name of the field as it is defined in its schema.

value - to set to GenericRecord

Returns:

itself for chaining

Throws:

HazelcastSerializationException - if the field name does not exist in the schema or the type of the field does not match the one in the schema or the same field is trying to be set without using GenericRecord.newBuilderWithClone().

UnsupportedOperationException - if the setter is called after a GenericRecord is built by build().

setString

@Nonnull
GenericRecordBuilder setString(@Nonnull
 String fieldName,
 @Nullable
 String value)

It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone(). Otherwise, it is illegal to set to the same field twice.

Parameters:

fieldName - name of the field as it is defined in its schema/class definition. It should be composed of only alphanumeric characters for Portable GenericRecords.

value - to set to GenericRecord

Returns:

itself for chaining

Throws:

HazelcastSerializationException - if the field name does not exist in the schema/class definition or the type of the field does not match the one in the schema/class definition or the same field is trying to be set without using GenericRecord.newBuilderWithClone().

UnsupportedOperationException - if the setter is called after a GenericRecord is built by build().

setGenericRecord

@Nonnull
GenericRecordBuilder setGenericRecord(@Nonnull
 String fieldName,
 @Nullable
 GenericRecord value)

It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone(). Otherwise, it is illegal to set to the same field twice. This method allows nested structures. Subclass should also be created as `GenericRecord`.

Parameters:

fieldName - name of the field as it is defined in its schema/class definition. It should be composed of only alphanumeric characters for Portable GenericRecords.

value - to set to GenericRecord

Returns:

itself for chaining

Throws:

HazelcastSerializationException - 1. if the field name does not exist in the schema/class definition. 2. The type of the field does not match the one in the schema/class definition. 3. The same field is trying to be set without using GenericRecord.newBuilderWithClone(). 4. The type of the generic record is not the same as the generic record that is being built. e.g using portable generic record in a compact generic record builder.

UnsupportedOperationException - if the setter is called after a GenericRecord is built by build().

setDecimal

@Nonnull
GenericRecordBuilder setDecimal(@Nonnull
 String fieldName,
 @Nullable
 BigDecimal value)

Sets a decimal which is arbitrary precision and scale floating-point number.

It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone(). Otherwise, it is illegal to set to the same field twice.

Parameters:

fieldName - name of the field as it is defined in its schema/class definition. It should be composed of only alphanumeric characters for Portable GenericRecords.

value - to set to GenericRecord

Returns:

itself for chaining

Throws:

HazelcastSerializationException - if the field name does not exist in the schema/class definition or the type of the field does not match the one in the schema/class definition or the same field is trying to be set without using GenericRecord.newBuilderWithClone().

UnsupportedOperationException - if the setter is called after a GenericRecord is built by build().

setTime

@Nonnull
GenericRecordBuilder setTime(@Nonnull
 String fieldName,
 @Nullable
 LocalTime value)

Sets a time field consisting of hour, minute, seconds, and nanos parts.

It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone(). Otherwise, it is illegal to set to the same field twice.

Parameters:

fieldName - name of the field as it is defined in its schema/class definition. It should be composed of only alphanumeric characters for Portable GenericRecords.

value - to set to GenericRecord

Returns:

itself for chaining

Throws:

HazelcastSerializationException - if the field name does not exist in the schema/class definition or the type of the field does not match the one in the schema/class definition or the same field is trying to be set without using GenericRecord.newBuilderWithClone().

UnsupportedOperationException - if the setter is called after a GenericRecord is built by build().

setDate

@Nonnull
GenericRecordBuilder setDate(@Nonnull
 String fieldName,
 @Nullable
 LocalDate value)

Sets a date field consisting of year, month of the year, and day of the month.

It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone(). Otherwise, it is illegal to set to the same field twice.

Parameters:

fieldName - name of the field as it is defined in its schema/class definition. It should be composed of only alphanumeric characters for Portable GenericRecords.

value - to set to GenericRecord

Returns:

itself for chaining

Throws:

HazelcastSerializationException - if the field name does not exist in the schema/class definition or the type of the field does not match the one in the schema/class definition or the same field is trying to be set without using GenericRecord.newBuilderWithClone().

UnsupportedOperationException - if the setter is called after a GenericRecord is built by build().

setTimestamp

@Nonnull
GenericRecordBuilder setTimestamp(@Nonnull
 String fieldName,
 @Nullable
 LocalDateTime value)

Sets a timestamp field consisting of year, month of the year, and day of the month, hour, minute, seconds, nanos parts.

It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone(). Otherwise, it is illegal to set to the same field twice.

Parameters:

fieldName - name of the field as it is defined in its schema/class definition. It should be composed of only alphanumeric characters for Portable GenericRecords.

value - to set to GenericRecord

Returns:

itself for chaining

Throws:

HazelcastSerializationException - if the field name does not exist in the schema/class definition or the type of the field does not match the one in the schema/class definition or the same field is trying to be set without using GenericRecord.newBuilderWithClone().

UnsupportedOperationException - if the setter is called after a GenericRecord is built by build().

setTimestampWithTimezone

@Nonnull
GenericRecordBuilder setTimestampWithTimezone(@Nonnull
 String fieldName,
 @Nullable
 OffsetDateTime value)

Sets a timestamp with timezone field consisting of year, month of the year and day of the month, offset seconds, hour, minute, seconds, nanos parts.

It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone(). Otherwise, it is illegal to set to the same field twice.

Parameters:

fieldName - name of the field as it is defined in its schema/class definition. It should be composed of only alphanumeric characters for Portable GenericRecords.

value - to set to GenericRecord

Returns:

itself for chaining

Throws:

HazelcastSerializationException - if the field name does not exist in the schema/class definition or the type of the field does not match the one in the schema/class definition or the same field is trying to be set without using GenericRecord.newBuilderWithClone().

UnsupportedOperationException - if the setter is called after a GenericRecord is built by build().

setArrayOfBoolean

@Nonnull
GenericRecordBuilder setArrayOfBoolean(@Nonnull
 String fieldName,
 @Nullable
 boolean[] value)

It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone(). Otherwise, it is illegal to set to the same field twice.

Parameters:

fieldName - name of the field as it is defined in its schema/class definition. It should be composed of only alphanumeric characters for Portable GenericRecords.

value - to set to GenericRecord

Returns:

itself for chaining

Throws:

HazelcastSerializationException - if the field name does not exist in the schema/class definition or the type of the field does not match the one in the schema/class definition or the same field is trying to be set without using GenericRecord.newBuilderWithClone().

UnsupportedOperationException - if the setter is called after a GenericRecord is built by build().

setArrayOfInt8

@Nonnull
GenericRecordBuilder setArrayOfInt8(@Nonnull
 String fieldName,
 @Nullable
 byte[] value)

It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone(). Otherwise, it is illegal to set to the same field twice.

Parameters:

fieldName - name of the field as it is defined in its schema/class definition. It should be composed of only alphanumeric characters for Portable GenericRecords.

value - to set to GenericRecord

Returns:

itself for chaining

Throws:

HazelcastSerializationException - if the field name does not exist in the schema/class definition or the type of the field does not match the one in the schema/class definition or the same field is trying to be set without using GenericRecord.newBuilderWithClone().

UnsupportedOperationException - if the setter is called after a GenericRecord is built by build().

setArrayOfChar

@Nonnull
GenericRecordBuilder setArrayOfChar(@Nonnull
 String fieldName,
 @Nullable
 char[] value)

It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone(). Otherwise, it is illegal to set to the same field twice.

Supported only for Portable. Not applicable for Compact

Parameters:

fieldName - name of the field as it is defined in its class definition. It should be composed of only alphanumeric characters

value - to set to GenericRecord

Returns:

itself for chaining

Throws:

HazelcastSerializationException - if the field name does not exist in the class definition or the type of the field does not match the one in the class definition or the same field is trying to be set without using GenericRecord.newBuilderWithClone().

UnsupportedOperationException - if the setter is called after a GenericRecord is built by build().

setArrayOfInt16

@Nonnull
GenericRecordBuilder setArrayOfInt16(@Nonnull
 String fieldName,
 @Nullable
 short[] value)

It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone(). Otherwise, it is illegal to set to the same field twice.

Parameters:

fieldName - name of the field as it is defined in its schema/class definition. It should be composed of only alphanumeric characters for Portable GenericRecords.

value - to set to GenericRecord

Returns:

itself for chaining

Throws:

HazelcastSerializationException - if the field name does not exist in the schema/class definition or the type of the field does not match the one in the schema/class definition or the same field is trying to be set without using GenericRecord.newBuilderWithClone().

UnsupportedOperationException - if the setter is called after a GenericRecord is built by build().

setArrayOfInt32

@Nonnull
GenericRecordBuilder setArrayOfInt32(@Nonnull
 String fieldName,
 @Nullable
 int[] value)

It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone(). Otherwise, it is illegal to set to the same field twice.

Parameters:

fieldName - name of the field as it is defined in its schema/class definition. It should be composed of only alphanumeric characters for Portable GenericRecords.

value - to set to GenericRecord

Returns:

itself for chaining

Throws:

HazelcastSerializationException - if the field name does not exist in the schema/class definition or the type of the field does not match the one in the schema/class definition or the same field is trying to be set without using GenericRecord.newBuilderWithClone().

UnsupportedOperationException - if the setter is called after a GenericRecord is built by build().

setArrayOfInt64

@Nonnull
GenericRecordBuilder setArrayOfInt64(@Nonnull
 String fieldName,
 @Nullable
 long[] value)

It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone(). Otherwise, it is illegal to set to the same field twice.

Parameters:

fieldName - name of the field as it is defined in its schema/class definition. It should be composed of only alphanumeric characters for Portable GenericRecords.

value - to set to GenericRecord

Returns:

itself for chaining

Throws:

HazelcastSerializationException - if the field name does not exist in the schema/class definition or the type of the field does not match the one in the schema/class definition or the same field is trying to be set without using GenericRecord.newBuilderWithClone().

UnsupportedOperationException - if the setter is called after a GenericRecord is built by build().

setArrayOfFloat32

@Nonnull
GenericRecordBuilder setArrayOfFloat32(@Nonnull
 String fieldName,
 @Nullable
 float[] value)

It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone(). Otherwise, it is illegal to set to the same field twice.

Parameters:

fieldName - name of the field as it is defined in its schema/class definition. It should be composed of only alphanumeric characters for Portable GenericRecords.

value - to set to GenericRecord

Returns:

itself for chaining

Throws:

HazelcastSerializationException - if the field name does not exist in the schema/class definition or the type of the field does not match the one in the schema/class definition or the same field is trying to be set without using GenericRecord.newBuilderWithClone().

UnsupportedOperationException - if the setter is called after a GenericRecord is built by build().

setArrayOfFloat64

@Nonnull
GenericRecordBuilder setArrayOfFloat64(@Nonnull
 String fieldName,
 @Nullable
 double[] value)

It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone(). Otherwise, it is illegal to set to the same field twice.

Parameters:

fieldName - name of the field as it is defined in its schema/class definition. It should be composed of only alphanumeric characters for Portable GenericRecords.

value - to set to GenericRecord

Returns:

itself for chaining

Throws:

HazelcastSerializationException - if the field name does not exist in the schema/class definition or the type of the field does not match the one in the schema/class definition or the same field is trying to be set without using GenericRecord.newBuilderWithClone().

UnsupportedOperationException - if the setter is called after a GenericRecord is built by build().

setArrayOfNullableBoolean

@Nonnull
GenericRecordBuilder setArrayOfNullableBoolean(@Nonnull
 String fieldName,
 @Nullable
 Boolean[] value)

It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone(). Otherwise, it is illegal to set to the same field twice.

Supported only for Compact. Not applicable to Portable.

Parameters:

fieldName - name of the field as it is defined in its schema.

value - to set to GenericRecord

Returns:

itself for chaining

Throws:

HazelcastSerializationException - if the field name does not exist in the schema or the type of the field does not match the one in the schema or the same field is trying to be set without using GenericRecord.newBuilderWithClone().

UnsupportedOperationException - if the setter is called after a GenericRecord is built by build().

setArrayOfNullableInt8

@Nonnull
GenericRecordBuilder setArrayOfNullableInt8(@Nonnull
 String fieldName,
 @Nullable
 Byte[] value)

It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone(). Otherwise, it is illegal to set to the same field twice.

Supported only for Compact. Not applicable to Portable.

Parameters:

fieldName - name of the field as it is defined in its schema.

value - to set to GenericRecord

Returns:

itself for chaining

Throws:

HazelcastSerializationException - if the field name does not exist in the schema or the type of the field does not match the one in the schema or the same field is trying to be set without using GenericRecord.newBuilderWithClone().

UnsupportedOperationException - if the setter is called after a GenericRecord is built by build().

setArrayOfNullableInt16

@Nonnull
GenericRecordBuilder setArrayOfNullableInt16(@Nonnull
 String fieldName,
 @Nullable
 Short[] value)

It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone(). Otherwise, it is illegal to set to the same field twice.

Supported only for Compact. Not applicable to Portable.

Parameters:

fieldName - name of the field as it is defined in its schema.

value - to set to GenericRecord

Returns:

itself for chaining

Throws:

HazelcastSerializationException - if the field name does not exist in the schema or the type of the field does not match the one in the schema or the same field is trying to be set without using GenericRecord.newBuilderWithClone().

UnsupportedOperationException - if the setter is called after a GenericRecord is built by build().

setArrayOfNullableInt32

@Nonnull
GenericRecordBuilder setArrayOfNullableInt32(@Nonnull
 String fieldName,
 @Nullable
 Integer[] value)

It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone(). Otherwise, it is illegal to set to the same field twice.

Supported only for Compact. Not applicable to Portable.

Parameters:

fieldName - name of the field as it is defined in its schema.

value - to set to GenericRecord

Returns:

itself for chaining

Throws:

HazelcastSerializationException - if the field name does not exist in the schema or the type of the field does not match the one in the schema or the same field is trying to be set without using GenericRecord.newBuilderWithClone().

UnsupportedOperationException - if the setter is called after a GenericRecord is built by build().

setArrayOfNullableInt64

@Nonnull
GenericRecordBuilder setArrayOfNullableInt64(@Nonnull
 String fieldName,
 @Nullable
 Long[] value)

It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone(). Otherwise, it is illegal to set to the same field twice.

Supported only for Compact. Not applicable to Portable.

Parameters:

fieldName - name of the field as it is defined in its schema.

value - to set to GenericRecord

Returns:

itself for chaining

Throws:

HazelcastSerializationException - if the field name does not exist in the schema or the type of the field does not match the one in the schema or the same field is trying to be set without using GenericRecord.newBuilderWithClone().

UnsupportedOperationException - if the setter is called after a GenericRecord is built by build().

setArrayOfNullableFloat32

@Nonnull
GenericRecordBuilder setArrayOfNullableFloat32(@Nonnull
 String fieldName,
 @Nullable
 Float[] value)

It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone(). Otherwise, it is illegal to set to the same field twice.

Supported only for Compact. Not applicable to Portable.

Parameters:

fieldName - name of the field as it is defined in its schema.

value - to set to GenericRecord

Returns:

itself for chaining

Throws:

HazelcastSerializationException - if the field name does not exist in the schema or the type of the field does not match the one in the schema or the same field is trying to be set without using GenericRecord.newBuilderWithClone().

UnsupportedOperationException - if the setter is called after a GenericRecord is built by build().

setArrayOfNullableFloat64

@Nonnull
GenericRecordBuilder setArrayOfNullableFloat64(@Nonnull
 String fieldName,
 @Nullable
 Double[] value)

It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone(). Otherwise, it is illegal to set to the same field twice.

Supported only for Compact. Not applicable to Portable.

Parameters:

fieldName - name of the field as it is defined in its schema.

value - to set to GenericRecord

Returns:

itself for chaining

Throws:

HazelcastSerializationException - if the field name does not exist in the schema or the type of the field does not match the one in the schema or the same field is trying to be set without using GenericRecord.newBuilderWithClone().

UnsupportedOperationException - if the setter is called after a GenericRecord is built by build().

setArrayOfString

@Nonnull
GenericRecordBuilder setArrayOfString(@Nonnull
 String fieldName,
 @Nullable
 String[] value)

It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone(). Otherwise, it is illegal to set to the same field twice. Array items can not be null.

Parameters:

fieldName - name of the field as it is defined in its schema/class definition. It should be composed of only alphanumeric characters for Portable GenericRecords.

value - to set to GenericRecord

Returns:

itself for chaining

Throws:

HazelcastSerializationException - if the field name does not exist in the schema/class definition or the type of the field does not match the one in the schema/class definition or the same field is trying to be set without using GenericRecord.newBuilderWithClone().

UnsupportedOperationException - if the setter is called after a GenericRecord is built by build().

setArrayOfDecimal

@Nonnull
GenericRecordBuilder setArrayOfDecimal(@Nonnull
 String fieldName,
 @Nullable
 BigDecimal[] value)

It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone(). Otherwise, it is illegal to set to the same field twice. Array items can not be null.

Parameters:

fieldName - name of the field as it is defined in its schema/class definition. It should be composed of only alphanumeric characters for Portable GenericRecords.

value - to set to GenericRecord

Returns:

itself for chaining

Throws:

HazelcastSerializationException - if the field name does not exist in the schema/class definition or the type of the field does not match the one in the schema/class definition or the same field is trying to be set without using GenericRecord.newBuilderWithClone().

UnsupportedOperationException - if the setter is called after a GenericRecord is built by build().

See Also:

• setDecimal(String, BigDecimal)

setArrayOfTime

@Nonnull
GenericRecordBuilder setArrayOfTime(@Nonnull
 String fieldName,
 @Nullable
 LocalTime[] value)

It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone(). Otherwise, it is illegal to set to the same field twice. Array items can not be null.

Parameters:

fieldName - name of the field as it is defined in its schema/class definition. It should be composed of only alphanumeric characters for Portable GenericRecords.

value - to set to GenericRecord

Returns:

itself for chaining

Throws:

HazelcastSerializationException - if the field name does not exist in the schema/class definition or the type of the field does not match the one in the schema/class definition or the same field is trying to be set without using GenericRecord.newBuilderWithClone().

UnsupportedOperationException - if the setter is called after a GenericRecord is built by build().

See Also:

• setTime(String, LocalTime)

setArrayOfDate

@Nonnull
GenericRecordBuilder setArrayOfDate(@Nonnull
 String fieldName,
 @Nullable
 LocalDate[] value)

It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone(). Otherwise, it is illegal to set to the same field twice. Array items can not be null.

Parameters:

fieldName - name of the field as it is defined in its schema/class definition. It should be composed of only alphanumeric characters for Portable GenericRecords.

value - to set to GenericRecord

Returns:

itself for chaining

Throws:

HazelcastSerializationException - if the field name does not exist in the schema/class definition or the type of the field does not match the one in the schema/class definition or the same field is trying to be set without using GenericRecord.newBuilderWithClone().

UnsupportedOperationException - if the setter is called after a GenericRecord is built by build().

See Also:

• setDate(String, LocalDate)

setArrayOfTimestamp

@Nonnull
GenericRecordBuilder setArrayOfTimestamp(@Nonnull
 String fieldName,
 @Nullable
 LocalDateTime[] value)

It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone(). Otherwise, it is illegal to set to the same field twice. Array items can not be null.

Parameters:

fieldName - name of the field as it is defined in its schema/class definition. It should be composed of only alphanumeric characters for Portable GenericRecords.

value - to set to GenericRecord

Returns:

itself for chaining

Throws:

HazelcastSerializationException - if the field name does not exist in the schema/class definition or the type of the field does not match the one in the schema/class definition or the same field is trying to be set without using GenericRecord.newBuilderWithClone().

UnsupportedOperationException - if the setter is called after a GenericRecord is built by build().

See Also:

• setTimestamp(String, LocalDateTime)

setArrayOfTimestampWithTimezone

@Nonnull
GenericRecordBuilder setArrayOfTimestampWithTimezone(@Nonnull
 String fieldName,
 @Nullable
 OffsetDateTime[] value)

It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone(). Otherwise, it is illegal to set to the same field twice. Array items can not be null.

Parameters:

fieldName - name of the field as it is defined in its schema/class definition. It should be composed of only alphanumeric characters for Portable GenericRecords.

value - to set to GenericRecord

Returns:

itself for chaining

Throws:

HazelcastSerializationException - if the field name does not exist in the schema/class definition or the type of the field does not match the one in the schema/class definition or the same field is trying to be set without using GenericRecord.newBuilderWithClone().

UnsupportedOperationException - if the setter is called after a GenericRecord is built by build().

See Also:

• setTimestampWithTimezone(String, OffsetDateTime)

setArrayOfGenericRecord

@Nonnull
GenericRecordBuilder setArrayOfGenericRecord(@Nonnull
 String fieldName,
 @Nullable
 GenericRecord[] value)

It is legal to set the field again only when Builder is created with GenericRecord.newBuilderWithClone(). Otherwise, it is illegal to set to the same field twice. This method allows nested structures. Subclasses should also be created as `GenericRecord`.

Array items can not be null.

For Compact objects, it is not allowed write an array containing different item types or a HazelcastSerializationException will be thrown.

Parameters:

fieldName - name of the field as it is defined in its schema/class definition. It should be composed of only alphanumeric characters for Portable GenericRecords.

value - to set to GenericRecord

Returns:

itself for chaining

Throws:

HazelcastSerializationException - 1. if the field name does not exist in the schema/class definition. 2. The type of the field does not match the one in the schema/class definition. 3. The same field is trying to be set without using GenericRecord.newBuilderWithClone(). 4. The type of the generic record is not the same as the generic record that is being built. e.g using portable generic record in a compact generic record builder.

UnsupportedOperationException - if the setter is called after a GenericRecord is built by build().