Remove unused session-related methods from public interface
[Sone.git] / src / main / java / net / pterodactylus / sone / web / SoneTemplatePage.java
1 /*
2  * Sone - SoneTemplatePage.java - Copyright © 2010–2016 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.UnsupportedEncodingException;
21 import java.net.URLEncoder;
22 import java.util.ArrayList;
23 import java.util.Arrays;
24 import java.util.Collection;
25 import java.util.Collections;
26 import java.util.List;
27 import java.util.Map;
28
29 import javax.annotation.Nonnull;
30
31 import net.pterodactylus.sone.data.Sone;
32 import net.pterodactylus.sone.main.SonePlugin;
33 import net.pterodactylus.sone.web.page.FreenetRequest;
34 import net.pterodactylus.sone.web.page.FreenetTemplatePage;
35 import net.pterodactylus.util.notify.Notification;
36 import net.pterodactylus.util.template.Template;
37 import net.pterodactylus.util.template.TemplateContext;
38
39 import freenet.clients.http.SessionManager.Session;
40 import freenet.clients.http.ToadletContext;
41 import freenet.support.api.HTTPRequest;
42
43 import com.google.common.collect.ImmutableList;
44 import com.google.common.collect.ImmutableMap;
45
46 /**
47  * Base page for the Sone web interface.
48  *
49  * @author <a href="mailto:bombe@pterodactylus.net">David ‘Bombe’ Roden</a>
50  */
51 public class SoneTemplatePage extends FreenetTemplatePage {
52
53         /** The Sone core. */
54         protected final WebInterface webInterface;
55
56         /** The page title l10n key. */
57         private final String pageTitleKey;
58
59         /** Whether to require a login. */
60         private final boolean requireLogin;
61
62         /**
63          * Creates a new template page for Sone that does not require the user to be
64          * logged in.
65          *
66          * @param path
67          *            The path of the page
68          * @param template
69          *            The template to render
70          * @param pageTitleKey
71          *            The l10n key of the page title
72          * @param webInterface
73          *            The Sone web interface
74          */
75         public SoneTemplatePage(String path, Template template, String pageTitleKey, WebInterface webInterface) {
76                 this(path, template, pageTitleKey, webInterface, false);
77         }
78
79         /**
80          * Creates a new template page for Sone.
81          *
82          * @param path
83          *            The path of the page
84          * @param template
85          *            The template to render
86          * @param webInterface
87          *            The Sone web interface
88          * @param requireLogin
89          *            Whether this page requires a login
90          */
91         public SoneTemplatePage(String path, Template template, WebInterface webInterface, boolean requireLogin) {
92                 this(path, template, null, webInterface, requireLogin);
93         }
94
95         /**
96          * Creates a new template page for Sone.
97          *
98          * @param path
99          *            The path of the page
100          * @param template
101          *            The template to render
102          * @param pageTitleKey
103          *            The l10n key of the page title
104          * @param webInterface
105          *            The Sone web interface
106          * @param requireLogin
107          *            Whether this page requires a login
108          */
109         public SoneTemplatePage(String path, Template template, String pageTitleKey, WebInterface webInterface, boolean requireLogin) {
110                 super(path, webInterface.getTemplateContextFactory(), template, "noPermission.html");
111                 this.pageTitleKey = pageTitleKey;
112                 this.webInterface = webInterface;
113                 this.requireLogin = requireLogin;
114         }
115
116         //
117         // PROTECTED METHODS
118         //
119
120         /**
121          * Returns the currently logged in Sone.
122          *
123          * @param toadletContext
124          *            The toadlet context
125          * @return The currently logged in Sone, or {@code null} if no Sone is
126          *         currently logged in
127          */
128         protected Sone getCurrentSone(ToadletContext toadletContext) {
129                 return webInterface.getCurrentSone(toadletContext);
130         }
131
132         /**
133          * Returns the currently logged in Sone.
134          *
135          * @param toadletContext
136          *            The toadlet context
137          * @param create
138          *            {@code true} to create a new session if no session exists,
139          *            {@code false} to not create a new session
140          * @return The currently logged in Sone, or {@code null} if no Sone is
141          *         currently logged in
142          */
143         protected Sone getCurrentSone(ToadletContext toadletContext, boolean create) {
144                 return webInterface.getCurrentSone(toadletContext, create);
145         }
146
147         /**
148          * Sets the currently logged in Sone.
149          *
150          * @param toadletContext
151          *            The toadlet context
152          * @param sone
153          *            The Sone to set as currently logged in
154          */
155         protected void setCurrentSone(ToadletContext toadletContext, Sone sone) {
156                 webInterface.setCurrentSone(toadletContext, sone);
157         }
158
159         //
160         // TEMPLATEPAGE METHODS
161         //
162
163         /**
164          * {@inheritDoc}
165          */
166         @Override
167         protected String getPageTitle(FreenetRequest request) {
168                 if (pageTitleKey != null) {
169                         return webInterface.getL10n().getString(pageTitleKey);
170                 }
171                 return "";
172         }
173
174         /**
175          * {@inheritDoc}
176          */
177         @Override
178         protected List<Map<String, String>> getAdditionalLinkNodes(FreenetRequest request) {
179                 return ImmutableList.<Map<String, String>> builder().add(ImmutableMap.<String, String> builder().put("rel", "search").put("type", "application/opensearchdescription+xml").put("title", "Sone").put("href", "http://" + request.getHttpRequest().getHeader("host") + "/Sone/OpenSearch.xml").build()).build();
180         }
181
182         /**
183          * {@inheritDoc}
184          */
185         @Override
186         protected Collection<String> getStyleSheets() {
187                 return Arrays.asList("css/sone.css");
188         }
189
190         /**
191          * {@inheritDoc}
192          */
193         @Override
194         protected String getShortcutIcon() {
195                 return "images/icon.png";
196         }
197
198         /**
199          * Returns whether this page requires the user to log in.
200          *
201          * @return {@code true} if the user is required to be logged in to use this
202          *         page, {@code false} otherwise
203          */
204         protected boolean requiresLogin() {
205                 return requireLogin;
206         }
207
208         /**
209          * {@inheritDoc}
210          */
211         @Override
212         protected final void processTemplate(FreenetRequest request, TemplateContext templateContext) throws RedirectException {
213                 super.processTemplate(request, templateContext);
214                 Sone currentSone = getCurrentSone(request.getToadletContext(), false);
215                 templateContext.set("core", webInterface.getCore());
216                 templateContext.set("currentSone", currentSone);
217                 templateContext.set("localSones", webInterface.getCore().getLocalSones());
218                 templateContext.set("request", request);
219                 templateContext.set("currentVersion", SonePlugin.getPluginVersion());
220                 templateContext.set("hasLatestVersion", webInterface.getCore().getUpdateChecker().hasLatestVersion());
221                 templateContext.set("latestEdition", webInterface.getCore().getUpdateChecker().getLatestEdition());
222                 templateContext.set("latestVersion", webInterface.getCore().getUpdateChecker().getLatestVersion());
223                 templateContext.set("latestVersionTime", webInterface.getCore().getUpdateChecker().getLatestVersionDate());
224                 List<Notification> notifications = new ArrayList<Notification>(webInterface.getNotifications(currentSone));
225                 Collections.sort(notifications, Notification.CREATED_TIME_SORTER);
226                 templateContext.set("notifications", notifications);
227                 templateContext.set("notificationHash", notifications.hashCode());
228                 handleRequest(request, templateContext);
229         }
230
231         protected void handleRequest(@Nonnull FreenetRequest request, @Nonnull TemplateContext templateContext) throws RedirectException {
232         }
233
234         /**
235          * {@inheritDoc}
236          */
237         @Override
238         protected String getRedirectTarget(FreenetRequest request) {
239                 if (requiresLogin() && (getCurrentSone(request.getToadletContext(), false) == null)) {
240                         HTTPRequest httpRequest = request.getHttpRequest();
241                         String originalUrl = httpRequest.getPath();
242                         if (httpRequest.hasParameters()) {
243                                 StringBuilder requestParameters = new StringBuilder();
244                                 for (String parameterName : httpRequest.getParameterNames()) {
245                                         if (requestParameters.length() > 0) {
246                                                 requestParameters.append("&");
247                                         }
248                                         String[] parameterValues = httpRequest.getMultipleParam(parameterName);
249                                         for (String parameterValue : parameterValues) {
250                                                 requestParameters.append(urlEncode(parameterName)).append("=").append(urlEncode(parameterValue));
251                                         }
252                                 }
253                                 originalUrl += "?" + requestParameters.toString();
254                         }
255                         return "login.html?target=" + urlEncode(originalUrl);
256                 }
257                 return null;
258         }
259
260         private static String urlEncode(String value) {
261                 try {
262                         return URLEncoder.encode(value, "UTF-8");
263                 } catch (UnsupportedEncodingException uee1) {
264                                                         /* A JVM without UTF-8? I don’t think so. */
265                         throw new RuntimeException(uee1);
266                 }
267         }
268
269         /**
270          * {@inheritDoc}
271          */
272         @Override
273         protected boolean isFullAccessOnly() {
274                 return webInterface.getCore().getPreferences().isRequireFullAccess();
275         }
276
277         /**
278          * {@inheritDoc}
279          */
280         @Override
281         public boolean isEnabled(ToadletContext toadletContext) {
282                 if (webInterface.getCore().getPreferences().isRequireFullAccess() && !toadletContext.isAllowedFullAccess()) {
283                         return false;
284                 }
285                 if (requiresLogin()) {
286                         return getCurrentSone(toadletContext, false) != null;
287                 }
288                 return true;
289         }
290
291 }