com.hazelcast.nio.serialization

Interface GenericRecord

All Known Implementing Classes:

AbstractGenericRecord

@Beta
public interface GenericRecord

A generic object interface that is returned to the user when the domain class can not be created from any of the distributed hazelcast data structures like IMap, IQueue etc.

On remote calls like in the distributed executor service or EntryProcessors, you may need access to the domain object. In case the class of the domain object is not available on the cluster, GenericRecord allows you to read and write the object without the domain class on the classpath. Here is an example with EntryProcessor:

 map.executeOnKey(key, (EntryProcessor<Object, Object, Object>) entry -> {
             Object value = entry.getValue();
             GenericRecord genericRecord = (GenericRecord) value;

             int id = genericRecord.getInt("id");

             return null;
         });
 

Another example with EntryProcessor to demonstrate how to read, modify and set the value back to the map:

 map.executeOnKey("key", (EntryProcessor<Object, Object, Object>) entry -> {
             GenericRecord genericRecord = (GenericRecord) entry.getValue();
             GenericRecord modifiedGenericRecord = genericRecord.cloneWithBuilder()
                     .setInt("age",22).build();
             entry.setValue(modifiedGenericRecord);
             return null;
         });
 

GenericRecord also allows reading from a cluster without having the classes on the client side. For Portable, when PortableFactory is not provided in the config at the start, a HazelcastSerializationException was thrown stating that a factory could not be found. Starting from 4.1, the objects will be returned as GenericRecord. This way, the clients can read and write objects back to the cluster without the need to have the domain classes on the classpath.

Currently this is valid for Portable objects.

Since:

4.1

Method Summary

Modifier and Type	Method and Description
GenericRecordBuilder	cloneWithBuilder() Returned GenericRecordBuilder can be used to have exact copy and also just to update a couple of fields.
boolean[]	getArrayOfBoolean(String fieldName)
char[]	getArrayOfChar(String fieldName)
LocalDate[]	getArrayOfDate(String fieldName)
BigDecimal[]	getArrayOfDecimal(String fieldName)
float[]	getArrayOfFloat32(String fieldName)
double[]	getArrayOfFloat64(String fieldName)
GenericRecord[]	getArrayOfGenericRecord(String fieldName)
short[]	getArrayOfInt16(String fieldName)
int[]	getArrayOfInt32(String fieldName)
long[]	getArrayOfInt64(String fieldName)
byte[]	getArrayOfInt8(String fieldName)
Boolean[]	getArrayOfNullableBoolean(String fieldName)
Float[]	getArrayOfNullableFloat32(String fieldName)
Double[]	getArrayOfNullableFloat64(String fieldName)
Short[]	getArrayOfNullableInt16(String fieldName)
Integer[]	getArrayOfNullableInt32(String fieldName)
Long[]	getArrayOfNullableInt64(String fieldName)
Byte[]	getArrayOfNullableInt8(String fieldName)
String[]	getArrayOfString(String fieldName)
LocalTime[]	getArrayOfTime(String fieldName)
LocalDateTime[]	getArrayOfTimestamp(String fieldName)
OffsetDateTime[]	getArrayOfTimestampWithTimezone(String fieldName)
boolean	getBoolean(String fieldName)
char	getChar(String fieldName)
LocalDate	getDate(String fieldName)
BigDecimal	getDecimal(String fieldName)
FieldKind	getFieldKind(String fieldName)
Set<String>	getFieldNames()
float	getFloat32(String fieldName)
double	getFloat64(String fieldName)
GenericRecord	getGenericRecord(String fieldName)
short	getInt16(String fieldName)
int	getInt32(String fieldName)
long	getInt64(String fieldName)
byte	getInt8(String fieldName)
Boolean	getNullableBoolean(String fieldName)
Float	getNullableFloat32(String fieldName)
Double	getNullableFloat64(String fieldName)
Short	getNullableInt16(String fieldName)
Integer	getNullableInt32(String fieldName)
Long	getNullableInt64(String fieldName)
Byte	getNullableInt8(String fieldName)
String	getString(String fieldName)
LocalTime	getTime(String fieldName)
LocalDateTime	getTimestamp(String fieldName)
OffsetDateTime	getTimestampWithTimezone(String fieldName)
boolean	hasField(String fieldName)
GenericRecordBuilder	newBuilder() Creates a GenericRecordBuilder allows to create a new object.

Method Detail

newBuilder

@Nonnull
GenericRecordBuilder newBuilder()

Creates a GenericRecordBuilder allows to create a new object. This method is a convenience method to get a builder, without creating the class definition for this type. Here you can see a new object is constructed from an existing GenericRecord with its class definition:

 GenericRecord newGenericRecord = genericRecord.newBuilder()
      .setString("name", "bar")
      .setInt("id", 4).build();

 

see GenericRecordBuilder.portable(ClassDefinition) to create a GenericRecord in Portable format with a different class definition.

Returns:

an empty generic record builder with same class definition as this one

cloneWithBuilder

@Nonnull
GenericRecordBuilder cloneWithBuilder()

