org.gbif.api.util

Class CitationGenerator

java.lang.Object

org.gbif.api.util.CitationGenerator

public final class CitationGenerator
extends Object

Helper class tha generates a Citation String from Dataset and Organization objects. Documentation : /docs/citations.md

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	CitationGenerator.CitationData

Method Summary

Modifier and Type	Method and Description
static List<String>	generateAuthorsName(List<CitationContact> authors) Given a list of authors, generates a List of String representing the authors name.
static CitationGenerator.CitationData	generateCitation(Dataset dataset, Organization org)
static CitationGenerator.CitationData	generateCitation(Dataset dataset, String organizationTitle) Generate a citation for a Dataset and its Organization.
static String	generatePublisherProvidedCitation(Dataset dataset) Generate a citation for a Dataset using the publisher's provided citation.
static String	getAuthorName(Contact creator) Given a Contact, generates a String for that contact for citation purpose.
static List<CitationContact>	getAuthors(List<Contact> contacts) Extracts an ordered list of unique authors from a list of contacts.

Methods inherited from class java.lang.Object

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

Method Detail

generateCitation

public static CitationGenerator.CitationData generateCitation(Dataset dataset,
                                                              Organization org)

generatePublisherProvidedCitation

public static String generatePublisherProvidedCitation(Dataset dataset)

Generate a citation for a Dataset using the publisher's provided citation.

Parameters:

dataset - dataset

Returns:

generated citation as String

generateCitation

public static CitationGenerator.CitationData generateCitation(Dataset dataset,
                                                              String organizationTitle)

Generate a citation for a Dataset and its Organization. TODO add support for i18n

Returns:

generated citation as String

getAuthors

public static List<CitationContact> getAuthors(List<Contact> contacts)

Extracts an ordered list of unique authors from a list of contacts. A Contact is identified as an author when his ContactType is contained in AUTHOR_CONTACT_TYPE. But, we shall at least have one contact of type MANDATORY_CONTACT_TYPE.

Parameters:

contacts - list of contacts available

Returns:

ordered list of authors or empty list, never null

generateAuthorsName

public static List<String> generateAuthorsName(List<CitationContact> authors)

Given a list of authors, generates a List of String representing the authors name. If a contact doesn't have a first AND last name it will not be included.

Parameters:

authors - ordered list of authors

Returns:

list of author names (if it can be generated) or empty list, never null

getAuthorName

public static String getAuthorName(Contact creator)

Given a Contact, generates a String for that contact for citation purpose. The organization will be used (if present) in case we don't have both lastName and firstNames of the contact.

Parameters:

creator - contact object

Returns:

name