com.aerospike.mapper.annotations.AerospikeEmbed Maven / Gradle / Ivy

Go to download
package com.aerospike.mapper.annotations;

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

/**
 * Bins marked with AerospikeEmbed will have the objects they reference embedded in the parent object, either as a list or a map
 */
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.FIELD)
public @interface AerospikeEmbed {

    enum EmbedType {
        LIST,
        MAP,
        DEFAULT
    }

    EmbedType type() default EmbedType.DEFAULT;

    /**
     * The elementType is used for sub-elements. For example, if there is:
     *      * @AerospikeBin
     * @AerospikeEmbed(elementType = EmbedType.LIST)
     * private List accounts;
     * 
     * then the objects will be stored in the database as lists of lists, rather than lists of maps.
     */
    EmbedType elementType() default EmbedType.DEFAULT;

    /**
     * Determine whether the key should be saved in the sub-object. This is used only for translating
     * a list of objects in Java into a map of objects which contains a list. For example:
     * 
     * public class Transaction {
     *    private String name;
     *    private int value;
     *    @AerospikeKey
     *    private long time;
     *
     *    public Transaction() {}
     *    public Transaction(String name, int value, long time) {
     *        super();
     *        this.name = name;
     *        this.value = value;
     *        this.time = time;
     *    }
     * }
     *
     * ...
     *
     * @AerospikeEmbed(type = EmbedType.MAP, elementType = EmbedType.LIST)
     * public List<Transaction> txns;
     * 
     * 
     * Assume elements have been inserted into the list as follows:
     * 
     *  account.txns.add(new Transaction("details1", 100, 101));
     *  account.txns.add(new Transaction("details2", 200, 99));
     *  account.txns.add(new Transaction("details3", 300, 1010));
     * 
     * 
     * Since these elements are stored in a map, the AerospikeKey field (time in this case) will be the key to the map.
     * By default, the key is then dropped from the list as it is not needed, resulting in:
     * 
     * KEY_ORDERED_MAP('{99:["details2", 200], 101:["details1", 100], 1010:["details3", 300]}')
     * 
     * 
     * If it is desired for the key to be part of the list as well, this value can be set to true:
     *
     * 
     * @AerospikeEmbed(type = EmbedType.MAP, elementType = EmbedType.LIST, saveKey = true)
     * public List<Transaction> txns;
     * 
     * 
     * This would result in:
     * 
     * KEY_ORDERED_MAP('{99:["details2", 99, 200], 101:["details1", 101, 100], 1010:["details3", 1010, 300]}')
     * 
     */
    boolean saveKey() default false;
}