org.schabi.newpipe.extractor.downloader

Class Downloader

java.lang.Object

org.schabi.newpipe.extractor.downloader.Downloader

public abstract class Downloader
extends Object

A base for downloader implementations that NewPipe will use to download needed resources during extraction.

Constructor Summary

Constructors

Constructor and Description
Downloader()

Method Summary

Modifier and Type	Method and Description
abstract Response	execute(Request request) Do a request using the specified Request object.
Response	get(String url) Do a GET request to get the resource that the url is pointing to. This method calls get(String, Map, Localization) with the default preferred localization.
Response	get(String url, Localization localization) Do a GET request to get the resource that the url is pointing to. It will set the Accept-Language header to the language of the localization parameter.
Response	get(String url, Map<String,List<String>> headers) Do a GET request with the specified headers.
Response	get(String url, Map<String,List<String>> headers, Localization localization) Do a GET request with the specified headers. It will set the Accept-Language header to the language of the localization parameter.
Response	head(String url) Do a HEAD request.
Response	head(String url, Map<String,List<String>> headers) Do a HEAD request with the specified headers.
Response	post(String url, Map<String,List<String>> headers, byte[] dataToSend) Do a POST request with the specified headers, sending the data array.
Response	post(String url, Map<String,List<String>> headers, byte[] dataToSend, Localization localization) Do a POST request with the specified headers, sending the data array.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Downloader

public Downloader()

Method Detail

get

public Response get(String url)
             throws IOException,
                    ReCaptchaException

Do a GET request to get the resource that the url is pointing to.

This method calls get(String, Map, Localization) with the default preferred localization. It should only be used when the resource that will be fetched won't be affected by the localization.

Parameters:

url - the URL that is pointing to the wanted resource

Returns:

the result of the GET request

Throws:

IOException

ReCaptchaException

get

public Response get(String url,
                    @Nullable
                    Localization localization)
             throws IOException,
                    ReCaptchaException

Do a GET request to get the resource that the url is pointing to.

It will set the Accept-Language header to the language of the localization parameter.

Parameters:

url - the URL that is pointing to the wanted resource

localization - the source of the value of the Accept-Language header

Returns:

the result of the GET request

Throws:

IOException

ReCaptchaException

get

public Response get(String url,
                    @Nullable
                    Map<String,List<String>> headers)
             throws IOException,
                    ReCaptchaException

Do a GET request with the specified headers.

Parameters:

url - the URL that is pointing to the wanted resource

headers - a list of headers that will be used in the request. Any default headers should be overridden by these.

Returns:

the result of the GET request

Throws:

IOException

ReCaptchaException

get

public Response get(String url,
                    @Nullable
                    Map<String,List<String>> headers,
                    @Nullable
                    Localization localization)
             throws IOException,
                    ReCaptchaException

Do a GET request with the specified headers.

It will set the Accept-Language header to the language of the localization parameter.

Parameters:

url - the URL that is pointing to the wanted resource

headers - a list of headers that will be used in the request. Any default headers should be overridden by these.

localization - the source of the value of the Accept-Language header

Returns:

the result of the GET request

Throws:

IOException

ReCaptchaException

head

public Response head(String url)
              throws IOException,
                     ReCaptchaException

Do a HEAD request.

Parameters:

url - the URL that is pointing to the wanted resource

Returns:

the result of the HEAD request

Throws:

IOException

ReCaptchaException

head

public Response head(String url,
                     @Nullable
                     Map<String,List<String>> headers)
              throws IOException,
                     ReCaptchaException

Do a HEAD request with the specified headers.

Parameters:

url - the URL that is pointing to the wanted resource

headers - a list of headers that will be used in the request. Any default headers should be overridden by these.

Returns:

the result of the HEAD request

Throws:

IOException

ReCaptchaException

post

public Response post(String url,
                     @Nullable
                     Map<String,List<String>> headers,
                     @Nullable
                     byte[] dataToSend)
              throws IOException,
                     ReCaptchaException

Do a POST request with the specified headers, sending the data array.

Parameters:

url - the URL that is pointing to the wanted resource

headers - a list of headers that will be used in the request. Any default headers should be overridden by these.

dataToSend - byte array that will be sent when doing the request.

Returns:

the result of the GET request

Throws:

IOException

ReCaptchaException

post

public Response post(String url,
                     @Nullable
                     Map<String,List<String>> headers,
                     @Nullable
                     byte[] dataToSend,
                     @Nullable
                     Localization localization)
              throws IOException,
                     ReCaptchaException

Do a POST request with the specified headers, sending the data array.
It will set the Accept-Language header to the language of the localization parameter.

Parameters:

url - the URL that is pointing to the wanted resource

headers - a list of headers that will be used in the request. Any default headers should be overridden by these.

dataToSend - byte array that will be sent when doing the request.

localization - the source of the value of the Accept-Language header

Returns:

the result of the GET request

Throws:

IOException

ReCaptchaException

execute

public abstract Response execute(@Nonnull
                                 Request request)
                          throws IOException,
                                 ReCaptchaException

Do a request using the specified Request object.

Returns:

the result of the request

Throws:

IOException

ReCaptchaException