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.remote.controller;

import java.io.IOException;

import java.util.ArrayList;

import java.util.Arrays;

import java.util.Hashtable;

import java.util.Iterator;

import java.util.List;

import java.util.Map;

import java.util.Set;

import java.util.UUID;

import javax.servlet.http.HttpServletRequest;

import javax.servlet.http.HttpServletResponse;

import org.apache.log4j.Logger;

import org.springframework.beans.factory.annotation.Autowired;

import org.springframework.stereotype.Controller;

import org.springframework.web.bind.WebDataBinder;

import org.springframework.web.bind.annotation.InitBinder;

import org.springframework.web.bind.annotation.PathVariable;

import org.springframework.web.bind.annotation.RequestMapping;

import org.springframework.web.bind.annotation.RequestMethod;

import org.springframework.web.bind.annotation.RequestParam;

import org.springframework.web.servlet.ModelAndView;

import eu.etaxonomy.cdm.api.service.INameService;

import eu.etaxonomy.cdm.api.service.ITaxonNodeService;

import eu.etaxonomy.cdm.api.service.ITaxonService;

import eu.etaxonomy.cdm.api.service.ITermService;

import eu.etaxonomy.cdm.api.service.util.TaxonRelationshipEdge;

import eu.etaxonomy.cdm.database.UpdatableRoutingDataSource;

import eu.etaxonomy.cdm.hibernate.HibernateProxyHelper;

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

import eu.etaxonomy.cdm.model.common.RelationshipBase.Direction;

import eu.etaxonomy.cdm.model.location.NamedArea;

import eu.etaxonomy.cdm.model.media.Media;

import eu.etaxonomy.cdm.model.media.MediaRepresentationPart;

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

import eu.etaxonomy.cdm.model.taxon.Synonym;

import eu.etaxonomy.cdm.model.taxon.Taxon;

import eu.etaxonomy.cdm.model.taxon.TaxonBase;

import eu.etaxonomy.cdm.model.taxon.TaxonNode;

import eu.etaxonomy.cdm.model.taxon.TaxonRelationship;

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

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

import eu.etaxonomy.cdm.remote.controller.util.ControllerUtils;

import eu.etaxonomy.cdm.remote.controller.util.IMediaToolbox;

import eu.etaxonomy.cdm.remote.editor.CdmTypePropertyEditor;

import eu.etaxonomy.cdm.remote.editor.DefinedTermBaseList;

import eu.etaxonomy.cdm.remote.editor.MatchModePropertyEditor;

import eu.etaxonomy.cdm.remote.editor.NamedAreaPropertyEditor;

import eu.etaxonomy.cdm.remote.editor.TermBaseListPropertyEditor;

import eu.etaxonomy.cdm.remote.editor.UUIDListPropertyEditor;

import eu.etaxonomy.cdm.remote.editor.UuidList;

import io.swagger.annotations.Api;

/**

 * The TaxonPortalController class is a Spring MVC Controller.

 * <p>

 * The syntax of the mapped service URIs contains the the {datasource-name} path element.

 * The available {datasource-name}s are defined in a configuration file which

 * is loaded by the {@link UpdatableRoutingDataSource}. If the

 * UpdatableRoutingDataSource is not being used in the actual application

 * context any arbitrary {datasource-name} may be used.

 * <p>

 * Methods mapped at type level, inherited from super classes ({@link BaseController}):

 * <blockquote>

 * URI: <b>&#x002F;{datasource-name}&#x002F;portal&#x002F;taxon&#x002F;{taxon-uuid}</b>

 *

 * Get the {@link TaxonBase} instance identified by the <code>{taxon-uuid}</code>.

 * The returned Taxon is initialized by

 * the following strategy {@link #TAXON_INIT_STRATEGY}

 * </blockquote>

 *

 * @author a.kohlbecker

 * @since 20.07.2009

 *

 */

@Controller

@Api("portal_taxon")

@RequestMapping(value = {"/portal/taxon/{uuid}"})

public class TaxonPortalController extends TaxonController{

    public static final Logger logger = Logger.getLogger(TaxonPortalController.class);

    @Autowired

    private INameService nameService;

