EDIT

/**

* Copyright (C) 2007 EDIT

* European Distributed Institute of Taxonomy

* http://www.e-taxonomy.eu

*

* The contents of this file are subject to the Mozilla Public License Version 1.1

* See LICENSE.TXT at the top of this package for the full license terms.

*/

package eu.etaxonomy.cdm.api.service;

import java.io.IOException;

import java.util.Collection;

import java.util.HashMap;

import java.util.List;

import java.util.Map;

import java.util.Optional;

import java.util.Set;

import java.util.UUID;

import org.hibernate.criterion.Criterion;

import eu.etaxonomy.cdm.api.service.config.NameDeletionConfigurator;

import eu.etaxonomy.cdm.api.service.dto.TypeDesignationStatusFilter;

import eu.etaxonomy.cdm.api.service.pager.Pager;

import eu.etaxonomy.cdm.api.service.search.DocumentSearchResult;

import eu.etaxonomy.cdm.api.service.search.LuceneParseException;

import eu.etaxonomy.cdm.api.service.search.SearchResult;

import eu.etaxonomy.cdm.api.utility.TaxonNamePartsFilter;

import eu.etaxonomy.cdm.model.common.Language;

import eu.etaxonomy.cdm.model.name.HomotypicalGroup;

import eu.etaxonomy.cdm.model.name.HybridRelationship;

import eu.etaxonomy.cdm.model.name.HybridRelationshipType;

import eu.etaxonomy.cdm.model.name.INonViralName;

import eu.etaxonomy.cdm.model.name.NameRelationship;

import eu.etaxonomy.cdm.model.name.NameRelationshipType;

import eu.etaxonomy.cdm.model.name.NomenclaturalCode;

import eu.etaxonomy.cdm.model.name.NomenclaturalStatus;

import eu.etaxonomy.cdm.model.name.Rank;

import eu.etaxonomy.cdm.model.name.SpecimenTypeDesignation;

import eu.etaxonomy.cdm.model.name.SpecimenTypeDesignationStatus;

import eu.etaxonomy.cdm.model.name.TaxonName;

import eu.etaxonomy.cdm.model.name.TypeDesignationBase;

import eu.etaxonomy.cdm.model.name.TypeDesignationStatusBase;

import eu.etaxonomy.cdm.model.occurrence.FieldUnit;

import eu.etaxonomy.cdm.persistence.dao.common.Restriction;

import eu.etaxonomy.cdm.persistence.dao.initializer.IBeanInitializer;

import eu.etaxonomy.cdm.persistence.dto.TaxonNameParts;

import eu.etaxonomy.cdm.persistence.dto.UuidAndTitleCache;

import eu.etaxonomy.cdm.persistence.query.MatchMode;

import eu.etaxonomy.cdm.persistence.query.OrderHint;

import eu.etaxonomy.cdm.strategy.cache.TaggedText;

import eu.etaxonomy.cdm.strategy.parser.NonViralNameParserImpl;

