aboutsummaryrefslogtreecommitdiffstats
path: root/container-search/src/main/java/com/yahoo/search/grouping/request/ArrayAtLookup.java
blob: 17642eb01708cd7aec33ee401df1e833353d3da9 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
// Copyright Vespa.ai. Licensed under the terms of the Apache 2.0 license. See LICENSE in the project root.
package com.yahoo.search.grouping.request;

import com.yahoo.api.annotations.Beta;

/**
 * Represents access of array element in a document attribute in a {@link GroupingExpression}.
 *
 * The first argument should be the name of an array attribute in the
 * input {@link com.yahoo.search.result.Hit}, while the second
 * argument is evaluated as an integer and used as the index in that array.
 * If the index argument is less than 0 returns the first array element;
 * if the index is greater than or equal to size(array) returns the last array element;
 * if the array is empty returns 0 (or NaN?).
 *
 * @author arnej27959
 */
@Beta
public class ArrayAtLookup extends DocumentValue {

    private final String attributeName;
    private final GroupingExpression indexArgument;

    /**
     * Constructs a new instance of this class.
     *
     * @param attributeName the attribute name to assign to this.
     */
    public ArrayAtLookup(String attributeName, GroupingExpression indexArg) {
        this(null, null, attributeName, indexArg);
    }

    private ArrayAtLookup(String label, Integer level, String attributeName, GroupingExpression indexArgument) {
        super("array.at(" + attributeName + ", " + indexArgument + ")", label, level);
        this.attributeName = attributeName;
        this.indexArgument = indexArgument;
    }

    @Override
    public ArrayAtLookup copy() {
        return new ArrayAtLookup(getLabel(), getLevelOrNull(), getAttributeName(), getIndexArgument().copy());
    }

    /** Returns the name of the attribute to retrieve from the input hit */
    public String getAttributeName() {
        return attributeName;
    }

    /** Return the expression to evaluate before indexing */
    public GroupingExpression getIndexArgument() {
        return indexArgument;
    }

}