    @Autowired

    private ITaxonNodeService taxonNodeService;

    @Autowired

    private ITaxonService taxonService;

    @Autowired

    private ITermService termService;

    @Autowired

    private IMediaToolbox mediaToolbox;

    public static final EntityInitStrategy TAXON_INIT_STRATEGY = new EntityInitStrategy(Arrays.asList(new String []{

            "$",

            "sources",

            "statusNote",

            // taxon relations

//            "relationsToThisName.fromTaxon.name",

            // the name

            "name.$",

            "name.nomenclaturalSource.citation.authorship",

            "name.nomenclaturalSource.citation.inReference",

            "name.rank.representations",

            "name.status.type.representations",

            "sec.authorship"

//            "descriptions" // TODO remove

            }));

    public static final EntityInitStrategy TAXON_WITH_CHILDNODES_INIT_STRATEGY = new EntityInitStrategy(Arrays.asList(new String []{

            "taxonNodes.$",

            "taxonNodes.classification.$",

            "taxonNodes.childNodes.$"

            }));

    public static final EntityInitStrategy SIMPLE_TAXON_INIT_STRATEGY = new EntityInitStrategy(Arrays.asList(new String []{

            "$",

            // the name

            "name.$",

            "name.rank.representations",

            "name.status.type.representations",

            "name.nomenclaturalSource.citation.authorship",

            "name.nomenclaturalSource.citation.inReference.authorship",

            "taxonNodes.classification",

            "sec.authorship"

            }));

    public static final EntityInitStrategy SYNONYMY_INIT_STRATEGY = new EntityInitStrategy(Arrays.asList(new String []{

            // initialize homotypical and heterotypical groups; needs synonyms

            "synonyms.$",

            "synonyms.name.status.type.representations",

            "synonyms.name.nomenclaturalSource.citation.authorship",

            "synonyms.name.nomenclaturalSource.citation.inReference",

//            "synonyms.name.homotypicalGroup.typifiedNames.$",

//            "synonyms.name.homotypicalGroup.typifiedNames.taxonBases.$",

            "synonyms.name.combinationAuthorship.$",

            "name.typeDesignations",

            "name.homotypicalGroup.$",

            "name.homotypicalGroup.typifiedNames.$",

            "name.homotypicalGroup.typifiedNames.nomenclaturalSource.citation.authorship",

            "name.homotypicalGroup.typifiedNames.nomenclaturalSource.citation.inReference",

//            "name.homotypicalGroup.typifiedNames.taxonBases.$"

    }));

    private static final EntityInitStrategy TAXONRELATIONSHIP_INIT_STRATEGY = new EntityInitStrategy(Arrays.asList(new String []{

            "$",

            "type.inverseRepresentations",

            "fromTaxon.sec",

            "fromTaxon.name",

            "toTaxon.sec",

            "toTaxon.name"

    }));

    public static final EntityInitStrategy NAMERELATIONSHIP_INIT_STRATEGY = new EntityInitStrategy(Arrays.asList(new String []{

            "$",

            "type.inverseRepresentations",

            "citation",

            "toName.$",

            "toName.nomenclaturalSource.citation.authorship",

            "toName.nomenclaturalSource.citation.inReference",

            "fromName.$",

            "fromName.nomenclaturalSource.citation.authorship",

            "fromName.nomenclaturalSource.citation.inReference",

    }));

    protected static final EntityInitStrategy TAXONDESCRIPTION_INIT_STRATEGY = DescriptionPortalController.DESCRIPTION_INIT_STRATEGY;

    protected static final EntityInitStrategy DESCRIPTION_ELEMENT_INIT_STRATEGY = new EntityInitStrategy(Arrays.asList(new String []{

            "$",

            "sources.citation.authorship",

            "sources.nameUsedInSource",

            "multilanguageText",

            "media",

    }));

//	private static final List<String> NAMEDESCRIPTION_INIT_STRATEGY = Arrays.asList(new String []{

//			"uuid",

//			"feature",

//			"elements.$",

//			"elements.multilanguageText",

//			"elements.media",

//	});