Returned GenericRecordBuilder can be used to have exact copy and also just to update a couple of fields. By default, it will copy all the fields. So instead of following where only the `id` field is updated,

     GenericRecord modifiedGenericRecord = genericRecord.newBuilder()
                         .setString("name", genericRecord.getString("name"))
                         .setLong("id", 4)
                         .setString("surname", genericRecord.getString("surname"))
                         .setInt("age", genericRecord.getInt("age")).build();
 

`cloneWithBuilder` used as follows:

     GenericRecord modifiedGenericRecord = genericRecord.cloneWithBuilder().setInt("id", 4).build();
 

Returns:

a generic record builder with same class definition as this one and populated with same values.

getFieldNames

@Nonnull
Set<String> getFieldNames()

Returns:

set of field names of this GenericRecord

getFieldKind

@Nonnull
FieldKind getFieldKind(@Nonnull
                                String fieldName)

Parameters:

fieldName - the name of the field

Returns:

field type for the given field name

Throws:

IllegalArgumentException - if the field name does not exist in the class definition

hasField

boolean hasField(@Nonnull
                 String fieldName)

Parameters:

fieldName - the name of the field

Returns:

true if field exists in the definition of the class. Note that returns true even if the field is null.

getBoolean

boolean getBoolean(@Nonnull
                   String fieldName)

Parameters:

fieldName - the name of the field

Returns:

the value of the field

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.

getChar

char getChar(@Nonnull
             String fieldName)

Parameters:

fieldName - the name of the field

Returns:

the value of the field

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.

getInt8

byte getInt8(@Nonnull
             String fieldName)

Parameters:

fieldName - the name of the field

Returns:

the value of the field

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.

getInt16

short getInt16(@Nonnull
               String fieldName)

Parameters:

fieldName - the name of the field

Returns:

the value of the field

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.

getInt32

int getInt32(@Nonnull
             String fieldName)

Parameters:

fieldName - the name of the field

Returns:

the value of the field

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.

getInt64

long getInt64(@Nonnull
              String fieldName)

Parameters:

fieldName - the name of the field

Returns:

the value of the field

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.

getFloat32

float getFloat32(@Nonnull
                 String fieldName)

Parameters:

fieldName - the name of the field

Returns:

the value of the field

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.

getFloat64

double getFloat64(@Nonnull
                  String fieldName)

Parameters:

fieldName - the name of the field

Returns:

the value of the field

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.

getString

@Nullable
String getString(@Nonnull
                           String fieldName)

Parameters:

fieldName - the name of the field

Returns:

the value of the field

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.

getDecimal

@Nullable
BigDecimal getDecimal(@Nonnull
                                String fieldName)

Parameters:

fieldName - the name of the field

Returns:

decimal which is arbitrary precision and scale floating-point number as BigDecimal

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.

getTime

@Nullable
LocalTime getTime(@Nonnull
                            String fieldName)

Parameters:

fieldName - the name of the field

Returns:

time field consisting of hour, minute, seconds and nanos parts as LocalTime

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.

getDate

@Nullable
LocalDate getDate(@Nonnull
                            String fieldName)

Parameters:

fieldName - the name of the field

Returns:

date field consisting of year, month of the year and day of the month as LocalDate

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.

getTimestamp

@Nullable
LocalDateTime getTimestamp(@Nonnull
                                     String fieldName)

Parameters:

fieldName - the name of the field

Returns:

timestamp field consisting of year, month of the year, day of the month, hour, minute, seconds, nanos parts as LocalDateTime

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.

getTimestampWithTimezone

@Nullable
OffsetDateTime getTimestampWithTimezone(@Nonnull
                                                  String fieldName)

Parameters:

fieldName - the name of the field

Returns:

timestamp with timezone field consisting of year, month of the year, day of the month, offset seconds, hour, minute, seconds, nanos parts as OffsetDateTime

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.

getGenericRecord

@Nullable
GenericRecord getGenericRecord(@Nonnull
                                         String fieldName)

Parameters:

fieldName - the name of the field

Returns:

the value of the field

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.

getArrayOfBoolean

@Nullable
boolean[] getArrayOfBoolean(@Nonnull
                                      String fieldName)

Parameters:

fieldName - the name of the field

Returns:

the value of the field

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.

getArrayOfChar

@Nullable
char[] getArrayOfChar(@Nonnull
                                String fieldName)

Parameters:

fieldName - the name of the field

Returns:

the value of the field

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.

getArrayOfInt8

@Nullable
byte[] getArrayOfInt8(@Nonnull
                                String fieldName)

Parameters:

fieldName - the name of the field

Returns:

the value of the field

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.

getArrayOfInt16

@Nullable
short[] getArrayOfInt16(@Nonnull
                                  String fieldName)

Parameters:

fieldName - the name of the field

Returns:

the value of the field

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.

getArrayOfInt32

@Nullable
int[] getArrayOfInt32(@Nonnull
                                String fieldName)

Parameters:

fieldName - the name of the field

Returns:

the value of the field

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.

getArrayOfInt64

@Nullable
long[] getArrayOfInt64(@Nonnull
                                 String fieldName)

