X-Git-Url: https://git.pterodactylus.net/?a=blobdiff_plain;f=src%2Fmain%2Fjava%2Fnet%2Fpterodactylus%2Fsone%2Ffreenet%2Fwot%2FIdentity.java;h=bc594f8c37132276643049ea742696c0e85e38ca;hb=e641b6984bf4d67fb842d7a858e8521f2b34155f;hp=60e24d6e8bc1d258cd31eccef859926d87cab183;hpb=5e474d0d5ee39c2fd3dfd4376308ad7f8e55dd5d;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 60e24d6..bc594f8 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â2013 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,155 +17,153 @@
package net.pterodactylus.sone.freenet.wot;
-import java.util.Collections;
-import java.util.HashMap;
+import java.util.Collection;
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. An identity is only a container for identity data
+ * and will not perform any updating in the WebOfTrust plugin itself.
*
* @author David âBombeâ Roden
*/
-public class Identity {
-
- /** The Web of Trust connector. */
- protected final WebOfTrustConnector webOfTrustConnector;
-
- /** 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 properties of the identity. */
- protected final Map properties = Collections.synchronizedMap(new HashMap());
-
- /**
- * Creates a new 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
- */
- public Identity(WebOfTrustConnector webOfTrustConnector, String id, String nickname, String requestUri) {
- this.webOfTrustConnector = webOfTrustConnector;
- 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. If the contexts have not been
- * loaded yet, they will be loaded. If loading the contexts fails, an empty
- * set is returned.
+ * Returns all contexts of this identity.
*
- * @return The contexts of the identity
- * @throws PluginException
- * if an error occured communicating with the Web of Trust
- * plugin
+ * @return All contexts of this identity
*/
- public Set getContexts() throws PluginException {
- return webOfTrustConnector.loadIdentityContexts(this);
- }
+ public Set 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
- * @throws PluginException
- * if an error occured communicating with the Web of Trust
- * plugin
*/
- public boolean hasContext(String context) throws PluginException {
- return getContexts().contains(context);
- }
+ public boolean hasContext(String context);
+
+ /**
+ * Adds the given context to this identity.
+ *
+ * @param context
+ * The context to add
+ */
+ public void addContext(String context);
+
+ /**
+ * Sets all contexts of this identity.
+ *
+ * @param contexts
+ * All contexts of the identity
+ */
+ public void setContexts(Collection contexts);
+
+ /**
+ * Removes the given context from this identity.
+ *
+ * @param context
+ * The context to remove
+ */
+ public void removeContext(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 getProperties() {
- return Collections.unmodifiableMap(properties);
- }
+ public Map 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);
+
+ /**
+ * 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 void setProperty(String name, String value);
+
+ /**
+ * Sets all properties of this identity.
+ *
+ * @param properties
+ * The new properties of this identity
*/
- public String getProperty(String name) {
- return properties.get(name);
- }
+ public void setProperties(Map properties);
- //
- // OBJECT METHODS
- //
+ /**
+ * Removes the property with the given name.
+ *
+ * @param name
+ * The name of the property to remove
+ */
+ public void removeProperty(String name);
/**
- * {@inheritDoc}
+ * Retrieves the trust that this identity receives from the given own
+ * 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, or {@code null} if the trust
+ * could not be retrieved
*/
- @Override
- public int hashCode() {
- return id.hashCode();
- }
+ public Trust getTrust(OwnIdentity ownIdentity);
/**
- * {@inheritDoc}
+ * 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 void 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
*/
- @Override
- public boolean equals(Object object) {
- if (!(object instanceof Identity)) {
- return false;
- }
- Identity identity = (Identity) object;
- return identity.id.equals(id);
- }
+ public void removeTrust(OwnIdentity ownIdentity);
}