    protected static final EntityInitStrategy TAXONDESCRIPTION_MEDIA_INIT_STRATEGY = new EntityInitStrategy(Arrays.asList(new String []{

            "elements.media"

    }));

    private static final EntityInitStrategy TYPEDESIGNATION_INIT_STRATEGY = new EntityInitStrategy(Arrays.asList(new String []{

            "typeSpecimen.$",

            "citation.authorship.$",

            "typeName",

            "typeStatus"

    }));

    protected static final EntityInitStrategy TAXONNODE_WITH_CHILDNODES_INIT_STRATEGY = new EntityInitStrategy(Arrays.asList(new String []{

            "childNodes.taxon",

    }));

    protected static final EntityInitStrategy TAXONNODE_INIT_STRATEGY = new EntityInitStrategy(Arrays.asList(new String []{

            "taxonNodes.classification",

            "taxonNodes.statusNote.*",

            "taxonNodes.source.citation",

            "acceptedTaxon.taxonNodes.classification",

    }));

    private static final String termTreeUuidPattern = "^/taxon(?:(?:/)([^/?#&\\.]+))+.*";

    public TaxonPortalController(){

        super();

        setInitializationStrategy(TAXON_INIT_STRATEGY.getPropertyPaths());

    }

    @Autowired

    @Override

    public void setService(ITaxonService service) {

        this.service = service;

    }

    @InitBinder

    @Override

    public void initBinder(WebDataBinder binder) {

        super.initBinder(binder);

        binder.registerCustomEditor(NamedArea.class, new NamedAreaPropertyEditor());

        binder.registerCustomEditor(MatchMode.class, new MatchModePropertyEditor());

        binder.registerCustomEditor(Class.class, new CdmTypePropertyEditor());

        binder.registerCustomEditor(UuidList.class, new UUIDListPropertyEditor());

        binder.registerCustomEditor(DefinedTermBaseList.class, new TermBaseListPropertyEditor<>(termService));

    }

    /**

     * Get the synonymy for a taxon identified by the <code>{taxon-uuid}</code>.

     * The synonymy consists

     * of two parts: The group of homotypic synonyms of the taxon and the

     * heterotypic synonymy groups of the taxon. The synonymy is ordered

     * historically by the type designations and by the publication date of the

     * nomenclatural reference

     * <p>

     * URI:

     * <b>&#x002F;{datasource-name}&#x002F;portal&#x002F;taxon&#x002F;{taxon-uuid}&#x002F;synonymy</b>

     *

     *

     * @param request

     * @param response

     * @return a Map with two entries which are mapped by the following keys:

     *         "homotypicSynonymsByHomotypicGroup", "heterotypicSynonymyGroups",

     *         containing lists of {@link Synonym}s which // TODO Auto-generated catch block

                    e.printStackTrace();are initialized using the

     *         following initialization strategy: {@link #SYNONYMY_INIT_STRATEGY}

     *

     * @throws IOException

     */

    @RequestMapping(

            value = {"synonymy"},

            method = RequestMethod.GET)

    public ModelAndView doGetSynonymy(@PathVariable("uuid") UUID taxonUuid,

            @RequestParam(value = "subtree", required = false) UUID subtreeUuid,

            HttpServletRequest request,

            HttpServletResponse response)throws IOException {

        boolean includeUnpublished = NO_UNPUBLISHED;

        if(request != null){

            logger.info("doGetSynonymy() " + requestPathAndQuery(request));

        }

        ModelAndView mv = new ModelAndView();

        Taxon taxon = getCdmBaseInstance(Taxon.class, taxonUuid, response, getTaxonNodeInitStrategy().getPropertyPaths());

        TaxonNode subtree = getSubtreeOrError(subtreeUuid, taxonNodeService, response);

        taxon = checkExistsSubtreeAndAccess(taxon, subtree, NO_UNPUBLISHED, response);

        Map<String, List<?>> synonymy = new Hashtable<>();

        //new

        List<List<Synonym>> synonymyGroups = service.getSynonymsByHomotypicGroup(taxon, SYNONYMY_INIT_STRATEGY.getPropertyPaths());

        if(!includeUnpublished){

            synonymyGroups = removeUnpublishedSynonyms(synonymyGroups);

        }

        synonymy.put("homotypicSynonymsByHomotypicGroup", synonymyGroups.get(0));

        synonymyGroups.remove(0);

        synonymy.put("heterotypicSynonymyGroups", synonymyGroups);

        //old

//        synonymy.put("homotypicSynonymsByHomotypicGroup", service.getHomotypicSynonymsByHomotypicGroup(taxon, SYNONYMY_INIT_STRATEGY));

//        synonymy.put("heterotypicSynonymyGroups", service.getHeterotypicSynonymyGroups(taxon, SYNONYMY_INIT_STRATEGY));

        mv.addObject(synonymy);

        return mv;

    }

