Object
- AbstractMetadata
- - ModifiableMetadata
  - - MetadataEntity
    - - CitationImpl

All Implemented Interfaces:

Serializable, Cloneable, Citation
```
public class CitationImpl
extends MetadataEntity
implements Citation
```
Standardized resource reference.

Since:

2.1

Author:

Martin Desruisseaux (IRD), Jody Garnett

See Also:

Serialized Form

Field Summary
- Fields inherited from class AbstractMetadata
  LOGGER

Constructor Summary

Constructors
Constructor	Description
`CitationImpl()`	Constructs an initially empty citation.
`CitationImpl(CharSequence title)`	Constructs a citation with the specified title.
`CitationImpl(Citation source)`	Constructs a new citation initialized to the values specified by the given object.
`CitationImpl(ResponsibleParty party)`	Constructs a citation with the specified responsible party.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`Collection<InternationalString>`	`getAlternateTitles()`	Returns the short name or other language name by which the cited information is known.
`Collection<ResponsibleParty>`	`getCitedResponsibleParties()`	Returns the name and position information for an individual or organization that is responsible for the resource.
`InternationalString`	`getCollectiveTitle()`	Returns the common title with holdings note.
`Collection<CitationDate>`	`getDates()`	Returns the reference date for the cited resource.
`InternationalString`	`getEdition()`	Returns the version of the cited resource.
`Date`	`getEditionDate()`	Returns the date of the edition, or `null` if none.
`Collection<Identifier>`	`getIdentifiers()`	Returns the unique identifier for the resource.
`String`	`getISBN()`	Returns the International Standard Book Number, or `null` if none.
`String`	`getISSN()`	Returns the International Standard Serial Number, or `null` if none.
`InternationalString`	`getOtherCitationDetails()`	Returns other information required to complete the citation that is not recorded elsewhere.
`Collection<PresentationForm>`	`getPresentationForm()`	Returns the mode in which the resource is represented, or an empty string if none.
`Series`	`getSeries()`	Returns the information about the series, or aggregate dataset, of which the dataset is a part.
`InternationalString`	`getTitle()`	Returns the name by which the cited resource is known.
`void`	`setAlternateTitles(Collection<? extends InternationalString> newValues)`	Set the short name or other language name by which the cited information is known.
`void`	`setCitedResponsibleParties(Collection<? extends ResponsibleParty> newValues)`	Set the name and position information for an individual or organization that is responsible for the resource.
`void`	`setCollectiveTitle(InternationalString newValue)`	Set the common title with holdings note.
`void`	`setDates(Collection<? extends CitationDate> newValues)`	Set the reference date for the cited resource.
`void`	`setEdition(InternationalString newValue)`	Set the version of the cited resource.
`void`	`setEditionDate(Date newValue)`	Set the date of the edition, or `null` if none.
`void`	`setIdentifiers(Collection<? extends Identifier> newValues)`	Set the unique identifier for the resource.
`void`	`setISBN(String newValue)`	Set the International Standard Book Number, or `null` if none.
`void`	`setISSN(String newValue)`	Set the International Standard Serial Number, or `null` if none.
`void`	`setOtherCitationDetails(InternationalString newValue)`	Set other information required to complete the citation that is not recorded elsewhere.
`void`	`setPresentationForm(Collection<? extends PresentationForm> newValues)`	Set the mode in which the resource is represented, or an empty string if none.
`void`	`setSeries(Series newValue)`	Set the information about the series, or aggregate dataset, of which the dataset is a part.
`void`	`setTitle(InternationalString newValue)`	Set the name by which the cited resource is known.

Methods inherited from class MetadataEntity
ensureNonNull, getStandard

Methods inherited from class ModifiableMetadata
checkWritePermission, clone, copyCollection, copyList, freeze, isModifiable, nonNullCollection, nonNullList, nonNullSet, unmodifiable

Methods inherited from class AbstractMetadata
asMap, asTree, equals, getInterface, hashCode, toString

Methods inherited from class Object
finalize, getClass, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - CitationImpl
```
public CitationImpl()
```
    Constructs an initially empty citation.
  - CitationImpl
```
public CitationImpl(Citation source)
```
    Constructs a new citation initialized to the values specified by the given object. This constructor performs a shallow copy (i.e. each source attributes are reused without copying them).
  - CitationImpl
```
public CitationImpl(CharSequence title)
```
    Constructs a citation with the specified title.
    
    Parameters:
    
    title - The title, as a String or an InternationalString object.
  - CitationImpl
```
public CitationImpl(ResponsibleParty party)
```
    Constructs a citation with the specified responsible party. This convenience constructor initialize the citation title to the first non-null of the following properties: organisation name, position name or individual name.
    
    Since:
    
    2.2
- Method Detail
  - getTitle
```
public InternationalString getTitle()
```
    Returns the name by which the cited resource is known.
    
    Specified by:
    
    getTitle in interface Citation
    
    Returns:
    
    The cited resource name.
  - setTitle
```
public void setTitle(InternationalString newValue)
```
    Set the name by which the cited resource is known.
  - getAlternateTitles
```
public Collection<InternationalString> getAlternateTitles()
```
    Returns the short name or other language name by which the cited information is known. Example: "DCW" as an alternative title for "Digital Chart of the World".
    
    Specified by:
    
    getAlternateTitles in interface Citation
    
    Returns:
    
    Other names for the resource, or an empty collection if none.
  - setAlternateTitles
```
public void setAlternateTitles(Collection<? extends InternationalString> newValues)
```
    Set the short name or other language name by which the cited information is known.
  - getDates
