SolrOperations.java

/*
 * Copyright 2012 - 2017 the original author or authors.
 *
 * 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 org.springframework.data.solr.core;

import java.io.Serializable;
import java.util.Collection;
import java.util.Optional;

import org.apache.solr.client.solrj.SolrClient;
import org.apache.solr.client.solrj.response.SolrPingResponse;
import org.apache.solr.client.solrj.response.UpdateResponse;
import org.apache.solr.common.SolrInputDocument;
import org.springframework.data.domain.Page;
import org.springframework.data.solr.core.convert.SolrConverter;
import org.springframework.data.solr.core.query.FacetAndHighlightQuery;
import org.springframework.data.solr.core.query.FacetQuery;
import org.springframework.data.solr.core.query.HighlightQuery;
import org.springframework.data.solr.core.query.Query;
import org.springframework.data.solr.core.query.SolrDataQuery;
import org.springframework.data.solr.core.query.TermsQuery;
import org.springframework.data.solr.core.query.result.Cursor;
import org.springframework.data.solr.core.query.result.FacetAndHighlightPage;
import org.springframework.data.solr.core.query.result.FacetPage;
import org.springframework.data.solr.core.query.result.GroupPage;
import org.springframework.data.solr.core.query.result.HighlightPage;
import org.springframework.data.solr.core.query.result.ScoredPage;
import org.springframework.data.solr.core.query.result.StatsPage;
import org.springframework.data.solr.core.query.result.TermsPage;
import org.springframework.data.solr.core.schema.SchemaOperations;

/**
 * Interface that specifies a basic set of Solr operations.
 * 
 * @author Christoph Strobl
 * @author Joachim Uhrlass
 * @author Francisco Spaeth
 * @author Shiradwade Sateesh Krishna
 * @author David Webb
 */
public interface SolrOperations {

	/**
	 * Get the underlying SolrClient instance
	 * 
	 * @return
	 */
	SolrClient getSolrClient();

	/**
	 * Execute ping against SolrClient and return duration in msec
	 * 
	 * @return
	 */
	SolrPingResponse ping();

	/**
	 * return number of elements found by for given query
	 * 
	 * @param query must not be {@literal null}.
	 * @return
	 */
	long count(SolrDataQuery query);

	/**
	 * return number of elements found by for given query
	 *
	 * @param collection must not be {@literal null}.
	 * @param query must not be {@literal null}.
	 * @return
	 * @since 3.0
	 */
	long count(String collection, SolrDataQuery query);

	/**
	 * return number of elements found by for given query
	 * 
	 * @param query must not be {@literal null}.
	 * @param method must not be {@literal null}.
	 * @return
	 * @since 2.0
	 */
	long count(SolrDataQuery query, RequestMethod method);

	/**
	 * return number of elements found by for given query
	 *
	 * @param collection must not be {@literal null}.
	 * @param query must not be {@literal null}.
	 * @param method must not be {@literal null}.
	 * @return
	 * @since 3.0
	 */
	long count(String collection, SolrDataQuery query, RequestMethod method);

	/**
	 * Execute add operation against solr, which will do either insert or update into the default collection.
	 * 
	 * @param obj
	 * @return
	 */
	UpdateResponse saveBean(Object obj);

	/**
	 * Execute add operation against solr, which will do either insert or update.
	 *
	 * @param collection must not be {@literal null}.
	 * @param obj must not be {@literal null}.
	 * @return
	 * @since 3.0
	 */
	UpdateResponse saveBean(String collection, Object obj);

	/**
	 * Execute add operation against solr, which will do either insert or update with support for commitWithin strategy
	 * 
	 * @param obj
	 * @param commitWithinMs
	 * @return
	 */
	UpdateResponse saveBean(Object obj, int commitWithinMs);

	/**
	 * Execute add operation against solr, which will do either insert or update with support for commitWithin strategy.
	 *
	 * @param collection must not be {@literal null}.
	 * @param obj must not be {@literal null}.
	 * @param commitWithinMs
	 * @return
	 */
	UpdateResponse saveBean(String collection, Object obj, int commitWithinMs);

	/**
	 * Add a collection of beans to solr, which will do either insert or update in the default collection.
	 * 
	 * @param beans
	 * @return
	 */
	UpdateResponse saveBeans(Collection<?> beans);

