Package io.wcm.handler.media

Class Media

  • @ProviderType
public final class Media
extends Object
    Holds information about a media request processed and resolved by MediaHandler.

    • Constructor Detail

      • Media

        public Media​(@NotNull
             @NotNull MediaSource mediaSource,
             @NotNull
             @NotNull MediaRequest mediaRequest)
        Parameters:
        mediaSource - Media source
        mediaRequest - Processed media request

    • Method Detail

      • getMediaSource

        @NotNull
public @NotNull MediaSource getMediaSource()
        Returns:
        Media source

      • getMediaRequest

        @NotNull
public @NotNull MediaRequest getMediaRequest()
        Returns:
        Media handling request

      • setMediaRequest

        public void setMediaRequest​(@NotNull
                            @NotNull MediaRequest mediaRequest)
        Parameters:
        mediaRequest - Media handling request

      • getElement

        public io.wcm.handler.commons.dom.HtmlElement<?> getElement()
        Returns:
        Html element

      • getMarkup

        public String getMarkup()
        Returns:
        Media HTML element serialized to string. Returns null if media element is null.

      • setElement

        public void setElement​(io.wcm.handler.commons.dom.HtmlElement<?> value)
        Parameters:
        value - Html element

      • getUrl

        public String getUrl()
        Returns:
        Media URL

      • setUrl

        public void setUrl​(String value)
        Parameters:
        value - Media URL

      • getAsset

        public Asset getAsset()
        Get media item info that was resolved during media handler processing
        Returns:
        Media item

      • setAsset

        public void setAsset​(Asset asset)
        Set media item that was resolved during media handler processing
        Parameters:
        asset - Media item

      • getRendition

        public Rendition getRendition()
        Get first (and best-match) rendition that was resolved during media handler processing
        Returns:
        Rendition

      • getRenditions

        public Collection<Rendition> getRenditions()
        Get all renditions that were resolved during media handler processing
        Returns:
        Renditions

      • setRenditions

        public void setRenditions​(Collection<Rendition> renditions)
        Set all renditions that was resolved during media handler processing
        Parameters:
        renditions - Renditions

      • getCropDimension

        @Nullable
public @Nullable CropDimension getCropDimension()
        Returns:
        Crop dimensions (optional)

      • setCropDimension

        public void setCropDimension​(@Nullable
                             @Nullable CropDimension cropDimension)
        Parameters:
        cropDimension - Crop dimensions (optional)

      • getRotation

        @Nullable
public @Nullable Integer getRotation()
        Returns:
        Image rotation (optional)

      • setRotation

        public void setRotation​(@Nullable
                        @Nullable Integer rotation)
        Parameters:
        rotation - Image Rotation (optional)

      • getMap

        @Nullable
public @Nullable List<ImageMapArea> getMap()
        Returns:
        Image map (optional)

      • setMap

        public void setMap​(@Nullable
                   @Nullable List<ImageMapArea> map)
        Parameters:
        map - Image map (optional)

      • isValid

        public boolean isValid()
        Returns:
        true if link is valid and was resolved successfully

      • getMediaInvalidReason

        public MediaInvalidReason getMediaInvalidReason()
        Returns:
        Reason why the requested media could not be resolved and is invalid

      • setMediaInvalidReason

        public void setMediaInvalidReason​(MediaInvalidReason mediaInvalidReason)
        Parameters:
        mediaInvalidReason - Reason why the requested media could not be resolved and is invalid