org.osid.personnel

Interface PersonQuery

All Superinterfaces:

Extensible, OsidBrowsableQuery, OsidExtensibleQuery, OsidIdentifiableQuery, OsidObjectQuery, OsidQuery, Suppliable

public interface PersonQuery
extends OsidObjectQuery

This is the query for searching persons. Each method specifies an AND term while multiple invocations of the same method produce a nested OR.

Method Summary

Methods

Modifier and Type	Method and Description
void	clearBirthDateTerms() Clears all birth date terms.
void	clearDeathDateTerms() Clears all death date terms.
void	clearForenameAliasTerms() Clears all forename alias terms.
void	clearGenerationQualifierTerms() Clears all generation qualifier terms.
void	clearGivenNameTerms() Clears all given name terms.
void	clearInstitutionalIdentifierTerms() Clears all institutional identifier terms.
void	clearLivingDateTerms() Clears all living date terms.
void	clearMiddleNameTerms() Clears all middle name terms.
void	clearPreferredNameTerms() Clears all preferred name terms.
void	clearQualificationSuffixTerms() Clears all qualification suffix terms.
void	clearRealmIdTerms() Clears all realm Id terms.
void	clearRealmTerms() Clears all realm terms.
void	clearSalutationTerms() Clears all salutation terms.
void	clearSurnameAliasTerms() Clears all surname alias terms.
void	clearSurnameTerms() Clears all surname terms.
PersonQueryRecord	getPersonQueryRecord(Type personRecordType) Gets the person query record corresponding to the given Person record Type.
RealmQuery	getRealmQuery() Gets the query for a realm query.
void	matchAnyBirthDate(boolean match) Matches persons with any birth date.
void	matchAnyDeathDate(boolean match) Matches persons with any death date.
void	matchAnyForenameAlias(boolean match) Matches persons with any forename alias.
void	matchAnyGenerationQualifier(boolean match) Matches persons with any generation qualifier.
void	matchAnyGivenName(boolean match) Matches persons with any given name.
void	matchAnyInstitutionalIdentifier(boolean match) Matches persons with any institutional identifier.
void	matchAnyMiddleName(boolean match) Matches persons with any middle name.
void	matchAnyPreferredName(boolean match) Matches persons with any preferred name.
void	matchAnyQualificationSuffix(boolean match) Matches persons with any qualification suffix.
void	matchAnySalutation(boolean match) Matches persons with any salutation.
void	matchAnySurname(boolean match) Matches persons with any surname.
void	matchAnySurnameAlias(boolean match) Matches persons with any surname alias.
void	matchBirthDate(DateTime from, DateTime to, boolean match) Matches a birth date bwteen the given range inclusive.
void	matchDeathDate(DateTime from, DateTime to, boolean match) Matches a death date between the given range inclusive.
void	matchForenameAlias(java.lang.String forenameAlias, Type stringMatchType, boolean match) Matches a forename alias.
void	matchGenerationQualifier(java.lang.String generationQualifier, Type stringMatchType, boolean match) Matches a generation qualifier.
void	matchGivenName(java.lang.String givenName, Type stringMatchType, boolean match) Matches a given name.
void	matchInstitutionalIdentifier(java.lang.String identifier, Type stringMatchType, boolean match) Matches an institutional identifier.
void	matchLivingDate(DateTime from, DateTime to, boolean match) Matches a persons alive within the given dates inclusive.
void	matchMiddleName(java.lang.String middleName, Type stringMatchType, boolean match) Matches a middle name.
void	matchPreferredName(java.lang.String preferredName, Type stringMatchType, boolean match) Matches a preferred name.
void	matchQualificationSuffix(java.lang.String qualificationSuffix, Type stringMatchType, boolean match) Matches a qualification suffix.
void	matchRealmId(Id realmId, boolean match) Sets the realm Id for this query to match persons assigned to realms.
void	matchSalutation(java.lang.String salutation, Type stringMatchType, boolean match) Matches a salutation.
void	matchSurname(java.lang.String surName, Type stringMatchType, boolean match) Matches a surname.
void	matchSurnameAlias(java.lang.String surnameAlias, Type stringMatchType, boolean match) Matches a surname alias.
boolean	supportsRealmQuery() Tests if a RealmQuery is available.

Methods inherited from interface org.osid.OsidObjectQuery

