Class VernacularName
- All Implemented Interfaces:
NameUsageExtension
- See Also:
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionboolean
getArea()
The area for the vernacular name.The country in which the vernacular name is used.ISO 639-1 language code used for the vernacular name value.The age class or life stage of the species for which the vernacular name applies.getSex()
The sex (gender) of the taxon for which the vernacular name applies when the vernacular name is limited to a specific gender of a species.Bibliographic citation referencing a source where the vernacular name refers to the cited species.If the source is another name usage this is the taxonKey of that usage.The name usage "taxon" key to which this vernacular name belongs.@NotNull String
A common or vernacular name.int
hashCode()
isPlural()
This value is true if the vernacular name it qualifies refers to a plural form of the name.This term is true if the source citing the use of this vernacular name indicates the usage has some preference or specific standing over other possible vernacular names used for the species.void
void
setCountry
(Country country) void
setLanguage
(Language language) void
setLifeStage
(LifeStage lifeStage) void
void
setPreferred
(Boolean preferred) void
void
void
setSourceTaxonKey
(Integer sourceTaxonKey) void
setTaxonKey
(Integer taxonKey) void
setVernacularName
(String vernacularName) toString()
-
Constructor Details
-
VernacularName
public VernacularName()
-
-
Method Details
-
getTaxonKey
The name usage "taxon" key to which this vernacular name belongs.- Specified by:
getTaxonKey
in interfaceNameUsageExtension
-
setTaxonKey
- Specified by:
setTaxonKey
in interfaceNameUsageExtension
-
getArea
The area for the vernacular name.- Returns:
- the area
-
setArea
- Parameters:
area
- the area to set
-
getCountry
The country in which the vernacular name is used.- Returns:
- the country
-
setCountry
- Parameters:
country
- the country to set
-
getLanguage
ISO 639-1 language code used for the vernacular name value.Example: es
- Returns:
- the language
-
setLanguage
- Parameters:
language
- the language to set
-
getLifeStage
The age class or life stage of the species for which the vernacular name applies. Best practice is to utilise a controlled list of terms for this value.Example: "juvenile" is the life stage of the fish Pomatomus saltatrix for which the name "snapper blue" refers.
- Returns:
- the lifeStage
- See Also:
-
setLifeStage
- Parameters:
lifeStage
- the lifeStage to set
-
getSex
The sex (gender) of the taxon for which the vernacular name applies when the vernacular name is limited to a specific gender of a species. If not limited sex should be empty. For example the vernacular name "Buck" applies to the "Male" gender of the species, Odocoileus virginianus.Example: male.
- Returns:
- the sex
- See Also:
-
setSex
- Parameters:
sex
- the sex to set
-
getSource
Bibliographic citation referencing a source where the vernacular name refers to the cited species.Example: Peterson Field Guide to the Eastern Seashore, Houghton Mifflin Co, 1961, p131.
- Specified by:
getSource
in interfaceNameUsageExtension
- Returns:
- the source
-
setSource
- Specified by:
setSource
in interfaceNameUsageExtension
- Parameters:
source
- the source to set
-
getSourceTaxonKey
Description copied from interface:NameUsageExtension
If the source is another name usage this is the taxonKey of that usage. Only useful for the backbone dataset.- Specified by:
getSourceTaxonKey
in interfaceNameUsageExtension
- Returns:
- The key of the name usage this instance is derived from.
-
setSourceTaxonKey
- Specified by:
setSourceTaxonKey
in interfaceNameUsageExtension
-
getVernacularName
A common or vernacular name.Example: Andean Condor", "Condor Andino", "American Eagle", "Gänsegeier".
- Returns:
- the vernacularName
-
setVernacularName
- Parameters:
vernacularName
- the vernacularName to set
-
isPlural
This value is true if the vernacular name it qualifies refers to a plural form of the name.Example: The term "Schoolies" is the plural form of a name used along the coastal Northeastern U.S. for groups of juvenile fish of the species, Morone saxatilis.
- Returns:
- the plural
- See Also:
-
setPlural
- Parameters:
plural
- the plural to set
-
isPreferred
This term is true if the source citing the use of this vernacular name indicates the usage has some preference or specific standing over other possible vernacular names used for the species.Example: Some organisations have attempted to assign specific and unique vernacular names for particular taxon groups in a systematic attempt to bring order and consistency to the use of these names. For example, the American Ornithological Union assigns the name "Pearl Kite" for the taxon, Gampsonyx swainsonii. The value of isPreferredName for this record would be true.
- Returns:
- the preferred
- See Also:
-
setPreferred
- Parameters:
preferred
- the preferred to set
-
equals
-
hashCode
-
toString
-