org.gedcomx.conclusion

Class Subject

java.lang.Object

org.gedcomx.common.ExtensibleData

org.gedcomx.links.HypermediaEnabledData

org.gedcomx.conclusion.Conclusion

org.gedcomx.conclusion.Subject

All Implemented Interfaces:

Attributable, HasNotes, HasTransientProperties, SupportsLinks, SupportsExtensionElements, ReferencesSources

Direct Known Subclasses:

Event, Person, PlaceDescription, Relationship

public abstract class Subject
extends Conclusion
implements Attributable

The Subject data type defines the abstract concept of a genealogical subject. A subject is something with a unique and intrinsic identity, e.g., a person, a location on the surface of the earth. We identify that subject in time and space using various supporting conclusions, e.g. for a person: things like name, birth date, age, address, etc. We aggregate these supporting conclusions to form an apparently-unique identity by which we can distinguish our subject from all other possible subjects.

Author:

Ryan Heaton

Field Summary

Fields inherited from class org.gedcomx.common.ExtensibleData

extensionElements, transientProperties

Constructor Summary

Constructors

Constructor and Description
Subject()

Method Summary

Modifier and Type	Method and Description
void	addEvidence(EvidenceReference evidenceRef) Add an evidence reference for this subject.
void	addIdentifier(Identifier identifier) Add an identifier of the subject.
void	addMedia(SourceReference mediaRef) Add an media reference associated with this subject.
Subject	analysis(Document analysis) Add a reference to the analysis for this conclusion.
Subject	analysis(ResourceReference analysis) Add a reference to the analysis for this conclusion.
Subject	analysis(URI analysis) Add a reference to the analysis for this conclusion.
Subject	attribution(Attribution attribution) Build up this conclusion with attribution.
Subject	confidence(ConfidenceLevel confidence) Build up this conclusion with a confidence level.
Subject	confidence(URI confidence) Build up this conclusion with a confidence level.
protected void	embed(Subject subject)
Subject	evidence(EvidenceReference evidence) Build up this subject with an evidence reference.
Subject	extensionElement(Object element)
Subject	extracted(Boolean extracted) Build up this subject with an extracted flag.
List<EvidenceReference>	getEvidence() References to the evidence being referenced for this subject.
Boolean	getExtracted() Whether this subject has been identified as "extracted", meaning it captures information extracted from a single source.
List<Identifier>	getIdentifiers() The list of identifiers for the subject.
List<SourceReference>	getMedia() References to multimedia resources associated with this subject.
URI	getPersistentId() Find the long-term, persistent identifier for this subject from the list of identifiers.
Subject	id(String id) Build up this object with an id.
Subject	identifier(Identifier identifier) Build up this subject with an identifier.
Subject	lang(String lang) Build up this conclusion with a lang.
Subject	link(Link link) Build up this data with a link.
Subject	link(String rel, URI href) Build up this data with a link.
Subject	media(SourceDescription media) Build up this subject with a media reference.
Subject	media(SourceReference media) Build up this subject with a media reference.
Subject	note(Note note) Build up this conclusion with a note.
void	setEvidence(List<EvidenceReference> evidence) References to the evidence being referenced for this subject.
void	setExtracted(Boolean extracted) Whether this subject has been identified as "extracted", meaning it captures information extracted from a single source.
void	setIdentifiers(List<Identifier> identifiers) The list of identifiers of the subject.
void	setMedia(List<SourceReference> media) References to multimedia resources associated with this subject.
void	setPersistentId(URI persistentId) A long-term, persistent, globally unique identifier for this subject.
Subject	sortKey(String sortKey) Build up this fact with a sort key.
Subject	source(SourceDescription source) Build up this conclusion with a source reference.
Subject	source(SourceReference sourceReference) Build up this conclusion with a source reference.

Methods inherited from class org.gedcomx.conclusion.Conclusion

addNote, addSource, embed, getAnalysis, getAttribution, getConfidence, getKnownConfidenceLevel, getLang, getNotes, getSortKey, getSources, setAnalysis, setAttribution, setConfidence, setKnownConfidenceLevel, setLang, setNotes, setSortKey, setSources, toString

Methods inherited from class org.gedcomx.links.HypermediaEnabledData

addLink, addLink, addTemplatedLink, embed, getLink, getLinks, getLinks, setLinks

Methods inherited from class org.gedcomx.common.ExtensibleData

addExtensionElement, embed, findExtensionOfType, findExtensionOfType, findExtensionsOfType, findExtensionsOfType, getExtensionElements, getId, getTransientProperties, getTransientProperty, removeExtensionElements, setExtensionElement, setExtensionElements, setId, setTransientProperty

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.gedcomx.common.Attributable

getAttribution, setAttribution

Constructor Detail

Subject

public Subject()

Method Detail

id

public Subject id(String id)

Description copied from class: ExtensibleData

Build up this object with an id.

Overrides:

id in class Conclusion

Parameters:

id - The id.

Returns:

this.

extensionElement

public Subject extensionElement(Object element)

Overrides:

extensionElement in class Conclusion

link

public Subject link(String rel,
                    URI href)

Description copied from class: HypermediaEnabledData

Build up this data with a link.

Overrides:

link in class Conclusion

Parameters:

rel - The rel.

href - The href.

Returns:

this.

link

public Subject link(Link link)

Description copied from class: HypermediaEnabledData

Build up this data with a link.

Overrides:

