X-Git-Url: https://git.pterodactylus.net/?a=blobdiff_plain;f=src%2Fmain%2Fjava%2Fnet%2Fpterodactylus%2Fsone%2Fdata%2FAlbum.java;h=5a02f199c65b67145299a5e8677248ec115e1d9d;hb=6f1f26e3998cfef155b0cf59152827accea70d30;hp=1e79f89a8738da34ed600ba7f231ef43e1cd07bf;hpb=f313a48bfc36f9968d18b76436739c093b562b7a;p=Sone.git

diff --git a/src/main/java/net/pterodactylus/sone/data/Album.java b/src/main/java/net/pterodactylus/sone/data/Album.java
index 1e79f89..5a02f19 100644
--- a/src/main/java/net/pterodactylus/sone/data/Album.java
+++ b/src/main/java/net/pterodactylus/sone/data/Album.java
@@ -1,5 +1,5 @@
 /*
- * Sone - Album.java - Copyright © 2011–2013 David Roden
+ * Sone - Album.java - Copyright © 2011–2016 David Roden
  *
  * This program is free software: you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
@@ -116,16 +116,6 @@ public interface Album extends Identified, Fingerprintable {
 	Sone getSone();
 
 	/**
-	 * Sets the owner of the album. The owner can only be set as long as the
-	 * current owner is {@code null}.
-	 *
-	 * @param sone
-	 * 		The album owner
-	 * @return This album
-	 */
-	Album setSone(Sone sone);
-
-	/**
 	 * Returns the nested albums.
 	 *
 	 * @return The nested albums
@@ -216,23 +206,6 @@ public interface Album extends Identified, Fingerprintable {
 	Image moveImageDown(Image image);
 
 	/**
-	 * Returns the album image of this album, or {@code null} if no album image has
-	 * been set.
-	 *
-	 * @return The image to show when this album is listed
-	 */
-	Image getAlbumImage();
-
-	/**
-	 * Sets the ID of the album image.
-	 *
-	 * @param id
-	 * 		The ID of the album image
-	 * @return This album
-	 */
-	Album setAlbumImage(String id);
-
-	/**
 	 * Returns whether this album contains any other albums or images.
 	 *
 	 * @return {@code true} if this album is empty, {@code false} otherwise
@@ -279,28 +252,38 @@ public interface Album extends Identified, Fingerprintable {
 	String getTitle();
 
 	/**
-	 * Sets the title of this album.
+	 * Returns the description of this album.
 	 *
-	 * @param title
-	 * 		The title of this album
-	 * @return This album
+	 * @return The description of this album
 	 */
-	Album setTitle(String title);
+	String getDescription();
 
 	/**
-	 * Returns the description of this album.
+	 * Returns a modifier for this album.
 	 *
-	 * @return The description of this album
+	 * @return A modifier for this album
+	 * @throws IllegalStateException
+	 * 		if this album can not be modified
 	 */
-	String getDescription();
+	Modifier modify() throws IllegalStateException;
 
 	/**
-	 * Sets the description of this album.
+	 * Allows modifying an album. Modifications are only performed once {@link
+	 * #update()} has succesfully returned a new album with the modifications
+	 * made.
 	 *
-	 * @param description
-	 * 		The description of this album
-	 * @return This album
+	 * @author <a href="mailto:bombe@pterodactylus.net">David ‘Bombe’ Roden</a>
 	 */
-	Album setDescription(String description);
+	interface Modifier {
+
+		Modifier setTitle(String title);
+
+		Modifier setDescription(String description);
+
+		Album update() throws IllegalStateException;
+
+		class AlbumTitleMustNotBeEmpty extends IllegalStateException { }
+
+	}
 
 }