	/**
	 * Add a collection of beans to solr, which will do either insert or update.
	 *
	 * @param collection must not be {@literal null}.
	 * @param beans must not be {@literal null}.
	 * @return
	 * @since 3.0
	 */
	UpdateResponse saveBeans(String collection, Collection<?> beans);

	/**
	 * Add a collection of beans to solr, which will do either insert or update in the default collection with support for
	 * commitWithin strategy.
	 * 
	 * @param beans
	 * @param commitWithinMs
	 * @return
	 */
	UpdateResponse saveBeans(Collection<?> beans, int commitWithinMs);

	/**
	 * Add a collection of beans to solr, which will do either insert or update with support for commitWithin strategy.
	 *
	 * @param collection must not be {@literal null}.
	 * @param beans must not be {@literal null}.
	 * @param commitWithinMs
	 * @return
	 * @since 3.0
	 */
	UpdateResponse saveBeans(String collection, Collection<?> beans, int commitWithinMs);

	/**
	 * Add a solrj input document to solr, which will do either insert or update
	 * 
	 * @param document
	 * @return
	 */
	UpdateResponse saveDocument(SolrInputDocument document);

	/**
	 * Add a solrj input document to solr, which will do either insert or update
	 *
	 * @param document
	 * @return
	 */
	UpdateResponse saveDocument(String collection, SolrInputDocument document);

	/**
	 * Add a solrj input document to solr, which will do either insert or update in the default collection with support
	 * for commitWithin strategy
	 * 
	 * @param document
	 * @param commitWithinMs
	 * @return
	 */
	UpdateResponse saveDocument(SolrInputDocument document, int commitWithinMs);

	/**
	 * Add a solrj input document to solr, which will do either insert or update with support for commitWithin strategy
	 *
	 * @param document must not be {@literal null}.
	 * @param commitWithinMs must not be {@literal null}.
	 * @return
	 * @since 3.0
	 */
	UpdateResponse saveDocument(String collection, SolrInputDocument document, int commitWithinMs);

	/**
	 * Add multiple solrj input documents to solr, which will do either insert or update
	 * 
	 * @param documents
	 * @return
	 */
	UpdateResponse saveDocuments(Collection<SolrInputDocument> documents);

	/**
	 * Add multiple solrj input documents to solr, which will do either insert or update
	 *
	 * @param collection must not be {@literal null}.
	 * @param documents must not be {@literal null}.
	 * @return
	 * @since 3.0
	 */
	UpdateResponse saveDocuments(String collection, Collection<SolrInputDocument> documents);

	/**
	 * Add multiple solrj input documents to solr, which will do either insert or update with support for commitWithin
	 * strategy
	 * 
	 * @param documents
	 * @param commitWithinMs
	 * @return
	 */
	UpdateResponse saveDocuments(Collection<SolrInputDocument> documents, int commitWithinMs);

	/**
	 * Add multiple solrj input documents to solr, which will do either insert or update with support for commitWithin
	 * strategy.
	 *
	 * @param collection must not be {@literal null}.
	 * @param documents must not be {@literal null}.
	 * @param commitWithinMs
	 * @return
	 * @since 3.0
	 */
	UpdateResponse saveDocuments(String collection, Collection<SolrInputDocument> documents, int commitWithinMs);

	/**
	 * Find and delete all objects matching the provided Query from the default collection.
	 * 
	 * @param query must not be {@literal null}.
	 * @return
	 */
	UpdateResponse delete(SolrDataQuery query);

	/**
	 * Find and delete all objects matching the provided Query.
	 *
	 * @param collection must not be {@literal null}.
	 * @param query must not be {@literal null}.
	 * @return
	 * @since 3.0
	 */
	UpdateResponse delete(String collection, SolrDataQuery query);

	/**
	 * Detele the one object with provided id from the default collection.
	 * 
	 * @param id must not be {@literal null}.
	 * @return
	 */
	UpdateResponse deleteById(String id);

	/**
	 * Detele the one object with provided id.
	 *
	 * @param collection must not be {@literal null}.
	 * @param id must not be {@literal null}.
	 * @return
	 * @since 3.0
	 */
	UpdateResponse deleteById(String collection, String id);