clearCommentIdTerms, clearCommentTerms, clearCreditIdTerms, clearCreditTerms, clearDescriptionTerms, clearDisplayNameTerms, clearGenusTypeTerms, clearJournalEntryIdTerms, clearJournalEntryTerms, clearParentGenusTypeTerms, clearRelationshipIdTerms, clearRelationshipPeerIdTerms, clearRelationshipTerms, clearStateIdTerms, clearStateTerms, clearStatisticTerms, clearSubjectIdTerms, clearSubjectRelevancyTerms, clearSubjectTerms, getCommentQuery, getCreditQuery, getJournalEntryQuery, getRelationshipQuery, getStateQuery, getStatisticQuery, getSubjectQuery, getSubjectRelevancyQuery, matchAnyComment, matchAnyCredit, matchAnyDescription, matchAnyDisplayName, matchAnyGenusType, matchAnyJournalEntry, matchAnyRelationship, matchAnyState, matchAnyStatistic, matchAnySubject, matchCommentId, matchCreditId, matchDescription, matchDisplayName, matchGenusType, matchJournalEntryId, matchParentGenusType, matchRelationshipId, matchRelationshipPeerId, matchStateId, matchSubjectId, supportsCommentQuery, supportsCreditQuery, supportsJournalEntryQuery, supportsRelationshipQuery, supportsStateQuery, supportsStatisticQuery, supportsSubjectQuery, supportsSubjectRelevancyQuery

Methods inherited from interface org.osid.OsidIdentifiableQuery

clearIdTerms, matchId

Methods inherited from interface org.osid.OsidExtensibleQuery

clearRecordTerms, matchAnyRecord, matchRecordType

Methods inherited from interface org.osid.Extensible

getRecordTypes, hasRecordType

Methods inherited from interface org.osid.OsidQuery

clearAnyTerms, clearKeywordTerms, getStringMatchTypes, matchAny, matchKeyword, supportsStringMatchType

Method Detail

matchSalutation

void matchSalutation(java.lang.String salutation,
                   Type stringMatchType,
                   boolean match)

Matches a salutation.

Parameters:

salutation - a salutation

stringMatchType - a string match type

match - true for a positive match, false for a negative match

Throws:

InvalidArgumentException - salutation is not of stringMatchType

NullArgumentException - salutation or stringMatchType is null

UnsupportedException - supportsStringMatchType(stringMatchType) is false

Compliance:

mandatory - This method must be implemented.

matchAnySalutation

void matchAnySalutation(boolean match)

Matches persons with any salutation.

Parameters:

match - true to match persons with any salutation, false to match persons with no salutation

Compliance:

mandatory - This method must be implemented.

clearSalutationTerms

void clearSalutationTerms()

Clears all salutation terms.

Compliance:

mandatory - This method must be implemented.

matchGivenName

void matchGivenName(java.lang.String givenName,
                  Type stringMatchType,
                  boolean match)

Matches a given name.

Parameters:

givenName - a given name

stringMatchType - a string match type

match - true for a positive match, false for a negative match

Throws:

InvalidArgumentException - givenName is not of stringMatchType

NullArgumentException - givenName or stringMatchType is null

UnsupportedException - supportsStringMatchType(stringMatchType) is false

Compliance:

mandatory - This method must be implemented.

matchAnyGivenName

void matchAnyGivenName(boolean match)

Matches persons with any given name.

Parameters:

match - true to match persons with any given name, false to match persons with no given name

Compliance:

mandatory - This method must be implemented.

clearGivenNameTerms

void clearGivenNameTerms()

Clears all given name terms.

Compliance:

mandatory - This method must be implemented.

matchPreferredName

void matchPreferredName(java.lang.String preferredName,
                      Type stringMatchType,
                      boolean match)

Matches a preferred name.

Parameters:

preferredName - a preferred name

stringMatchType - a string match type

match - true for a positive match, false for a negative match

Throws:

InvalidArgumentException - preferredName is not of stringMatchType

NullArgumentException - preferredName or stringMatchType is null

UnsupportedException - supportsStringMatchType(stringMatchType) is false

Compliance:

mandatory - This method must be implemented.

matchAnyPreferredName

void matchAnyPreferredName(boolean match)

Matches persons with any preferred name.

Parameters:

match - true to match persons with any preferred name, false to match persons with no preferred name

Compliance:

mandatory - This method must be implemented.

clearPreferredNameTerms

void clearPreferredNameTerms()

Clears all preferred name terms.

Compliance:

mandatory - This method must be implemented.

matchForenameAlias

void matchForenameAlias(java.lang.String forenameAlias,
                      Type stringMatchType,
                      boolean match)

Matches a forename alias.

Parameters:

forenameAlias - a forename alias

stringMatchType - a string match type

match - true for a positive match, false for a negative match

Throws:

InvalidArgumentException - forenameAlias is not of stringMatchType

NullArgumentException - forenameAlias or stringMatchType is null

UnsupportedException - supportsStringMatchType(stringMatchType) is false

Compliance:

mandatory - This method must be implemented.

matchAnyForenameAlias

void matchAnyForenameAlias(boolean match)

Matches persons with any forename alias.

