org.schabi.newpipe.extractor.utils

Class Utils

java.lang.Object

org.schabi.newpipe.extractor.utils.Utils

public final class Utils
extends Object

Field Summary

Fields

Modifier and Type	Field and Description
static String	EMPTY_STRING
static String	HTTP
static String	HTTPS
static String	UTF_8

Method Summary

Modifier and Type	Method and Description
static void	checkUrl(String pattern, String url) Check if the url matches the pattern.
static String	followGoogleRedirectIfNeeded(String url) If the provided url is a Google search redirect, then the actual url is extracted from the url= query value and returned, otherwise the original url is returned.
static String	getBaseUrl(String url)
static String	getQueryValue(URL url, String parameterName) Get the value of a URL-query by name.
static String	getStringResultFromRegexArray(String input, Pattern[] regexes) Find the result of an array of Patterns inside an input on the first group (0).
static String	getStringResultFromRegexArray(String input, Pattern[] regexes, int group) Find the result of an array of Patterns inside an input on a specific group.
static String	getStringResultFromRegexArray(String input, String[] regexes) Find the result of an array of string regular expressions inside an input on the first group (0).
static String	getStringResultFromRegexArray(String input, String[] regexes, int group) Find the result of an array of string regular expressions inside an input on a specific group.
static boolean	isBlank(String string)
static boolean	isHTTP(URL url)
static boolean	isNullOrEmpty(Collection<?> collection) Checks if a collection is null or empty.
static <K,V> boolean	isNullOrEmpty(Map<K,V> map) Checks if a map is null or empty.
static boolean	isNullOrEmpty(String str)
static boolean	isWhitespace(int c)
static String	join(CharSequence delimiter, Iterable<? extends CharSequence> elements)
static String	join(String delimiter, String mapJoin, Map<? extends CharSequence,? extends CharSequence> elements)
static long	mixedNumberWordToLong(String numberWord) Convert a mixed number word to a long.
static String	nonEmptyAndNullJoin(CharSequence delimiter, String[] elements) Concatenate all non-null, non-empty and strings which are not equal to "null".
static String	removeMAndWWWFromUrl(String url)
static String	removeNonDigitCharacters(String toRemove) Remove all non-digit characters from a string.
static String	removeUTF8BOM(String s)
static String	replaceHttpWithHttps(String url)
static URL	stringToURL(String url) Convert a string to a URL object.

Methods inherited from class java.lang.Object

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

Field Detail

HTTP

public static final String HTTP

See Also:

Constant Field Values

HTTPS

public static final String HTTPS

See Also:

Constant Field Values

UTF_8

public static final String UTF_8

See Also:

Constant Field Values

EMPTY_STRING

public static final String EMPTY_STRING

See Also:

Constant Field Values

Method Detail

removeNonDigitCharacters

@Nonnull
public static String removeNonDigitCharacters(@Nonnull
                                                       String toRemove)

Remove all non-digit characters from a string.

Examples:

• 1 234 567 views -> 1234567
• $31,133.124 -> 31133124

Parameters:

toRemove - string to remove non-digit chars

Returns:

a string that contains only digits

mixedNumberWordToLong

public static long mixedNumberWordToLong(String numberWord)
                                  throws NumberFormatException,
                                         ParsingException

Convert a mixed number word to a long.

Examples:

• 123 -> 123
• 1.23K -> 1230
• 1.23M -> 1230000

Parameters:

numberWord - string to be converted to a long

Returns:

a long

Throws:

NumberFormatException

ParsingException

checkUrl

public static void checkUrl(String pattern,
                            String url)
                     throws ParsingException

Check if the url matches the pattern.

Parameters:

pattern - the pattern that will be used to check the url

url - the url to be tested

Throws:

ParsingException

replaceHttpWithHttps

public static String replaceHttpWithHttps(String url)

getQueryValue

@Nullable
public static String getQueryValue(@Nonnull
                                             URL url,
                                             String parameterName)

Get the value of a URL-query by name.

If an url-query is give multiple times, only the value of the first query is returned.

Parameters:

url - the url to be used

parameterName - the pattern that will be used to check the url

Returns:

a string that contains the value of the query parameter or null if nothing was found