	/**
	 * Delete objects with given ids from the default collection.
	 * 
	 * @param id must not be {@literal null}.
	 * @return
	 */
	UpdateResponse deleteById(Collection<String> id);

	/**
	 * Delete objects with given ids
	 *
	 * @param collection must not be {@literal null}.
	 * @param id must not be {@literal null}.
	 * @return
	 * @since 3.0
	 */
	UpdateResponse deleteById(String collection, Collection<String> id);

	/**
	 * Execute the query against solr and return the first returned object
	 * 
	 * @param query must not be {@literal null}.
	 * @param clazz must not be {@literal null}.
	 * @return the first matching object
	 */
	<T> Optional<T> queryForObject(Query query, Class<T> clazz);

	/**
	 * Execute the query against solr and return the first returned object
	 *
	 * @param collection must not be {@literal null}.
	 * @param query must not be {@literal null}.
	 * @param clazz must not be {@literal null}.
	 * @return the first matching object
	 * @since 3.0
	 */
	<T> Optional<T> queryForObject(String collection, Query query, Class<T> clazz);

	/**
	 * Execute the query against solr and return the first returned object
	 * 
	 * @param query must not be {@literal null}.
	 * @param clazz must not be {@literal null}.
	 * @param method must not be {@literal null}.
	 * @return the first matching object
	 * @since 2.0
	 */
	<T> Optional<T> queryForObject(Query query, Class<T> clazz, RequestMethod method);

	/**
	 * Execute the query against solr and return the first returned object
	 *
	 * @param collection must not be {@literal null}.
	 * @param query must not be {@literal null}.
	 * @param clazz must not be {@literal null}.
	 * @param method must not be {@literal null}.
	 * @return the first matching object
	 * @since 3.0
	 */
	<T> Optional<T> queryForObject(String collection, Query query, Class<T> clazz, RequestMethod method);

	/**
	 * Execute the query against solr and retrun result as {@link Page}
	 * 
	 * @param query must not be {@literal null}.
	 * @param clazz must not be {@literal null}.
	 * @return
	 */
	<T> ScoredPage<T> queryForPage(Query query, Class<T> clazz);

	/**
	 * Execute the query against solr and retrun result as {@link Page}
	 *
	 * @param collection must not be {@literal null}.
	 * @param query must not be {@literal null}.
	 * @param clazz must not be {@literal null}.
	 * @return
	 * @since 3.0
	 */
	<T> ScoredPage<T> queryForPage(String collection, Query query, Class<T> clazz);

	/**
	 * Execute the query against solr and retrun result as {@link Page}
	 *
	 * @param query must not be {@literal null}.
	 * @param clazz must not be {@literal null}.
	 * @param method must not be {@literal null}.
	 * @return
	 * @since 2.0
	 */
	<T> ScoredPage<T> queryForPage(Query query, Class<T> clazz, RequestMethod method);

	/**
	 * Execute the query against solr and retrun result as {@link Page}
	 *
	 * @param collection must not be {@literal null}.
	 * @param query must not be {@literal null}.
	 * @param clazz must not be {@literal null}.
	 * @param method must not be {@literal null}.
	 * @return
	 * @since 3.0
	 */
	<T> ScoredPage<T> queryForPage(String collection, Query query, Class<T> clazz, RequestMethod method);

	/**
	 * Execute a facet query against solr facet result will be returned along with query result within the FacetPage
	 * 
	 * @param query must not be {@literal null}.
	 * @param clazz must not be {@literal null}.
	 * @return
	 */
	<T> FacetPage<T> queryForFacetPage(FacetQuery query, Class<T> clazz);

	/**
	 * Execute a facet query against solr facet result will be returned along with query result within the FacetPage
	 *
	 * @param collection must not be {@literal null}.
	 * @param query must not be {@literal null}.
	 * @param clazz must not be {@literal null}.
	 * @return
	 * @since 3.0
	 */
	<T> FacetPage<T> queryForFacetPage(String collection, FacetQuery query, Class<T> clazz);

	/**
	 * Execute a facet query against solr facet result will be returned along with query result within the FacetPage
	 * 
	 * @param query must not be {@literal null}.
	 * @param clazz must not be {@literal null}.
	 * @param method must not be {@literal null}.
	 * @return
	 * @since 2.0
	 */
	<T> FacetPage<T> queryForFacetPage(FacetQuery query, Class<T> clazz, RequestMethod method);

