2 * Sone - Profile.java - Copyright © 2010–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;
20 import static com.google.common.base.Optional.fromNullable;
21 import static com.google.common.base.Preconditions.checkArgument;
22 import static com.google.common.base.Preconditions.checkNotNull;
23 import static com.google.common.base.Preconditions.checkState;
25 import java.util.ArrayList;
26 import java.util.Collections;
27 import java.util.List;
28 import java.util.UUID;
30 import com.google.common.base.Optional;
31 import com.google.common.hash.Hasher;
32 import com.google.common.hash.Hashing;
35 * A profile stores personal information about a {@link Sone}. All information
36 * is optional and can be {@code null}.
38 * @author <a href="mailto:bombe@pterodactylus.net">David ‘Bombe’ Roden</a>
40 public class Profile implements Fingerprintable {
42 /** The Sone this profile belongs to. */
43 private final Sone sone;
45 private volatile Name name = new Name();
46 private volatile BirthDate birthDate = new BirthDate();
48 /** The ID of the avatar image. */
49 private volatile String avatar;
51 /** Additional fields in the profile. */
52 private final List<Field> fields = Collections.synchronizedList(new ArrayList<Field>());
55 * Creates a new empty profile.
58 * The Sone this profile belongs to
60 public Profile(Sone sone) {
65 * Creates a copy of a profile.
70 public Profile(Profile profile) {
71 this.sone = profile.sone;
72 this.name = profile.name;
73 this.birthDate = profile.birthDate;
74 this.avatar = profile.avatar;
75 this.fields.addAll(profile.fields);
83 * Returns the Sone this profile belongs to.
85 * @return The Sone this profile belongs to
87 public Sone getSone() {
92 * Returns the first name.
94 * @return The first name
96 public String getFirstName() {
97 return name.getFirst().orNull();
101 * Returns the middle name(s).
103 * @return The middle name
105 public String getMiddleName() {
106 return name.getMiddle().orNull();
110 * Returns the last name.
112 * @return The last name
114 public String getLastName() {
115 return name.getLast().orNull();
119 * Returns the day of the birth date.
121 * @return The day of the birth date (from 1 to 31)
123 public Integer getBirthDay() {
124 return birthDate.getDay().orNull();
128 * Returns the month of the birth date.
130 * @return The month of the birth date (from 1 to 12)
132 public Integer getBirthMonth() {
133 return birthDate.getMonth().orNull();
137 * Returns the year of the birth date.
139 * @return The year of the birth date
141 public Integer getBirthYear() {
142 return birthDate.getYear().orNull();
146 * Returns the ID of the currently selected avatar image.
148 * @return The ID of the currently selected avatar image, or {@code null} if
149 * no avatar is selected.
151 public String getAvatar() {
156 * Sets the avatar image.
159 * The ID of the new avatar image
160 * @return This profile
162 public Profile setAvatar(Optional<String> avatarId) {
163 this.avatar = avatarId.orNull();
168 * Returns the fields of this profile.
170 * @return The fields of this profile
172 public List<Field> getFields() {
173 return new ArrayList<Field>(fields);
177 * Returns whether this profile contains the given field.
180 * The field to check for
181 * @return {@code true} if this profile contains the field, false otherwise
183 public boolean hasField(Field field) {
184 return fields.contains(field);
188 * Returns the field with the given ID.
191 * The ID of the field to get
192 * @return The field, or {@code null} if this profile does not contain a
193 * field with the given ID
195 public Field getFieldById(String fieldId) {
196 checkNotNull(fieldId, "fieldId must not be null");
197 for (Field field : fields) {
198 if (field.getId().equals(fieldId)) {
206 * Returns the field with the given name.
209 * The name of the field to get
210 * @return The field, or {@code null} if this profile does not contain a
211 * field with the given name
213 public Field getFieldByName(String fieldName) {
214 for (Field field : fields) {
215 if (field.getName().equals(fieldName)) {
223 * Appends a new field to the list of fields.
226 * The name of the new field
227 * @return The new field
228 * @throws IllegalArgumentException
229 * if the name is not valid
231 public Field addField(String fieldName) throws IllegalArgumentException {
232 checkNotNull(fieldName, "fieldName must not be null");
233 checkArgument(fieldName.length() > 0, "fieldName must not be empty");
234 checkState(getFieldByName(fieldName) == null, "fieldName must be unique");
235 @SuppressWarnings("synthetic-access")
236 Field field = new Field().setName(fieldName);
241 public void renameField(Field field, String newName) {
242 int indexOfField = fields.indexOf(field);
243 if (indexOfField == -1) {
246 fields.set(indexOfField, new Field(field.getId(), newName, field.getValue()));
250 * Moves the given field up one position in the field list. The index of the
251 * field to move must be greater than {@code 0} (because you obviously can
252 * not move the first field further up).
255 * The field to move up
257 public void moveFieldUp(Field field) {
258 checkNotNull(field, "field must not be null");
259 checkArgument(hasField(field), "field must belong to this profile");
260 checkArgument(getFieldIndex(field) > 0, "field index must be > 0");
261 int fieldIndex = getFieldIndex(field);
262 fields.remove(field);
263 fields.add(fieldIndex - 1, field);
267 * Moves the given field down one position in the field list. The index of
268 * the field to move must be less than the index of the last field (because
269 * you obviously can not move the last field further down).
272 * The field to move down
274 public void moveFieldDown(Field field) {
275 checkNotNull(field, "field must not be null");
276 checkArgument(hasField(field), "field must belong to this profile");
277 checkArgument(getFieldIndex(field) < fields.size() - 1, "field index must be < " + (fields.size() - 1));
278 int fieldIndex = getFieldIndex(field);
279 fields.remove(field);
280 fields.add(fieldIndex + 1, field);
284 * Removes the given field.
287 * The field to remove
289 public void removeField(Field field) {
290 checkNotNull(field, "field must not be null");
291 checkArgument(hasField(field), "field must belong to this profile");
292 fields.remove(field);
295 public Modifier modify() {
296 return new Modifier() {
297 private Optional<String> firstName = name.getFirst();
298 private Optional<String> middleName = name.getMiddle();
299 private Optional<String> lastName = name.getLast();
300 private Optional<Integer> birthYear = birthDate.getYear();
301 private Optional<Integer> birthMonth = birthDate.getMonth();
302 private Optional<Integer> birthDay = birthDate.getDay();
305 public Modifier setFirstName(String firstName) {
306 this.firstName = fromNullable(firstName);
311 public Modifier setMiddleName(String middleName) {
312 this.middleName = fromNullable(middleName);
317 public Modifier setLastName(String lastName) {
318 this.lastName = fromNullable(lastName);
323 public Modifier setBirthYear(Integer birthYear) {
324 this.birthYear = fromNullable(birthYear);
329 public Modifier setBirthMonth(Integer birthMonth) {
330 this.birthMonth = fromNullable(birthMonth);
335 public Modifier setBirthDay(Integer birthDay) {
336 this.birthDay = fromNullable(birthDay);
341 public Profile update() {
342 Profile.this.name = new Name(firstName, middleName, lastName);
343 Profile.this.birthDate = new BirthDate(birthYear, birthMonth, birthDay);
349 public interface Modifier {
351 Modifier setFirstName(String firstName);
352 Modifier setMiddleName(String middleName);
353 Modifier setLastName(String lastName);
354 Modifier setBirthYear(Integer birthYear);
355 Modifier setBirthMonth(Integer birthMonth);
356 Modifier setBirthDay(Integer birthDay);
366 * Returns the index of the field with the given name.
369 * The name of the field
370 * @return The index of the field, or {@code -1} if there is no field with
373 private int getFieldIndex(Field field) {
374 return fields.indexOf(field);
378 // INTERFACE Fingerprintable
385 public String getFingerprint() {
386 Hasher hash = Hashing.sha256().newHasher();
387 hash.putString("Profile(");
388 hash.putString(name.getFingerprint());
389 hash.putString(birthDate.getFingerprint());
390 if (avatar != null) {
391 hash.putString("Avatar(").putString(avatar).putString(")");
393 hash.putString("ContactInformation(");
394 for (Field field : fields) {
395 hash.putString(field.getName()).putString("(").putString(field.getValue()).putString(")");
400 return hash.hash().toString();
404 * Container for a profile field.
406 * @author <a href="mailto:bombe@pterodactylus.net">David ‘Bombe’ Roden</a>
410 /** The ID of the field. */
411 private final String id;
413 /** The name of the field. */
416 /** The value of the field. */
417 private String value;
420 * Creates a new field with a random ID.
423 this(UUID.randomUUID().toString());
427 * Creates a new field with the given ID.
430 * The ID of the field
432 private Field(String id) {
433 this.id = checkNotNull(id, "id must not be null");
436 public Field(String id, String name, String value) {
437 this.id = checkNotNull(id, "id must not be null");
443 * Returns the ID of this field.
445 * @return The ID of this field
447 public String getId() {
452 * Returns the name of this field.
454 * @return The name of this field
456 public String getName() {
461 * Sets the name of this field. The name must not be {@code null} and
462 * must not match any other fields in this profile but my match the name
466 * The new name of this field
469 public Field setName(String name) {
470 checkNotNull(name, "name must not be null");
471 checkArgument(getFieldByName(name) == null, "name must be unique");
477 * Returns the value of this field.
479 * @return The value of this field
481 public String getValue() {
486 * Sets the value of this field. While {@code null} is allowed, no
487 * guarantees are made that {@code null} values are correctly persisted
488 * across restarts of the plugin!
491 * The new value of this field
494 public Field setValue(String value) {
507 public boolean equals(Object object) {
508 if (!(object instanceof Field)) {
511 Field field = (Field) object;
512 return id.equals(field.id);
519 public int hashCode() {
520 return id.hashCode();
525 public static class Name implements Fingerprintable {
527 private final Optional<String> first;
528 private final Optional<String> middle;
529 private final Optional<String> last;
532 this(Optional.<String>absent(), Optional.<String>absent(), Optional.<String>absent());
535 public Name(Optional<String> first, Optional<String> middle, Optional<String> last) {
537 this.middle = middle;
541 public Optional<String> getFirst() {
545 public Optional<String> getMiddle() {
549 public Optional<String> getLast() {
554 public String getFingerprint() {
555 Hasher hash = Hashing.sha256().newHasher();
556 hash.putString("Name(");
557 if (first.isPresent()) {
558 hash.putString("First(").putString(first.get()).putString(")");
560 if (middle.isPresent()) {
561 hash.putString("Middle(").putString(middle.get()).putString(")");
563 if (last.isPresent()) {
564 hash.putString("Last(").putString(last.get()).putString(")");
567 return hash.hash().toString();
572 public static class BirthDate implements Fingerprintable {
574 private final Optional<Integer> year;
575 private final Optional<Integer> month;
576 private final Optional<Integer> day;
579 this(Optional.<Integer>absent(), Optional.<Integer>absent(), Optional.<Integer>absent());
582 public BirthDate(Optional<Integer> year, Optional<Integer> month, Optional<Integer> day) {
588 public Optional<Integer> getYear() {
592 public Optional<Integer> getMonth() {
596 public Optional<Integer> getDay() {
601 public String getFingerprint() {
602 Hasher hash = Hashing.sha256().newHasher();
603 hash.putString("Birthdate(");
604 if (year.isPresent()) {
605 hash.putString("Year(").putInt(year.get()).putString(")");
607 if (month.isPresent()) {
608 hash.putString("Month(").putInt(month.get()).putString(")");
610 if (day.isPresent()) {
611 hash.putString("Day(").putInt(day.get()).putString(")");
614 return hash.hash().toString();