2 * Sone - Image.java - Copyright © 2011–2013 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.sone.data;
21 * Container for image metadata.
23 * @author <a href="mailto:d.roden@xplosion.de">David Roden</a>
25 public interface Image extends Identified, Fingerprintable {
28 * Returns the ID of this image.
30 * @return The ID of this image
33 String getInternalId();
36 * Returns the Sone this image belongs to.
38 * @return The Sone this image belongs to
43 * Returns the album this image belongs to.
45 * @return The album this image belongs to
50 * Sets the album this image belongs to. The album of an image can only be
51 * set once, and it is usually called by {@link Album#addImage(Image)}.
54 * The album this image belongs to
57 Image setAlbum(Album album);
60 * Returns the request key of this image.
62 * @return The request key of this image
67 * Returns whether the image has already been inserted. An image is
68 * considered as having been inserted it its {@link #getKey() key} is not
71 * @return {@code true} if there is a key for this image, {@code false}
77 * Returns the creation time of this image.
79 * @return The creation time of this image (in milliseconds since 1970, Jan
82 long getCreationTime();
85 * Returns the width of this image.
87 * @return The width of this image (in pixels)
92 * Returns the height of this image.
94 * @return The height of this image (in pixels)
99 * Returns the title of this image.
101 * @return The title of this image
106 * Returns the description of this image.
108 * @return The description of this image
110 String getDescription();
116 String getFingerprint();
118 Modifier modify() throws IllegalStateException;
122 Modifier setSone(Sone sone);
124 Modifier setCreationTime(long creationTime);
126 Modifier setKey(String key);
128 Modifier setTitle(String title);
130 Modifier setDescription(String description);
132 Modifier setWidth(int width);
134 Modifier setHeight(int height);
136 Image update() throws IllegalStateException;
138 class ImageTitleMustNotBeEmpty extends IllegalStateException { }