Class MediaContainer

  • All Implemented Interfaces:
    java.io.Serializable, java.lang.Comparable

    public class MediaContainer
    extends GeneratedMediaContainer
    A MediaContainer acts as a container for medias in order to group the "same" image in different formats and resolutions. Different formats / resolutions are represented as instances of the type MediaFormat. The media container offers simple setter / getter methods, to retrieve / store a media in a specified MediaFormat.
    Since:
    3.0-u5
    See Also:
    Serialized Form
    • Constructor Detail

      • MediaContainer

        public MediaContainer()
    • Method Detail

      • createItem

        protected Item createItem​(SessionContext ctx,
                                  ComposedType type,
                                  Item.ItemAttributeMap allAttributes)
                           throws JaloBusinessException
        Description copied from class: Item
        Has to be implemented for each concrete subtype of item. This method is responsible for creating a new item instance ( by calling managers, ejb homes, etc. ) during ComposedType.newInstance(Map).

        In case this method uses any of the attribute values during creation it is required to override Item.getNonInitialAttributes(SessionContext, ItemAttributeMap) too.
        Sn example:

        
         public static final String MY_ATTRIBUTE = "someAttribute"; ... protected Item createItem(SessionContext
         ctx, ComposedType type, Map allAttributes ) throws JaloBusinessException { MyManager man = ... return
         man.createMyItem( (String)allAttributes.get(MY_ATTRIBUTE) );
         // here MY_ATTRIBUTE is used for creation, so it must not be set again } protected Map getNonInitialAttributes(
         SessionContext ctx, Map allAttributes ) { // let superclass remove its own initial attributes Map ret =
         super.getNonInitialAttributes( ctx, allAttributes );
         // remove MY_ATTRIBUTE from all attributes since if has already been set ret.remove(MY_ATTRIBUTE); return ret; }
        
         
        Overrides:
        createItem in class GenericItem
        Parameters:
        ctx - the current session context which this item is created within
        type - the actual item type ( since subtypes may not provide a own jalo class this may be different from the type which this method was implemented for )
        Returns:
        the new item instance
        Throws:
        JaloBusinessException - indicates an error during creation - any changes will be rollbacked
      • getMedia

        public Media getMedia​(MediaFormat format)
        Returns media which is related to this container and has the specified format, otherwise null.
        Parameters:
        format - the format the media is needed for
        Returns:
        media managed by this container with given format or null
      • setMedia

        @Deprecated
        public void setMedia​(Media media)
                      throws JaloInvalidParameterException
        Deprecated.
        since ages
        If this MediaContainer already has a media in the format of the specified media, this media will be replaced by the specified media (old media looses relation to this container).
        Parameters:
        media - the media to set
        Throws:
        JaloInvalidParameterException