public interface INameService

        extends IIdentifiableEntityService<TaxonName> {

	/**

	 * Deletes a name. Depending on the configurator state links to the name will either be

	 * deleted or throw exceptions.<BR>

	 * If name is <code>null</code> this method has no effect.

	 * @param name

	 * @param config

	 *

	 */

	public DeleteResult delete(UUID nameUUID, NameDeletionConfigurator config);

	/**

	 * Creates specimen duplicate based on the given type specimen which will be assigned as a type

	 * of the given name.<br>

	 * The specimen will only differ in accession number, collection and type status and will be attached

	 * to the same {@link FieldUnit}

	 * @param name the name where this type designation will be added to

	 * @param baseDesignation the type specimen of this designation is cloned to create the new specimen

 	 * @param accessionNumber the accession number of the cloned specimen

 	 * @param barcode the barcode of the cloned specimen

 	 * @param catalogNumber the catalog number of the cloned specimen

	 * @param collectionUuid the collection the cloned specimen belongs to

	 * @param typeStatus the type status of the cloned specimen

	 * @return an {@link UpdateResult}

	 */

    public UpdateResult cloneTypeDesignation(UUID nameUuid, SpecimenTypeDesignation baseDesignation,

            String accessionNumber, String barcode, String catalogNumber,

            UUID collectionUuid, SpecimenTypeDesignationStatus typeStatus);

	/**

	 * Removes the given type designation from the given taxon name and deletes it from

	 * the database if it is not connected to any other name.

	 * If <code>typeDesignation</code> is <code>null</code> all type designations are deleted

	 * from the given taxon name. If <code>name</code> is <code>null</code> all names are removed from

	 * the given type designation. If both are <code>null</code> nothing happens.

	 * @param typeDesignation

	 * @param name

	 * @return

	 */

	public DeleteResult deleteTypeDesignation(TaxonName name, TypeDesignationBase<?> typeDesignation);

	/**

	 * Removes the given type designation from the given taxon name and deletes it from

	 * the database if it is not connected to any other name.

	 * If <code>typeDesignation</code> is <code>null</code> all type designations are deleted

	 * from the given taxon name. If <code>name</code> is <code>null</code> all names are removed from

	 * the given type designation. If both are <code>null</code> nothing happens.

	 * @param typeDesignation

	 * @param name

	 * @return

	 */

	public DeleteResult deleteTypeDesignation(UUID nameUuid, UUID typeDesignationUuid);

	/**

	 * Saves the given type designations.

	 * @param typeDesignationCollection

	 * @return

	 */

	public Map<UUID, TypeDesignationBase<?>> saveTypeDesignationAll(Collection<TypeDesignationBase<?>> typeDesignationCollection);

	/**

	 * Saves the given homotypical groups.

	 * @param homotypicalGroups

	 * @return

	 */

	public Map<UUID, HomotypicalGroup> saveAllHomotypicalGroups(Collection<HomotypicalGroup> homotypicalGroups);

	/**

	 * Returns all nomenclatural status.

	 * @param limit

	 * @param start

	 * @return

	 */

	public List<NomenclaturalStatus> getAllNomenclaturalStatus(int limit, int start);

	/**

	 * Returns all type designations.

	 * @param limit

	 * @param start

	 * @return

	 */

	public List<TypeDesignationBase<?>> getAllTypeDesignations(int limit, int start);

    public TypeDesignationBase<?> loadTypeDesignation(int id, List<String> propertyPaths);

    public TypeDesignationBase<?> loadTypeDesignation(UUID uuid, List<String> propertyPaths);

    public List<TypeDesignationBase<?>> loadTypeDesignations(List<UUID> uuids, List<String> propertyPaths);

	/**

	 * Returns all NonViralNames with a name cache that matches the given string

	 * @param name

	 * @return

	 */

	public List<TaxonName> getNamesByNameCache(String nameCache);

	/**

	 * Returns all NonViralNames with a title cache that matches the given string

	 * using the given match mode and initialization strategy

	 *

	 * @param name

	 * @param matchMode must not be <code>NULL</code>

	 * @param propertyPaths

	 * @return

	 */

	public List<TaxonName> findNamesByTitleCache(String titleCache, MatchMode matchMode, List<String> propertyPaths);

	/**

     * Supports using wildcards in the query parameters.

     * If a name part passed to the method contains the asterisk character ('*') it will be translated into '%' the related field is search with a LIKE clause.

     * <p>

     * A query parameter which is passed as <code>NULL</code> value will be ignored. A parameter passed as {@link Optional} object containing a <code>NULL</code> value will be used

     * to filter select taxon names where the according field is <code>null</code>.

     *

     * @param filter

     * @param infraGenericEpithet

     * @param specificEpithet

     * @param infraSpecificEpithet

     * @param rank

     *     Only names having the specified rank are taken into account.

     * @param excludedNamesUuids

     *     Names to be excluded from the result set

     * @return

     */

	public Pager<TaxonNameParts> findTaxonNameParts(Optional<String> genusOrUninomial,

            Optional<String> infraGenericEpithet, Optional<String> specificEpithet,

            Optional<String> infraSpecificEpithet, Rank rank, Set<UUID> excludedNamesUuids,

            Integer pageSize, Integer pageIndex, List<OrderHint> orderHints);

	/**

     * <b>This method behaves differently compared to {@link #findTaxonNameParts(Optional, Optional, Optional, Optional, Rank, Integer, Integer, List)}!</b>

     * <p>

     * The {@link TaxonNamePartsFilter} defines the rank and fixed name parts for the search process.

     * For example: In case the <code>rank</code> is "genus", the <code>genusOrUninomial</code> will be used as search parameter which needs to match exactly.

     * The <code>namePartQueryString</code> will be used to do a wildcard search on the specificEpithet.

     * <p>

     * For name part lookup purposes the <code>TaxonNameParts</code> in the result list can be asked to return the relavant name part by

     * calling {@link TaxonNameParts#nameRankSpecificNamePart(TaxonName)}

     *

     *

     * @param filter

     * @return

     */

	public Pager<TaxonNameParts> findTaxonNameParts(TaxonNamePartsFilter filter, String namePartQueryString, Integer pageSize, Integer pageIndex, List<OrderHint> orderHints);

	/**

	 * Returns all NonViralNames with a name cache that matches the given string

	 * using the given match mode and initialization strategy

	 *

	 * @param name

	 * @param matchMode

	 * @param propertyPaths

	 * @return

	 */

	public List<TaxonName> findNamesByNameCache(String nameCache, MatchMode matchMode, List<String> propertyPaths);

	/**

	 * Fuzzy matching for the taxon name elements. The input name is first atomised using the {@link NonViralNameParserImpl}

	 * into its separate parts (genusOrUninomial,infraGenericEpithet,specificEpithet,infraGenericEpithet,authorshipCache).

	 * Each field is then matched separately with the same accuracy parameter.

	 *

	 * @param name taxon name to fuzzy match

	 * @param accuracy value > 0.0 and < 1.0 which determines the accuracy of the result.

	 * @param languages list of languages to consider when matching (currently not used)

	 * @param highlightFragments

	 * @param propertyPaths

	 * @param maxNoOfResults

	 * @return

	 * @throws IOException

	 * @throws LuceneParseException

	 */

	public List<SearchResult<TaxonName>> findByNameFuzzySearch(

            String name,

            float accuracy,

            List<Language> languages,

            boolean highlightFragments,

            List<String> propertyPaths,

            int maxNoOfResults) throws IOException, LuceneParseException;

	/**

	 * Fuzzy matching for the taxon name elements using only the lucene index.

	 *

	 * The input name is first atomised using the {@link NonViralNameParserImpl}

	 * into its separate parts (genusOrUninomial,infraGenericEpithet,specificEpithet,infraGenericEpithet,authorshipCache).

	 * Each field is then matched separately with the same accuracy parameter.

	 *

	 * @param name taxon name to fuzzy match

	 * @param accuracy value > 0.0 and < 1.0 which determines the accuracy of the result.

	 * @param languages list of languages to consider when matching (currently not used)

	 * @param highlightFragments

	 * @param maxNoOfResults

	 * @return

	 * @throws IOException

	 * @throws LuceneParseException

	 */

    public List<DocumentSearchResult> findByNameFuzzySearch(

            String name,

            float accuracy,

            List<Language> languages,

            boolean highlightFragments,

            int maxNoOfResults) throws IOException, LuceneParseException;

	/**

	 * Fuzzy matching against the name cache using only the lucene index.

	 *

	 *

	 * @param name taxon name to fuzzy match

	 * @param accuracy value > 0.0 and < 1.0 which determines the accuracy of the result.

	 * @param languages list of languages to consider when matching (currently not used)

	 * @param highlightFragments

	 * @param maxNoOfResults

	 * @return

	 * @throws IOException

	 * @throws LuceneParseException

	 */

    public List<DocumentSearchResult> findByFuzzyNameCacheSearch(

            String name,

            float accuracy,

            List<Language> languages,

            boolean highlightFragments,

            int maxNoOfResults) throws IOException, LuceneParseException;

	/**

	 * Exact matching for the taxon name elements using only the lucene index.

	 *

	 * The input name is first atomised using the {@link NonViralNameParserImpl}

	 * into its separate parts (genusOrUninomial,infraGenericEpithet,specificEpithet,infraGenericEpithet,authorshipCache).

	 * Each field is then matched separately with the same accuracy parameter.

	 *

	 * @param name taxon name to fuzzy match

	 * @param wildcard boolean flag to indicate whether a wildcard '*' should be added at the end of the query

	 * @param languages list of languages to consider when matching (currently not used)

	 * @param highlightFragments

	 * @param maxNoOfResults

	 * @return

	 * @throws IOException

	 * @throws LuceneParseException

	 */

    public List<DocumentSearchResult> findByNameExactSearch(

            String name,

            boolean wildcard,

            List<Language> languages,

            boolean highlightFragments,

            int maxNoOfResults) throws IOException, LuceneParseException;

	// TODO: Remove getNamesByName() methods. Use findNamesByTitle() instead.

    public List<HomotypicalGroup> getAllHomotypicalGroups(int limit, int start);

	/**

     * Returns all or a page of all taxon name relationships in the database.

     * The result can be filtered by relationship types.

     * It does NOT contain hybrid relationships

     * (see {@link #listHybridRelationships(Set, Integer, Integer, List, List)})

     *

     * @param types The name relationship type filter, if <code>null</code> no filter is set, if empty the result will also be empty

     * @param pageSize the page size

     * @param pageStart the number of the page

     * @param orderHints the order hints

     * @param propertyPaths the property path to initialize the resulting objects

     * @return list of name relationships matching the filter criteria

     */

    public List<NameRelationship> listNameRelationships(Set<NameRelationshipType> types,

            Integer pageSize, Integer pageNumber, List<OrderHint> orderHints, List<String> propertyPaths);

    /**

     * Returns all or a page of all hybrid relationships in the database.

     * The result can be filtered by relationship types.

     * It does NOT contain ordinary name relationships

     * (see {@link #listNameRelationships(Set, Integer, Integer, List, List)})

     *

     * @param types The hybrid relationship type filter, if <code>null</code> no filter is set, if empty the result will also be empty

     * @param pageSize the page size

     * @param pageStart the number of the page

     * @param orderHints the order hints

     * @param propertyPaths the property path to initialize the resulting objects

     * @return list of hybrid relationships matching the filter criteria

     */

    public List<HybridRelationship> listHybridRelationships(Set<HybridRelationshipType> types,

            Integer pageSize, Integer pageNumber, List<OrderHint> orderHints, List<String> propertyPaths);

	/**

	 * Return a List of name relationships in which this name is related to

	 * another name, optionally filtered by relationship type

	 *

	 * @param name

	 *            the name on either the <i>"from side"</i> or on the

	 *            <i>"to side"</i> of the relationship, depending on the

	 *            <code>direction</code> of the relationship.

	 * @param direction

	 *            the direction of the NameRelationship, may be null to return all relationships

	 * @param type

	 *            the relationship type (or null to return all relationships)

	 * @param pageSize

	 *            The maximum number of relationships returned (can be null for

	 *            all relationships)

	 * @param pageNumber

	 *            The offset (in pageSize chunks) from the start of the result

	 *            set (0 - based)

	 * @param orderHints

	 *            may be null

	 * @param propertyPaths

	 *            properties to initialize - see

	 *            {@link IBeanInitializer#initialize(Object, List)}

	 * @return a Pager of NameRelationship instances

	 */

	public List<NameRelationship> listNameRelationships(TaxonName name,  NameRelationship.Direction direction, NameRelationshipType type, Integer pageSize, Integer pageNumber, List<OrderHint> orderHints, List<String> propertyPaths);

	/**

	 * Return a List of name relationships in which this name is related to another name, optionally filtered

	 * by relationship type

	 *

	 * @param name the name on the <i>"from side"</i> of the relationship

	 * @param direction the direction of the NameRelationship

	 * @param type the relationship type (or null to return all relationships)

	 * @param pageSize The maximum number of relationships returned (can be null for all relationships)

	 * @param pageNumber The offset (in pageSize chunks) from the start of the result set (0 - based)

	 * @param orderHints may be null

	 * @param propertyPaths properties to initialize - see {@link IBeanInitializer#initialize(Object, List)}

	 * @return a Pager of NameRelationship instances

	 */

	public Pager<NameRelationship> pageNameRelationships(TaxonName name,  NameRelationship.Direction direction, NameRelationshipType type, Integer pageSize, Integer pageNumber, List<OrderHint> orderHints, List<String> propertyPaths);

	/**

	 * Return a List of relationships in which this name is related to another name, optionally filtered

	 * by relationship type

	 *

	 * @param name the name on the <i>"from side"</i> of the relationship

	 * @param type the relationship type (or null to return all relationships)

	 * @param pageSize The maximum number of relationships returned (can be null for all relationships)

	 * @param pageNumber The offset (in pageSize chunks) from the start of the result set (0 - based)

	 * @param orderHints may be null

	 * @param propertyPaths properties to initialize - see {@link IBeanInitializer#initialize(Object, List)}

	 * @return a Pager of NameRelationship instances

	 * @deprecated use {@link #listNameRelationships(TaxonName, eu.etaxonomy.cdm.model.common.RelationshipBase.Direction, NameRelationshipType, Integer, Integer, List, List)} instead

	 */

	@Deprecated

	public List<NameRelationship> listFromNameRelationships(TaxonName name,  NameRelationshipType type, Integer pageSize, Integer pageNumber, List<OrderHint> orderHints, List<String> propertyPaths);

	/**

	 * Return a List of relationships in which this name is related to another name, optionally filtered

	 * by relationship type

	 *

	 * @param name the name on the <i>"from side"</i> of the relationship

	 * @param type the relationship type (or null to return all relationships)

	 * @param pageSize The maximum number of relationships returned (can be null for all relationships)

	 * @param pageNumber The offset (in pageSize chunks) from the start of the result set (0 - based)

	 * @param orderHints may be null

	 * @param propertyPaths properties to initialize - see {@link IBeanInitializer#initialize(Object, List)}

	 * @return a Pager of NameRelationship instances

	 * @deprecated use {@link #pageNameRelationships(TaxonName, eu.etaxonomy.cdm.model.common.RelationshipBase.Direction, NameRelationshipType, Integer, Integer, List, List)} instead

	 */

	@Deprecated

	public Pager<NameRelationship> pageFromNameRelationships(TaxonName name,  NameRelationshipType type, Integer pageSize, Integer pageNumber, List<OrderHint> orderHints, List<String> propertyPaths);

	/**

	 * Return a List of relationships in which another name is related to this name, optionally filtered

	 * by relationship type

	 *

	 * @param name the name on the <i>"to side"</i> of the relationship

	 * @param type the relationship type (or null to return all relationships)

	 * @param pageSize The maximum number of relationships returned (can be null for all relationships)

	 * @param pageNumber The offset (in pageSize chunks) from the start of the result set (0 - based)

	 * @param orderHints may be null

	 * @param propertyPaths properties to initialize - see {@link IBeanInitializer#initialize(Object, List)}

	 * @return a Pager of NameRelationship instances

	 * @deprecated use {@link #listNameRelationships(TaxonName, eu.etaxonomy.cdm.model.common.RelationshipBase.Direction, NameRelationshipType, Integer, Integer, List, List)} instead

	 */

	@Deprecated

	public List<NameRelationship> listToNameRelationships(TaxonName name,  NameRelationshipType type, Integer pageSize, Integer pageNumber, List<OrderHint> orderHints, List<String> propertyPaths);

	/**

	 * Return a List of relationships in which another name is related to this name, optionally filtered

	 * by relationship type

	 *

	 * @param name the name on the <i>"to side"</i> of the relationship

	 * @param type the relationship type (or null to return all relationships)

	 * @param pageSize The maximum number of relationships returned (can be null for all relationships)

	 * @param pageNumber The offset (in pageSize chunks) from the start of the result set (0 - based)

	 * @param orderHints may be null

	 * @param propertyPaths properties to initialize - see {@link IBeanInitializer#initialize(Object, List)}

	 * @return a Pager of NameRelationship instances

	 * @deprecated use {@link #pageNameRelationships(TaxonName, eu.etaxonomy.cdm.model.common.RelationshipBase.Direction, NameRelationshipType, Integer, Integer, List, List)} instead

	 */

	@Deprecated

	public Pager<NameRelationship> pageToNameRelationships(TaxonName name,  NameRelationshipType type, Integer pageSize, Integer pageNumber, List<OrderHint> orderHints, List<String> propertyPaths);

	/**

	 * Return a List of hybrids related to this name, optionally filtered

	 * by hybrid relationship type

	 *

	 * @param name the name

	 * @param type the hybrid relationship type (or null to return all hybrids)

	 * @param pageSize The maximum number of hybrid relationships returned (can be null for all relationships)

	 * @param pageNumber The offset (in pageSize chunks) from the start of the result set (0 - based)

	 * @param orderHints may be null

	 * @param propertyPaths properties to initialize - see {@link IBeanInitializer#initialize(Object, List)}

	 * @return a Pager of HybridRelationship instances

	 */

	public Pager<HybridRelationship> getHybridNames(INonViralName name, HybridRelationshipType type, Integer pageSize, Integer pageNumber, List<OrderHint> orderHints, List<String> propertyPaths);

	/**

	 * Return a List of types related to this name, optionally filtered

	 * by type designation status

	 *

	 * @param name the name

	 * @param status the type designation status (or null to return all types)

	 * @param pageSize The maximum number of types returned (can be null for all types)

	 * @param pageNumber The offset (in pageSize chunks) from the start of the result set (0 - based)

	 * @return a Pager of TypeDesignationBase instances

	 */

	public Pager<TypeDesignationBase> getTypeDesignations(TaxonName name,

			SpecimenTypeDesignationStatus status, Integer pageSize, Integer pageNumber);

	public Pager<TypeDesignationBase> getTypeDesignations(TaxonName name,

			SpecimenTypeDesignationStatus status, Integer pageSize, Integer pageNumber, List<String> propertyPaths);

	public List<TypeDesignationBase> getTypeDesignationsInHomotypicalGroup(UUID nameUuid, Integer pageSize,

	        Integer pageNumber, List<String> propertyPaths);

	/**

	 * Returns a List of TaxonName instances that match the properties passed

	 *

	 * @param uninomial

	 * @param infraGenericEpithet

	 * @param specificEpithet

	 * @param infraspecificEpithet

	 * @param rank

	 * @param pageSize The maximum number of names returned (can be null for all names)

	 * @param pageNumber The offset (in pageSize chunks) from the start of the result set (0 - based)

	 * @param orderHints may be null

	 * @param propertyPaths properties to initialize - see {@link IBeanInitializer#initialize(Object, List)}

	 * @return a Pager of TaxonName instances

	 */

	public Pager<TaxonName> searchNames(String uninomial, String infraGenericEpithet, String specificEpithet, String infraspecificEpithet, Rank rank, Integer pageSize, Integer pageNumber, List<OrderHint> orderHints, List<String> propertyPaths);

	/**

	 * Returns a Paged List of TaxonName instances where the default field matches the String queryString (as interpreted by the Lucene QueryParser)

	 *

	 * @param clazz filter the results by class (or pass null to return all TaxonName instances)

	 * @param queryString

	 * @param pageSize The maximum number of names returned (can be null for all matching names)

	 * @param pageNumber The offset (in pageSize chunks) from the start of the result set (0 - based)

	 * @param orderHints

	 *            Supports path like <code>orderHints.propertyNames</code> which

	 *            include *-to-one properties like createdBy.username or

	 *            authorTeam.persistentTitleCache

	 * @param propertyPaths properties to be initialized

	 * @return a Pager TaxonName instances

	 * @see <a href="http://lucene.apache.org/java/2_4_0/queryparsersyntax.html">Apache Lucene - Query Parser Syntax</a>

	 */

	@Override

    public Pager<TaxonName> search(Class<? extends TaxonName> clazz, String queryString, Integer pageSize, Integer pageNumber, List<OrderHint> orderHints, List<String> propertyPaths);

	/**

	 * Returns a map that holds uuid, titleCache pairs of all names in the current database

	 *

	 * @return

	 * 			a <code>Map</code> containing uuid and titleCache of names

	 */

	public List<UuidAndTitleCache> getUuidAndTitleCacheOfNames(Integer limit, String pattern);

	/**

     * Returns a list of names belonging to the synonymy of the taxon

     * @param limit

     * @param taxonUuid

     * @return a list containing uuid and titleCache of names of the synonymy of the given taxon

     */

    public List<UuidAndTitleCache> getUuidAndTitleCacheOfSynonymy(Integer limit, UUID taxonUuid);

	/**

	 * Return a Pager of names matching the given query string, optionally filtered by class, optionally with a particular MatchMode

	 *

	 * @param clazz filter by class - can be null to include all instances of type T

	 * @param queryString the query string to filter by

	 * @param matchmode use a particular type of matching (can be null - defaults to exact matching)

	 * @param criteria additional criteria to filter by

	 * @param pageSize The maximum number of objects returned (can be null for all objects)

	 * @param pageNumber The offset (in pageSize chunks) from the start of the result set (0 - based)

	 * @param propertyPaths properties to initialize - see {@link IBeanInitializer#initialize(Object, List)}

	 * @param orderHints

	 *            Supports path like <code>orderHints.propertyNames</code> which

	 *            include *-to-one properties like createdBy.username or

	 *            authorTeam.persistentTitleCache

	 * @return a paged list of instances of type T matching the queryString

	 */

    public Pager<TaxonName> findByName(Class<TaxonName> clazz, String queryString, MatchMode matchmode,

            List<Criterion> criteria, Integer pageSize, Integer pageNumber, List<OrderHint> orderHints, List<String> propertyPaths);

    /**

     * Returns a homotypical group with the given UUID or null if not homotypical group exists with that UUID

     *

     * @param uuid the uuid of the homotypical group

     * @return a homotypical group

     */

    public HomotypicalGroup findHomotypicalGroup(UUID uuid);

    /**

     * @param uuid

     * @return

     */

    public List<TaggedText> getTaggedName(UUID uuid);

    /**

     * @param nameUuid

     * @return

     */

    public UpdateResult setAsGroupsBasionym(UUID nameUuid);

	public List<HashMap<String, String>> getNameRecords();

    /**

     * @param name

     * @param config

     * @return

     */

    DeleteResult delete(TaxonName name, NameDeletionConfigurator config);

    List<TypeDesignationStatusBase> getTypeDesignationStatusInUse();

    /**

     * Provides a collection of the TypeDesignationStatusBase terms which are in use.

     * Terms having the same label are merged into one filter item.

     *

     * @param preferredLanguage

     * @return

     */

    Collection<TypeDesignationStatusFilter> getTypeDesignationStatusFilterTerms(List<Language> preferredLanguages);

    /**

     * @param uuid

     * @param propertyPaths

     * @return

     */

    NomenclaturalStatus loadNomenclaturalStatus(UUID uuid, List<String> propertyPaths);

    /**

     * @param clazz

     * @param restrictions

     * @param pageSize

     * @param pageIndex

     * @param orderHints

     * @param propertyPaths

     * @param includeUnpublished

     * @return

     */

    public <S extends TaxonName> Pager<S> page(Class<S> clazz, List<Restriction<?>> restrictions, Integer pageSize, Integer pageIndex,

            List<OrderHint> orderHints, List<String> propertyPaths, boolean includeUnpublished);

    /**

     * @param clazz

     * @param queryString

     * @param matchmode

     * @param criteria

     * @param pageSize

     * @param pageNumber

     * @param orderHints

     * @param propertyPaths

     * @return

     */

    public List<TaxonName> findByFullTitle(Class<TaxonName> clazz, String queryString, MatchMode matchmode,

            List<Criterion> criteria, Integer pageSize, Integer pageNumber, List<OrderHint> orderHints,

            List<String> propertyPaths);

    /**

     * Parses a name string and returns a parsed name. If deduplicate is <code>true</code>

     * the parsed parts like nomenclatural reference and authors are deduplicated against the

     * database.

     *

     * @param taxonNameString

     * @param code the nomenclatural code to use

     * @param preferredRank the preferred rank to use if rank is not clearly defined by the taxon name

     * @param doDeduplicate if <code>true</code> the name parts are deduplicated against the database,

     *      but the name itself is NOT deduplicated (this may change in future)

     * @return

     */

    public UpdateResult parseName(String taxonNameString, NomenclaturalCode code, Rank preferredRank, boolean doDeduplicate);

    public UpdateResult parseName(TaxonName nameToBeFilled, String stringToBeParsed, Rank preferredRank, boolean doEmpty, boolean doDeduplicate);

}