X-Git-Url: https://git.pterodactylus.net/?p=Sone.git;a=blobdiff_plain;f=src%2Fmain%2Fjava%2Fnet%2Fpterodactylus%2Fsone%2Ffreenet%2Fwot%2FOwnIdentity.java;h=6c6224fc6358840981a1a21953bae7145a96464a;hp=a8f24cb49ea0bda981d28f28310ddfd3cfebb08a;hb=a47643aed43d118ca68044f95451bb5374cdb332;hpb=e8e813b99a7945130099845190efc4fca16b13bf

diff --git a/src/main/java/net/pterodactylus/sone/freenet/wot/OwnIdentity.java b/src/main/java/net/pterodactylus/sone/freenet/wot/OwnIdentity.java
index a8f24cb..6c6224f 100644
--- a/src/main/java/net/pterodactylus/sone/freenet/wot/OwnIdentity.java
+++ b/src/main/java/net/pterodactylus/sone/freenet/wot/OwnIdentity.java
@@ -1,5 +1,5 @@
 /*
- * Sone - OwnIdentity.java - Copyright © 2010 David Roden
+ * Sone - OwnIdentity.java - Copyright © 2010–2012 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,113 +17,117 @@
 
 package net.pterodactylus.sone.freenet.wot;
 
+import java.util.Map;
+import java.util.Set;
+
 /**
- * An own identity is an identity that the owner of the node has full control
- * over.
+ * Defines a local identity, an own identity.
  *
  * @author <a href="mailto:bombe@pterodactylus.net">David ‘Bombe’ Roden</a>
  */
-public class OwnIdentity extends Identity {
-
-	/** The insert URI of the identity. */
-	private final String insertUri;
-
-	/**
-	 * Creates a new own identity.
-	 *
-	 * @param webOfTrustConnector
-	 *            The Web of Trust connector
-	 * @param id
-	 *            The ID of the identity
-	 * @param nickname
-	 *            The nickname of the identity
-	 * @param requestUri
-	 *            The request URI of the identity
-	 * @param insertUri
-	 *            The insert URI of the identity
-	 */
-	public OwnIdentity(WebOfTrustConnector webOfTrustConnector, String id, String nickname, String requestUri, String insertUri) {
-		super(webOfTrustConnector, id, nickname, requestUri);
-		this.insertUri = insertUri;
-	}
-
-	//
-	// ACCESSORS
-	//
+public interface OwnIdentity extends Identity {
 
 	/**
 	 * Returns the insert URI of the identity.
 	 *
 	 * @return The insert URI of the identity
 	 */
-	public String getInsertUri() {
-		return insertUri;
-	}
+	public String getInsertUri();
 
 	/**
 	 * Adds the given context to this identity.
+	 * <p>
+	 * This method is only called by the {@link IdentityManager}.
 	 *
 	 * @param context
 	 *            The context to add
-	 * @throws PluginException
-	 *             if an error occured communicating with the Web of Trust
-	 *             plugin
+	 * @throws WebOfTrustException
+	 *             if an error occurs
 	 */
-	public void addContext(String context) throws PluginException {
-		if (getContexts().add(context)) {
-			webOfTrustConnector.addContext(this, context);
-		}
-	}
+	public void addContext(String context) throws WebOfTrustException;
+
+	/**
+	 * Sets all contexts of this identity.
+	 * <p>
+	 * This method is only called by the {@link IdentityManager}.
+	 *
+	 * @param contexts
+	 *            All contexts of the identity
+	 * @throws WebOfTrustException
+	 *             if an error occurs
+	 */
+	public void setContexts(Set<String> contexts) throws WebOfTrustException;
 
 	/**
 	 * Removes the given context from this identity.
+	 * <p>
+	 * This method is only called by the {@link IdentityManager}.
 	 *
 	 * @param context
 	 *            The context to remove
-	 * @throws PluginException
-	 *             if an error occured communicating with the Web of Trust
-	 *             plugin
+	 * @throws WebOfTrustException
+	 *             if an error occurs
 	 */
-	public void removeContext(String context) throws PluginException {
-		if (getContexts().remove(context)) {
-			webOfTrustConnector.removeContext(this, context);
-		}
-	}
+	public void removeContext(String context) throws WebOfTrustException;
 
 	/**
 	 * Sets the property with the given name to the given value.
 	 *
 	 * @param name
-	 *            The name of the property to set
+	 *            The name of the property
 	 * @param value
-	 *            The new value of the property
+	 *            The value of the property
+	 * @throws WebOfTrustException
+	 *             if an error occurs
+	 */
+	public void setProperty(String name, String value) throws WebOfTrustException;
+
+	/**
+	 * Sets all properties of this identity.
+	 * <p>
+	 * This method is only called by the {@link IdentityManager}.
+	 *
+	 * @param properties
+	 *            The new properties of this identity
+	 * @throws WebOfTrustException
+	 *             if an error occurs
 	 */
-	public void setProperty(String name, String value) {
-		properties.put(name, value);
-		/* TODO - set property. */
-	}
+	public void setProperties(Map<String, String> properties) throws WebOfTrustException;
 
 	/**
 	 * Removes the property with the given name.
+	 * <p>
+	 * This method is only called by the {@link IdentityManager}.
 	 *
 	 * @param name
 	 *            The name of the property to remove
+	 * @throws WebOfTrustException
+	 *             if an error occurs
 	 */
-	public void removeProperty(String name) {
-		properties.remove(name);
-		/* TODO - remove property. */
-	}
+	public void removeProperty(String name) throws WebOfTrustException;
 
-	//
-	// OBJECT METHODS
-	//
+	/**
+	 * Sets the trust for the given target identity.
+	 *
+	 * @param target
+	 *            The target to set the trust for
+	 * @param trustValue
+	 *            The new trust value (from {@code -100} or {@code 100})
+	 * @param comment
+	 *            The comment for the trust assignment
+	 * @throws WebOfTrustException
+	 *             if an error occurs
+	 */
+	public void setTrust(Identity target, int trustValue, String comment) throws WebOfTrustException;
 
 	/**
-	 * {@inheritDoc}
+	 * Removes any trust assignment for the given target identity.
+	 *
+	 * @param target
+	 *            The targe to remove the trust assignment for
+	 * @throws WebOfTrustException
+	 *             if an error occurs
 	 */
-	@Override
-	public String toString() {
-		return getClass().getSimpleName() + "[id=" + getId() + ",nickname=" + getNickname() + ",requestUri=" + getRequestUri() + ",insertUri=" + insertUri + "]";
-	}
+	public void removeTrust(Identity target) throws WebOfTrustException;
 
 }