src/main/java/net/pterodactylus/sone/web/WebInterface.java

   1 /*
   2  * FreenetSone - WebInterface.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.web;
  19
  20 import java.io.InputStream;
  21 import java.io.InputStreamReader;
  22 import java.io.Reader;
  23 import java.io.UnsupportedEncodingException;
  24 import java.net.URI;
  25 import java.net.URISyntaxException;
  26 import java.util.ArrayList;
  27 import java.util.List;
  28 import java.util.logging.Level;
  29 import java.util.logging.Logger;
  30
  31 import net.pterodactylus.sone.core.Core;
  32 import net.pterodactylus.sone.data.Post;
  33 import net.pterodactylus.sone.data.Reply;
  34 import net.pterodactylus.sone.data.Sone;
  35 import net.pterodactylus.sone.freenet.L10nFilter;
  36 import net.pterodactylus.sone.main.SonePlugin;
  37 import net.pterodactylus.sone.template.GetPagePlugin;
  38 import net.pterodactylus.sone.template.PostAccessor;
  39 import net.pterodactylus.sone.template.ReplyAccessor;
  40 import net.pterodactylus.sone.template.RequestChangeFilter;
  41 import net.pterodactylus.sone.template.SoneAccessor;
  42 import net.pterodactylus.sone.template.SubstringFilter;
  43 import net.pterodactylus.sone.web.ajax.BlockSoneAjaxPage;
  44 import net.pterodactylus.sone.web.ajax.DeletePostAjaxPage;
  45 import net.pterodactylus.sone.web.ajax.DeleteReplyAjaxPage;
  46 import net.pterodactylus.sone.web.ajax.FollowSoneAjaxPage;
  47 import net.pterodactylus.sone.web.ajax.GetLikesAjaxPage;
  48 import net.pterodactylus.sone.web.ajax.GetSoneStatusPage;
  49 import net.pterodactylus.sone.web.ajax.GetTranslationPage;
  50 import net.pterodactylus.sone.web.ajax.LikeAjaxPage;
  51 import net.pterodactylus.sone.web.ajax.UnblockSoneAjaxPage;
  52 import net.pterodactylus.sone.web.ajax.UnfollowSoneAjaxPage;
  53 import net.pterodactylus.sone.web.ajax.UnlikeAjaxPage;
  54 import net.pterodactylus.sone.web.page.PageToadlet;
  55 import net.pterodactylus.sone.web.page.PageToadletFactory;
  56 import net.pterodactylus.sone.web.page.StaticPage;
  57 import net.pterodactylus.util.logging.Logging;
  58 import net.pterodactylus.util.service.AbstractService;
  59 import net.pterodactylus.util.template.DateFilter;
  60 import net.pterodactylus.util.template.DefaultTemplateFactory;
  61 import net.pterodactylus.util.template.MatchFilter;
  62 import net.pterodactylus.util.template.PaginationPlugin;
  63 import net.pterodactylus.util.template.ReflectionAccessor;
  64 import net.pterodactylus.util.template.Template;
  65 import net.pterodactylus.util.template.TemplateException;
  66 import net.pterodactylus.util.template.TemplateFactory;
  67 import net.pterodactylus.util.template.TemplateProvider;
  68 import net.pterodactylus.util.template.XmlFilter;
  69 import freenet.clients.http.SessionManager;
  70 import freenet.clients.http.ToadletContainer;
  71 import freenet.l10n.BaseL10n;
  72
  73 /**
  74  * Bundles functionality that a web interface of a Freenet plugin needs, e.g.
  75  * references to l10n helpers.
  76  *
  77  * @author <a href="mailto:bombe@pterodactylus.net">David ‘Bombe’ Roden</a>
  78  */
  79 public class WebInterface extends AbstractService {
  80
  81         /** The logger. */
  82         private static final Logger logger = Logging.getLogger(WebInterface.class);
  83
  84         /** The Sone plugin. */
  85         private final SonePlugin sonePlugin;
  86
  87         /** The registered toadlets. */
  88         private final List<PageToadlet> pageToadlets = new ArrayList<PageToadlet>();
  89
  90         /** The form password. */
  91         private final String formPassword;
  92
  93         /**
  94          * Creates a new web interface.
  95          *
  96          * @param sonePlugin
  97          *            The Sone plugin
  98          */
  99         public WebInterface(SonePlugin sonePlugin) {
 100                 super("Sone Web Interface", false);
 101                 this.sonePlugin = sonePlugin;
 102                 formPassword = sonePlugin.pluginRespirator().getToadletContainer().getFormPassword();
 103         }
 104
 105         //
 106         // ACCESSORS
 107         //
 108
 109         /**
 110          * Returns the Sone core used by the Sone plugin.
 111          *
 112          * @return The Sone core
 113          */
 114         public Core core() {
 115                 return sonePlugin.core();
 116         }
 117
 118         /**
 119          * Returns the l10n helper of the node.
 120          *
 121          * @return The node’s l10n helper
 122          */
 123         public BaseL10n l10n() {
 124                 return sonePlugin.l10n().getBase();
 125         }
 126
 127         /**
 128          * Returns the session manager of the node.
 129          *
 130          * @return The node’s session manager
 131          */
 132         public SessionManager sessionManager() {
 133                 try {
 134                         return sonePlugin.pluginRespirator().getSessionManager(new URI("/"));
 135                 } catch (URISyntaxException use1) {
 136                         logger.log(Level.SEVERE, "Could not get Session Manager!", use1);
 137                         return null;
 138                 }
 139         }
 140
 141         /**
 142          * Returns the node’s form password.
 143          *
 144          * @return The form password
 145          */
 146         public String formPassword() {
 147                 return formPassword;
 148         }
 149
 150         //
 151         // SERVICE METHODS
 152         //
 153
 154         /**
 155          * {@inheritDoc}
 156          */
 157         @Override
 158         protected void serviceStart() {
 159                 registerToadlets();
 160         }
 161
 162         /**
 163          * {@inheritDoc}
 164          */
 165         @Override
 166         protected void serviceStop() {
 167                 unregisterToadlets();
 168         }
 169
 170         //
 171         // PRIVATE METHODS
 172         //
 173
 174         /**
 175          * Register all toadlets.
 176          */
 177         private void registerToadlets() {
 178                 DefaultTemplateFactory templateFactory = new DefaultTemplateFactory();
 179                 templateFactory.addAccessor(Object.class, new ReflectionAccessor());
 180                 templateFactory.addAccessor(Sone.class, new SoneAccessor(core()));
 181                 templateFactory.addAccessor(Post.class, new PostAccessor(core()));
 182                 templateFactory.addAccessor(Reply.class, new ReplyAccessor(core()));
 183                 templateFactory.addFilter("date", new DateFilter());
 184                 templateFactory.addFilter("l10n", new L10nFilter(l10n()));
 185                 templateFactory.addFilter("substring", new SubstringFilter());
 186                 templateFactory.addFilter("xml", new XmlFilter());
 187                 templateFactory.addFilter("change", new RequestChangeFilter());
 188                 templateFactory.addFilter("match", new MatchFilter());
 189                 templateFactory.addPlugin("getpage", new GetPagePlugin());
 190                 templateFactory.addPlugin("paginate", new PaginationPlugin());
 191                 templateFactory.setTemplateProvider(new ClassPathTemplateProvider(templateFactory));
 192                 templateFactory.addTemplateObject("formPassword", formPassword);
 193
 194                 Template loginTemplate = templateFactory.createTemplate(createReader("/templates/login.html"));
 195                 Template indexTemplate = templateFactory.createTemplate(createReader("/templates/index.html"));
 196                 Template addSoneTemplate = templateFactory.createTemplate(createReader("/templates/addSone.html"));
 197                 Template loadSoneTemplate = templateFactory.createTemplate(createReader("/templates/loadSone.html"));
 198                 Template knownSonesTemplate = templateFactory.createTemplate(createReader("/templates/knownSones.html"));
 199                 Template createSoneTemplate = templateFactory.createTemplate(createReader("/templates/createSone.html"));
 200                 Template createPostTemplate = templateFactory.createTemplate(createReader("/templates/createPost.html"));
 201                 Template createReplyTemplate = templateFactory.createTemplate(createReader("/templates/createReply.html"));
 202                 Template editProfileTemplate = templateFactory.createTemplate(createReader("/templates/editProfile.html"));
 203                 Template backupProfileTemplate = templateFactory.createTemplate(createReader("/templates/backup.xml"));
 204                 Template viewSoneTemplate = templateFactory.createTemplate(createReader("/templates/viewSone.html"));
 205                 Template blockSoneTemplate = templateFactory.createTemplate(createReader("/templates/blockSone.html"));
 206                 Template unblockSoneTemplate = templateFactory.createTemplate(createReader("/templates/unblockSone.html"));
 207                 Template viewPostTemplate = templateFactory.createTemplate(createReader("/templates/viewPost.html"));
 208                 Template likePostTemplate = templateFactory.createTemplate(createReader("/templates/like.html"));
 209                 Template unlikePostTemplate = templateFactory.createTemplate(createReader("/templates/unlike.html"));
 210                 Template deletePostTemplate = templateFactory.createTemplate(createReader("/templates/deletePost.html"));
 211                 Template deleteReplyTemplate = templateFactory.createTemplate(createReader("/templates/deleteReply.html"));
 212                 Template followSoneTemplate = templateFactory.createTemplate(createReader("/templates/followSone.html"));
 213                 Template unfollowSoneTemplate = templateFactory.createTemplate(createReader("/templates/unfollowSone.html"));
 214                 Template deleteSoneTemplate = templateFactory.createTemplate(createReader("/templates/deleteSone.html"));
 215                 Template noPermissionTemplate = templateFactory.createTemplate(createReader("/templates/noPermission.html"));
 216                 Template logoutTemplate = templateFactory.createTemplate(createReader("/templates/logout.html"));
 217                 Template optionsTemplate = templateFactory.createTemplate(createReader("/templates/options.html"));
 218                 Template aboutTemplate = templateFactory.createTemplate(createReader("/templates/about.html"));
 219
 220                 PageToadletFactory pageToadletFactory = new PageToadletFactory(sonePlugin.pluginRespirator().getHLSimpleClient(), "/Sone/");
 221                 pageToadlets.add(pageToadletFactory.createPageToadlet(new IndexPage(indexTemplate, this), "Index"));
 222                 pageToadlets.add(pageToadletFactory.createPageToadlet(new CreateSonePage(createSoneTemplate, this), "CreateSone"));
 223                 pageToadlets.add(pageToadletFactory.createPageToadlet(new LoadSonePage(loadSoneTemplate, this)));
 224                 pageToadlets.add(pageToadletFactory.createPageToadlet(new AddSonePage(addSoneTemplate, this)));
 225                 pageToadlets.add(pageToadletFactory.createPageToadlet(new KnownSonesPage(knownSonesTemplate, this), "KnownSones"));
 226                 pageToadlets.add(pageToadletFactory.createPageToadlet(new EditProfilePage(editProfileTemplate, this), "EditProfile"));
 227                 pageToadlets.add(pageToadletFactory.createPageToadlet(new BackupProfilePage(backupProfileTemplate, this)));
 228                 pageToadlets.add(pageToadletFactory.createPageToadlet(new CreatePostPage(createPostTemplate, this)));
 229                 pageToadlets.add(pageToadletFactory.createPageToadlet(new CreateReplyPage(createReplyTemplate, this)));
 230                 pageToadlets.add(pageToadletFactory.createPageToadlet(new ViewSonePage(viewSoneTemplate, this)));
 231                 pageToadlets.add(pageToadletFactory.createPageToadlet(new BlockSonePage(blockSoneTemplate, this)));
 232                 pageToadlets.add(pageToadletFactory.createPageToadlet(new UnblockSonePage(unblockSoneTemplate, this)));
 233                 pageToadlets.add(pageToadletFactory.createPageToadlet(new ViewPostPage(viewPostTemplate, this)));
 234                 pageToadlets.add(pageToadletFactory.createPageToadlet(new LikePage(likePostTemplate, this)));
 235                 pageToadlets.add(pageToadletFactory.createPageToadlet(new UnlikePage(unlikePostTemplate, this)));
 236                 pageToadlets.add(pageToadletFactory.createPageToadlet(new DeletePostPage(deletePostTemplate, this)));
 237                 pageToadlets.add(pageToadletFactory.createPageToadlet(new DeleteReplyPage(deleteReplyTemplate, this)));
 238                 pageToadlets.add(pageToadletFactory.createPageToadlet(new FollowSonePage(followSoneTemplate, this)));
 239                 pageToadlets.add(pageToadletFactory.createPageToadlet(new UnfollowSonePage(unfollowSoneTemplate, this)));
 240                 pageToadlets.add(pageToadletFactory.createPageToadlet(new DeleteSonePage(deleteSoneTemplate, this), "DeleteSone"));
 241                 pageToadlets.add(pageToadletFactory.createPageToadlet(new LoginPage(loginTemplate, this), "Login"));
 242                 pageToadlets.add(pageToadletFactory.createPageToadlet(new LogoutPage(logoutTemplate, this), "Logout"));
 243                 pageToadlets.add(pageToadletFactory.createPageToadlet(new OptionsPage(optionsTemplate, this), "Options"));
 244                 pageToadlets.add(pageToadletFactory.createPageToadlet(new SoneTemplatePage("about.html", aboutTemplate, "Page.About.Title", this), "About"));
 245                 pageToadlets.add(pageToadletFactory.createPageToadlet(new SoneTemplatePage("noPermission.html", noPermissionTemplate, "Page.NoPermission.Title", this)));
 246                 pageToadlets.add(pageToadletFactory.createPageToadlet(new StaticPage("css/", "/static/css/", "text/css")));
 247                 pageToadlets.add(pageToadletFactory.createPageToadlet(new StaticPage("javascript/", "/static/javascript/", "text/javascript")));
 248                 pageToadlets.add(pageToadletFactory.createPageToadlet(new StaticPage("images/", "/static/images/", "image/png")));
 249                 pageToadlets.add(pageToadletFactory.createPageToadlet(new GetTranslationPage(this)));
 250                 pageToadlets.add(pageToadletFactory.createPageToadlet(new GetSoneStatusPage(this)));
 251                 pageToadlets.add(pageToadletFactory.createPageToadlet(new DeletePostAjaxPage(this)));
 252                 pageToadlets.add(pageToadletFactory.createPageToadlet(new DeleteReplyAjaxPage(this)));
 253                 pageToadlets.add(pageToadletFactory.createPageToadlet(new FollowSoneAjaxPage(this)));
 254                 pageToadlets.add(pageToadletFactory.createPageToadlet(new UnfollowSoneAjaxPage(this)));
 255                 pageToadlets.add(pageToadletFactory.createPageToadlet(new BlockSoneAjaxPage(this)));
 256                 pageToadlets.add(pageToadletFactory.createPageToadlet(new UnblockSoneAjaxPage(this)));
 257                 pageToadlets.add(pageToadletFactory.createPageToadlet(new LikeAjaxPage(this)));
 258                 pageToadlets.add(pageToadletFactory.createPageToadlet(new UnlikeAjaxPage(this)));
 259                 pageToadlets.add(pageToadletFactory.createPageToadlet(new GetLikesAjaxPage(this)));
 260
 261                 ToadletContainer toadletContainer = sonePlugin.pluginRespirator().getToadletContainer();
 262                 toadletContainer.getPageMaker().addNavigationCategory("/Sone/index.html", "Navigation.Menu.Name", "Navigation.Menu.Tooltip", sonePlugin);
 263                 for (PageToadlet toadlet : pageToadlets) {
 264                         String menuName = toadlet.getMenuName();
 265                         if (menuName != null) {
 266                                 toadletContainer.register(toadlet, "Navigation.Menu.Name", toadlet.path(), true, "Navigation.Menu.Item." + menuName + ".Name", "Navigation.Menu.Item." + menuName + ".Tooltip", false, toadlet);
 267                         } else {
 268                                 toadletContainer.register(toadlet, null, toadlet.path(), true, false);
 269                         }
 270                 }
 271         }
 272
 273         /**
 274          * Unregisters all toadlets.
 275          */
 276         private void unregisterToadlets() {
 277                 ToadletContainer toadletContainer = sonePlugin.pluginRespirator().getToadletContainer();
 278                 for (PageToadlet pageToadlet : pageToadlets) {
 279                         toadletContainer.unregister(pageToadlet);
 280                 }
 281                 toadletContainer.getPageMaker().removeNavigationCategory("Navigation.Menu.Name");
 282         }
 283
 284         /**
 285          * Creates a {@link Reader} from the {@link InputStream} for the resource
 286          * with the given name.
 287          *
 288          * @param resourceName
 289          *            The name of the resource
 290          * @return A {@link Reader} for the resource
 291          */
 292         private Reader createReader(String resourceName) {
 293                 try {
 294                         return new InputStreamReader(getClass().getResourceAsStream(resourceName), "UTF-8");
 295                 } catch (UnsupportedEncodingException uee1) {
 296                         return null;
 297                 }
 298         }
 299
 300         /**
 301          * Template provider implementation that uses
 302          * {@link WebInterface#createReader(String)} to load templates for
 303          * inclusion.
 304          *
 305          * @author <a href="mailto:bombe@pterodactylus.net">David ‘Bombe’ Roden</a>
 306          */
 307         private class ClassPathTemplateProvider implements TemplateProvider {
 308
 309                 /** The template factory. */
 310                 private final TemplateFactory templateFactory;
 311
 312                 /**
 313                  * Creates a new template provider that locates templates on the
 314                  * classpath.
 315                  *
 316                  * @param templateFactory
 317                  *            The template factory to create the templates
 318                  */
 319                 public ClassPathTemplateProvider(TemplateFactory templateFactory) {
 320                         this.templateFactory = templateFactory;
 321                 }
 322
 323                 /**
 324                  * {@inheritDoc}
 325                  */
 326                 @Override
 327                 @SuppressWarnings("synthetic-access")
 328                 public Template getTemplate(String templateName) {
 329                         Reader templateReader = createReader("/templates/" + templateName);
 330                         if (templateReader == null) {
 331                                 return null;
 332                         }
 333                         Template template = templateFactory.createTemplate(templateReader);
 334                         try {
 335                                 template.parse();
 336                         } catch (TemplateException te1) {
 337                                 logger.log(Level.WARNING, "Could not parse template “" + templateName + "” for inclusion!", te1);
 338                         }
 339                         return template;
 340                 }
 341
 342         }
 343 }