    /**

     * @param synonymyGroups

     */

    private List<List<Synonym>> removeUnpublishedSynonyms(List<List<Synonym>> synonymyGroups) {

        List<List<Synonym>> result = new ArrayList<>();

        boolean isHomotypicToAccepted = true;

        for (List<Synonym> oldList : synonymyGroups){

            List<Synonym> newList = new ArrayList<>();

            for (Synonym oldSyn : oldList){

                if (oldSyn.isPublish()){

                    newList.add(oldSyn);

                }

            }

            if (isHomotypicToAccepted || !newList.isEmpty()){

                result.add(newList);

            }

            isHomotypicToAccepted = false;

        }

        return result;

    }

    /**

     * {@inheritDoc}

     */

    @Override

    protected List<String> getTaxonDescriptionInitStrategy() {

        return TAXONDESCRIPTION_INIT_STRATEGY.getPropertyPaths();

    }

    @Override

    protected List<String> getTaxonDescriptionElementInitStrategy() {

        return DESCRIPTION_ELEMENT_INIT_STRATEGY.getPropertyPaths();

    }

    @Override

    protected  EntityInitStrategy getTaxonNodeInitStrategy() {

        return TAXONNODE_INIT_STRATEGY;

    }

    /**

     * Get the list of {@link TaxonRelationship}s for the given

     * {@link TaxonBase} instance identified by the <code>{taxon-uuid}</code>.

     * <p>

     * URI: <b>&#x002F;{datasource-name}&#x002F;portal&#x002F;taxon&#x002F;{taxon-uuid}&#x002F;taxonRelationships</b>

     *

     * @param request

     * @param response

     * @return a List of {@link TaxonRelationship} entities which are initialized

     *         using the following initialization strategy:

     *         {@link #TAXONRELATIONSHIP_INIT_STRATEGY}

     * @throws IOException

     */

    @RequestMapping(

            value = {"taxonRelationships"},

            method = RequestMethod.GET)

    public List<TaxonRelationship> doGetTaxonRelations(@PathVariable("uuid") UUID uuid,

            HttpServletRequest request, HttpServletResponse response)throws IOException {

        boolean includeUnpublished = NO_UNPUBLISHED;

        logger.info("doGetTaxonRelations()" + requestPathAndQuery(request));

        Taxon taxon = getCdmBaseInstance(Taxon.class, uuid, response, (List<String>)null);

        taxon = checkExistsAndAccess(taxon, includeUnpublished, response);

        List<TaxonRelationship> toRelationships = service.listToTaxonRelationships(taxon, null,

                includeUnpublished, null, null, null, TAXONRELATIONSHIP_INIT_STRATEGY.getPropertyPaths());

        List<TaxonRelationship> fromRelationships = service.listFromTaxonRelationships(taxon, null,

                includeUnpublished, null, null, null, TAXONRELATIONSHIP_INIT_STRATEGY.getPropertyPaths());

        List<TaxonRelationship> allRelationships = new ArrayList<>(toRelationships.size() + fromRelationships.size());

        allRelationships.addAll(toRelationships);

        allRelationships.addAll(fromRelationships);

        return allRelationships;

    }

