PublicationFetcher (PSI :: JAMI - Java framework for molecular interactions 3.3.0 API)

All Known Subinterfaces:

ImexCentralClient

All Known Implementing Classes:

CachedEuroPubmedCentralFetcher, DefaultImexCentralClient, EuroPubmedCentralFetcher, FailingPublicationFetcher, MockImexCentralClient, MockPublicationFetcher
```
public interface PublicationFetcher
```
The interface for fetching a publication record.

Since:

29/07/13

Author:

Gabriel Aldam (galdam@ebi.ac.uk)

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method	Description
`Publication`	`fetchByIdentifier(String identifier, String source)`	Uses the identifier to search for a publication and return a completed record.
`Collection<Publication>`	`fetchByIdentifiers(Map<String,Collection<String>> identifiers)`	Uses the identifiers to search for publications and return completed records.

- Method Detail
  - fetchByIdentifier
```
Publication fetchByIdentifier(String identifier,
                              String source)
                       throws BridgeFailedException
```
    Uses the identifier to search for a publication and return a completed record.
    
    Parameters:
    
    identifier - The identifier of the publication to search for.
    
    source - The database that the identifier is from (pubmed, doi, ...).
    
    Returns:
    
    A completed record for the publication or null if no publication could be found.
    
    Throws:
    
    BridgeFailedException - if any.
    
    IllegalArgumentException - if identifier is null
    
    IllegalArgumentException - if source is null
  - fetchByIdentifiers
```
Collection<Publication> fetchByIdentifiers(Map<String,Collection<String>> identifiers)
                                    throws BridgeFailedException
```
    Uses the identifiers to search for publications and return completed records.
    
    Parameters:
    
    identifiers - The identifiers of the publications to search for per publication identifier source (pubmed, doi, ...).
    
    Returns:
    
    Completed records for the publications.
    
    Throws:
    
    BridgeFailedException - if any.
    
    IllegalArgumentException - if identifiers is null or key/value is null