Parameters:

match - true to match persons with any forename alias, false to match persons with no forename aliases

Compliance:

mandatory - This method must be implemented.

clearForenameAliasTerms

void clearForenameAliasTerms()

Clears all forename alias terms.

Compliance:

mandatory - This method must be implemented.

matchMiddleName

void matchMiddleName(java.lang.String middleName,
                   Type stringMatchType,
                   boolean match)

Matches a middle name.

Parameters:

middleName - a middle name

stringMatchType - a string match type

match - true for a positive match, false for a negative match

Throws:

InvalidArgumentException - middleName is not of stringMatchType

NullArgumentException - middleName or stringMatchType is null

UnsupportedException - supportsStringMatchType(stringMatchType) is false

Compliance:

mandatory - This method must be implemented.

matchAnyMiddleName

void matchAnyMiddleName(boolean match)

Matches persons with any middle name.

Parameters:

match - true to match persons with any middle name, false to match persons with no middle name

Compliance:

mandatory - This method must be implemented.

clearMiddleNameTerms

void clearMiddleNameTerms()

Clears all middle name terms.

Compliance:

mandatory - This method must be implemented.

matchSurname

void matchSurname(java.lang.String surName,
                Type stringMatchType,
                boolean match)

Matches a surname.

Parameters:

surName - a surname

stringMatchType - a string match type

match - true for a positive match, false for a negative match

Throws:

InvalidArgumentException - surName is not of stringMatchType

NullArgumentException - surName or stringMatchType is null

UnsupportedException - supportsStringMatchType(stringMatchType) is false

Compliance:

mandatory - This method must be implemented.

matchAnySurname

void matchAnySurname(boolean match)

Matches persons with any surname.

Parameters:

match - true to match persons with any surname, false to match persons with no surname

Compliance:

mandatory - This method must be implemented.

clearSurnameTerms

void clearSurnameTerms()

Clears all surname terms.

Compliance:

mandatory - This method must be implemented.

matchSurnameAlias

void matchSurnameAlias(java.lang.String surnameAlias,
                     Type stringMatchType,
                     boolean match)

Matches a surname alias.

Parameters:

surnameAlias - a surname alias

stringMatchType - a string match type

match - true for a positive match, false for a negative match

Throws:

InvalidArgumentException - surnameAlias is not of stringMatchType

NullArgumentException - surnameAlias or stringMatchType is null

UnsupportedException - supportsStringMatchType(stringMatchType) is false

Compliance:

mandatory - This method must be implemented.

matchAnySurnameAlias

void matchAnySurnameAlias(boolean match)

Matches persons with any surname alias.

Parameters:

match - true to match persons with any surname alias, false to match persons with no surname alias

Compliance:

mandatory - This method must be implemented.

clearSurnameAliasTerms

void clearSurnameAliasTerms()

Clears all surname alias terms.

Compliance:

mandatory - This method must be implemented.

matchGenerationQualifier

void matchGenerationQualifier(java.lang.String generationQualifier,
                            Type stringMatchType,
                            boolean match)

Matches a generation qualifier.

Parameters:

generationQualifier - a generation qualifier

stringMatchType - a string match type

match - true for a positive match, false for a negative match

Throws:

InvalidArgumentException - generationQualifier is not of stringMatchType

NullArgumentException - generationQualifier or stringMatchType is null

UnsupportedException - supportsStringMatchType(stringMatchType) is false

Compliance:

mandatory - This method must be implemented.

matchAnyGenerationQualifier

void matchAnyGenerationQualifier(boolean match)

Matches persons with any generation qualifier.

Parameters:

match - true to match persons with any generation qualifier, false to match persons with no generation qualifier

Compliance:

mandatory - This method must be implemented.

clearGenerationQualifierTerms

void clearGenerationQualifierTerms()

Clears all generation qualifier terms.

Compliance:

mandatory - This method must be implemented.

matchQualificationSuffix

void matchQualificationSuffix(java.lang.String qualificationSuffix,
                            Type stringMatchType,
                            boolean match)

Matches a qualification suffix.

Parameters:

qualificationSuffix - a qualification suffix

stringMatchType - a string match type

match - true for a positive match, false for a negative match

Throws:

InvalidArgumentException - qualificationSuffix is not of stringMatchType

NullArgumentException - qualificationSuffix or stringMatchType is null

UnsupportedException - supportsStringMatchType(stringMatchType) is false

Compliance:

mandatory - This method must be implemented.

matchAnyQualificationSuffix

void matchAnyQualificationSuffix(boolean match)

Matches persons with any qualification suffix.

Parameters:

match - true to match persons with any qualification sufix, false to match persons with no qualification suffix

Compliance:

mandatory - This method must be implemented.