    /**

     * Get the list of {@link NameRelationship}s of the Name associated with the

     * {@link TaxonBase} instance identified by the <code>{taxon-uuid}</code>.

     * <p>

     * URI: <b>&#x002F;{datasource-name}&#x002F;portal&#x002F;taxon&#x002F;{taxon-uuid}&#x002F;nameRelationships</b>

     *

     * @param request

     * @param response

     * @return a List of {@link NameRelationship} entities which are initialized

     *         using the following initialization strategy:

     *         {@link #NAMERELATIONSHIP_INIT_STRATEGY}

     * @throws IOException

     */

    @RequestMapping(

            value = {"toNameRelationships"},

            method = RequestMethod.GET)

    public List<NameRelationship> doGetToNameRelations(@PathVariable("uuid") UUID uuid,

            HttpServletRequest request, HttpServletResponse response)throws IOException {

        logger.info("doGetNameRelations()" + request.getRequestURI());

        boolean includeUnpublished = NO_UNPUBLISHED;

        TaxonBase<?> taxonBase = getCdmBaseInstance(TaxonBase.class, uuid, response, (List<String>)null);

        taxonBase = checkExistsAndAccess(taxonBase, includeUnpublished, response);

        List<NameRelationship> list = nameService.listNameRelationships(taxonBase.getName(), Direction.relatedTo, null, null, 0, null, NAMERELATIONSHIP_INIT_STRATEGY.getPropertyPaths());

        return list;

    }

    /**

     * Get the list of {@link NameRelationship}s of the Name associated with the

     * {@link TaxonBase} instance identified by the <code>{taxon-uuid}</code>.

     * <p>

     * URI: <b>&#x002F;{datasource-name}&#x002F;portal&#x002F;taxon&#x002F;{taxon-uuid}&#x002F;nameRelationships</b>

     *

     * @param request

     * @param response

     * @return a List of {@link NameRelationship} entities which are initialized

     *         using the following initialization strategy:

     *         {@link #NAMERELATIONSHIP_INIT_STRATEGY}

     * @throws IOException

     */

    @RequestMapping(

            value = {"fromNameRelationships"},

            method = RequestMethod.GET)

    public List<NameRelationship> doGetFromNameRelations(@PathVariable("uuid") UUID uuid,

            HttpServletRequest request, HttpServletResponse response)throws IOException {

        logger.info("doGetNameFromNameRelations()" + requestPathAndQuery(request));

        boolean includeUnpublished = NO_UNPUBLISHED;

        TaxonBase<?> taxonBase = getCdmBaseInstance(TaxonBase.class, uuid, response, SIMPLE_TAXON_INIT_STRATEGY.getPropertyPaths());

        taxonBase = checkExistsAndAccess(taxonBase, includeUnpublished, response);

        List<NameRelationship> list = nameService.listNameRelationships(taxonBase.getName(), Direction.relatedFrom, null, null, 0, null, NAMERELATIONSHIP_INIT_STRATEGY.getPropertyPaths());

        return list;

    }

//	@RequestMapping(value = "specimens", method = RequestMethod.GET)

//	public ModelAndView doGetSpecimens(

//			@PathVariable("uuid") UUID uuid,

//			HttpServletRequest request,

//			HttpServletResponse response) throws IOException, ClassNotFoundException {

//		logger.info("doGetSpecimens() - " + request.getRequestURI());

//

//		ModelAndView mv = new ModelAndView();

//

//		List<DerivedUnitFacade> derivedUnitFacadeList = new ArrayList<>();

//

//		// find speciemens in the TaxonDescriptions

//		List<TaxonDescription> taxonDescriptions = doGetDescriptions(uuid, request, response);

//		if (taxonDescriptions != null) {

//

//			for (TaxonDescription description : taxonDescriptions) {

//				derivedUnitFacadeList.addAll( occurrenceService.listDerivedUnitFacades(description, null) );

//			}

//		}

//		// TODO find specimens in the NameDescriptions ??

//

//		// TODO also find type specimens

//

//		mv.addObject(derivedUnitFacadeList);

//

//		return mv;

//	}

