Implement delegate methods to add and remove contexts from OwnIdentity’s.
[Sone.git] / src / main / java / net / pterodactylus / sone / freenet / wot / OwnIdentity.java
1 /*
2  * Sone - OwnIdentity.java - Copyright © 2010 David Roden
3  *
4  * This program is free software: you can redistribute it and/or modify
5  * it under the terms of the GNU General Public License as published by
6  * the Free Software Foundation, either version 3 of the License, or
7  * (at your option) any later version.
8  *
9  * This program is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12  * GNU General Public License for more details.
13  *
14  * You should have received a copy of the GNU General Public License
15  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
16  */
17
18 package net.pterodactylus.sone.freenet.wot;
19
20 /**
21  * An own identity is an identity that the owner of the node has full control
22  * over.
23  *
24  * @author <a href="mailto:bombe@pterodactylus.net">David ‘Bombe’ Roden</a>
25  */
26 public class OwnIdentity extends Identity {
27
28         /** The insert URI of the identity. */
29         private final String insertUri;
30
31         /**
32          * Creates a new own identity.
33          *
34          * @param webOfTrustConnector
35          *            The Web of Trust connector
36          * @param id
37          *            The ID of the identity
38          * @param nickname
39          *            The nickname of the identity
40          * @param requestUri
41          *            The request URI of the identity
42          * @param insertUri
43          *            The insert URI of the identity
44          */
45         public OwnIdentity(WebOfTrustConnector webOfTrustConnector, String id, String nickname, String requestUri, String insertUri) {
46                 super(webOfTrustConnector, id, nickname, requestUri);
47                 this.insertUri = insertUri;
48         }
49
50         //
51         // ACCESSORS
52         //
53
54         /**
55          * Returns the insert URI of the identity.
56          *
57          * @return The insert URI of the identity
58          */
59         public String getInsertUri() {
60                 return insertUri;
61         }
62
63         /**
64          * Adds the given context to this identity.
65          *
66          * @param context
67          *            The context to add
68          * @throws PluginException
69          *             if an error occured communicating with the Web of Trust
70          *             plugin
71          */
72         public void addContext(String context) throws PluginException {
73                 if (getContexts().add(context)) {
74                         webOfTrustConnector.addContext(this, context);
75                 }
76         }
77
78         /**
79          * Removes the given context from this identity.
80          *
81          * @param context
82          *            The context to remove
83          * @throws PluginException
84          *             if an error occured communicating with the Web of Trust
85          *             plugin
86          */
87         public void removeContext(String context) throws PluginException {
88                 if (getContexts().remove(context)) {
89                         webOfTrustConnector.removeContext(this, context);
90                 }
91         }
92
93         /**
94          * Sets the property with the given name to the given value.
95          *
96          * @param name
97          *            The name of the property to set
98          * @param value
99          *            The new value of the property
100          */
101         public void setProperty(String name, String value) {
102                 properties.put(name, value);
103                 /* TODO - set property. */
104         }
105
106         /**
107          * Removes the property with the given name.
108          *
109          * @param name
110          *            The name of the property to remove
111          */
112         public void removeProperty(String name) {
113                 properties.remove(name);
114                 /* TODO - remove property. */
115         }
116
117         //
118         // OBJECT METHODS
119         //
120
121         /**
122          * {@inheritDoc}
123          */
124         @Override
125         public String toString() {
126                 return getClass().getSimpleName() + "[id=" + getId() + ",nickname=" + getNickname() + ",requestUri=" + getRequestUri() + ",insertUri=" + insertUri + "]";
127         }
128
129 }