Don’t cache properties, either, and implement property manipulation.
[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                 webOfTrustConnector.addContext(this, context);
74         }
75
76         /**
77          * Removes the given context from this identity.
78          *
79          * @param context
80          *            The context to remove
81          * @throws PluginException
82          *             if an error occured communicating with the Web of Trust
83          *             plugin
84          */
85         public void removeContext(String context) throws PluginException {
86                 webOfTrustConnector.removeContext(this, context);
87         }
88
89         /**
90          * Sets the property with the given name to the given value.
91          *
92          * @param name
93          *            The name of the property to set
94          * @param value
95          *            The new value of the property
96          * @throws PluginException
97          *             if an error occured communicating with the Web of Trust
98          *             plugin
99          */
100         public void setProperty(String name, String value) throws PluginException {
101                 webOfTrustConnector.setProperty(this, name, value);
102         }
103
104         /**
105          * Removes the property with the given name.
106          *
107          * @param name
108          *            The name of the property to remove
109          * @throws PluginException
110          *             if an error occured communicating with the Web of Trust
111          *             plugin
112          */
113         public void removeProperty(String name) throws PluginException {
114                 webOfTrustConnector.removeProperty(this, name);
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 }