    /**

     * Get the {@link Media} attached to the {@link Taxon} instance

     * identified by the <code>{taxon-uuid}</code>.

     *

     * Usage /{datasource-name}/portal/taxon/{taxon-

     * uuid}/media/{mime type

     * list}/{size}[,[widthOrDuration}][,{height}]/

     *

     * Whereas

     * <ul>

     * <li><b>{mime type list}</b>: a comma separated list of mime types, in the

     * order of preference. The forward slashes contained in the mime types must

     * be replaced by a colon. Regular expressions can be used. Each media

     * associated with this given taxon is being searched whereas the first

     * matching mime type matching a representation always rules.</li>

     * <li><b>{size},{widthOrDuration},{height}</b>: <i>not jet implemented</i>

     * valid values are an integer or the asterisk '*' as a wildcard</li>

     * </ul>

     *

     * @param request

     * @param response

     * @return a List of {@link Media} entities which are initialized

     *         using the following initialization strategy:

     *         {@link #TAXONDESCRIPTION_INIT_STRATEGY}

     * @throws IOException

     */

    @RequestMapping(

        value = {"media"},

        method = RequestMethod.GET)

    public List<Media> doGetMedia(

            @PathVariable("uuid") UUID uuid,

            @RequestParam(value = "type", required = false) Class<? extends MediaRepresentationPart> type,

            @RequestParam(value = "mimeTypes", required = false) String[] mimeTypes,

            @RequestParam(value = "relationships", required = false) UuidList relationshipUuids,

            @RequestParam(value = "relationshipsInvers", required = false) UuidList relationshipInversUuids,

            @RequestParam(value = "includeTaxonDescriptions", required = true) Boolean  includeTaxonDescriptions,

            @RequestParam(value = "includeOccurrences", required = true) Boolean  includeOccurrences,

            @RequestParam(value = "includeTaxonNameDescriptions", required = true) Boolean  includeTaxonNameDescriptions,

            @RequestParam(value = "widthOrDuration", required = false) Integer  widthOrDuration,

            @RequestParam(value = "height", required = false) Integer height,

            @RequestParam(value = "size", required = false) Integer size,

            HttpServletRequest request, HttpServletResponse response) throws IOException {

        logger.info("doGetMedia() " + requestPathAndQuery(request));

        List<String> initStrategy = null;

        EntityMediaContext<Taxon> taxonMediaContext = loadMediaForTaxonAndRelated(uuid, relationshipUuids,

                relationshipInversUuids, includeTaxonDescriptions, includeOccurrences, includeTaxonNameDescriptions,

                response, initStrategy, MediaPortalController.MEDIA_INIT_STRATEGY.getPropertyPaths());

        List<Media> mediafilteredForPreferredRepresentations = mediaToolbox.processAndFilterPreferredMediaRepresentations(type, mimeTypes, widthOrDuration, height, size,

                taxonMediaContext.media);

        return mediafilteredForPreferredRepresentations;

    }

    /**

     * @param uuid

     * @param type

     * @param mimeTypes

     * @param relationshipUuids

     * @param relationshipInversUuids

     * @param includeTaxonDescriptions

     * @param includeOccurrences

     * @param includeTaxonNameDescriptions

     * @param widthOrDuration

     * @param height

     * @param size

     * @param response

     * @param initStrategy

     * @return

     * @throws IOException

     * @Deprecated To be replaced by other loadMediaForTaxonAndRelated method

     */

    @Deprecated

    public  EntityMediaContext<Taxon> loadMediaForTaxonAndRelated(UUID uuid,

            UuidList relationshipUuids, UuidList relationshipInversUuids,

            Boolean includeTaxonDescriptions, Boolean includeOccurrences, Boolean includeTaxonNameDescriptions,

            HttpServletResponse response,

            List<String> taxonInitStrategy) throws IOException {

        return loadMediaForTaxonAndRelated(uuid, relationshipUuids, relationshipInversUuids,

                includeTaxonDescriptions, includeOccurrences, includeTaxonNameDescriptions, response, taxonInitStrategy, null);

    }

    /**

     * @param uuid

     * @param type

     * @param mimeTypes

     * @param relationshipUuids

     * @param relationshipInversUuids

     * @param includeTaxonDescriptions

     * @param includeOccurrences

     * @param includeTaxonNameDescriptions

     * @param widthOrDuration

     * @param height

     * @param size

     * @param response

     * @param initStrategy

     * @return

     * @throws IOException

     */