	/**
	 * Execute a facet query against solr facet result will be returned along with query result within the FacetPage
	 *
	 * @param collection must not be {@literal null}.
	 * @param query must not be {@literal null}.
	 * @param clazz must not be {@literal null}.
	 * @param method must not be {@literal null}.
	 * @return
	 * @since 3.0
	 */
	<T> FacetPage<T> queryForFacetPage(String collection, FacetQuery query, Class<T> clazz, RequestMethod method);

	/**
	 * Execute a query and highlight matches in result
	 * 
	 * @param query must not be {@literal null}.
	 * @param clazz must not be {@literal null}.
	 * @return
	 */
	<T> HighlightPage<T> queryForHighlightPage(HighlightQuery query, Class<T> clazz);

	/**
	 * Execute a query and highlight matches in result
	 *
	 * @param collection must not be {@literal null}.
	 * @param query must not be {@literal null}.
	 * @param clazz must not be {@literal null}.
	 * @return
	 * @since 3.0
	 */
	<T> HighlightPage<T> queryForHighlightPage(String collection, HighlightQuery query, Class<T> clazz);

	/**
	 * Execute a query and highlight matches in result
	 * 
	 * @param query must not be {@literal null}.
	 * @param clazz must not be {@literal null}.
	 * @param method must not be {@literal null}.
	 * @return
	 * @since 2.0
	 */
	<T> HighlightPage<T> queryForHighlightPage(HighlightQuery query, Class<T> clazz, RequestMethod method);

	/**
	 * Execute a query and highlight matches in result
	 *
	 * @param collection must not be {@literal null}.
	 * @param query must not be {@literal null}.
	 * @param clazz must not be {@literal null}.
	 * @param method must not be {@literal null}.
	 * @return
	 * @since 3.0
	 */
	<T> HighlightPage<T> queryForHighlightPage(String collection, HighlightQuery query, Class<T> clazz,
			RequestMethod method);

	/**
	 * Execute a query and highlight matches in result
	 *
	 * @param query must not be {@literal null}.
	 * @param clazz must not be {@literal null}.
	 * @return
	 * @since 2.1
	 */
	<T> FacetAndHighlightPage<T> queryForFacetAndHighlightPage(FacetAndHighlightQuery query, Class<T> clazz);

	/**
	 * Execute a query and highlight matches in result
	 *
	 * @param collection must not be {@literal null}.
	 * @param query must not be {@literal null}.
	 * @param clazz must not be {@literal null}.
	 * @return
	 * @since 3.0
	 */
	<T> FacetAndHighlightPage<T> queryForFacetAndHighlightPage(String collection, FacetAndHighlightQuery query,
			Class<T> clazz);

	/**
	 * Execute a query and highlight matches in result
	 *
	 * @param query must not be {@literal null}.
	 * @param clazz must not be {@literal null}.
	 * @param method must not be {@literal null}.
	 * @return
	 * @since 2.1
	 */
	<T> FacetAndHighlightPage<T> queryForFacetAndHighlightPage(FacetAndHighlightQuery query, Class<T> clazz,
			RequestMethod method);

	/**
	 * Execute a query and highlight matches in result
	 *
	 * @param collection must not be {@literal null}.
	 * @param query must not be {@literal null}.
	 * @param clazz must not be {@literal null}.
	 * @param method must not be {@literal null}.
	 * @return
	 * @since 3.0
	 */
	<T> FacetAndHighlightPage<T> queryForFacetAndHighlightPage(String collection, FacetAndHighlightQuery query,
			Class<T> clazz, RequestMethod method);

	/**
	 * Execute query using terms handler
	 * 
	 * @param query must not be {@literal null}.
	 * @return
	 */
	TermsPage queryForTermsPage(TermsQuery query);

	/**
	 * Execute query using terms handler
	 *
	 * @param collection must not be {@literal null}.
	 * @param query must not be {@literal null}.
	 * @return
	 * @since 3.0
	 */
	TermsPage queryForTermsPage(String collection, TermsQuery query);

