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=0e13e9e16a7b5a9f5a17083b9421ba6c2ffc689d;hpb=b6c31e4b57f25dc59813c8585505d26034dc59e0;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 0e13e9e..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,204 +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 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 contexts of the identity. */ - protected final Set contexts = Collections.synchronizedSet(new HashSet()); - - /** Whether the contexts have already been loaded. */ - private volatile boolean contextsLoaded = false; - - /** The properties of the identity. */ - private 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 + * @return All contexts of this identity */ - public Set getContexts() { - try { - return getContexts(false); - } catch (PluginException pe1) { - return Collections.emptySet(); - } - } + public Set getContexts(); /** - * Returns the contexts of the identity. - * - * @param forceReload - * {@code true} to force a reload of the contexts - * @return The contexts of the identity - * @throws PluginException - * if an error occured communicating with the Web of Trust - * plugin - */ - public Set getContexts(boolean forceReload) throws PluginException { - if (!contextsLoaded || forceReload) { - Set contexts = webOfTrustConnector.loadIdentityContexts(this); - contextsLoaded = true; - this.contexts.clear(); - this.contexts.addAll(contexts); - } - return Collections.unmodifiableSet(contexts); - } - - /** - * 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 getContexts().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 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) { - 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; }