```
public Collection<CitationDate> getDates()
```
    Returns the reference date for the cited resource.
    
    Specified by:
    
    getDates in interface Citation
    
    Returns:
    
    The reference date.
  - setDates
```
public void setDates(Collection<? extends CitationDate> newValues)
```
    Set the reference date for the cited resource.
  - getEdition
```
public InternationalString getEdition()
```
    Returns the version of the cited resource.
    
    Specified by:
    
    getEdition in interface Citation
    
    Returns:
    
    The version, or null if none.
  - setEdition
```
public void setEdition(InternationalString newValue)
```
    Set the version of the cited resource.
  - getEditionDate
```
public Date getEditionDate()
```
    Returns the date of the edition, or null if none.
    
    Specified by:
    
    getEditionDate in interface Citation
    
    Returns:
    
    The edition date, or null if none.
  - setEditionDate
```
public void setEditionDate(Date newValue)
```
    Set the date of the edition, or null if none.
  - getIdentifiers
```
public Collection<Identifier> getIdentifiers()
```
    Returns the unique identifier for the resource. Example: Universal Product Code (UPC), National Stock Number (NSN).
    
    Specified by:
    
    getIdentifiers in interface Citation
    
    Returns:
    
    The identifiers, or an empty collection if none.
  - setIdentifiers
```
public void setIdentifiers(Collection<? extends Identifier> newValues)
```
    Set the unique identifier for the resource. Example: Universal Product Code (UPC), National Stock Number (NSN).
  - getCitedResponsibleParties
```
public Collection<ResponsibleParty> getCitedResponsibleParties()
```
    Returns the name and position information for an individual or organization that is responsible for the resource. Returns an empty string if there is none.
    
    Specified by:
    
    getCitedResponsibleParties in interface Citation
    
    Returns:
    
    The individual or organization that is responsible, or an empty collection if none.
  - setCitedResponsibleParties
```
public void setCitedResponsibleParties(Collection<? extends ResponsibleParty> newValues)
```
    Set the name and position information for an individual or organization that is responsible for the resource. Returns an empty string if there is none.
  - getPresentationForm
```
public Collection<PresentationForm> getPresentationForm()
```
    Returns the mode in which the resource is represented, or an empty string if none.
    
    Specified by:
    
    getPresentationForm in interface Citation
    
    Returns:
    
    The presentation mode, or an empty collection if none.
  - setPresentationForm
```
public void setPresentationForm(Collection<? extends PresentationForm> newValues)
```
    Set the mode in which the resource is represented, or an empty string if none.
  - getSeries
```
public Series getSeries()
```
    Returns the information about the series, or aggregate dataset, of which the dataset is a part. Returns null if none.
    
    Specified by:
    
    getSeries in interface Citation
    
    Returns:
    
    The series of which the dataset is a part, or null if none.
  - setSeries
```
public void setSeries(Series newValue)
```
    Set the information about the series, or aggregate dataset, of which the dataset is a part. Set to null if none.
  - getOtherCitationDetails
```
public InternationalString getOtherCitationDetails()
```
    Returns other information required to complete the citation that is not recorded elsewhere. Returns null if none.
    
    Specified by:
    
    getOtherCitationDetails in interface Citation
    
    Returns:
    
    Other details, or null if none.
  - setOtherCitationDetails
```
public void setOtherCitationDetails(InternationalString newValue)
```
    Set other information required to complete the citation that is not recorded elsewhere. Set to null if none.
  - getCollectiveTitle
```
public InternationalString getCollectiveTitle()
```
    Returns the common title with holdings note. Note: title identifies elements of a series collectively, combined with information about what volumes are available at the source cited. Returns null if there is no title.
    
    Specified by:
    
    getCollectiveTitle in interface Citation
    
    Returns:
    
    The common title, or null if none.
  - setCollectiveTitle
```
public void setCollectiveTitle(InternationalString newValue)
```
    Set the common title with holdings note. Note: title identifies elements of a series collectively, combined with information about what volumes are available at the source cited. Set to null if there is no title.
  - getISBN
```
public String getISBN()
```
    Returns the International Standard Book Number, or null if none.
    
    Specified by:
    
    getISBN in interface Citation
    
    Returns:
    
    The ISBN, or null if none.
  - setISBN
```
public void setISBN(String newValue)
```
    Set the International Standard Book Number, or null if none.
  - getISSN
```
public String getISSN()
```
    Returns the International Standard Serial Number, or null if none.
    
    Specified by:
    
    getISSN in interface Citation
    
    Returns:
    
    The ISSN, or null if none.
  - setISSN
```
public void setISSN(String newValue)
```
    Set the International Standard Serial Number, or null if none.

Class CitationImpl

Field Summary

Fields inherited from class AbstractMetadata

Constructor Summary

Method Summary

Methods inherited from class MetadataEntity

Methods inherited from class ModifiableMetadata

Methods inherited from class AbstractMetadata

Methods inherited from class Object

Constructor Detail

CitationImpl

CitationImpl

CitationImpl

CitationImpl

Method Detail

getTitle

setTitle

getAlternateTitles

setAlternateTitles

getDates

setDates

getEdition

setEdition

getEditionDate

setEditionDate

getIdentifiers

setIdentifiers

getCitedResponsibleParties

setCitedResponsibleParties

getPresentationForm

setPresentationForm

getSeries

setSeries

getOtherCitationDetails

setOtherCitationDetails

getCollectiveTitle

setCollectiveTitle

getISBN

setISBN

getISSN

setISSN