Remove javadoc comments from overriding methods.
[Sone.git] / src / main / java / net / pterodactylus / sone / main / SonePlugin.java
1 /*
2  * Sone - SonePlugin.java - Copyright © 2010–2013 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.main;
19
20 import java.io.File;
21 import java.util.logging.Level;
22 import java.util.logging.LogRecord;
23 import java.util.logging.Logger;
24
25 import net.pterodactylus.sone.core.Core;
26 import net.pterodactylus.sone.core.FreenetInterface;
27 import net.pterodactylus.sone.core.WebOfTrustUpdater;
28 import net.pterodactylus.sone.database.Database;
29 import net.pterodactylus.sone.database.PostProvider;
30 import net.pterodactylus.sone.database.SoneProvider;
31 import net.pterodactylus.sone.database.memory.MemoryDatabase;
32 import net.pterodactylus.sone.fcp.FcpInterface;
33 import net.pterodactylus.sone.freenet.PluginStoreConfigurationBackend;
34 import net.pterodactylus.sone.freenet.plugin.PluginConnector;
35 import net.pterodactylus.sone.freenet.wot.IdentityManager;
36 import net.pterodactylus.sone.freenet.wot.WebOfTrustConnector;
37 import net.pterodactylus.sone.web.WebInterface;
38 import net.pterodactylus.util.config.Configuration;
39 import net.pterodactylus.util.config.ConfigurationException;
40 import net.pterodactylus.util.config.MapConfigurationBackend;
41 import net.pterodactylus.util.logging.Logging;
42 import net.pterodactylus.util.logging.LoggingListener;
43 import net.pterodactylus.util.version.Version;
44
45 import freenet.client.async.DatabaseDisabledException;
46 import freenet.l10n.BaseL10n.LANGUAGE;
47 import freenet.l10n.PluginL10n;
48 import freenet.node.Node;
49 import freenet.pluginmanager.FredPlugin;
50 import freenet.pluginmanager.FredPluginBaseL10n;
51 import freenet.pluginmanager.FredPluginFCP;
52 import freenet.pluginmanager.FredPluginL10n;
53 import freenet.pluginmanager.FredPluginThreadless;
54 import freenet.pluginmanager.FredPluginVersioned;
55 import freenet.pluginmanager.PluginReplySender;
56 import freenet.pluginmanager.PluginRespirator;
57 import freenet.support.SimpleFieldSet;
58 import freenet.support.api.Bucket;
59
60 import com.google.common.eventbus.EventBus;
61 import com.google.inject.AbstractModule;
62 import com.google.inject.Guice;
63 import com.google.inject.Injector;
64 import com.google.inject.Singleton;
65 import com.google.inject.TypeLiteral;
66 import com.google.inject.matcher.Matchers;
67 import com.google.inject.name.Names;
68 import com.google.inject.spi.InjectionListener;
69 import com.google.inject.spi.TypeEncounter;
70 import com.google.inject.spi.TypeListener;
71
72 /**
73  * This class interfaces with Freenet. It is the class that is loaded by the
74  * node and starts up the whole Sone system.
75  *
76  * @author <a href="mailto:bombe@pterodactylus.net">David ‘Bombe’ Roden</a>
77  */
78 public class SonePlugin implements FredPlugin, FredPluginFCP, FredPluginL10n, FredPluginBaseL10n, FredPluginThreadless, FredPluginVersioned {
79
80         static {
81                 /* initialize logging. */
82                 Logging.setup("sone");
83                 Logging.addLoggingListener(new LoggingListener() {
84
85                         @Override
86                         public void logged(LogRecord logRecord) {
87                                 Class<?> loggerClass = Logging.getLoggerClass(logRecord.getLoggerName());
88                                 int recordLevel = logRecord.getLevel().intValue();
89                                 if (recordLevel < Level.FINE.intValue()) {
90                                         freenet.support.Logger.debug(loggerClass, logRecord.getMessage(), logRecord.getThrown());
91                                 } else if (recordLevel < Level.INFO.intValue()) {
92                                         freenet.support.Logger.minor(loggerClass, logRecord.getMessage(), logRecord.getThrown());
93                                 } else if (recordLevel < Level.WARNING.intValue()) {
94                                         freenet.support.Logger.normal(loggerClass, logRecord.getMessage(), logRecord.getThrown());
95                                 } else if (recordLevel < Level.SEVERE.intValue()) {
96                                         freenet.support.Logger.warning(loggerClass, logRecord.getMessage(), logRecord.getThrown());
97                                 } else {
98                                         freenet.support.Logger.error(loggerClass, logRecord.getMessage(), logRecord.getThrown());
99                                 }
100                         }
101                 });
102         }
103
104         /** The version. */
105         public static final Version VERSION = new Version(0, 8, 7);
106
107         /** The logger. */
108         private static final Logger logger = Logging.getLogger(SonePlugin.class);
109
110         /** The plugin respirator. */
111         private PluginRespirator pluginRespirator;
112
113         /** The core. */
114         private Core core;
115
116         /** The web interface. */
117         private WebInterface webInterface;
118
119         /** The FCP interface. */
120         private FcpInterface fcpInterface;
121
122         /** The l10n helper. */
123         private PluginL10n l10n;
124
125         /** The web of trust connector. */
126         private WebOfTrustConnector webOfTrustConnector;
127
128         //
129         // ACCESSORS
130         //
131
132         /**
133          * Returns the plugin respirator for this plugin.
134          *
135          * @return The plugin respirator
136          */
137         public PluginRespirator pluginRespirator() {
138                 return pluginRespirator;
139         }
140
141         /**
142          * Returns the core started by this plugin.
143          *
144          * @return The core
145          */
146         public Core core() {
147                 return core;
148         }
149
150         /**
151          * Returns the plugin’s l10n helper.
152          *
153          * @return The plugin’s l10n helper
154          */
155         public PluginL10n l10n() {
156                 return l10n;
157         }
158
159         //
160         // FREDPLUGIN METHODS
161         //
162
163         @Override
164         public void runPlugin(PluginRespirator pluginRespirator) {
165                 this.pluginRespirator = pluginRespirator;
166
167                 /* create a configuration. */
168                 Configuration oldConfiguration;
169                 Configuration newConfiguration = null;
170                 boolean firstStart = !new File("sone.properties").exists();
171                 boolean newConfig = false;
172                 try {
173                         oldConfiguration = new Configuration(new MapConfigurationBackend(new File("sone.properties"), false));
174                         newConfiguration = oldConfiguration;
175                 } catch (ConfigurationException ce1) {
176                         newConfig = true;
177                         logger.log(Level.INFO, "Could not load configuration file, trying plugin store…", ce1);
178                         try {
179                                 newConfiguration = new Configuration(new MapConfigurationBackend(new File("sone.properties"), true));
180                                 logger.log(Level.INFO, "Created new configuration file.");
181                         } catch (ConfigurationException ce2) {
182                                 logger.log(Level.SEVERE, "Could not create configuration file, using Plugin Store!", ce2);
183                         }
184                         try {
185                                 oldConfiguration = new Configuration(new PluginStoreConfigurationBackend(pluginRespirator));
186                                 logger.log(Level.INFO, "Plugin store loaded.");
187                         } catch (DatabaseDisabledException dde1) {
188                                 logger.log(Level.SEVERE, "Could not load any configuration, using empty configuration!");
189                                 oldConfiguration = new Configuration(new MapConfigurationBackend());
190                         }
191                 }
192
193                 final Configuration startConfiguration = oldConfiguration;
194                 final EventBus eventBus = new EventBus();
195
196                 /* Freenet injector configuration. */
197                 AbstractModule freenetModule = new AbstractModule() {
198
199                         @Override
200                         @SuppressWarnings("synthetic-access")
201                         protected void configure() {
202                                 bind(PluginRespirator.class).toInstance(SonePlugin.this.pluginRespirator);
203                                 bind(Node.class).toInstance(SonePlugin.this.pluginRespirator.getNode());
204                         }
205                 };
206                 /* Sone injector configuration. */
207                 AbstractModule soneModule = new AbstractModule() {
208
209                         @Override
210                         protected void configure() {
211                                 bind(Core.class).in(Singleton.class);
212                                 bind(MemoryDatabase.class).in(Singleton.class);
213                                 bind(EventBus.class).toInstance(eventBus);
214                                 bind(Configuration.class).toInstance(startConfiguration);
215                                 bind(FreenetInterface.class).in(Singleton.class);
216                                 bind(PluginConnector.class).in(Singleton.class);
217                                 bind(WebOfTrustConnector.class).in(Singleton.class);
218                                 bind(WebOfTrustUpdater.class).in(Singleton.class);
219                                 bind(IdentityManager.class).in(Singleton.class);
220                                 bind(String.class).annotatedWith(Names.named("WebOfTrustContext")).toInstance("Sone");
221                                 bind(SonePlugin.class).toInstance(SonePlugin.this);
222                                 bind(FcpInterface.class).in(Singleton.class);
223                                 bind(Database.class).to(MemoryDatabase.class);
224                                 bind(SoneProvider.class).to(Core.class).in(Singleton.class);
225                                 bind(PostProvider.class).to(MemoryDatabase.class);
226                                 bindListener(Matchers.any(), new TypeListener() {
227
228                                         @Override
229                                         public <I> void hear(TypeLiteral<I> typeLiteral, TypeEncounter<I> typeEncounter) {
230                                                 typeEncounter.register(new InjectionListener<I>() {
231
232                                                         @Override
233                                                         public void afterInjection(I injectee) {
234                                                                 eventBus.register(injectee);
235                                                         }
236                                                 });
237                                         }
238                                 });
239                         }
240
241                 };
242                 Injector injector = Guice.createInjector(freenetModule, soneModule);
243                 core = injector.getInstance(Core.class);
244
245                 /* create web of trust connector. */
246                 webOfTrustConnector = injector.getInstance(WebOfTrustConnector.class);
247
248                 /* create FCP interface. */
249                 fcpInterface = injector.getInstance(FcpInterface.class);
250                 core.setFcpInterface(fcpInterface);
251
252                 /* create the web interface. */
253                 webInterface = injector.getInstance(WebInterface.class);
254
255                 boolean startupFailed = true;
256                 try {
257
258                         /* start core! */
259                         core.start();
260                         if ((newConfiguration != null) && (oldConfiguration != newConfiguration)) {
261                                 logger.log(Level.INFO, "Setting configuration to file-based configuration.");
262                                 core.setConfiguration(newConfiguration);
263                         }
264                         webInterface.start();
265                         webInterface.setFirstStart(firstStart);
266                         webInterface.setNewConfig(newConfig);
267                         startupFailed = false;
268                 } finally {
269                         if (startupFailed) {
270                                 /*
271                                  * we let the exception bubble up but shut the logging down so
272                                  * that the logfile is not swamped by the installed logging
273                                  * handlers of the failed instances.
274                                  */
275                                 Logging.shutdown();
276                         }
277                 }
278         }
279
280         @Override
281         public void terminate() {
282                 try {
283                         /* stop the web interface. */
284                         webInterface.stop();
285
286                         /* stop the core. */
287                         core.stop();
288
289                         /* stop the web of trust connector. */
290                         webOfTrustConnector.stop();
291                 } catch (Throwable t1) {
292                         logger.log(Level.SEVERE, "Error while shutting down!", t1);
293                 } finally {
294                         /* shutdown logger. */
295                         Logging.shutdown();
296                 }
297         }
298
299         //
300         // INTERFACE FredPluginFCP
301         //
302
303         @Override
304         public void handle(PluginReplySender pluginReplySender, SimpleFieldSet parameters, Bucket data, int accessType) {
305                 fcpInterface.handle(pluginReplySender, parameters, data, accessType);
306         }
307
308         //
309         // INTERFACE FredPluginL10n
310         //
311
312         @Override
313         public String getString(String key) {
314                 return l10n.getBase().getString(key);
315         }
316
317         @Override
318         public void setLanguage(LANGUAGE newLanguage) {
319                 l10n = new PluginL10n(this, newLanguage);
320         }
321
322         //
323         // INTERFACE FredPluginBaseL10n
324         //
325
326         @Override
327         public String getL10nFilesBasePath() {
328                 return "i18n";
329         }
330
331         @Override
332         public String getL10nFilesMask() {
333                 return "sone.${lang}.properties";
334         }
335
336         @Override
337         public String getL10nOverrideFilesMask() {
338                 return "sone.${lang}.override.properties";
339         }
340
341         @Override
342         public ClassLoader getPluginClassLoader() {
343                 return SonePlugin.class.getClassLoader();
344         }
345
346         //
347         // INTERFACE FredPluginVersioned
348         //
349
350         @Override
351         public String getVersion() {
352                 return VERSION.toString();
353         }
354
355 }