Class CrossRefFetcher

java.lang.Object

ubic.gemma.core.loader.crossref.CrossRefFetcher

public class CrossRefFetcher
extends Object

Fetch bibliographic metadata for a DOI from the CrossRef REST API (api.crossref.org).

Complements PubMedSearch: PubMed covers DOIs that NCBI indexes, CrossRef covers the rest — most journal articles and, crucially, bioRxiv / medRxiv preprints that PubMed does not carry. This is what lets a curator attach a preprint to an experiment instead of noting it in a free-text comment.

Plain (non-Spring) helper, constructed at the use site like PubMedSearch. No API key is required; a contact-bearing User-Agent opts into CrossRef's "polite pool".

Author:

gemma

Constructor Summary

Constructors

Constructor	Description
CrossRefFetcher()

Method Summary

Modifier and Type	Method	Description
BibliographicReference	retrieveByDoi(String doi)	Retrieve a BibliographicReference for the given DOI from CrossRef.

Methods inherited from class Object

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

Constructor Details

CrossRefFetcher

public CrossRefFetcher()

Method Details

retrieveByDoi

@Nullable
public BibliographicReference retrieveByDoi(String doi)
                                     throws IOException

Retrieve a BibliographicReference for the given DOI from CrossRef.

Parameters:

doi - a DOI, already normalized to its bare form (no https://doi.org/ prefix).

Returns:

a transient BibliographicReference with its pubAccession set to the DOI (under the ExternalDatabases.DOI external database), or null if CrossRef has no record for the DOI (HTTP 404).

Throws:

IOException - on a transport error or an unexpected (non-200, non-404) CrossRef response.