Remove javadoc comments from overriding methods.
[Sone.git] / src / main / java / net / pterodactylus / sone / web / page / PageToadlet.java
1 /*
2  * Sone - PageToadlet.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.web.page;
19
20 import java.io.IOException;
21 import java.io.OutputStream;
22 import java.net.URI;
23
24 import net.pterodactylus.util.web.Header;
25 import net.pterodactylus.util.web.Method;
26 import net.pterodactylus.util.web.Page;
27 import net.pterodactylus.util.web.Response;
28
29 import freenet.client.HighLevelSimpleClient;
30 import freenet.clients.http.LinkEnabledCallback;
31 import freenet.clients.http.LinkFilterExceptedToadlet;
32 import freenet.clients.http.Toadlet;
33 import freenet.clients.http.ToadletContext;
34 import freenet.clients.http.ToadletContextClosedException;
35 import freenet.support.MultiValueTable;
36 import freenet.support.api.Bucket;
37 import freenet.support.api.HTTPRequest;
38 import freenet.support.io.Closer;
39
40 /**
41  * {@link Toadlet} implementation that is wrapped around a {@link Page}.
42  *
43  * @author <a href="mailto:bombe@pterodactylus.net">David ‘Bombe’ Roden</a>
44  */
45 public class PageToadlet extends Toadlet implements LinkEnabledCallback, LinkFilterExceptedToadlet {
46
47         /** The name of the menu item. */
48         private final String menuName;
49
50         /** The page that handles processing. */
51         private final Page<FreenetRequest> page;
52
53         /** The path prefix for the page. */
54         private final String pathPrefix;
55
56         /**
57          * Creates a new toadlet that hands off processing to a {@link Page}.
58          *
59          * @param highLevelSimpleClient
60          *            The high-level simple client
61          * @param menuName
62          *            The name of the menu item
63          * @param page
64          *            The page to handle processing
65          * @param pathPrefix
66          *            Prefix that is prepended to all {@link Page#getPath()} return
67          *            values
68          */
69         protected PageToadlet(HighLevelSimpleClient highLevelSimpleClient, String menuName, Page<FreenetRequest> page, String pathPrefix) {
70                 super(highLevelSimpleClient);
71                 this.menuName = menuName;
72                 this.page = page;
73                 this.pathPrefix = pathPrefix;
74         }
75
76         /**
77          * Returns the name to display in the menu.
78          *
79          * @return The name in the menu
80          */
81         public String getMenuName() {
82                 return menuName;
83         }
84
85         @Override
86         public String path() {
87                 return pathPrefix + page.getPath();
88         }
89
90         /**
91          * Handles a HTTP GET request.
92          *
93          * @param uri
94          *            The URI of the request
95          * @param httpRequest
96          *            The HTTP request
97          * @param toadletContext
98          *            The toadlet context
99          * @throws IOException
100          *             if an I/O error occurs
101          * @throws ToadletContextClosedException
102          *             if the toadlet context is closed
103          */
104         public void handleMethodGET(URI uri, HTTPRequest httpRequest, ToadletContext toadletContext) throws IOException, ToadletContextClosedException {
105                 handleRequest(new FreenetRequest(uri, Method.GET, httpRequest, toadletContext));
106         }
107
108         /**
109          * Handles a HTTP POST request.
110          *
111          * @param uri
112          *            The URI of the request
113          * @param httpRequest
114          *            The HTTP request
115          * @param toadletContext
116          *            The toadlet context
117          * @throws IOException
118          *             if an I/O error occurs
119          * @throws ToadletContextClosedException
120          *             if the toadlet context is closed
121          */
122         public void handleMethodPOST(URI uri, HTTPRequest httpRequest, ToadletContext toadletContext) throws IOException, ToadletContextClosedException {
123                 handleRequest(new FreenetRequest(uri, Method.POST, httpRequest, toadletContext));
124         }
125
126         @Override
127         public String toString() {
128                 return getClass().getName() + "[path=" + path() + ",page=" + page + "]";
129         }
130
131         /**
132          * Handles a HTTP request.
133          *
134          * @param pageRequest
135          *            The request to handle
136          * @throws IOException
137          *             if an I/O error occurs
138          * @throws ToadletContextClosedException
139          *             if the toadlet context is closed
140          */
141         private void handleRequest(FreenetRequest pageRequest) throws IOException, ToadletContextClosedException {
142                 Bucket pageBucket = null;
143                 OutputStream pageBucketOutputStream = null;
144                 Response pageResponse;
145                 try {
146                         pageBucket = pageRequest.getToadletContext().getBucketFactory().makeBucket(-1);
147                         pageBucketOutputStream = pageBucket.getOutputStream();
148                         pageResponse = page.handleRequest(pageRequest, new Response(pageBucketOutputStream));
149                 } catch (IOException ioe1) {
150                         Closer.close(pageBucket);
151                         throw ioe1;
152                 } finally {
153                         Closer.close(pageBucketOutputStream);
154                 }
155                 MultiValueTable<String, String> headers = new MultiValueTable<String, String>();
156                 if (pageResponse.getHeaders() != null) {
157                         for (Header header : pageResponse.getHeaders()) {
158                                 for (String value : header) {
159                                         headers.put(header.getName(), value);
160                                 }
161                         }
162                 }
163                 try {
164                         writeReply(pageRequest.getToadletContext(), pageResponse.getStatusCode(), pageResponse.getContentType(), pageResponse.getStatusText(), headers, pageBucket);
165                 } finally {
166                         Closer.close(pageBucket);
167                 }
168         }
169
170         @Override
171         public boolean isEnabled(ToadletContext toadletContext) {
172                 if (page instanceof LinkEnabledCallback) {
173                         return ((LinkEnabledCallback) page).isEnabled(toadletContext);
174                 }
175                 return true;
176         }
177
178         //
179         // LINKFILTEREXCEPTEDTOADLET METHODS
180         //
181
182         @Override
183         public boolean isLinkExcepted(URI link) {
184                 return (page instanceof FreenetPage) ? ((FreenetPage) page).isLinkExcepted(link) : false;
185         }
186
187 }