/* * SPDX-License-Identifier: Apache-2.0 * * The OpenSearch Contributors require contributions made to * this file be licensed under the Apache-2.0 license or a * compatible open source license. */ /* * Licensed to Elasticsearch under one or more contributor * license agreements. See the NOTICE file distributed with * this work for additional information regarding copyright * ownership. Elasticsearch licenses this file to you under * the Apache License, Version 2.0 (the "License"); you may * not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, * software distributed under the License is distributed on an * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY * KIND, either express or implied. See the License for the * specific language governing permissions and limitations * under the License. */ /* * Modifications Copyright OpenSearch Contributors. See * GitHub history for details. */ package org.opensearch.search.fetch.subphase; import org.apache.lucene.index.LeafReaderContext; import org.opensearch.common.document.DocumentField; import org.opensearch.index.mapper.IgnoredFieldMapper; import org.opensearch.search.SearchHit; import org.opensearch.search.fetch.FetchContext; import org.opensearch.search.fetch.FetchSubPhase; import org.opensearch.search.fetch.FetchSubPhaseProcessor; import org.opensearch.search.lookup.SearchLookup; import org.opensearch.search.lookup.SourceLookup; import java.io.IOException; import java.util.HashSet; import java.util.Map; import java.util.Set; /** * A fetch sub-phase for high-level field retrieval. Given a list of fields, it * retrieves the field values from _source and returns them as document fields. * * @opensearch.internal */ public final class FetchFieldsPhase implements FetchSubPhase { @Override public FetchSubPhaseProcessor getProcessor(FetchContext fetchContext) { FetchFieldsContext fetchFieldsContext = fetchContext.fetchFieldsContext(); if (fetchFieldsContext == null) { return null; } SearchLookup searchLookup = fetchContext.searchLookup(); if (fetchContext.mapperService().documentMapper().sourceMapper().enabled() == false) { throw new IllegalArgumentException( "Unable to retrieve the requested [fields] since _source is disabled " + "in the mappings for index [" + fetchContext.getIndexName() + "]" ); } FieldFetcher fieldFetcher = FieldFetcher.create(fetchContext.getQueryShardContext(), searchLookup, fetchFieldsContext.fields()); return new FetchSubPhaseProcessor() { @Override public void setNextReader(LeafReaderContext readerContext) { fieldFetcher.setNextReader(readerContext); } @Override public void process(HitContext hitContext) throws IOException { SearchHit hit = hitContext.hit(); SourceLookup sourceLookup = hitContext.sourceLookup(); Set ignoredFields = getIgnoredFields(hit); Map documentFields = fieldFetcher.fetch(sourceLookup, ignoredFields); for (Map.Entry entry : documentFields.entrySet()) { hit.setDocumentField(entry.getKey(), entry.getValue()); } } }; } private Set getIgnoredFields(SearchHit hit) { DocumentField field = hit.field(IgnoredFieldMapper.NAME); if (field == null) { return Set.of(); } Set ignoredFields = new HashSet<>(); for (Object value : field.getValues()) { ignoredFields.add((String) value); } return ignoredFields; } }