Parameters:

fieldName - the name of the field

Returns:

the value of the field

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.

getArrayOfFloat32

@Nullable
float[] getArrayOfFloat32(@Nonnull
                                    String fieldName)

Parameters:

fieldName - the name of the field

Returns:

the value of the field

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.

getArrayOfFloat64

@Nullable
double[] getArrayOfFloat64(@Nonnull
                                     String fieldName)

Parameters:

fieldName - the name of the field

Returns:

the value of the field

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.

getArrayOfString

@Nullable
String[] getArrayOfString(@Nonnull
                                    String fieldName)

Parameters:

fieldName - the name of the field

Returns:

the value of the field

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.

getArrayOfDecimal

@Nullable
BigDecimal[] getArrayOfDecimal(@Nonnull
                                         String fieldName)

Parameters:

fieldName - the name of the field

Returns:

array of Decimal's as BigDecimal[]

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.

See Also:

getDecimal(String)

getArrayOfTime

@Nullable
LocalTime[] getArrayOfTime(@Nonnull
                                     String fieldName)

Parameters:

fieldName - the name of the field

Returns:

array of Time's as LocalTime[]

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.

See Also:

getTime(String)

getArrayOfDate

@Nullable
LocalDate[] getArrayOfDate(@Nonnull
                                     String fieldName)

Parameters:

fieldName - the name of the field

Returns:

array of Date's to LocalDate[]

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.

See Also:

getDate(String)

getArrayOfTimestamp

@Nullable
LocalDateTime[] getArrayOfTimestamp(@Nonnull
                                              String fieldName)

Parameters:

fieldName - the name of the field

Returns:

array of Timestamp's as LocalDateTime[]

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.

See Also:

getTimestamp(String)

getArrayOfTimestampWithTimezone

@Nullable
OffsetDateTime[] getArrayOfTimestampWithTimezone(@Nonnull
                                                           String fieldName)

Parameters:

fieldName - the name of the field

Returns:

array of TimestampWithTimezone's as OffsetDateTime[]

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.

See Also:

getTimestampWithTimezone(String)

getArrayOfGenericRecord

@Nullable
GenericRecord[] getArrayOfGenericRecord(@Nonnull
                                                  String fieldName)

Parameters:

fieldName - the name of the field

Returns:

the value of the field

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.

getNullableBoolean

@Nullable
Boolean getNullableBoolean(@Nonnull
                                     String fieldName)

Parameters:

fieldName - the name of the field

Returns:

the value of the field

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.

getNullableInt8

@Nullable
Byte getNullableInt8(@Nonnull
                               String fieldName)

Parameters:

fieldName - the name of the field

Returns:

the value of the field

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.

getNullableInt16

@Nullable
Short getNullableInt16(@Nonnull
                                 String fieldName)

Parameters:

fieldName - the name of the field

Returns:

the value of the field

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.

getNullableInt32

@Nullable
Integer getNullableInt32(@Nonnull
                                   String fieldName)

Parameters:

fieldName - the name of the field

Returns:

the value of the field

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.

getNullableInt64

@Nullable
Long getNullableInt64(@Nonnull
                                String fieldName)

Parameters:

fieldName - the name of the field

Returns:

the value of the field

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.

getNullableFloat32

@Nullable
Float getNullableFloat32(@Nonnull
                                   String fieldName)

Parameters:

fieldName - the name of the field

Returns:

the value of the field

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.

getNullableFloat64

@Nullable
Double getNullableFloat64(@Nonnull
                                    String fieldName)

Parameters:

fieldName - the name of the field

Returns:

the value of the field

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.

getArrayOfNullableBoolean

@Nullable
Boolean[] getArrayOfNullableBoolean(@Nonnull
                                              String fieldName)

Parameters:

fieldName - the name of the field

Returns:

the value of the field

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.

getArrayOfNullableInt8

@Nullable
Byte[] getArrayOfNullableInt8(@Nonnull
                                        String fieldName)

Parameters:

fieldName - the name of the field

Returns:

the value of the field

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.

getArrayOfNullableInt16

@Nullable
Short[] getArrayOfNullableInt16(@Nonnull
                                          String fieldName)

Parameters:

fieldName - the name of the field

Returns:

the value of the field

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.

getArrayOfNullableInt32

@Nullable
Integer[] getArrayOfNullableInt32(@Nonnull
                                            String fieldName)

Parameters:

fieldName - the name of the field

Returns:

the value of the field

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.

getArrayOfNullableInt64

@Nullable
Long[] getArrayOfNullableInt64(@Nonnull
                                         String fieldName)

Parameters:

fieldName - the name of the field

Returns:

the value of the field

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.

getArrayOfNullableFloat32

@Nullable
Float[] getArrayOfNullableFloat32(@Nonnull
                                            String fieldName)

Parameters:

fieldName - the name of the field

Returns:

the value of the field

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.

getArrayOfNullableFloat64

@Nullable
Double[] getArrayOfNullableFloat64(@Nonnull
                                             String fieldName)

Parameters:

fieldName - the name of the field

Returns:

the value of the field

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.