2 * DemosceneMusic - Track.java - Copyright © 2012 David Roden
4 * This program is free software: you can redistribute it and/or modify
5 * it under the terms of the GNU General Public License as published by
6 * the Free Software Foundation, either version 3 of the License, or
7 * (at your option) any later version.
9 * This program is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 * GNU General Public License for more details.
14 * You should have received a copy of the GNU General Public License
15 * along with this program. If not, see <http://www.gnu.org/licenses/>.
18 package net.pterodactylus.demoscenemusic.data;
20 import java.util.Collection;
21 import java.util.List;
25 * Data interface for tracks.
27 * @author <a href="mailto:bombe@pterodactylus.net">David ‘Bombe’ Roden</a>
29 public interface Track extends Base {
32 * Defines relationships between tracks.
34 * @author <a href="mailto:bombe@pterodactylus.net">David ‘Bombe’ Roden</a>
36 public enum Relationship {
38 /** The track is the original of a related track. */
41 /** The track is a remix of a related track. */
44 /** The track is a cover version of a related track. */
50 * Returns the name of this track.
52 * @return The name of this track
54 public String getName();
57 * Sets the name of this track.
60 * The name of this track
63 public Track setName(String name);
66 * Returns all artists involved in this track.
68 * @return All involved artists in preferred order
70 public List<Artist> getArtists();
73 * Sets all artists involved in this track.
76 * All involved artists in preferred order
79 public Track setArtists(List<Artist> artists);
82 * Returns all styles of this track.
84 * @return All styles of this track
86 public Collection<Style> getStyles();
89 * Sets all styles of this track.
92 * All styles of this track
95 public Track setStyles(Collection<? extends Style> styles);
98 * Returns the name of this remix. If this track is not a remix,
99 * {@code null} is returned.
101 * @return The name of this remix, or {@code null} if this track is not a
104 public String getRemix();
107 * Sets the name of the remix.
110 * The name of this remix, or {@code null} if this track is not a
114 public Track setRemix(String remix);
117 * Returns all remix artists involved in this track.
119 * @return All remix artists involved in this track
121 public List<Artist> getRemixArtists();
124 * Sets all remix artists involved in this track.
126 * @param remixArtists
127 * All remix artists involved in this track
130 public Track setRemixArtists(List<Artist> remixArtists);
133 * Returns all derivatives of this track. A derivative of a MOD file could
134 * be a WAV or MP3 file.
136 * @return All derivatives of this track
138 public Collection<TrackDerivative> getDerivatives();
141 * Sets the derivatives of this track.
144 * The derivatives of this track
147 public Track setDerivatives(Collection<TrackDerivative> derivatives);
150 * Returns all tracks that are somehow related to this track.
152 * @return All tracks that are related to this track
154 public Map<Relationship, Collection<Track>> getRelatedTracks();
157 * Sets all related tracks.
159 * @param relatedTracks
163 public Track setRelatedTracks(Map<Relationship, Collection<Track>> relatedTracks);
166 * Returns all parties this track was released at.
168 * @return All parties this track was released at
170 public Collection<Party> getParties();
173 * Sets all parties this track was released at.
176 * All parties this track was released at
179 public Track setParties(Collection<Party> parties);