	/**
	 * Execute query using terms handler
	 * 
	 * @param query must not be {@literal null}.
	 * @param method must not be {@literal null}.
	 * @return
	 * @since 2.0
	 */
	TermsPage queryForTermsPage(TermsQuery query, RequestMethod method);

	/**
	 * Execute query using terms handler
	 *
	 * @param collection must not be {@literal null}.
	 * @param query must not be {@literal null}.
	 * @param method must not be {@literal null}.
	 * @return
	 * @since 3.0
	 */
	TermsPage queryForTermsPage(String collection, TermsQuery query, RequestMethod method);

	/**
	 * Executes the given {@link Query} and returns an open {@link Cursor} allowing to iterate of results, dynamically
	 * fetching additional ones if required.
	 * 
	 * @param query must not be {@literal null}.
	 * @param clazz must not be {@literal null}.
	 * @return
	 * @since 1.3
	 */
	<T> Cursor<T> queryForCursor(Query query, Class<T> clazz);

	/**
	 * Executes the given {@link Query} and returns an open {@link Cursor} allowing to iterate of results, dynamically
	 * fetching additional ones if required.
	 *
	 * @param collection must not be {@literal null}.
	 * @param query must not be {@literal null}.
	 * @param clazz must not be {@literal null}.
	 * @return
	 * @since 3.0
	 */
	<T> Cursor<T> queryForCursor(String collection, Query query, Class<T> clazz);

	/**
	 * Execute the query against solr and return result as {@link GroupPage}
	 * 
	 * @param query must not be {@literal null}.
	 * @param clazz must not be {@literal null}.
	 * @return
	 * @since 1.4
	 */
	<T> GroupPage<T> queryForGroupPage(Query query, Class<T> clazz);

	/**
	 * Execute the query against solr and return result as {@link GroupPage}
	 *
	 * @param collection must not be {@literal null}.
	 * @param query must not be {@literal null}.
	 * @param clazz must not be {@literal null}.
	 * @return
	 * @since 3.0
	 */
	<T> GroupPage<T> queryForGroupPage(String collection, Query query, Class<T> clazz);

	/**
	 * Execute the query against solr and return result as {@link GroupPage}
	 * 
	 * @param query must not be {@literal null}.
	 * @param clazz must not be {@literal null}.
	 * @param method must not be {@literal null}.
	 * @return
	 * @since 2.0
	 */
	<T> GroupPage<T> queryForGroupPage(Query query, Class<T> clazz, RequestMethod method);

	/**
	 * Execute the query against solr and return result as {@link GroupPage}
	 *
	 * @param collection must not be {@literal null}.
	 * @param query must not be {@literal null}.
	 * @param clazz must not be {@literal null}.
	 * @param method must not be {@literal null}.
	 * @return
	 * @since 3.0
	 */
	<T> GroupPage<T> queryForGroupPage(String collection, Query query, Class<T> clazz, RequestMethod method);

	/**
	 * Execute the query against Solr and return result as {@link StatsPage}.
	 * 
	 * @param query must not be {@literal null}.
	 * @param clazz must not be {@literal null}.
	 * @return
	 * @size 1.4
	 */
	<T> StatsPage<T> queryForStatsPage(Query query, Class<T> clazz);

	/**
	 * Execute the query against Solr and return result as {@link StatsPage}.
	 *
	 * @param collection must not be {@literal null}.
	 * @param query must not be {@literal null}.
	 * @param clazz must not be {@literal null}.
	 * @return
	 * @size 3.0
	 */
	<T> StatsPage<T> queryForStatsPage(String collection, Query query, Class<T> clazz);

	/**
	 * Execute the query against Solr and return result as {@link StatsPage}.
	 * 
	 * @param query must not be {@literal null}.
	 * @param clazz must not be {@literal null}.
	 * @param method must not be {@literal null}.
	 * @return
	 * @since 2.0
	 */
	<T> StatsPage<T> queryForStatsPage(Query query, Class<T> clazz, RequestMethod method);

	/**
	 * Execute the query against Solr and return result as {@link StatsPage}.
	 *
	 * @param collection must not be {@literal null}.
	 * @param query must not be {@literal null}.
	 * @param clazz must not be {@literal null}.
	 * @param method must not be {@literal null}.
	 * @return
	 * @since 3.0
	 */
	<T> StatsPage<T> queryForStatsPage(String collection, Query query, Class<T> clazz, RequestMethod method);

