EDIT

* European Distributed Institute of Taxonomy

*

 * A {@link Media media} is any kind of media that represents a media object.

 * This media object can have multiple {@link MediaRepresentation media representations} that differ in MIME-type

 * and/or quality.

 * E.g.

 * (1) an image can have a tiff and a jpg media representation.

 * (2) an formatted text can have a text/html or an application/pdf representation.

    private static final long serialVersionUID = -1927421567263473658L;

    @SuppressWarnings("unused")

    private static final Logger logger = Logger.getLogger(Media.class);

    // private MultilanguageText title = new MultilanguageText();

    @XmlElement(name = "MediaTitle")

    private Map<Language,LanguageString> title = new HashMap<Language,LanguageString>();

    //creation date of the media (not of the record)

    @XmlElement(name = "MediaCreated", type= String.class)

    @XmlJavaTypeAdapter(DateTimeAdapter.class)

    @Type(type="dateTimeUserType")

    @Basic(fetch = FetchType.LAZY)

    private DateTime mediaCreated;

     // TODO once hibernate annotations support custom collection type

    // private MultilanguageText description = new MultilanguageText();

    @XmlElement(name = "MediaDescription")

    private Map<Language,LanguageString> description = new HashMap<Language,LanguageString>();

    //A single medium such as a picture can have multiple representations in files.

    //Common are multiple resolutions or file formats for images for example

    @XmlElementWrapper(name = "MediaRepresentations")

    @XmlElement(name = "MediaRepresentation")

    @OneToMany(mappedBy="media",fetch = FetchType.LAZY)

    @Cascade({CascadeType.SAVE_UPDATE, CascadeType.MERGE, CascadeType.DELETE, CascadeType.DELETE_ORPHAN, CascadeType.REFRESH})

    @NotNull

    @NotEmpty(groups = Level2.class)

    private Set<MediaRepresentation> representations = new HashSet<MediaRepresentation>();

    @XmlElement(name = "Artist")

    @XmlIDREF

    @XmlSchemaType(name = "IDREF")

    @ManyToOne(fetch = FetchType.LAZY)

    @IndexedEmbedded

    @Cascade(CascadeType.SAVE_UPDATE)

    private AgentBase artist;

    /**

     * Factory method

     * @return

     */

    public static Media NewInstance(){

        return new Media();

    }

    /**

     * Factory method which creates a new media, adds a reprsentation including mime type and suffix information

     * and adds to the later a representation part for a given uri and size

     * Returns <code>null</code> if uri is empty

     * @return Media

     */

    public static Media NewInstance(URI uri, Integer size, String mimeType, String suffix){

        MediaRepresentation representation = MediaRepresentation.NewInstance(mimeType, suffix, uri, size);

        if (representation == null){

            return null;

        }

        Media media = new Media();

        media.addRepresentation(representation);

        return media;

    }

    /**

     * Constructor

     */

    protected Media() {

        super();

        setMediaCacheStrategy();

    }

    private void setMediaCacheStrategy() {

        if (getClass() == Media.class){

            this.cacheStrategy = MediaDefaultCacheStrategy.NewInstance();

        }

    }

    public Set<MediaRepresentation> getRepresentations(){

        if(representations == null) {

            this.representations = new HashSet<MediaRepresentation>();

        }

        return this.representations;

    }

    @SuppressWarnings("deprecation")

    public void addRepresentation(MediaRepresentation representation){

        if (representation != null){

            this.getRepresentations().add(representation);

            representation.setMedia(this);

        }

    }

    @SuppressWarnings("deprecation")

    public void removeRepresentation(MediaRepresentation representation){

        this.getRepresentations().remove(representation);

        if (representation != null){

            representation.setMedia(null);

        }

    }

    public AgentBase getArtist(){

        return this.artist;

    }

    public void setArtist(AgentBase artist){

        this.artist = artist;

    }

    public LanguageString getTitle(){

        return getTitle(Language.DEFAULT());

    }

    public LanguageString getTitle(Language language){

        return title.get(language);

    }

    @Transient

    public Map<Language,LanguageString> getAllTitles(){

        if(title == null) {

            this.title = new HashMap<Language,LanguageString>();

        }

        return this.title;

    }

    /**

     * Adds the languageString to the {@link MultilanguageText multilanguage text}

     * used to be the title of <i>this</i> media.

     *

     * @param title		the languageString with the title in a particular language

     * @see    	   		#getTitle()

     * @see    	   		#putTitle(Language String)

     * @deprecated		should follow the put semantic of maps, this method will be removed in v4.0

     * 					Use the {@link #putTitle(LanguageString) putTitle} method instead

     */

    @Deprecated

    public void addTitle(LanguageString title){

        this.putTitle(title);

    }

    public void putTitle(LanguageString title){

        this.title.put(title.getLanguage(), title);

    }

    /**

     * Creates a {@link LanguageString language string} based on the given text string

     * and the given {@link Language language} and adds it to the {@link MultilanguageText multilanguage text}

     * used to be the title of <i>this</i> media.

     *

     * @param text		the title in a particular language

     * @param language	the language in which the title string is formulated

     * @see    	   		#getTitle()

     * @see    	   		#putTitle(LanguageString)

     * @deprecated		should follow the put semantic of maps, this method will be removed in v4.0

     * 					Use the {@link #putTitle(Language, String) putTitle} method instead

     */

    @Deprecated

    public void addTitle(String title, Language language){

        this.putTitle(language, title);

    }

    /**

     * Creates a {@link LanguageString language string} based on the given text string

     * and the given {@link Language language} and adds it to the {@link MultilanguageText multilanguage text}

     * used to be the title of <i>this</i> media.

     *

     * @param language	the language in which the title string is formulated

     * @param text		the title in a particular language

     *

     * @see    	   		#getTitle()

     * @see    	   		#putTitle(LanguageString)

     */

    public void putTitle(Language language, String title){

        this.title.put(language, LanguageString.NewInstance(title, language));

    }

    public void removeTitle(Language language){

        this.title.remove(language);

    }

    @Transient

    public String getTitleCacheByLanguage(Language lang){

        if (cacheStrategy != null){

            return ((MediaDefaultCacheStrategy)cacheStrategy).getTitleCacheByLanguage(this, lang);

        }else{

            return null;

        }

    }

    /*

     * (non-Javadoc)

     * @see eu.etaxonomy.cdm.model.common.IdentifiableEntity#setTitleCache(java.lang.String)

     */

    @Override

    public void setTitleCache(String titleCache) {

        putTitle(LanguageString.NewInstance(titleCache, Language.DEFAULT()));

    }

    /* (non-Javadoc)

     * @see eu.etaxonomy.cdm.model.common.IIdentifiableEntity#getTitleCache()

     */

    @Override

    public String getTitleCache(){

        if (protectedTitleCache){

            return this.titleCache;

        }

        // is title dirty, i.e. equal NULL?

        if (titleCache == null){

            this.titleCache = generateTitle();

            this.titleCache = getTruncatedCache(this.titleCache) ;

        }else{

            //do the same as listeners on dependend objects like representations parts

            //are not yet installed

            this.titleCache = generateTitle();

            this.titleCache = getTruncatedCache(this.titleCache) ;

        }

        return titleCache;

    }

    public DateTime getMediaCreated(){

        return this.mediaCreated;

    }

    public void setMediaCreated(DateTime mediaCreated){

        this.mediaCreated = mediaCreated;

    }

    //************* Descriptions

    public Map<Language,LanguageString> getAllDescriptions(){

        if(this.description == null) {

            this.description = new HashMap<Language,LanguageString>();

        }

        return this.description;

    }

    public LanguageString getDescription(Language language){

        return getAllDescriptions().get(language);

    }

    public void addDescription(LanguageString description){

        this.description.put(description.getLanguage(), description);

    }

    public void addDescription(String text, Language language){

        this.description.put(language, LanguageString.NewInstance(text, language));

    }

    public void removeDescription(Language language){

        this.description.remove(language);

    }

    /* (non-Javadoc)

     * @see java.lang.Object#clone()

     */

    @Override

    public Object clone() throws CloneNotSupportedException{

        Media result = (Media)super.clone();

        //description

        result.description = new HashMap<Language, LanguageString>();

        for (Language language: this.description.keySet()){

            result.description.put(language, this.description.get(language));

        }

        //title

        result.title = new HashMap<Language, LanguageString>();

        for (Language language: this.title.keySet()){

            result.title.put(language, this.title.get(language));

        }

        //media representations

        result.representations = new HashSet<MediaRepresentation>();

        for (MediaRepresentation mediaRepresentation: this.representations){

            result.representations.add((MediaRepresentation)mediaRepresentation.clone());

        }

        //no changes to: artist

        return result;

    }

    public int compareTo(Object o) {

        return 0;

    }