link in class Conclusion

Parameters:

link - The link.

Returns:

this.

lang

public Subject lang(String lang)

Description copied from class: Conclusion

Build up this conclusion with a lang.

Overrides:

lang in class Conclusion

Parameters:

lang - The lang.

Returns:

this.

confidence

public Subject confidence(URI confidence)

Description copied from class: Conclusion

Build up this conclusion with a confidence level.

Overrides:

confidence in class Conclusion

Parameters:

confidence - The confidence level.

Returns:

this.

confidence

public Subject confidence(ConfidenceLevel confidence)

Description copied from class: Conclusion

Build up this conclusion with a confidence level.

Overrides:

confidence in class Conclusion

Parameters:

confidence - The confidence level.

Returns:

this.

source

public Subject source(SourceReference sourceReference)

Description copied from class: Conclusion

Build up this conclusion with a source reference.

Overrides:

source in class Conclusion

Parameters:

sourceReference - The source reference.

Returns:

this.

source

public Subject source(SourceDescription source)

Description copied from class: Conclusion

Build up this conclusion with a source reference.

Overrides:

source in class Conclusion

Parameters:

source - The source description being referenced.

Returns:

this.

note

public Subject note(Note note)

Description copied from class: Conclusion

Build up this conclusion with a note.

Overrides:

note in class Conclusion

Parameters:

note - The note.

Returns:

this.

attribution

public Subject attribution(Attribution attribution)

Description copied from class: Conclusion

Build up this conclusion with attribution.

Overrides:

attribution in class Conclusion

Parameters:

attribution - The attribution.

Returns:

this.

analysis

public Subject analysis(ResourceReference analysis)

Description copied from class: Conclusion

Add a reference to the analysis for this conclusion.

Overrides:

analysis in class Conclusion

Parameters:

analysis - The analysis.

Returns:

this.

analysis

public Subject analysis(URI analysis)

Description copied from class: Conclusion

Add a reference to the analysis for this conclusion.

Overrides:

analysis in class Conclusion

Parameters:

analysis - The analysis.

Returns:

this.

analysis

public Subject analysis(Document analysis)

Description copied from class: Conclusion

Add a reference to the analysis for this conclusion.

Overrides:

analysis in class Conclusion

Parameters:

analysis - The analysis.

Returns:

this.

sortKey

public Subject sortKey(String sortKey)

Description copied from class: Conclusion

Build up this fact with a sort key.

Overrides:

sortKey in class Conclusion

Parameters:

sortKey - The sort key.

Returns:

this.

getExtracted

public Boolean getExtracted()

Whether this subject has been identified as "extracted", meaning it captures information extracted from a single source.

Returns:

Whether this subject has been identified as "extracted".

setExtracted

public void setExtracted(Boolean extracted)

Whether this subject has been identified as "extracted", meaning it captures information extracted from a single source.

Parameters:

extracted - Whether this subject has been identified as "extracted".

extracted

public Subject extracted(Boolean extracted)

Build up this subject with an extracted flag.

Parameters:

extracted - The extracted flag.

Returns:

this.

getPersistentId

public URI getPersistentId()

Find the long-term, persistent identifier for this subject from the list of identifiers.

Returns:

The long-term, persistent identifier for this subject.

setPersistentId

public void setPersistentId(URI persistentId)

A long-term, persistent, globally unique identifier for this subject.

Parameters:

persistentId - A long-term, persistent, globally unique identifier for this subject.

getIdentifiers

public List<Identifier> getIdentifiers()

The list of identifiers for the subject.

Returns:

The list of identifiers for the subject.

setIdentifiers

public void setIdentifiers(List<Identifier> identifiers)

The list of identifiers of the subject.

Parameters:

identifiers - The list of identifiers of the subject.

identifier

public Subject identifier(Identifier identifier)

Build up this subject with an identifier.

Parameters:

identifier - The identifier.

Returns:

this.

addIdentifier

public void addIdentifier(Identifier identifier)

Add an identifier of the subject.

Parameters:

identifier - The identifier to be added.

getEvidence

public List<EvidenceReference> getEvidence()

References to the evidence being referenced for this subject.

Returns:

References to the evidence being referenced.

setEvidence

public void setEvidence(List<EvidenceReference> evidence)

References to the evidence being referenced for this subject.

Parameters:

evidence - References to the evidence being referenced.

evidence

public Subject evidence(EvidenceReference evidence)

Build up this subject with an evidence reference.

Parameters:

evidence - The evidence reference.

Returns:

this.

addEvidence

public void addEvidence(EvidenceReference evidenceRef)

Add an evidence reference for this subject.

Parameters:

evidenceRef - The evidence to be added.

getMedia

public List<SourceReference> getMedia()

References to multimedia resources associated with this subject.

Returns:

References to multimedia resources associated with this subject.

setMedia

public void setMedia(List<SourceReference> media)

References to multimedia resources associated with this subject.

Parameters:

media - References to multimedia resources associated with this subject.

media

public Subject media(SourceReference media)

Build up this subject with a media reference.

Parameters:

media - The media reference.

Returns:

this.

media

public Subject media(SourceDescription media)

Build up this subject with a media reference.

Parameters:

media - The media reference.

Returns:

this.

addMedia

public void addMedia(SourceReference mediaRef)

Add an media reference associated with this subject.

Parameters:

mediaRef - The reference to the media to be added.

embed

protected void embed(Subject subject)