1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
package Torello.HTML.Tools.NewsSite;

import Torello.HTML.*;

import java.util.*;
import java.util.function.*;
import java.net.URL;
import java.io.*;

/**
 * This function-pointer / lambda-target interface which facilitates extracting news-article
 * {@code URL's} on the main-page (or a sub-sections) of a news-media web-site.
 * 
 * <BR /><BR /><EMBED CLASS='external-html' DATA-FILE-ID=LINKS_GET>
 */
@FunctionalInterface
public interface LinksGet extends BiFunction<URL, Vector<HTMLNode>, Vector<String>>, Serializable
{
    /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUIDFI>  */
    public static final long serialVersionUID = 1;

    /**
     * <EMBED CLASS='external-html' DATA-FILE-ID=FUNC_INTER_METH>
     *
     * <BR /><BR />The purpose of this method is to retrieve all of the relevant HTML Anchor
     * Elements from a news-website.
     * 
     * @param url The {@code URL} of a section of a newspaper, or content, website.
     * @param page The download of that {@code URL} into a vectorized-html page.
     * 
     * @return A list of all the {@code TagNode's} that have relevant 
     * {@code URL}-link information.
     */
    public Vector<String> apply(URL url, Vector<HTMLNode> page);
}