Add short name to groups.
[demoscenemusic.git] / src / main / java / net / pterodactylus / demoscenemusic / data / Group.java
index 8ab2f87..08ce879 100644 (file)
 
 package net.pterodactylus.demoscenemusic.data;
 
+import java.util.Collection;
+
 /**
- * TODO
+ * Data interface for groups.
  *
  * @author <a href="mailto:bombe@pterodactylus.net">David ‘Bombe’ Roden</a>
  */
 public interface Group extends Base {
 
-       public String name();
+       /**
+        * Returns the name of this group.
+        *
+        * @return The name of this group
+        */
+       public String getName();
+
+       /**
+        * Sets the name of this group.
+        *
+        * @param name
+        *            The name of this group
+        * @return This group
+        */
+       public Group setName(String name);
+
+       /**
+        * Returns the short name of this group.
+        *
+        * @return The short name of this group, or {@code null} if this group does
+        *         not have a short name
+        */
+       public String getShortName();
 
-       public Group name(String name);
+       /**
+        * Sets the short name of this group.
+        *
+        * @param shortName
+        *            The new short name of this group
+        * @return This group
+        */
+       public Group setShortName(String shortName);
 
-       public String url();
+       /**
+        * Returns all artists belonging to this group.
+        *
+        * @return All artists belonging to this group
+        */
+       public Collection<Artist> getArtists();
 
-       public Group url(String url);
+       /**
+        * Sets all artists belonging to this group.
+        *
+        * @param artists
+        *            All artists belonging to this group
+        * @return This group
+        */
+       public Group setArtists(Collection<Artist> artists);
 
 }