1 package be
.nikiroo
.fanfix
.supported
;
3 import java
.io
.IOException
;
4 import java
.io
.InputStream
;
6 import java
.util
.AbstractMap
;
7 import java
.util
.ArrayList
;
8 import java
.util
.HashMap
;
11 import java
.util
.Map
.Entry
;
12 import java
.util
.TreeMap
;
14 import org
.jsoup
.nodes
.Document
;
16 import be
.nikiroo
.fanfix
.Instance
;
17 import be
.nikiroo
.fanfix
.bundles
.Config
;
18 import be
.nikiroo
.fanfix
.data
.MetaData
;
19 import be
.nikiroo
.fanfix
.data
.Story
;
20 import be
.nikiroo
.utils
.IOUtils
;
21 import be
.nikiroo
.utils
.Image
;
22 import be
.nikiroo
.utils
.Progress
;
25 * Support class for <a href="http://www.fimfiction.net/">FimFiction.net</a>
26 * stories, a website dedicated to My Little Pony.
28 * This version uses the new, official API of FimFiction.
32 class FimfictionApi
extends BasicSupport
{
36 private Map
<Integer
, String
> chapterNames
;
37 private Map
<Integer
, String
> chapterContents
;
39 public FimfictionApi() throws IOException
{
40 if (Instance
.getConfig().getBoolean(
41 Config
.LOGIN_FIMFICTION_APIKEY_FORCE_HTML
, false)) {
42 throw new IOException(
43 "Configuration is set to force HTML scrapping");
46 String oauth
= Instance
.getConfig().getString(
47 Config
.LOGIN_FIMFICTION_APIKEY_TOKEN
);
49 if (oauth
== null || oauth
.isEmpty()) {
50 String clientId
= Instance
.getConfig().getString(
51 Config
.LOGIN_FIMFICTION_APIKEY_CLIENT_ID
)
53 String clientSecret
= Instance
.getConfig().getString(
54 Config
.LOGIN_FIMFICTION_APIKEY_CLIENT_SECRET
)
57 if (clientId
.trim().isEmpty() || clientSecret
.trim().isEmpty()) {
58 throw new IOException("API key required for the beta API v2");
61 oauth
= generateOAuth(clientId
, clientSecret
);
63 Instance
.getConfig().setString(
64 Config
.LOGIN_FIMFICTION_APIKEY_TOKEN
, oauth
);
65 Instance
.getConfig().updateFile();
72 protected Document
loadDocument(URL source
) throws IOException
{
78 public String
getOAuth() {
83 protected boolean isHtml() {
88 * Extract the full JSON data we will later use to build the {@link Story}.
90 * @return the data in a JSON format
93 * in case of I/O error
95 private String
getJsonData() throws IOException
{
96 // extract the ID from:
97 // https://www.fimfiction.net/story/123456/name-of-story
98 String storyId
= getKeyText(getSource().toString(), "/story/", null,
101 // Selectors, so to download all I need and only what I need
102 String storyContent
= "fields[story]=title,description,date_published,cover_image";
103 String authorContent
= "fields[author]=name";
104 String chapterContent
= "fields[chapter]=chapter_number,title,content_html,authors_note_html";
105 String includes
= "author,chapters,tags";
107 String urlString
= String
.format(
108 "https://www.fimfiction.net/api/v2/stories/%s?" //
112 storyContent
, authorContent
, chapterContent
,//
115 // URL params must be URL-encoded: "[ ]" <-> "%5B %5D"
116 urlString
= urlString
.replace("[", "%5B").replace("]", "%5D");
118 URL url
= new URL(urlString
);
119 InputStream jsonIn
= Instance
.getCache().open(url
, this, false);
121 return IOUtils
.readSmallStream(jsonIn
);
128 protected MetaData
getMeta() throws IOException
{
129 MetaData meta
= new MetaData();
131 meta
.setTitle(getKeyJson(json
, 0, "type", "story", "title"));
132 meta
.setAuthor(getKeyJson(json
, 0, "type", "user", "name"));
133 meta
.setDate(getKeyJson(json
, 0, "type", "story", "date_published"));
134 meta
.setTags(getTags());
135 meta
.setSource(getType().getSourceName());
136 meta
.setUrl(getSource().toString());
137 meta
.setPublisher(getType().getSourceName());
138 meta
.setUuid(getSource().toString());
141 meta
.setSubject("MLP");
142 meta
.setType(getType().toString());
143 meta
.setImageDocument(false);
145 String coverImageLink
= getKeyJson(json
, 0, "type", "story",
146 "cover_image", "full");
147 if (!coverImageLink
.trim().isEmpty()) {
148 URL coverImageUrl
= new URL(coverImageLink
.trim());
150 InputStream in
= Instance
.getCache()
151 .open(coverImageUrl
, this, true);
153 meta
.setCover(new Image(in
));
162 private List
<String
> getTags() {
163 List
<String
> tags
= new ArrayList
<String
>();
168 pos
= indexOfJsonAfter(json
, pos
, "type", "story_tag");
170 tags
.add(getKeyJson(json
, pos
, "name").trim());
178 protected String
getDesc() {
179 String desc
= getKeyJson(json
, 0, "type", "story", "description");
180 return unbbcode(desc
);
184 protected List
<Entry
<String
, URL
>> getChapters(Progress pg
) {
185 chapterNames
= new TreeMap
<Integer
, String
>();
186 chapterContents
= new TreeMap
<Integer
, String
>();
190 pos
= indexOfJsonAfter(json
, pos
, "type", "chapter");
192 int posNumber
= indexOfJsonAfter(json
, pos
, "chapter_number");
193 int posComa
= json
.indexOf(",", posNumber
);
194 final int number
= Integer
.parseInt(json
.substring(posNumber
,
196 final String title
= getKeyJson(json
, pos
, "title");
197 String notes
= getKeyJson(json
, pos
, "authors_note_html");
198 String content
= getKeyJson(json
, pos
, "content_html");
200 if (!notes
.trim().isEmpty()) {
201 notes
= "<br/>* * *<br/>" + notes
;
204 chapterNames
.put(number
, title
);
205 chapterContents
.put(number
, content
+ notes
);
209 List
<Entry
<String
, URL
>> urls
= new ArrayList
<Entry
<String
, URL
>>();
210 for (String title
: chapterNames
.values()) {
211 urls
.add(new AbstractMap
.SimpleEntry
<String
, URL
>(title
, null));
218 protected String
getChapterContent(URL source
, int number
, Progress pg
) {
219 return chapterContents
.get(number
);
223 protected boolean supports(URL url
) {
224 return "fimfiction.net".equals(url
.getHost())
225 || "www.fimfiction.net".equals(url
.getHost());
229 * Generate a new token from the client ID and secret.
231 * Note that those tokens are long-lived, and it would be badly seen to
232 * create a lot of them without due cause.
234 * So, please cache and re-use them.
237 * the client ID offered on FimFiction
238 * @param clientSecret
239 * the client secret that goes with it
241 * @return a new generated token linked to that client ID
243 * @throws IOException
244 * in case of I/O errors
246 static private String
generateOAuth(String clientId
, String clientSecret
)
248 URL url
= new URL("https://www.fimfiction.net/api/v2/token");
249 Map
<String
, String
> params
= new HashMap
<String
, String
>();
250 params
.put("client_id", clientId
);
251 params
.put("client_secret", clientSecret
);
252 params
.put("grant_type", "client_credentials");
253 InputStream in
= Instance
.getCache().openNoCache(url
, null, params
,
256 String jsonToken
= IOUtils
.readSmallStream(in
);
259 // Extract token type and token from: {
260 // token_type = "Bearer",
261 // access_token = "xxxxxxxxxxxxxx"
264 String tokenType
= getKeyText(jsonToken
, "\"token_type\"", "\"", "\"");
265 String token
= getKeyText(jsonToken
, "\"access_token\"", "\"", "\"");
267 return tokenType
+ " " + token
;
270 // afters: [name, value] pairs (or "" for any of them), can end without
272 static private int indexOfJsonAfter(String json
, int startAt
,
273 String
... afterKeys
) {
274 ArrayList
<String
> afters
= new ArrayList
<String
>();
276 for (String key
: afterKeys
) {
277 if (key
!= null && !key
.isEmpty()) {
278 afters
.add("\"" + key
+ "\"");
291 return indexOfAfter(json
, startAt
, afters
.toArray(new String
[] {}));
294 // afters: [name, value] pairs (or "" for any of them), can end without
295 // value but will then be empty, not NULL
296 static private String
getKeyJson(String json
, int startAt
,
297 String
... afterKeys
) {
298 int pos
= indexOfJsonAfter(json
, startAt
, afterKeys
);
304 String wip
= json
.substring(pos
);
306 pos
= nextUnescapedQuote(wip
, 0);
308 wip
= wip
.substring(pos
+ 1);
309 pos
= nextUnescapedQuote(wip
, 0);
311 result
= wip
.substring(0, pos
);
315 result
= result
.replace("\\t", "\t").replace("\\\"", "\"");
320 // next " but don't take \" into account
321 static private int nextUnescapedQuote(String result
, int pos
) {
323 pos
= result
.indexOf("\"", pos
);
324 if (pos
== 0 || (pos
> 0 && result
.charAt(pos
- 1) != '\\')) {
328 if (pos
< result
.length()) {
336 // quick & dirty filter
337 static private String
unbbcode(String bbcode
) {
338 String text
= bbcode
.replace("\\r\\n", "<br/>") //
339 .replace("[i]", "_").replace("[/i]", "_") //
340 .replace("[b]", "*").replace("[/b]", "*") //
341 .replaceAll("\\[[^\\]]*\\]", "");
346 * Return the text between the key and the endKey (and optional subKey can
347 * be passed, in this case we will look for the key first, then take the
348 * text between the subKey and the endKey).
353 * the key to match (also supports "^" at start to say
354 * "only if it starts with" the key)
356 * the sub key or NULL if none
358 * the end key or NULL for "up to the end"
359 * @return the text or NULL if not found
361 static private String
getKeyText(String in
, String key
, String subKey
,
363 String result
= null;
366 if (line
!= null && line
.contains(key
)) {
367 line
= line
.substring(line
.indexOf(key
) + key
.length());
368 if (subKey
== null || subKey
.isEmpty() || line
.contains(subKey
)) {
369 if (subKey
!= null) {
370 line
= line
.substring(line
.indexOf(subKey
)
373 if (endKey
== null || line
.contains(endKey
)) {
374 if (endKey
!= null) {
375 line
= line
.substring(0, line
.indexOf(endKey
));
386 * Return the first index after all the given "afters" have been found in
387 * the {@link String}, or -1 if it was not possible.
392 * start at this position in the string
394 * the sub-keys to find before checking for key/endKey
396 * @return the text or NULL if not found
398 static private int indexOfAfter(String in
, int startAt
, String
... afters
) {
400 if (in
!= null && !in
.isEmpty()) {
402 if (afters
!= null) {
403 for (int i
= 0; pos
>= 0 && i
< afters
.length
; i
++) {
404 String subKey
= afters
[i
];
405 if (!subKey
.isEmpty()) {
406 pos
= in
.indexOf(subKey
, pos
);
408 pos
+= subKey
.length();