stringToURL

@Nonnull
public static URL stringToURL(String url)
                                throws MalformedURLException

Convert a string to a URL object.

Defaults to HTTP if no protocol is given.

Parameters:

url - the string to be converted to a URL-Object

Returns:

a URL object containing the url

Throws:

MalformedURLException

isHTTP

public static boolean isHTTP(@Nonnull
                             URL url)

removeMAndWWWFromUrl

public static String removeMAndWWWFromUrl(String url)

removeUTF8BOM

@Nonnull
public static String removeUTF8BOM(@Nonnull
                                            String s)

getBaseUrl

@Nonnull
public static String getBaseUrl(String url)
                                  throws ParsingException

Throws:

ParsingException

followGoogleRedirectIfNeeded

public static String followGoogleRedirectIfNeeded(String url)

If the provided url is a Google search redirect, then the actual url is extracted from the url= query value and returned, otherwise the original url is returned.

Parameters:

url - the url which can possibly be a Google search redirect

Returns:

an url with no Google search redirects

isNullOrEmpty

public static boolean isNullOrEmpty(String str)

isNullOrEmpty

public static boolean isNullOrEmpty(Collection<?> collection)

Checks if a collection is null or empty.

This method can be also used for JsonArrays.

Parameters:

collection - the collection on which check if it's null or empty

Returns:

whether the collection is null or empty

isNullOrEmpty

public static <K,V> boolean isNullOrEmpty(Map<K,V> map)

Checks if a map is null or empty.

This method can be also used for JsonObjects.

Parameters:

map - the map on which check if it's null or empty

Returns:

whether the map is null or empty

isWhitespace

public static boolean isWhitespace(int c)

isBlank

public static boolean isBlank(String string)

join

@Nonnull
public static String join(CharSequence delimiter,
                                   @Nonnull
                                   Iterable<? extends CharSequence> elements)

join

@Nonnull
public static String join(String delimiter,
                                   String mapJoin,
                                   @Nonnull
                                   Map<? extends CharSequence,? extends CharSequence> elements)

nonEmptyAndNullJoin

@Nonnull
public static String nonEmptyAndNullJoin(CharSequence delimiter,
                                                  String[] elements)

Concatenate all non-null, non-empty and strings which are not equal to "null".

getStringResultFromRegexArray

@Nonnull
public static String getStringResultFromRegexArray(@Nonnull
                                                            String input,
                                                            @Nonnull
                                                            String[] regexes)
                                                     throws Parser.RegexException

Find the result of an array of string regular expressions inside an input on the first group (0).

Parameters:

input - the input on which using the regular expressions

regexes - the string array of regular expressions

Returns:

the result

Throws:

Parser.RegexException - if none of the patterns match the input

getStringResultFromRegexArray

@Nonnull
public static String getStringResultFromRegexArray(@Nonnull
                                                            String input,
                                                            @Nonnull
                                                            Pattern[] regexes)
                                                     throws Parser.RegexException

Find the result of an array of Patterns inside an input on the first group (0).

Parameters:

input - the input on which using the regular expressions

regexes - the Pattern array

Returns:

the result

Throws:

Parser.RegexException - if none of the patterns match the input

getStringResultFromRegexArray

@Nonnull
public static String getStringResultFromRegexArray(@Nonnull
                                                            String input,
                                                            @Nonnull
                                                            String[] regexes,
                                                            int group)
                                                     throws Parser.RegexException

Find the result of an array of string regular expressions inside an input on a specific group.

Parameters:

input - the input on which using the regular expressions

regexes - the string array of regular expressions

group - the group to match

Returns:

the result

Throws:

Parser.RegexException - if none of the patterns match the input, or at least in the specified group

getStringResultFromRegexArray

@Nonnull
public static String getStringResultFromRegexArray(@Nonnull
                                                            String input,
                                                            @Nonnull
                                                            Pattern[] regexes,
                                                            int group)
                                                     throws Parser.RegexException

Find the result of an array of Patterns inside an input on a specific group.

Parameters:

input - the input on which using the regular expressions

regexes - the Pattern array

group - the group to match

Returns:

the result

Throws:

Parser.RegexException - if none of the patterns match the input, or at least in the specified group