Remove @author tags
[Sone.git] / src / main / java / net / pterodactylus / sone / data / impl / AbstractAlbumBuilder.java
1 /*
2  * Sone - AbstractAlbumBuilder.java - Copyright © 2013–2016 David Roden
3  *
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.
8  *
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.
13  *
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/>.
16  */
17
18 package net.pterodactylus.sone.data.impl;
19
20 import static com.google.common.base.Preconditions.checkState;
21
22 import net.pterodactylus.sone.data.Sone;
23 import net.pterodactylus.sone.database.AlbumBuilder;
24
25 /**
26  * Abstract {@link AlbumBuilder} implementation. It stores the state of the new
27  * album and performs validation, you only need to implement {@link #build()}.
28  */
29 public abstract class AbstractAlbumBuilder implements AlbumBuilder {
30
31         /** Whether to create an album with a random ID. */
32         protected boolean randomId;
33
34         /** The ID of the album to create. */
35         protected String id;
36         protected Sone sone;
37
38         @Override
39         public AlbumBuilder randomId() {
40                 randomId = true;
41                 return this;
42         }
43
44         @Override
45         public AlbumBuilder withId(String id) {
46                 this.id = id;
47                 return this;
48         }
49
50         public AlbumBuilder by(Sone sone) {
51                 this.sone = sone;
52                 return this;
53         }
54
55         //
56         // PROTECTED METHODS
57         //
58
59         /**
60          * Validates the state of this post builder.
61          *
62          * @throws IllegalStateException
63          *              if the state is not valid for building a new post
64          */
65         protected void validate() throws IllegalStateException {
66                 checkState((randomId && (id == null)) || (!randomId && (id != null)), "exactly one of random ID or custom ID must be set");
67                 checkState(sone != null, "Sone must not be null");
68         }
69
70 }