2 * Rhynodge - KickAssTorrentsFilter.java - Copyright © 2013 David Roden
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.
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.
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/>.
18 package net.pterodactylus.rhynodge.filters;
20 import static com.google.common.base.Preconditions.checkState;
22 import java.io.UnsupportedEncodingException;
24 import java.net.URISyntaxException;
25 import java.net.URLEncoder;
27 import net.pterodactylus.rhynodge.Filter;
28 import net.pterodactylus.rhynodge.State;
29 import net.pterodactylus.rhynodge.queries.HttpQuery;
30 import net.pterodactylus.rhynodge.states.FailedState;
31 import net.pterodactylus.rhynodge.states.HtmlState;
32 import net.pterodactylus.rhynodge.states.TorrentState;
33 import net.pterodactylus.rhynodge.states.TorrentState.TorrentFile;
35 import org.jsoup.nodes.Document;
36 import org.jsoup.nodes.Element;
37 import org.jsoup.select.Elements;
40 * {@link Filter} implementation that parses a {@link TorrentState} from an
41 * {@link HtmlState} which was generated by a {@link HttpQuery} to
42 * {@code kickasstorrents.ph}.
44 * @author <a href="mailto:bombe@pterodactylus.net">David ‘Bombe’ Roden</a>
46 public abstract class TorrentSiteFilter implements Filter {
52 public State filter(State state) {
53 if (!state.success()) {
54 return FailedState.from(state);
56 checkState(state instanceof HtmlState, "state is not an HtmlState but a %s", state.getClass().getName());
58 /* get result table. */
59 Document document = ((HtmlState) state).document();
61 /* iterate over all rows. */
62 Elements dataRows = getDataRows(document);
63 TorrentState torrentState = new TorrentState();
64 for (Element dataRow : dataRows) {
65 String name = extractName(dataRow);
66 String size = extractSize(dataRow);
67 String magnetUri = extractMagnetUri(dataRow);
68 String downloadUri = extractDownloadUri(dataRow);
69 int fileCount = extractFileCount(dataRow);
70 int seedCount = extractSeedCount(dataRow);
71 int leechCount = extractLeechCount(dataRow);
73 if ((downloadUri != null) && (downloadUri.length() > 0)) {
74 downloadUri = new URI(((HtmlState) state).uri()).resolve(URLEncoder.encode(downloadUri, "UTF-8").replace("%2F", "/")).toString();
78 TorrentFile torrentFile = new TorrentFile(name, size, magnetUri, downloadUri, fileCount, seedCount, leechCount);
79 torrentState.addTorrentFile(torrentFile);
80 } catch (URISyntaxException use1) {
81 /* ignore; if uri was wrong, we wouldn’t be here. */
82 } catch (UnsupportedEncodingException uee1) {
83 /* ignore, all JVMs can do UTF-8. */
95 * Returns the data rows from the given document.
98 * The document to get the data rows from
99 * @return The data rows
101 protected abstract Elements getDataRows(Document document);
104 * Extracts the name from the given row.
107 * The row to extract the name from
108 * @return The extracted name
110 protected abstract String extractName(Element dataRow);
113 * Extracts the size from the given row.
116 * The row to extract the size from
117 * @return The extracted size
119 protected abstract String extractSize(Element dataRow);
122 * Extracts the magnet URI from the given row.
125 * The row to extract the magnet URI from
126 * @return The extracted magnet URI
128 protected abstract String extractMagnetUri(Element dataRow);
131 * Extracts the download URI from the given row.
134 * The row to extract the download URI from
135 * @return The extracted download URI
137 protected abstract String extractDownloadUri(Element dataRow);
140 * Extracts the file count from the given row.
143 * The row to extract the file count from
144 * @return The extracted file count, or {@code 0} if the file count can not
147 protected abstract int extractFileCount(Element dataRow);
150 * Extracts the seed count from the given row.
153 * The row to extract the seed count from
154 * @return The extracted seed count
156 protected abstract int extractSeedCount(Element dataRow);
159 * Extracts the leech count from the given row.
162 * The row to extract the leech count from
163 * @return The extracted leech count
165 protected abstract int extractLeechCount(Element dataRow);