Edit

    private <T extends IdentifiableEntity> Manifest manifestFor(EntityMediaContext<T> entityMediaContext, String onEntitiyType, String onEntityUuid) throws IOException {

import java.io.IOException;

    /**

     * Extend the set of media representations in <code>media</code>, filter the resulting representations by the

     * attributes defined via the parameters <code>type</code>, <code>size</code>, <code>height</code>, <code>widthOrDuration</code>

     * and <code>mimeTypes</code> and finally return the list of matching MediaRepresentations ordered by the ranging of the match.

     *

     */

            String[] mimeTypes, Integer widthOrDuration, Integer height, Integer size, List<Media> taxonGalleryMedia) throws IOException;

    /**

     * Filters the Media  objects and the contained MediaRepresentations the by the

     * attributes defined via the parameters <code>type</code>, <code>size</code>, <code>height</code>, <code>widthOrDuration</code>

     * and <code>mimeTypes</code> and finally return the media objects which have at lease one matching representation.

     * The MediaRepresentations are also filtered and ordered by the ranging of the match.

     */

    List<Media> filterPreferredMediaRepresentations(List<Media> mediaList, Class<? extends MediaRepresentationPart> type,

            String[] mimeTypes, Integer widthOrDuration, Integer height, Integer size);

    /**

     * Extend the set of media representations in <code>media</code>, filter the resulting representations by the

     * attributes defined via the parameters <code>type</code>, <code>size</code>, <code>height</code>, <code>widthOrDuration</code>

     * and <code>mimeTypes</code> and finally return the best matching MediaRepresentation.

     *

     * @param media

     * @param type

     * @param size

     * @param height

     * @param widthOrDuration

     * @param mimeTypes

     * @param missingValStrategy Strategies for replacing <code>null</code> values with a numeric value.

     * @return

     * @throws IOException

     */

            String[] mimeTypes, MissingValueStrategy missingValStrategy) throws IOException;

import org.springframework.stereotype.Component;

import eu.etaxonomy.cdm.api.service.media.DefaultMediaTransformations;

 * Utility service which which creates volatile object which must not be persisted.

 * <p>

 * By now this class provides methods for filtering {@link Media} and  {@link MediaRepresentation}s

 * <p>

 * See also {@link MediaUriTransformationProcessor} and {@link MediaUriTransformation}

