Module jakarta.nosql.core
Package jakarta.nosql

Interface AttributeConverter<X,Y>

Type Parameters:
X - the target type, that is, the type of the entity attribute
Y - a basic type or a supported type in the NoSQL database representing the type of the database column
public interface AttributeConverter<X,Y>
A class that implements this interface can be used to convert entity attribute state into a database column representation and vice versa. Note that the types X and Y may be the same Java type.

This interface is implemented by custom attribute converters. A converter is a class whose methods convert between the target type of the converter (an arbitrary Java type which may be used as the type of a persistent field or property) and a basic type or a type that can be persisted by a persistence provider, used as an intermediate step in mapping to the database representation.

A converted field or property is considered basic, since, with the aid of the converter, its values can be represented as instances of a basic type.

Note that the target type X and the converted basic type Y may be the same Java type.

Since:
1.0.0
See Also:

  • Method Summary

    Modifier and Type
    Method
    Description
    Y
    convertToDatabaseColumn(X attribute)
    Converts the value stored in the entity attribute into the data representation to be stored in the database.
    X
    convertToEntityAttribute(Y dbData)
    Converts the data stored in the database column into the value to be stored in the entity attribute.

  • Method Details

    • convertToDatabaseColumn

      Y convertToDatabaseColumn(X attribute)
      Converts the value stored in the entity attribute into the data representation to be stored in the database.
      Parameters:
      attribute - the entity attribute value to be converted
      Returns:
      the converted data to be stored in the database column

    • convertToEntityAttribute

      X convertToEntityAttribute(Y dbData)
      Converts the data stored in the database column into the value to be stored in the entity attribute. Note that it is the responsibility of the converter writer to specify the correct database data type for the corresponding column for use by the NoSQL database: i.e., persistence providers are not expected to do such type conversion.
      Parameters:
      dbData - the data from the database column to be converted
      Returns:
      the converted value to be stored in the entity attribute