X-Git-Url: https://git.pterodactylus.net/?p=Sone.git;a=blobdiff_plain;f=src%2Fmain%2Fjava%2Fnet%2Fpterodactylus%2Fsone%2Ffreenet%2Fwot%2FIdentity.java;h=c6875e965deb2e4169adb57b87fefb83484cfb28;hp=41540e531cb9e00b5e89c72080d37a206da7343e;hb=419098bcd6215125408b29e60bd888e60979d37b;hpb=db7d24156074d2735db4048a0e83cfe807500b3c

diff --git a/src/main/java/net/pterodactylus/sone/freenet/wot/Identity.java b/src/main/java/net/pterodactylus/sone/freenet/wot/Identity.java
index 41540e5..c6875e9 100644
--- a/src/main/java/net/pterodactylus/sone/freenet/wot/Identity.java
+++ b/src/main/java/net/pterodactylus/sone/freenet/wot/Identity.java
@@ -1,5 +1,5 @@
 /*
- * Sone - Identity.java - Copyright © 2010 David Roden
+ * Sone - Identity.java - Copyright © 2010–2015 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
@@ -17,18 +17,36 @@
 
 package net.pterodactylus.sone.freenet.wot;
 
+import java.util.Collection;
+import java.util.Collections;
 import java.util.Map;
 import java.util.Set;
 
+import com.google.common.base.Function;
+
 /**
  * Interface for web of trust identities, defining all functions that can be
- * performed on an identity. The identity is the main entry point for identity
- * management.
+ * performed on an identity. An identity is only a container for identity data
+ * and will not perform any updating in the WebOfTrust plugin itself.
  *
  * @author <a href="mailto:bombe@pterodactylus.net">David ‘Bombe’ Roden</a>
  */
 public interface Identity {
 
+	public static final Function<Identity, Set<String>> TO_CONTEXTS = new Function<Identity, Set<String>>() {
+		@Override
+		public Set<String> apply(Identity identity) {
+			return (identity == null) ? Collections.<String>emptySet() : identity.getContexts();
+		}
+	};
+
+	public static final Function<Identity, Map<String, String>> TO_PROPERTIES = new Function<Identity, Map<String, String>>() {
+		@Override
+		public Map<String, String> apply(Identity input) {
+			return (input == null) ? Collections.<String, String>emptyMap() : input.getProperties();
+		}
+	};
+
 	/**
 	 * Returns the ID of the identity.
 	 *
@@ -68,6 +86,30 @@ public interface Identity {
 	public boolean hasContext(String context);
 
 	/**
+	 * Adds the given context to this identity.
+	 *
+	 * @param context
+	 *            The context to add
+	 */
+	public Identity addContext(String context);
+
+	/**
+	 * Sets all contexts of this identity.
+	 *
+	 * @param contexts
+	 *            All contexts of the identity
+	 */
+	public void setContexts(Collection<String> contexts);
+
+	/**
+	 * Removes the given context from this identity.
+	 *
+	 * @param context
+	 *            The context to remove
+	 */
+	public Identity removeContext(String context);
+
+	/**
 	 * Returns all properties of this identity.
 	 *
 	 * @return All properties of this identity
@@ -84,14 +126,61 @@ public interface Identity {
 	public String getProperty(String name);
 
 	/**
+	 * Sets the property with the given name to the given value.
+	 *
+	 * @param name
+	 *            The name of the property
+	 * @param value
+	 *            The value of the property
+	 */
+	public Identity setProperty(String name, String value);
+
+	/**
+	 * Sets all properties of this identity.
+	 *
+	 * @param properties
+	 *            The new properties of this identity
+	 */
+	public void setProperties(Map<String, String> properties);
+
+	/**
+	 * Removes the property with the given name.
+	 *
+	 * @param name
+	 *            The name of the property to remove
+	 */
+	public Identity removeProperty(String name);
+
+	/**
 	 * Retrieves the trust that this identity receives from the given own
-	 * identity.
+	 * identity. If this identity is not in the own identity’s trust tree, a
+	 * {@link Trust} is returned that has all its elements set to {@code null}.
+	 * If the trust can not be retrieved, {@code null} is returned.
 	 *
 	 * @param ownIdentity
 	 *            The own identity to get the trust for
-	 * @return The trust assigned to this identity
-	 * @throws WebOfTrustException
+	 * @return The trust assigned to this identity, or {@code null} if the trust
+	 *         could not be retrieved
+	 */
+	public Trust getTrust(OwnIdentity ownIdentity);
+
+	/**
+	 * Sets the trust given by an own identity to this identity.
+	 *
+	 * @param ownIdentity
+	 *            The own identity that gave trust to this identity
+	 * @param trust
+	 *            The trust given by the given own identity
+	 */
+	public Identity setTrust(OwnIdentity ownIdentity, Trust trust);
+
+	/**
+	 * Removes trust assignment from the given own identity for this identity.
+	 *
+	 * @param ownIdentity
+	 *            The own identity that removed the trust assignment for this
+	 *            identity
 	 */
-	public Trust getTrust(OwnIdentity ownIdentity) throws WebOfTrustException;
+	public Identity removeTrust(OwnIdentity ownIdentity);
 
 }