org.mapfish.print.attribute.map.MapLayer Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of print-lib Show documentation
Library for generating PDFs and images from online webmapping services
There is a newer version: 3.22.0
package org.mapfish.print.attribute.map;

import com.google.common.base.Optional;
import org.mapfish.print.http.HttpRequestCache;
import org.mapfish.print.http.MfClientHttpRequestFactory;

import java.awt.Graphics2D;

/**
 * Encapsulates the data required to load map data for a layer and render it.
 */
public interface MapLayer {

    /**
     * Attempt to add the layer this layer so that both can be rendered as a single layer.
     * 
     * For example: 2 WMS layers from the same WMS server can be combined into a single WMS layer and the map
     * can be rendered with a single WMS request.
     *
     * @param newLayer the layer to combine with this layer.  The new layer will be rendered
     *         below the current layer.
     * @return If the two layers can be combined then a map layer representing the two layers will be
     *         returned.  If the two layers cannot be combined then Option.absent() will be returned.
     */
    Optional tryAddLayer(MapLayer newLayer);

    /**
     * Get the scale ratio between the tiles resolution and the target resolution. Used to don't scale the
     * tiles on tiled layer.
     */
    double getImageBufferScaling();

    /**
     * Render the layer to the graphics2D object.
     *
     * @param transformer the map transformer containing the map bounds and size.
     */
    void prepareRender(MapfishMapContext transformer);

    /**
     * Render the layer to the graphics2D object.
     *
     * @param graphics2D the graphics object.
     * @param clientHttpRequestFactory The factory to use for making http requests.
     * @param transformer the map transformer containing the map bounds and size.
     * @param jobId the job ID
     */
    void render(
            Graphics2D graphics2D,
            MfClientHttpRequestFactory clientHttpRequestFactory,
            MapfishMapContext transformer,
            String jobId);

    /**
     * Indicate if the layer supports native rotation (e.g. WMS layers with the "angle" parameter).
     *
     * @return True if the layer itself takes care of rotating.
     */
    boolean supportsNativeRotation();

    /**
     * The layer name.
     */
    String getName();

    /**
     * Specify whether layer should be rendered as PNG, JPEG or SVG.
     *
     * @return render type
     */
    RenderType getRenderType();

    /**
     * Cache any needed resources on disk.
     *
     * @param httpRequestCache TODO
     * @param clientHttpRequestFactory client http request factory
     * @param transformer transformer
     * @param jobId the job ID
     */
    void cacheResources(
            HttpRequestCache httpRequestCache,
            MfClientHttpRequestFactory clientHttpRequestFactory,
            MapfishMapContext transformer,
            String jobId);

    /**
     * Gets the opacity.
     *
     * @return the opacity
     */
    double getOpacity();

    /**
     * Enumerated type to specify whether layer should be rendered as PNG, JPEG or SVG.
     */
    enum RenderType {
        /**
         * Unknown Rendering Format (let CreateMapProcessor decide).
         */
        UNKNOWN,
        /**
         * Render as PNG.
         */
        PNG,
        /**
         * Render as JPEG.
         */
        JPEG,
        /**
         * Render as TIFF.
         */
        TIFF,
        /**
         * Render as SVG.
         */
        SVG;

        /**
         * Get RenderType from a string that represents a mime type.
         *
         * @param mimeType string with mime type
         * @return render type
         */
        public static RenderType fromMimeType(final String mimeType) {
            if (mimeType.equals("image/jpeg")) {
                return JPEG;
            } else if (mimeType.equals("image/png")) {
                return PNG;
            } else if (mimeType.matches("image/tiff(-fx)?")) {
                return TIFF;
            } else if (mimeType.matches("image/svg(\\+xml)?")) {
                return SVG;
            } else {
                return UNKNOWN;
            }
        }

        /**
         * Get RenderType from a string that represents a file extension.
         *
         * @param fileExtension string with file extension
         * @return render type
         */
        public static RenderType fromFileExtension(final String fileExtension) {
            final String extensionOrMimeLC = fileExtension.toLowerCase();
            if (extensionOrMimeLC.matches("jpe?g")) {
                return JPEG;
            } else if (extensionOrMimeLC.equals("png")) {
                return PNG;
            } else if (extensionOrMimeLC.matches("tiff?")) {
                return TIFF;
            } else if (extensionOrMimeLC.equals("svg")) {
                return SVG;
            } else {
                return UNKNOWN;
            }
        }
    }
}