@Entity @Configurable public class Person extends TeamOrPersonBase<Person>
contact
details, institutional membership
,
and other possible information such as life time period
,
taxonomic and/or geographical specialization
.
For a short abbreviated name the inherited attribute nomenclaturalTitle
is to be used.OriginalSource
instances must be created
and the inherited attribute originalNameString
must be used.
This class corresponds to:
Modifier and Type | Field and Description |
---|---|
protected java.util.Set<InstitutionalMembership> |
institutionalMemberships |
static Logger |
logger |
collectorTitle, isGeneratingTitleCache, nomenclaturalTitle
cacheStrategy, NOT_PROTECTED, PROTECTED, protectedTitleCache, titleCache
annotations, markers
CLOB_LENGTH, uuid
Modifier | Constructor and Description |
---|---|
protected |
Person()
Class constructor.
|
|
Person(java.lang.String givenname,
java.lang.String familyname,
java.lang.String nomenclaturalTitel)
Class constructor using a "forenames" string (including initials),
a surname (family name) and an abbreviated name as used in nomenclature.
|
Modifier and Type | Method and Description |
---|---|
protected void |
addInstitutionalMembership(InstitutionalMembership ims) |
InstitutionalMembership |
addInstitutionalMembership(Institution institution,
TimePeriod period,
java.lang.String department,
java.lang.String role)
Adds a new
membership of this person in an institution
to the set of his institution memberships. |
java.lang.Object |
clone()
Clones this Person.
|
java.lang.String |
getFamilyName()
Returns the string representing the hereditary name (surname or family name)
(for instance "Smith") of this person.
|
java.lang.String |
getGivenName()
Returns the string representing the given name or forename
(for instance "John") of this person.
|
java.lang.String |
getInitials()
Returns the initials of this person as used in bibliographic
references.
|
java.util.Set<InstitutionalMembership> |
getInstitutionalMemberships()
Returns the set of
institution memberships corresponding to this person. |
TimePeriod |
getLifespan()
Returns the
period of time
in which this person was alive (life span). |
ORCID |
getOrcid()
The
ORCiD of this person.See https://orcid.org/ for information on ORCiD. |
java.lang.String |
getPrefix()
Returns the string representing the prefix (for instance "Prof. Dr.")
to this person's name.
|
java.lang.String |
getSuffix()
Returns the string representing the suffix (for instance "Junior")
of this person's name.
|
static Person |
NewInstance()
Creates a new empty instance for a person whose existence is all what is known.
|
static Person |
NewInstance(java.lang.String nomRefTitle,
java.lang.String familyName,
java.lang.String initials,
java.lang.String givenName) |
static Person |
NewTitledInstance(java.lang.String titleCache)
Creates a new instance for a person for whom an "identification" string
is all what is known.
|
void |
removeInstitutionalMembership(InstitutionalMembership ims)
Removes one element from the set of institutional memberships of this person.
|
void |
setFamilyName(java.lang.String familyName) |
void |
setGivenName(java.lang.String givenName) |
void |
setInitials(java.lang.String initials) |
void |
setLifespan(TimePeriod lifespan) |
void |
setOrcid(ORCID orcid) |
void |
setPrefix(java.lang.String prefix) |
void |
setSuffix(java.lang.String suffix) |
boolean |
updateCaches() |
getFullTitle, getNomenclaturalTitle, getTitleCache, replaceEmptyTitleByNomTitle, setNomenclaturalTitle
addAddress, addAddress, addEmailAddress, addFaxNumber, addPhoneNumber, addUrl, getAddresses, getContact, getEmailAddresses, getFaxNumbers, getPhoneNumbers, getUrls, removeAddress, removeEmailAddress, removeFaxNumber, removePhoneNumber, removeUrl, setContact
addMedia, getMedia, removeMedia
addCredit, addCredit, addExtension, addExtension, addIdentifier, addIdentifier, addIdentifier, addRights, addSource, addSources, createNewSource, generateTitle, getCacheStrategy, getCredits, getCredits, getData, getExtensions, getExtensions, getExtensions, getExtensionsConcat, getExtensionsConcat, getFilteredExtensions, getIdentifiers, getIdentifiers, getIdentifiers, getLsid, getRights, getTruncatedCache, hasEmptyTitleCache, hasExtension, hasExtension, initListener, isProtectedTitleCache, removeCredit, removeCredit, removeExtension, removeIdentifier, removeIdentifier, removeRights, replaceCredit, replaceIdentifier, resetTitleCache, setCacheStrategy, setLsid, setProtectedTitleCache, setTitleCache, setTitleCache, toString, updateCaches
addAggregationSource, addImportSource, addPrimaryTaxonomicSource, addPrimaryTaxonomicSource, addSource, addSource, getSources, removeSource, removeSources
addAnnotation, addMarker, addMarker, getAnnotations, getAnnotations, getMarkers, getMarkers, hasMarker, hasMarker, markerValue, removeAnnotation, removeMarker, removeMarker, setAnnotations
cloneLanguageString, equals, getUpdated, getUpdatedBy, setUpdated, setUpdatedBy
addPropertyChangeListener, addPropertyChangeListener, addToSetWithChangeEvent, deproxy, deproxy, fireOnCreateEvent, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getCreated, getCreatedBy, getId, getUserFriendlyDescription, getUserFriendlyFieldName, getUserFriendlyTypeName, getUuid, hashCode, hasListeners, instanceToString, invokeSetMethod, invokeSetMethodWithNull, isBlank, isInstanceOf, isNotBlank, isPersited, removeFromSetWithChangeEvent, removePropertyChangeListener, removePropertyChangeListener, replaceInList, setCreated, setCreatedBy, setId, setNewEntityListener, setUuid
finalize, getClass, notify, notifyAll, wait, wait, wait
getCreated, getCreatedBy, getId, getUuid, isInstanceOf, isPersited, setCreated, setCreatedBy, setId, setUuid
removeSources
addAggregationSource, addImportSource, addPrimaryTaxonomicSource, addPrimaryTaxonomicSource, addSource, addSource, getSources, removeSource
addAnnotation, addMarker, getAnnotations, getMarkers, getMarkers, hasMarker, hasMarker, markerValue, removeAnnotation, removeMarker, removeMarker
getUpdated, getUpdatedBy, setUpdated, setUpdatedBy
public static final Logger logger
protected java.util.Set<InstitutionalMembership> institutionalMemberships
protected Person()
Person(String, String, String)
public Person(java.lang.String givenname, java.lang.String familyname, java.lang.String nomenclaturalTitel)
nomenclaturalTitle
is used.givenname
- the given namefamilyname
- the hereditary namenomenclaturalTitel
- the abbreviated namePerson()
,
NewInstance()
public static Person NewInstance()
PersonDefaultCacheStrategy
.public static Person NewTitledInstance(java.lang.String titleCache)
titleCache
attribute and should not be overwritten by the generateTitle
method
the protectedTitleCache
flag will be turned on.public static Person NewInstance(java.lang.String nomRefTitle, java.lang.String familyName, java.lang.String initials, java.lang.String givenName)
public java.util.Set<InstitutionalMembership> getInstitutionalMemberships()
institution memberships
corresponding to this person.InstitutionalMembership
protected void addInstitutionalMembership(InstitutionalMembership ims)
public InstitutionalMembership addInstitutionalMembership(Institution institution, TimePeriod period, java.lang.String department, java.lang.String role)
membership
of this person in an institution
to the set of his institution memberships.
This method also creates a new institutional membership instance.institution
- the institution this person belongs toperiod
- the time period for which this person has been a member of the institutiondepartment
- the string label for the department this person belongs to,
within the institutionrole
- the string label for the persons's role within the department or institutiongetInstitutionalMemberships()
,
InstitutionalMembership.InstitutionalMembership(Institution, Person, TimePeriod, String, String)
public void removeInstitutionalMembership(InstitutionalMembership ims)
ims
- the institutional membership of this person which should be deletedgetInstitutionalMemberships()
public java.lang.String getPrefix()
public void setPrefix(java.lang.String prefix)
getPrefix()
public java.lang.String getGivenName()
initials
A combination of expanded names and initials maybe stored here.
https://www.w3.org/International/questions/qa-personal-names.en#fielddesign
.getInitials()
,
getFamilyName()
,
https://www.w3.org/International/questions/qa-personal-names.en#fielddesign
public void setGivenName(java.lang.String givenName)
getGivenName()
public java.lang.String getInitials()
public void setInitials(java.lang.String initials)
#getInitals()
public java.lang.String getFamilyName()
https://www.w3.org/International/questions/qa-personal-names.en#fielddesign
.getInitials()
,
getGivenName()
,
https://www.w3.org/International/questions/qa-personal-names.en#fielddesign
public void setFamilyName(java.lang.String familyName)
#getfamilyName()
public java.lang.String getSuffix()
public void setSuffix(java.lang.String suffix)
getSuffix()
public TimePeriod getLifespan()
period of time
in which this person was alive (life span).
The general form is birth date - death date
(XXXX - YYYY; XXXX - or - YYYY as appropriate),
but a simple flourished date (fl. XXXX) is also possible
if that is all what is known.TimePeriod
public void setLifespan(TimePeriod lifespan)
getLifespan()
public ORCID getOrcid()
ORCiD
of this person.public void setOrcid(ORCID orcid)
getOrcid()
public boolean updateCaches()
updateCaches
in class IdentifiableEntity<INomenclaturalAuthorCacheStrategy<Person>>
public java.lang.Object clone()
clone
in class IdentifiableMediaEntity<INomenclaturalAuthorCacheStrategy<Person>>
IdentifiableMediaEntity.clone()
,
Object.clone()
Copyright © 2007-2020 EDIT. All Rights Reserved.