X-Git-Url: https://git.pterodactylus.net/?a=blobdiff_plain;f=src%2Fmain%2Fjava%2Fnet%2Fpterodactylus%2Fsone%2Ffreenet%2Fwot%2FOwnIdentity.java;h=26dc449cd1c533ea1eb06bf9a0b12ab65067ffb7;hb=b0fbeb0fe2184ba9bc0861f4c4507126760fc9b6;hp=371622939ce4dee62f7e8466d48cac073d4038dd;hpb=9ceea683ab66b047fc4ded3ee6f92b33ceea3968;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 3716229..26dc449 100644 --- a/src/main/java/net/pterodactylus/sone/freenet/wot/OwnIdentity.java +++ b/src/main/java/net/pterodactylus/sone/freenet/wot/OwnIdentity.java @@ -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 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 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 { - webOfTrustConnector.addContext(this, context); - } + 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 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 {
- 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
- * @throws PluginException
- * if an error occured communicating with the Web of Trust
- * plugin
+ * 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) throws PluginException {
- webOfTrustConnector.setProperty(this, name, value);
- }
+ public void setProperties(Map
+ * This method is only called by the {@link IdentityManager}.
*
* @param name
* The name of the property to remove
- * @throws PluginException
- * if an error occured communicating with the Web of Trust
- * plugin
+ * @throws WebOfTrustException
+ * if an error occurs
*/
- public void removeProperty(String name) throws PluginException {
- webOfTrustConnector.removeProperty(this, name);
- }
+ 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;
}