io.vertigo.datafactory.collections.model.FacetedQueryResult Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of vertigo-datafactory Show documentation
The newest version!
/*
 * vertigo - application development platform
 *
 * Copyright (C) 2013-2024, Vertigo.io, [email protected]
 *
 * Licensed 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.
 */
package io.vertigo.datafactory.collections.model;

import java.io.Serializable;
import java.util.Collections;
import java.util.List;
import java.util.Map;
import java.util.Optional;

import io.vertigo.core.lang.Assertion;
import io.vertigo.core.node.definition.DefinitionId;
import io.vertigo.datafactory.collections.definitions.FacetDefinition;
import io.vertigo.datamodel.data.definitions.DataField;
import io.vertigo.datamodel.data.model.DataObject;
import io.vertigo.datamodel.data.model.DtList;

/**
 * Résultat de la recherche.
 * Tout résultat est facetté.
 * Eventuellement il n'y a aucune facette.
 * @author pchretien, dchallas
 * @param  Type de l'objet resultant de la recherche
 * @param  Type de l'objet source
 */
public final class FacetedQueryResult implements Serializable {
	private static final long serialVersionUID = 1248453191954177054L;

	private final DtList list;
	private final List facets;
	private final Map> highlights;
	private final DefinitionId clusterFacetDefinitionId; //nullable
	private final Map> clusteredDtc;
	private final long count;
	private final S source;
	private final FacetedQuery facetedQueryOpt; //nullable

	/**
	 * Constructor.
	 * @param query Facettage de la requète
	 * @param count  Nombre total de résultats
	 * @param list DTC résultat, éventuellement tronquée à n (ex 500) si trop d'éléments.
	 * @param facets Liste des facettes. (Peut être vide jamais null)
	 * @param clusterFacetDefinition FacetDefinition du Cluster
	 * @param clusteredDtc Cluster des documents. (Peut être vide jamais null)
	 * @param highlights Liste des extraits avec mise en valeur par objet et par champs
	 * @param source Object source permettant rerentrer dans le mechanisme de filtrage
	 */
	public FacetedQueryResult(
			final Optional query,
			final long count,
			final DtList list,
			final List facets,
			final Optional clusterFacetDefinition,
			final Map> clusteredDtc,
			final Map> highlights,
			final S source) {
		Assertion.check()
				.isNotNull(query)
				.isNotNull(list)
				.isNotNull(facets)
				.isNotNull(source)
				.isNotNull(clusterFacetDefinition)
				.isNotNull(clusteredDtc)
				.isNotNull(highlights);
		//-----
		this.facetedQueryOpt = query.orElse(null);
		this.count = count;
		this.list = list;
		this.facets = facets;
		this.clusterFacetDefinitionId = clusterFacetDefinition.map(FacetDefinition::id).orElse(null);
		this.clusteredDtc = clusteredDtc;
		this.highlights = highlights;
		this.source = source;
	}

	/**
	 * @return Nombre total de résultats
	 */
	public long getCount() {
		return count;
	}

	/**
	 * Rappel des facettes de la requête initiale.
	 * @return Facettes de requète
	 */
	public Optional getFacetedQuery() {
		return Optional.ofNullable(facetedQueryOpt);
	}

	/**
	 * @return DTC résultat, éventuellement tronquée à n (ex 500) si trop d'éléments.
	 */
	public DtList getDtList() {
		return list;
	}

	/**
	 * @return Liste des facettes. (Peut être vide jamais null)
	 */
	public List getFacets() {
		return facets;
	}

	/**
	 * @return FacetDefinition du cluster des documents par valeur de facette, si demandé lors de la requête.
	 */
	public Optional getClusterFacetDefinition() {
		return clusterFacetDefinitionId == null
				? Optional.empty()
				: Optional.ofNullable(clusterFacetDefinitionId.get());
	}

	/**
	 * @return Cluster des documents par valeur de facette, si demandé lors de la requête. (Peut être vide jamais null)
	 */
	public Map> getClusters() {
		return clusteredDtc;
	}

	/**
	 * @param document Document dont on veut les highlights
	 * @return Extrait avec mise en valeur par champs. (Peut être vide jamais null)
	 */
	public Map getHighlights(final R document) {
		return highlights.getOrDefault(document, Collections.emptyMap());
	}

	/**
	 * @return Object source permettant réentrer dans le mécanisme de filtrage.
	 */
	public S getSource() {
		return source;
	}
}