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

org.molgenis.data.elasticsearch.SearchService Maven / Gradle / Ivy

The newest version!
package org.molgenis.data.elasticsearch;

import java.util.stream.Stream;

import org.molgenis.data.AggregateQuery;
import org.molgenis.data.AggregateResult;
import org.molgenis.data.Entity;
import org.molgenis.data.EntityMetaData;
import org.molgenis.data.Fetch;
import org.molgenis.data.Query;
import org.molgenis.data.elasticsearch.ElasticsearchService.IndexingMode;
import org.molgenis.data.elasticsearch.util.SearchRequest;
import org.molgenis.data.elasticsearch.util.SearchResult;

public interface SearchService
{

	/**
	 * Returns all type names for this index
	 * 
	 * @return
	 */
	Iterable getTypes();

	/**
	 * @deprecated see search(Query, EntityMetaData) or aggregate(AggregateQuery, EntityMetaData)
	 */
	@Deprecated
	SearchResult search(SearchRequest request);

	boolean hasMapping(EntityMetaData entityMetaData);

	void createMappings(EntityMetaData entityMetaData);

	void createMappings(EntityMetaData entityMetaData, boolean storeSource, boolean enableNorms,
			boolean createAllIndex);

	/**
	 * Refresh index, making all operations performed since the last refresh available for search
	 */
	void refresh(EntityMetaData entityMeta);

	long count(EntityMetaData entityMetaData);

	long count(Query q, EntityMetaData entityMetaData);

	void index(Entity entity, EntityMetaData entityMetaData, IndexingMode indexingMode);

	/**
	 * Adds or updated the given entities in the index
	 *
	 * @param entities
	 * @param entityMetaData
	 * @param indexingMode
	 * @return number of indexed entities, which equals the size of the input entities iterable
	 */
	long index(Iterable entities, EntityMetaData entityMetaData, IndexingMode indexingMode);

	/**
	 * Adds or updated the given entities in the index
	 * 
	 * @param entities
	 * @param entityMetaData
	 * @param indexingMode
	 * @return number of indexed entities
	 */
	long index(Stream entities, EntityMetaData entityMetaData, IndexingMode indexingMode);

	void delete(Entity entity, EntityMetaData entityMetaData);

	void deleteById(String id, EntityMetaData entityMetaData);

	void deleteById(Stream ids, EntityMetaData entityMetaData);

	void delete(Iterable entities, EntityMetaData entityMetaData);

	/**
	 * Deletes entities from index
	 * 
	 * @param entities
	 *            entity stream
	 * @param entityMetaData
	 */
	void delete(Stream entities, EntityMetaData entityMetaData);

	/**
	 * Deletes data and meta data
	 * 
	 * @param entityName
	 */
	void delete(String entityName);

	/**
	 * Returns entity with given id or null if entity does not exist
	 * 
	 * @param entityId
	 * @param entityMetaData
	 * @return entity or null
	 */
	Entity get(Object entityId, EntityMetaData entityMetaData);

	/**
	 * Returns entity with given id and attribute values defined by fetch or null if entity does not exist
	 * 
	 * @param entityId
	 * @param entityMetaData
	 * @param fetch
	 * @return entity or null
	 */
	Entity get(Object entityId, EntityMetaData entityMetaData, Fetch fetch);

	/**
	 * Returns entities with given ids
	 * 
	 * @param entityIds
	 * @param entityMetaData
	 * @return entities
	 */
	Iterable get(Iterable entityIds, EntityMetaData entityMetaData);

	/**
	 * Returns entities with given ids
	 * 
	 * @param entityIds
	 * @param entityMetaData
	 * @return
	 */
	Stream get(Stream entityIds, EntityMetaData entityMetaData);

	/**
	 * Returns entities with given ids and attribute values defined by fetch
	 * 
	 * @param entityIds
	 * @param entityMetaData
	 * @param fetch
	 * @return entities with attribute values defined by fetch
	 */
	Iterable get(Iterable entityIds, EntityMetaData entityMetaData, Fetch fetch);

	/**
	 * Returns entities with given ids and attribute values defined by fetch
	 * 
	 * @param entityIds
	 * @param entityMetaData
	 * @param fetch
	 * @return entities with attribute values defined by fetch
	 */
	Stream get(Stream entityIds, EntityMetaData entityMetaData, Fetch fetch);

	// TODO replace Iterable with EntityCollection and add EntityCollection.getTotal()
	Iterable search(Query q, EntityMetaData entityMetaData);

	/**
	 * TODO replace Stream with EntityCollection and add EntityCollection.getTotal()
	 * 
	 * @param q
	 * @param entityMetaData
	 * @return
	 */
	Stream searchAsStream(Query q, EntityMetaData entityMetaData);

	AggregateResult aggregate(AggregateQuery aggregateQuery, EntityMetaData entityMetaData);

	/**
	 * Frees memory from the index by flushing data to the index storage and clearing the internal transaction log
	 */
	void flush();

	void rebuildIndex(Iterable entities, EntityMetaData entityMetaData);

	/**
	 * Optimize the index for faster search operations, remove documents that are marked as deleted.
	 */
	void optimizeIndex();
}