X-Git-Url: https://git.pterodactylus.net/?a=blobdiff_plain;f=src%2Fmain%2Fjava%2Fnet%2Fpterodactylus%2Fsone%2Ffreenet%2Fwot%2FOwnIdentity.java;h=68a10f417c6ce38088b74ef664a705642fc5262a;hb=refs%2Ftags%2F0.4;hp=ecb8f251c82ff99527616bd7021f6dbe3f7b3256;hpb=40058abe80bf8a55b5c5eb6594b87d98bef8d0ce;p=Sone.git 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 ecb8f25..68a10f4 100644 --- a/src/main/java/net/pterodactylus/sone/freenet/wot/OwnIdentity.java +++ b/src/main/java/net/pterodactylus/sone/freenet/wot/OwnIdentity.java @@ -17,107 +17,119 @@ 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 David âBombeâ Roden */ -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. + *
+ * This method is only called by the {@link IdentityManager}. * * @param context * The context to add + * @throws WebOfTrustException + * if an error occurs */ - public void addContext(String context) { - if (getContexts().add(context)) { - /* TODO - add. */ - } - } + public void addContext(String context) throws WebOfTrustException; + + /** + * Sets all contexts of this identity. + *
+ * 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
+ * This method is only called by the {@link IdentityManager}.
*
* @param context
* The context to remove
+ * @throws WebOfTrustException
+ * if an error occurs
*/
- public void removeContext(String context) {
- if (getContexts().remove(context)) {
- /* TODO - remove */
- }
- }
+ public void removeContext(String context) throws WebOfTrustException;
/**
* Sets the property with the given name to the given value.
+ *
+ * This method is only called by the {@link IdentityManager}.
*
* @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.
+ *
+ * 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
+ * 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;
}