    public  EntityMediaContext<Taxon> loadMediaForTaxonAndRelated(UUID uuid,

            UuidList relationshipUuids, UuidList relationshipInversUuids,

            Boolean includeTaxonDescriptions, Boolean includeOccurrences, Boolean includeTaxonNameDescriptions,

            HttpServletResponse response,

            List<String> taxonInitStrategy, List<String> mediaInitStrategy) throws IOException {

        boolean includeUnpublished = NO_UNPUBLISHED;

        Taxon taxon = getCdmBaseInstance(Taxon.class, uuid, response, taxonInitStrategy);

        taxon = checkExistsAndAccess(taxon, includeUnpublished, response);

        Set<TaxonRelationshipEdge> includeRelationships = ControllerUtils.loadIncludeRelationships(relationshipUuids, relationshipInversUuids, termService);

        List<Media> media = listMediaForTaxon(taxon, includeRelationships,

                includeTaxonDescriptions, includeOccurrences, includeTaxonNameDescriptions, mediaInitStrategy);

        EntityMediaContext<Taxon> entityMediaContext = new EntityMediaContext<Taxon>(taxon, media);

        return entityMediaContext;

    }

    @RequestMapping(

            value = {"subtree/media"},

            method = RequestMethod.GET)

    public List<Media> doGetSubtreeMedia(

            @PathVariable("uuid") UUID uuid,

            @RequestParam(value = "type", required = false) Class<? extends MediaRepresentationPart> type,

            @RequestParam(value = "mimeTypes", required = false) String[] mimeTypes,

            @RequestParam(value = "relationships", required = false) UuidList relationshipUuids,

            @RequestParam(value = "relationshipsInvers", required = false) UuidList relationshipInversUuids,

            @RequestParam(value = "includeTaxonDescriptions", required = true) Boolean  includeTaxonDescriptions,

            @RequestParam(value = "includeOccurrences", required = true) Boolean  includeOccurrences,

            @RequestParam(value = "includeTaxonNameDescriptions", required = true) Boolean  includeTaxonNameDescriptions,

            @RequestParam(value = "widthOrDuration", required = false) Integer  widthOrDuration,

            @RequestParam(value = "height", required = false) Integer height,

            @RequestParam(value = "size", required = false) Integer size,

            HttpServletRequest request, HttpServletResponse response)throws IOException {

        boolean includeUnpublished = NO_UNPUBLISHED;

        logger.info("doGetSubtreeMedia() " + requestPathAndQuery(request));

        List<String> initStrategy = TAXON_WITH_CHILDNODES_INIT_STRATEGY.getPropertyPaths();

        Taxon taxon = getCdmBaseInstance(Taxon.class, uuid, response, initStrategy);

        taxon = checkExistsAndAccess(taxon, includeUnpublished, response);

        Set<TaxonRelationshipEdge> includeRelationships = ControllerUtils.loadIncludeRelationships(relationshipUuids, relationshipInversUuids, termService);

        List<Media> media = listMediaForTaxon(taxon, includeRelationships,

                includeTaxonDescriptions, includeOccurrences, includeTaxonNameDescriptions, null);

        media = addTaxonomicChildrenMedia(includeTaxonDescriptions, includeOccurrences, includeTaxonNameDescriptions, taxon,

                includeRelationships, media);

        List<Media> mediafilteredForPreferredRepresentations = mediaToolbox.processAndFilterPreferredMediaRepresentations(type, mimeTypes, widthOrDuration, height, size,

                media);

        return mediafilteredForPreferredRepresentations;

    }

    /**

     * @param includeTaxonDescriptions

     * @param includeOccurrences

     * @param includeTaxonNameDescriptions

     * @param taxon

     * @param includeRelationships

     * @param media

     */

