All Downloads are FREE. Search and download functionalities are using the official Maven repository.

org.elasticsearch.index.mapper.ArraySourceValueFetcher Maven / Gradle / Ivy

There is a newer version: 8.14.0
Show newest version
/*
 * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
 * or more contributor license agreements. Licensed under the Elastic License
 * 2.0 and the Server Side Public License, v 1; you may not use this file except
 * in compliance with, at your election, the Elastic License 2.0 or the Server
 * Side Public License, v 1.
 */

package org.elasticsearch.index.mapper;

import org.elasticsearch.core.Nullable;
import org.elasticsearch.index.query.SearchExecutionContext;
import org.elasticsearch.search.lookup.SourceLookup;

import java.util.ArrayList;
import java.util.List;
import java.util.Set;

/**
 * An implementation of {@link ValueFetcher} that knows how to extract values
 * from the document source.
 * 

* This class differs from {@link SourceValueFetcher} in that it directly handles * array values in parsing. Field types should use this class if their corresponding * mapper returns true for {@link FieldMapper#parsesArrayValue()}. */ public abstract class ArraySourceValueFetcher implements ValueFetcher { private final Set sourcePaths; private final @Nullable Object nullValue; public ArraySourceValueFetcher(String fieldName, SearchExecutionContext context) { this(fieldName, context, null); } /** * @param fieldName The name of the field. * @param context The query shard context * @param nullValue A optional substitute value if the _source value is 'null'. */ public ArraySourceValueFetcher(String fieldName, SearchExecutionContext context, Object nullValue) { this.sourcePaths = context.sourcePath(fieldName); this.nullValue = nullValue; } @Override public List fetchValues(SourceLookup lookup, List ignoredValues) { List values = new ArrayList<>(); for (String path : sourcePaths) { Object sourceValue = lookup.extractValue(path, nullValue); if (sourceValue == null) { return org.elasticsearch.core.List.of(); } try { values.addAll((List) parseSourceValue(sourceValue)); } catch (Exception e) { // if parsing fails here then it would have failed at index time // as well, meaning that we must be ignoring malformed values. ignoredValues.add(sourceValue); } } return values; } /** * Given a value that has been extracted from a document's source, parse it into a standard * format. This parsing logic should closely mirror the value parsing in * {@link FieldMapper#parseCreateField} or {@link FieldMapper#parse}. */ protected abstract Object parseSourceValue(Object value); }