com.screenscraper.util.agents

Class UserAgentQuery

java.lang.Object

com.screenscraper.util.agents.UserAgentQuery

public class UserAgentQuery
extends java.lang.Object

Class for querying for user agents

Version:

7.0.1a

Method Summary

Modifier and Type	Method and Description
static java.util.List<UserAgent>	getAllUserAgents(BrowserType type, java.time.LocalDate earliest, java.time.LocalDate latest, java.lang.String... browserNames) Returns all user agents that match the given criteria, or an empty list if there are no matching agents found.
static UserAgent	getRandomUserAgent(BrowserType type, java.time.LocalDate earliest, java.time.LocalDate latest, java.lang.String... browserNames) Returns a random user agent that matches the given criteria, or null if there are no matching agents found

Methods inherited from class java.lang.Object

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

Method Detail

getRandomUserAgent

@Nullable
public static UserAgent getRandomUserAgent(@Nullable
                                                      BrowserType type,
                                                      @Nullable
                                                      java.time.LocalDate earliest,
                                                      @Nullable
                                                      java.time.LocalDate latest,
                                                      @NotNull
                                                      java.lang.String... browserNames)

Returns a random user agent that matches the given criteria, or null if there are no matching agents found

Parameters:

type - The type of user agent (null to match any)

earliest - The earliest date of the user agent (null for no early release limit)

latest - The latest date of the user agent (null for no latest release limit)

browserNames - The names of the browsers (empty to match all browsers)

Returns:

A random matching user agent, or null if no matching agent was found

getAllUserAgents

@NotNull
public static java.util.List<UserAgent> getAllUserAgents(@Nullable
                                                                   BrowserType type,
                                                                   @Nullable
                                                                   java.time.LocalDate earliest,
                                                                   @Nullable
                                                                   java.time.LocalDate latest,
                                                                   @NotNull
                                                                   java.lang.String... browserNames)

Returns all user agents that match the given criteria, or an empty list if there are no matching agents found. The returned list is unmodifiable

Parameters:

type - The type of user agent (null to match any)

earliest - The earliest date of the user agent (null for no early release limit)

latest - The latest date of the user agent (null for no latest release limit)

browserNames - The names of the browsers (empty to match all browsers)

Returns:

All user agents that match the given criteria, or an empty list if there are no matching agents found