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

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 c3053ae..41540e5 100644
--- a/src/main/java/net/pterodactylus/sone/freenet/wot/Identity.java
+++ b/src/main/java/net/pterodactylus/sone/freenet/wot/Identity.java
@@ -17,169 +17,81 @@
 
 package net.pterodactylus.sone.freenet.wot;
 
-import java.util.Collections;
-import java.util.HashMap;
-import java.util.HashSet;
 import java.util.Map;
 import java.util.Set;
 
 /**
- * A Web of Trust identity.
+ * 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.
  *
  * @author <a href="mailto:bombe@pterodactylus.net">David ‘Bombe’ Roden</a>
  */
-public class Identity {
-
-	/** The ID of the identity. */
-	private final String id;
-
-	/** The nickname of the identity. */
-	private final String nickname;
-
-	/** The request URI of the identity. */
-	private final String requestUri;
-
-	/** The contexts of the identity. */
-	protected final Set<String> contexts = Collections.synchronizedSet(new HashSet<String>());
-
-	/** The properties of the identity. */
-	private final Map<String, String> properties = Collections.synchronizedMap(new HashMap<String, String>());
-
-	/**
-	 * Creates a new identity.
-	 *
-	 * @param id
-	 *            The ID of the identity
-	 * @param nickname
-	 *            The nickname of the identity
-	 * @param requestUri
-	 *            The request URI of the identity
-	 */
-	public Identity(String id, String nickname, String requestUri) {
-		this.id = id;
-		this.nickname = nickname;
-		this.requestUri = requestUri;
-	}
-
-	//
-	// ACCESSORS
-	//
+public interface Identity {
 
 	/**
 	 * Returns the ID of the identity.
 	 *
 	 * @return The ID of the identity
 	 */
-	public String getId() {
-		return id;
-	}
+	public String getId();
 
 	/**
 	 * Returns the nickname of the identity.
 	 *
 	 * @return The nickname of the identity
 	 */
-	public String getNickname() {
-		return nickname;
-	}
+	public String getNickname();
 
 	/**
 	 * Returns the request URI of the identity.
 	 *
 	 * @return The request URI of the identity
 	 */
-	public String getRequestUri() {
-		return requestUri;
-	}
+	public String getRequestUri();
 
 	/**
-	 * Returns the contexts of the identity.
+	 * Returns all contexts of this identity.
 	 *
-	 * @return The contexts of the identity
+	 * @return All contexts of this identity
 	 */
-	public Set<String> getContexts() {
-		return Collections.unmodifiableSet(contexts);
-	}
+	public Set<String> getContexts();
 
 	/**
-	 * Returns whether the identity contains the given context.
+	 * Returns whether this identity has the given context.
 	 *
 	 * @param context
 	 *            The context to check for
 	 * @return {@code true} if this identity has the given context,
 	 *         {@code false} otherwise
 	 */
-	public boolean hasContext(String context) {
-		return contexts.contains(context);
-	}
+	public boolean hasContext(String context);
 
 	/**
-	 * Returns the properties of the identity.
+	 * Returns all properties of this identity.
 	 *
-	 * @return The properties of the identity
+	 * @return All properties of this identity
 	 */
-	public Map<String, String> getProperties() {
-		return Collections.unmodifiableMap(properties);
-	}
+	public Map<String, String> getProperties();
 
 	/**
 	 * Returns the value of the property with the given name.
 	 *
 	 * @param name
 	 *            The name of the property
-	 * @return The value of the property, or {@code null} if there is no such
-	 *         property
+	 * @return The value of the property
 	 */
-	public String getProperty(String name) {
-		return properties.get(name);
-	}
+	public String getProperty(String name);
 
 	/**
-	 * Sets the property with the given name to the given value.
+	 * Retrieves the trust that this identity receives from the given own
+	 * identity.
 	 *
-	 * @param name
-	 *            The name of the property to set
-	 * @param value
-	 *            The new value of the property
-	 */
-	public void setProperty(String name, String value) {
-		properties.put(name, value);
-		/* TODO - set property. */
-	}
-
-	/**
-	 * Removes the property with the given name.
-	 *
-	 * @param name
-	 *            The name of the property to remove
-	 */
-	public void removeProperty(String name) {
-		properties.remove(name);
-		/* TODO - remove property. */
-	}
-
-	//
-	// OBJECT METHODS
-	//
-
-	/**
-	 * {@inheritDoc}
-	 */
-	@Override
-	public int hashCode() {
-		return id.hashCode();
-	}
-
-	/**
-	 * {@inheritDoc}
+	 * @param ownIdentity
+	 *            The own identity to get the trust for
+	 * @return The trust assigned to this identity
+	 * @throws WebOfTrustException
 	 */
-	@Override
-	public boolean equals(Object object) {
-		if (!(object instanceof Identity)) {
-			return false;
-		}
-		Identity identity = (Identity) object;
-		return identity.id.equals(id);
-	}
+	public Trust getTrust(OwnIdentity ownIdentity) throws WebOfTrustException;
 
 }