• Home
• nl.vpro.media
• media-domain
• 8.3.0
• source code
• Title.java

×

Project download

Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance.
Project price only 1 $

You can buy this project and download/modify it how often you want.

nl.vpro.domain.media.support.Title Maven / Gradle / Ivy

package nl.vpro.domain.media.support;

import java.io.Serial;
import java.io.Serializable;

import jakarta.persistence.*;
import jakarta.validation.constraints.NotNull;
import jakarta.validation.constraints.Size;
import jakarta.xml.bind.Unmarshaller;
import jakarta.xml.bind.annotation.*;

import org.checkerframework.checker.nullness.qual.NonNull;

import com.fasterxml.jackson.annotation.JsonProperty;
import com.fasterxml.jackson.annotation.JsonPropertyOrder;

import nl.vpro.domain.*;
import nl.vpro.domain.media.MediaObject;
import nl.vpro.validation.NoHtml;

/**
 * A {@link MediaObject} can have more than one title which should differ in type and
 * owner.
 * 

 * To some extent a titles type describes a usage scenario. In most cases the main title
 * will be used.
 * 

 * The title owner describes the origin of the title. Several media suppliers provide
 * their own titles. To prevent conflicts while updating incoming data, all titles are
 * stored for later usage. With the restriction that there are no titles t1 and t2 such
 * that t1.equals(t2).
 * 

 * This class confirms to a natural ordering consistent with equals based on its type
 * and owner. Beware of the fact that the title value itself has no part in the ordering
 * algorithm. Two titles are equal if their owner and type are equal. When adding a title
 * to a SortedSet which already contains an equal title, the added title automatically
 * replaces the existing title.
 * 

 * The ordering of titles is dictated by the order (ordinal numbers) of the enum values
 * for a titles type and ownertype.
 *
 * @author Roelof Jan Koekoek
 * @see TextualType
 * @see OwnerType
 * @since 0.4
 */
@Entity
@Cacheable
@XmlAccessorType(XmlAccessType.NONE)
@XmlType(name = "titleType", namespace = Xmlns.MEDIA_NAMESPACE)
@JsonPropertyOrder({"value", "owner", "type"})
public class Title extends AbstractOwnedText