	/**
	 * Execute the query against Solr and return result as page.
	 *
	 * @param query must not be {@literal null}.
	 * @param clazz must not be {@literal null}.
	 * @return never {@literal null}.
	 * @since 2.1
	 */
	<T, S extends Page<T>> S query(Query query, Class<T> clazz);

	/**
	 * Execute the query against Solr and return result as page.
	 *
	 * @param collection must not be {@literal null}.
	 * @param query must not be {@literal null}.
	 * @param clazz must not be {@literal null}.
	 * @return never {@literal null}.
	 * @since 3.0
	 */
	<T, S extends Page<T>> S query(String collection, Query query, Class<T> clazz);

	/**
	 * Execute the query against Solr and return result as page.
	 *
	 * @param query must not be {@literal null}.
	 * @param clazz must not be {@literal null}.
	 * @param method must not be {@literal null}.
	 * @return never {@literal null}.
	 * @since 2.1
	 */
	<T, S extends Page<T>> S query(Query query, Class<T> clazz, RequestMethod method);

	/**
	 * Execute the query against Solr and return result as page.
	 *
	 * @param collection must not be {@literal null}.
	 * @param query must not be {@literal null}.
	 * @param clazz must not be {@literal null}.
	 * @param method must not be {@literal null}.
	 * @return never {@literal null}.
	 * @since 3.0
	 */
	<T, S extends Page<T>> S query(String collection, Query query, Class<T> clazz, RequestMethod method);

	/**
	 * Executes a realtime get using given id.
	 * 
	 * @param id must not be {@literal null}.
	 * @param clazz must not be {@literal null}.
	 * @return
	 * @since 1.4
	 */
	<T> T getById(Serializable id, Class<T> clazz);

	/**
	 * Executes a realtime get using given id.
	 *
	 * @param collection must not be {@literal null}.
	 * @param id must not be {@literal null}.
	 * @param clazz must not be {@literal null}.
	 * @return
	 * @since 3.0
	 */
	<T> T getById(String collection, Serializable id, Class<T> clazz);

	/**
	 * Executes a realtime get using given ids.
	 * 
	 * @param ids must not be {@literal null}.
	 * @param clazz must not be {@literal null}.
	 * @return
	 * @since 1.4
	 */
	<T> Collection<T> getById(Collection<? extends Serializable> ids, Class<T> clazz);

	/**
	 * Executes a realtime get using given ids.
	 *
	 * @param collection must not be {@literal null}.
	 * @param ids must not be {@literal null}.
	 * @param clazz must not be {@literal null}.
	 * @return
	 * @since 3.0
	 */
	<T> Collection<T> getById(String collection, Collection<? extends Serializable> ids, Class<T> clazz);

	/**
	 * Send commit command {@link SolrClient#commit()}
	 */
	void commit();

	/**
	 * Send commit command {@link SolrClient#commit()}
	 * 
	 * @since 3.0
	 */
	void commit(String collection);

	/**
	 * Send soft commmit command {@link SolrClient#commit(boolean, boolean, boolean)}
	 */
	void softCommit();

	/**
	 * Send soft commmit command {@link SolrClient#commit(boolean, boolean, boolean)}
	 * 
	 * @since 3.9
	 */
	void softCommit(String collection);

	/**
	 * send rollback command {@link SolrClient#rollback()}
	 */
	void rollback();

	/**
	 * send rollback command {@link SolrClient#rollback()}
	 * 
	 * @since 3.0
	 */
	void rollback(String collection);

	/**
	 * Convert given bean into a solrj InputDocument
	 * 
	 * @param bean
	 * @return
	 */
	SolrInputDocument convertBeanToSolrInputDocument(Object bean);

	/**
	 * @return Converter in use
	 */
	SolrConverter getConverter();

	/**
	 * Execute action within callback
	 * 
	 * @param action
	 * @return
	 */
	<T> T execute(SolrCallback<T> action);

	/**
	 * Get the {@link SchemaOperations} executable.
	 *
	 * @param collection
	 * @return never {@literal null}.
	 * @since 2.1
	 */
	SchemaOperations getSchemaOperations(String collection);

}