Verified Owner
Top Description Methods
org.jabref.logic.importer

public Interface UrlBasedFetcher

extends WebFetcher
Known Direct Implementers
org.jabref.logic.importer.fetcher.GenericUrlBasedFetcher
Annotations
@NullMarked
Imports
java.util.List, org.jabref.model.entry.BibEntry, org.jspecify.annotations.NullMarked

Searches web resources for bibliographic information based on a URL pointing to the resource. May return multiple search hits, since a single URL can represent several works (e.g. an author's publication list or a conference proceedings page).

Method Summary

Modifier and TypeMethod and Description
public List<BibEntry>

Returns:

a list of BibEntry, one entry per hit found for the URL (may be empty, but never 'null')
performSearch
(String
a string containing the URL of the resource
url
)

Looks for bibliographic information for the resource located at the given URL.

Inherited from org.jabref.logic.importer.WebFetcher:
getHelpPagegetNamegetUrlDownload

Method Detail

performSearchback to summary
public List<BibEntry> performSearch(String url) throws FetcherException

Looks for bibliographic information for the resource located at the given URL.

Implementations must validate the given string themselves (it is typically raw user input, e.g. pasted from the clipboard) and throw a FetcherException if it is not a URL they can handle. Failures while gathering optional data (such as an unreachable host) should not lead to an exception, implementations should instead return the best entry they can construct from the URL alone.

Parameters
url:String

a string containing the URL of the resource

Returns:List<BibEntry>

a list of BibEntry, one entry per hit found for the URL (may be empty, but never 'null')