@Component // not used for component scan, see eu.etaxonomy.cdm.remote.config.CdmRemoteConfiguration

            Integer widthOrDuration, Integer height, Integer size, List<Media> mediaList) {

        for(Media media : mediaList) {

        return filterPreferredMediaRepresentations(mediaList, type, mimeTypes, widthOrDuration, height, size);

    public List<Media> filterPreferredMediaRepresentations(List<Media> mediaList, Class<? extends MediaRepresentationPart> type,

            String[] mimeTypes, Integer widthOrDuration, Integer height, Integer size) {

        Map<Media, MediaRepresentation> mediaRepresentationMap = MediaUtils.findPreferredMedia(mediaList, type, mimeTypes, widthOrDuration, height, size, MediaUtils.MissingValueStrategy.MAX);

    /**

     * Read the {@link MediaUriTransformation MediaUriTransformations} from the cdm preferences ({@link PreferencePredicate.MediaRepresentationTransformations}

     * or use the default defined in {@link DefaultMediaTransformations#digilib()}

     *

     */

            if(mediaRepresentationTransformationsLastHash == null || mediaRepresentationTransformationsLastHash != pref.getValue().hashCode()) {

        if(transformations == null) {

            transformations = DefaultMediaTransformations.digilib();

    /**

     * @param trans the list of MediaUriTransformation to be serialized

     * @return the JSON string

     * @throws JsonProcessingException

     */

    static protected String transformationsToJson(List<MediaUriTransformation> trans) throws JsonProcessingException {

      ObjectMapper mapper = new ObjectMapper();

      CollectionType javaType = mapper.getTypeFactory()

              .constructCollectionType(List.class, MediaUriTransformation.class);

      String json = mapper.writerFor(javaType).withDefaultPrettyPrinter().writeValueAsString(trans);

      return json;

    }

    /**

     *

     * @param args

     * @throws JsonProcessingException

     */

    public static void main(String[] args) throws JsonProcessingException {

        System.out.println("Default tansformations for digilib");

        System.out.println("========================================");

        System.out.println(transformationsToJson(DefaultMediaTransformations.digilib()));

    }

/**

* Copyright (C) 2020 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.media;

import java.util.ArrayList;

import java.util.List;

/**

 * Factory class to create default transformations

 *

 * @author a.kohlbecker

 * @since Jul 15, 2020

 */

public class DefaultMediaTransformations {

    /**

     * Create default transformations for the diglilib server:

     * <p>

     * Links:

     * <ul>

     * <li>https://robcast.github.io/digilib/scaler-api.html</li>

     * <li>https://robcast.github.io/digilib/iiif-api.html</li>

     * </ul>

     *

     * @return

     */

    static public List<MediaUriTransformation> digilib() {

        List<MediaUriTransformation> defaultTransformations = new ArrayList<>();

        /*

         * dataPortalPreviewImage:

         * image which fits the default preview image size which is

         * for example used in the taxon general page, max extend of the resulting images is 400px

         */

        String dataPortalPreviewImage = "digilib/Scaler/IIIF/$1!$2/full/!400,400/0/default.jpg";

        /*

         * universalViewerThumbnail:

         * crop to fit into a 200 x 147 preview box, the uvfix=1 parameter is used to

         * prevent the universal viewer from corrupting the last query parameter. UV appends a parameter t with

         * question mark character which causes problems for the URI query parser see https://dev.e-taxonomy.eu/redmine/issues/9132#note-8

         */

        String universalViewerThumbnail = "digilib/Scaler/?fn=$1/$2&mo=crop&dw=200&dh=147&uvfix=1";

        MediaUriTransformation tr1 = new MediaUriTransformation();

        tr1.setPathQueryFragment(new SearchReplace("digilib/Scaler/IIIF/([^\\!]+)\\!([^\\/]+)(.*)", dataPortalPreviewImage));

        tr1.setHost(new SearchReplace("pictures.bgbm.org", "pictures.bgbm.org")); // host part only used for matching, no replace!

        tr1.setMimeType("image/jpeg");

        tr1.setWidth(400);

        tr1.setHeight(400);

        MediaUriTransformation tr2 = new MediaUriTransformation();

        tr2.setPathQueryFragment(new SearchReplace("digilib/Scaler/IIIF/([^\\!]+)\\!([^\\/]+)(.*)", universalViewerThumbnail));

        tr2.setHost(new SearchReplace("pictures.bgbm.org", "pictures.bgbm.org")); // host part only used for matching, no replace!

        tr2.setMimeType("image/jpeg");

        tr2.setWidth(200);

        tr2.setHeight(200);

        MediaUriTransformation tr3 = new MediaUriTransformation();

        tr3.setPathQueryFragment(new SearchReplace("digilib/Scaler/\\?fn=([^\\\\/]+)/(\\w+)(.*)", dataPortalPreviewImage));

        tr3.setHost(new SearchReplace("pictures.bgbm.org", "pictures.bgbm.org")); // host part only used for matching, no replace!

        tr3.setMimeType("image/jpeg");

        tr3.setWidth(400);

        tr3.setHeight(400);

        MediaUriTransformation tr4 = new MediaUriTransformation();

        tr4.setPathQueryFragment(new SearchReplace("digilib/Scaler/\\?fn=([^\\\\/]+)/(\\w+)(.*)", universalViewerThumbnail));

        tr4.setHost(new SearchReplace("pictures.bgbm.org", "pictures.bgbm.org")); // host part only used for matching, no replace!

        tr4.setMimeType("image/jpeg");

        tr4.setWidth(200);

        tr4.setHeight(200);

        defaultTransformations.add(tr2);

        defaultTransformations.add(tr1);

        defaultTransformations.add(tr3);

        defaultTransformations.add(tr4);

        return defaultTransformations;

    }

}