com.hazelcast.nio.serialization.genericrecord

Interface GenericRecordBuilder

public interface GenericRecordBuilder

Interface for creating GenericRecord instances.

Since:

5.2

Method Summary

Modifier and Type	Method and 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 Detail

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().