    public List<Media> addTaxonomicChildrenMedia(Boolean includeTaxonDescriptions, Boolean includeOccurrences,

            Boolean includeTaxonNameDescriptions, Taxon taxon, Set<TaxonRelationshipEdge> includeRelationships,

            List<Media> media) {

        //TODO use treeindex

        //looking for all medias of direct children

        TaxonNode node;

        if (taxon.getTaxonNodes().size()>0){

            Set<TaxonNode> nodes = taxon.getTaxonNodes();

            Iterator<TaxonNode> iterator = nodes.iterator();

            //TaxonNode holen

            node = iterator.next();

            //Check if TaxonNode belongs to the current tree

            node = taxonNodeService.load(node.getUuid(), TAXONNODE_WITH_CHILDNODES_INIT_STRATEGY.getPropertyPaths());

            List<TaxonNode> children = node.getChildNodes();

            Taxon childTaxon;

            for (TaxonNode child : children){

                childTaxon = child.getTaxon();

                if(childTaxon != null) {

                    childTaxon = (Taxon)taxonService.load(childTaxon.getUuid(), NO_UNPUBLISHED, null);

                    media.addAll(listMediaForTaxon(childTaxon, includeRelationships,

                            includeTaxonDescriptions, includeOccurrences, includeTaxonNameDescriptions, MediaPortalController.MEDIA_INIT_STRATEGY.getPropertyPaths()));

                }

            }

        }

        return media;

    }

    /**

     *

     * @param taxon

     * @param includeRelationships

     * @param type

     * @param mimeTypes

     * @param widthOrDuration

     * @param height

     * @param size

     * @return

     */

    private List<Media> listMediaForTaxon(Taxon taxon, Set<TaxonRelationshipEdge> includeRelationships,

            Boolean includeTaxonDescriptions, Boolean includeOccurrences, Boolean includeTaxonNameDescriptions, List<String> propertyPath) {

        List<Media> media = service.listMedia(taxon, includeRelationships,

                false, includeTaxonDescriptions, includeOccurrences, includeTaxonNameDescriptions, propertyPath);

        return media;

    }

    public class EntityMediaContext<T extends IdentifiableEntity> {

        T entity;

        List<Media> media;

        /**

         * @param entity

         * @param media

         */

        public EntityMediaContext(T entity, List<Media> media) {

            this.entity = HibernateProxyHelper.deproxy(entity);

            this.media = media;

        }

        public T getEntity() {

            return entity;

        }

        public List<Media> getMedia() {

            return media;

        }

        /**

         * @param addTaxonomicChildrenMedia

         */

        public void setMedia(List<Media> media) {

            this.media = media;

        }

    }

// ---------------------- code snippet preserved for possible later use --------------------

//	@RequestMapping(

//			value = {"//*/portal/taxon/*/descriptions"}, // mapped as absolute path, see CdmAntPathMatcher

//			method = RequestMethod.GET)

//	public List<TaxonDescription> doGetDescriptionsbyFeatureTree(HttpServletRequest request, HttpServletResponse response)throws IOException {

//		TaxonBase tb = getCdmBase(request, response, null, Taxon.class);

//		if(tb instanceof Taxon){

//			//T O D O this is a quick and dirty implementation -> generalize

//			UUID featureTreeUuid = readValueUuid(request, termTreeUuidPattern);

//

//			FeatureTree featureTree = descriptionService.getFeatureTreeByUuid(featureTreeUuid);

//			Pager<TaxonDescription> p = descriptionService.getTaxonDescriptions((Taxon)tb, null, null, null, null, TAXONDESCRIPTION_INIT_STRATEGY);

//			List<TaxonDescription> descriptions = p.getRecords();

//

//			if(!featureTree.isDescriptionSeparated()){

//

//				TaxonDescription superDescription = TaxonDescription.NewInstance();

//				//put all descriptionElements in superDescription and make it invisible

//				for(TaxonDescription description: descriptions){

//					for(DescriptionElementBase element: description.getElements()){

//						superDescription.addElement(element);

//					}

//				}

//				List<TaxonDescription> separatedDescriptions = new ArrayList<TaxonDescription>(descriptions.size());

//				separatedDescriptions.add(superDescription);

//				return separatedDescriptions;

//			}else{

//				return descriptions;

//			}

//		} else {

//			response.sendError(HttpServletResponse.SC_NOT_FOUND, "invalid type; Taxon expected but " + tb.getClass().getSimpleName() + " found.");

//			return null;

//		}

//	}

}