clearQualificationSuffixTerms

void clearQualificationSuffixTerms()

Clears all qualification suffix terms.

Compliance:

mandatory - This method must be implemented.

matchBirthDate

void matchBirthDate(DateTime from,
                  DateTime to,
                  boolean match)

Matches a birth date bwteen the given range inclusive.

Parameters:

from - a starting date

to - an ending date

match - true for a positive match, false for a negative match

Throws:

InvalidArgumentException - from is greater than to

NullArgumentException - from or to is null

Compliance:

mandatory - This method must be implemented.

matchAnyBirthDate

void matchAnyBirthDate(boolean match)

Matches persons with any birth date.

Parameters:

match - true to match persons with any date of birth, false to match persons with no date of birth

Compliance:

mandatory - This method must be implemented.

clearBirthDateTerms

void clearBirthDateTerms()

Clears all birth date terms.

Compliance:

mandatory - This method must be implemented.

matchDeathDate

void matchDeathDate(DateTime from,
                  DateTime to,
                  boolean match)

Matches a death date between the given range inclusive.

Parameters:

from - a starting date

to - an ending date

match - true for a positive match, false for a negative match

Throws:

InvalidArgumentException - from is greater than to

NullArgumentException - from or to is null

Compliance:

mandatory - This method must be implemented.

matchAnyDeathDate

void matchAnyDeathDate(boolean match)

Matches persons with any death date.

Parameters:

match - true to match persons with any date of death, false to match persons who might still be alive

Compliance:

mandatory - This method must be implemented.

clearDeathDateTerms

void clearDeathDateTerms()

Clears all death date terms.

Compliance:

mandatory - This method must be implemented.

matchLivingDate

void matchLivingDate(DateTime from,
                   DateTime to,
                   boolean match)

Matches a persons alive within the given dates inclusive.

Parameters:

from - a starting date

to - an ending date

match - true for a positive match, false for a negative match

Throws:

InvalidArgumentException - from is greater than to

NullArgumentException - from or to is null

Compliance:

mandatory - This method must be implemented.

clearLivingDateTerms

void clearLivingDateTerms()

Clears all living date terms.

Compliance:

mandatory - This method must be implemented.

matchInstitutionalIdentifier

void matchInstitutionalIdentifier(java.lang.String identifier,
                                Type stringMatchType,
                                boolean match)

Matches an institutional identifier.

Parameters:

identifier - an institutional identifier

stringMatchType - a string match type

match - true for a positive match, false for a negative match

Throws:

InvalidArgumentException - identifier is not of stringMatchType

NullArgumentException - identifier or stringMatchType is null

UnsupportedException - supportsStringMatchType(stringMatchType) is false

Compliance:

mandatory - This method must be implemented.

matchAnyInstitutionalIdentifier

void matchAnyInstitutionalIdentifier(boolean match)

Matches persons with any institutional identifier.

Parameters:

match - true to match persons with any institutional identifier, false to match persons with no instituional identifier

Compliance:

mandatory - This method must be implemented.

clearInstitutionalIdentifierTerms

void clearInstitutionalIdentifierTerms()

Clears all institutional identifier terms.

Compliance:

mandatory - This method must be implemented.

matchRealmId

void matchRealmId(Id realmId,
                boolean match)

Sets the realm Id for this query to match persons assigned to realms.

Parameters:

realmId - a realm Id

match - true for a positive match, false for a negative match

Throws:

NullArgumentException - realmId is null

Compliance:

mandatory - This method must be implemented.

clearRealmIdTerms

void clearRealmIdTerms()

Clears all realm Id terms.

Compliance:

mandatory - This method must be implemented.

supportsRealmQuery

boolean supportsRealmQuery()

Tests if a RealmQuery is available.

Returns:

true if a realm query is available, false otherwise

Compliance:

mandatory - This method must be implemented.

getRealmQuery

RealmQuery getRealmQuery()

Gets the query for a realm query. Multiple retrievals produce a nested OR term.

Returns:

the realm query

Throws:

UnimplementedException - supportsRealmQuery() is false

Compliance:

optional - This method must be implemented if supportsRealmQuery() is true.

clearRealmTerms

void clearRealmTerms()

Clears all realm terms.

Compliance:

mandatory - This method must be implemented.

getPersonQueryRecord

PersonQueryRecord getPersonQueryRecord(Type personRecordType)
                                       throws OperationFailedException

Gets the person query record corresponding to the given Person record Type. Multiple record retrievals produce a nested OR term.

Parameters:

personRecordType - a person record type

Returns:

the person query record

Throws:

NullArgumentException - personRecordType is null

OperationFailedException - unable to complete request

UnsupportedException - hasRecordType(personRecordType) is false

Compliance:

mandatory - This method must be implemented.