X-Git-Url: https://git.pterodactylus.net/?a=blobdiff_plain;f=src%2Fmain%2Fjava%2Fnet%2Fpterodactylus%2Fsone%2Fdata%2FAlbum.java;h=89823a81786f4158e8bc0eff21a411f3fa06217a;hb=e71cce762443757a193067b13a82fb7ae92b28b2;hp=792f5181ecd2ed9279435528b5da3c8dbe83ee98;hpb=cf9d466a99e30e2c23694da9037c12de6372aaae;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 792f518..89823a8 100644 --- a/src/main/java/net/pterodactylus/sone/data/Album.java +++ b/src/main/java/net/pterodactylus/sone/data/Album.java @@ -18,7 +18,9 @@ package net.pterodactylus.sone.data; import java.util.ArrayList; +import java.util.LinkedHashMap; import java.util.List; +import java.util.Map; import java.util.UUID; import net.pterodactylus.util.validation.Validation; @@ -28,34 +30,37 @@ import net.pterodactylus.util.validation.Validation; * * @author David ‘Bombe’ Roden */ -public class Album { +public class Album implements Fingerprintable { /** The ID of this album. */ private final String id; /** The Sone this album belongs to. */ - private final Sone sone; + private Sone sone; /** Nested albums. */ private final List albums = new ArrayList(); /** The images in this album. */ - private final List images = new ArrayList(); + private final Map images = new LinkedHashMap(); - /** The name of this album. */ - private String name; + /** The parent album. */ + private Album parent; + + /** The title of this album. */ + private String title; /** The description of this album. */ private String description; + /** The ID of the album picture. */ + private String albumImage; + /** * Creates a new album with a random ID. - * - * @param sone - * The Sone this album belongs to */ - public Album(Sone sone) { - this(UUID.randomUUID().toString(), sone); + public Album() { + this(UUID.randomUUID().toString()); } /** @@ -63,13 +68,10 @@ public class Album { * * @param id * The ID of the album - * @param sone - * The Sone this album belongs to */ - public Album(String id, Sone sone) { - Validation.begin().isNotNull("Album ID", id).isNotNull("Album Owner", sone).check(); + public Album(String id) { + Validation.begin().isNotNull("Album ID", id).check(); this.id = id; - this.sone = sone; } // @@ -95,42 +97,187 @@ public class Album { } /** + * 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 + */ + public Album setSone(Sone sone) { + Validation.begin().isNotNull("New Album Owner", sone).isEither("Old Album Owner", this.sone, null, sone).check(); + this.sone = sone; + return this; + } + + /** * Returns the nested albums. * * @return The nested albums */ - public List getNestedAlbums() { + public List getAlbums() { return new ArrayList(albums); } /** + * Adds an album to this album. + * + * @param album + * The album to add + */ + public void addAlbum(Album album) { + Validation.begin().isNotNull("Album", album).check().isEqual("Album Owner", album.sone, sone).isEither("Old Album Parent", this.parent, null, album.parent).check(); + album.setParent(this); + if (!albums.contains(album)) { + albums.add(album); + } + } + + /** + * Removes an album from this album. + * + * @param album + * The album to remove + */ + public void removeAlbum(Album album) { + Validation.begin().isNotNull("Album", album).check().isEqual("Album Owner", album.sone, sone).isEqual("Album Parent", album.parent, this).check(); + albums.remove(album); + album.removeParent(); + } + + /** * Returns the images in this album. * * @return The images in this album */ public List getImages() { - return new ArrayList(images); + return new ArrayList(images.values()); + } + + /** + * Adds the given image to this album. + * + * @param image + * The image to add + */ + public void addImage(Image image) { + Validation.begin().isNotNull("Image", image).check().isNotNull("Image Owner", image.getSone()).check().isEqual("Image Owner", image.getSone(), sone).check(); + if (image.getAlbum() != null) { + image.getAlbum().removeImage(image); + } + image.setAlbum(this); + if (images.isEmpty()) { + albumImage = image.getId(); + } + if (!images.containsKey(image.getId())) { + images.put(image.getId(), image); + } + } + + /** + * Removes the given image from this album. + * + * @param image + * The image to remove + */ + public void removeImage(Image image) { + Validation.begin().isNotNull("Image", image).check().isEqual("Image Owner", image.getSone(), sone).check(); + images.remove(image); + if (image.getId().equals(albumImage)) { + if (images.isEmpty()) { + albumImage = null; + } else { + albumImage = images.values().iterator().next().getId(); + } + } + } + + /** + * 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 + */ + public Image getAlbumImage() { + if (albumImage == null) { + return null; + } + return images.get(albumImage); + } + + /** + * Sets the ID of the album image. + * + * @param id + * The ID of the album image + * @return This album + */ + public Album setAlbumImage(String id) { + this.albumImage = id; + return this; } /** - * Returns the name of this album. + * Returns whether this album contains any other albums or images. * - * @return The name of this album + * @return {@code true} if this album is empty, {@code false} otherwise */ - public String getName() { - return name; + public boolean isEmpty() { + return albums.isEmpty() && images.isEmpty(); } /** - * Sets the name of this album. + * Returns the parent album of this album. * - * @param name - * The name of this album + * @return The parent album of this album, or {@code null} if this album + * does not have a parent + */ + public Album getParent() { + return parent; + } + + /** + * Sets the parent album of this album. + * + * @param parent + * The new parent album of this album * @return This album */ - public Album setName(String name) { - Validation.begin().isNotNull("Album Name", name).check(); - this.name = name; + protected Album setParent(Album parent) { + Validation.begin().isNotNull("Album Parent", parent).check(); + this.parent = parent; + return this; + } + + /** + * Removes the parent album of this album. + * + * @return This album + */ + protected Album removeParent() { + this.parent = null; + return this; + } + + /** + * Returns the title of this album. + * + * @return The title of this album + */ + public String getTitle() { + return title; + } + + /** + * Sets the title of this album. + * + * @param title + * The title of this album + * @return This album + */ + public Album setTitle(String title) { + Validation.begin().isNotNull("Album Title", title).check(); + this.title = title; return this; } @@ -157,6 +304,41 @@ public class Album { } // + // FINGERPRINTABLE METHODS + // + + /** + * {@inheritDoc} + */ + @Override + public String getFingerprint() { + StringBuilder fingerprint = new StringBuilder(); + fingerprint.append("Album("); + fingerprint.append("ID(").append(id).append(')'); + fingerprint.append("Title(").append(title).append(')'); + fingerprint.append("Description(").append(description).append(')'); + + /* add nested albums. */ + fingerprint.append("Albums("); + for (Album album : albums) { + fingerprint.append(album.getFingerprint()); + } + fingerprint.append(')'); + + /* add images. */ + fingerprint.append("Images("); + for (Image image : images.values()) { + if (image.isInserted()) { + fingerprint.append(image.getFingerprint()); + } + } + fingerprint.append(')'); + + fingerprint.append(')'); + return fingerprint.toString(); + } + + // // OBJECT METHODS // @@ -164,12 +346,20 @@ public class Album { * {@inheritDoc} */ @Override + public int hashCode() { + return id.hashCode(); + } + + /** + * {@inheritDoc} + */ + @Override public boolean equals(Object object) { if (!(object instanceof Album)) { return false; } Album album = (Album) object; - return sone.equals(album.sone) && id.equals(album.id); + return id.equals(album.id); } }