Package org.emau.icmvc.ganimed.ttp.psn

Schnittstelle PSNManager

public interface PSNManager

Methodenübersicht

Modifizierer und Typ	Methode	Beschreibung
void	anonymiseAllEntriesForValue(String value, String domainName)	Anonymises all pseudonyms for the given value in the specified domain (replacing each "value" with "###_anonym_###_randString_###_anonym_###").
Map<String,AnonymisationResult>	anonymiseAllEntriesForValues(Set<String> values, String domainName)	Gibt SUCCESS, NOT_FOUND, ALREADY_ANONYMISED for the values depending on the result of anonymising all pseudonyms for each value zurück.
Map<String,AnonymisationResult>	anonymiseEntries(Set<String> values, String domainName)	Gibt SUCCESS, NOT_FOUND, ALREADY_ANONYMISED, or ERROR for the values depending on the result of anonymising them (replacing each "value" with "###_anonym_###_randString_###_anonym_###") zurück.
void	anonymiseEntry(String value, String domainName)	Anonymises a single pseudonym for the given value in the specified domain, replacing "value" with "###_anonym_###_randString_###_anonym_###".
void	anonymisePseudonym(String psn, String domainName)	Anonymises the given pseudonym in the specified domain.
Map<String,AnonymisationResult>	anonymisePseudonyms(Set<String> psns, String domainName)	Gibt SUCCESS, NOT_FOUND, or ALREADY_ANONYMISED for the pseudonyms depending on the result of anonymising them zurück.
String	createPseudonymFor(String value, String domainName)	Gibt a new pseudonym for the given value in the specified domain zurück.
Map<String,String>	createPseudonymForList(Set<String> values, String domainName)	Gibt a new pseudonym for each of the given values in the specified domain zurück.
List<String>	createPseudonymsFor(String value, String domainName, int number)	Gibt the specified number of new pseudonyms for the given value in the specified multi-PSN domain zurück.
Map<String,List<String>>	createPseudonymsForList(Set<String> values, String domainName, int number)	Gibt the specified number of new pseudonyms for each of the given values in the specified multi-PSN domain zurück.
void	deleteAllEntriesForValue(String value, String domainName)	Deletes all pseudonyms for the given value in the specified domain.
Map<String,DeletionResult>	deleteAllEntriesForValues(Set<String> values, String domainName)	Gibt SUCCESS, NOT_FOUND for the values depending on the result of deleting all pseudonyms for each value zurück.
Map<String,DeletionResult>	deleteEntries(Set<String> values, String domainName)	Gibt SUCCESS, NOT_FOUND, or ERROR for the given values depending on the result of deleting all their pseudonyms zurück.
void	deleteEntry(String value, String domainName)	Deletes a single pseudonym for the given value in the specified domain.
void	deletePseudonym(String psn, String domainName)	Deletes the pseudonym in the specified domain.
Map<String,DeletionResult>	deletePseudonyms(Set<String> psns, String domainName)	Gibt SUCCESS or NOT_FOUND for the given pseudonyms depending on the result of deleting pseudonyms zurück.
String	getOrCreatePseudonymFor(String value, String domainName)	Gibt the pseudonym for the given value in the specified domain, or create a new one if there is no such pseudonym, yet zurück.
Map<String,String>	getOrCreatePseudonymForList(Set<String> values, String domainName)	Gibt pseudonyms for the given values in the specified domain, or create a new ones if there are no such pseudonyms, yet zurück.
List<String>	getOrCreatePseudonymsFor(String value, String domainName, int minNumber)	Gibt all pseudonyms for the given value in the specified domain, and ensures that at least minNumber pseudonyms for the value, creating new ones as needed zurück.
Map<String,List<String>>	getOrCreatePseudonymsForList(Set<String> values, String domainName, int minNumber)	Gibt all pseudonyms for each of the given values in the specified domain, and ensures that at least minNumber pseudonyms exist per value, creating new ones as needed zurück.
String	getPseudonymFor(String value, String domainName)	Gibt the pseudonym for the given value in the specified domain or throw an exception if there is no such pseudonym zurück.
Map<String,String>	getPseudonymForList(Set<String> values, String domainName)	Gibt the pseudonyms for the given values in the specified domain or throw an exception if there is no such pseudonym zurück.
Map<String,String>	getPseudonymForValuePrefix(String valuePrefix, String domainName)	Gibt the pseudonyms for all values which starts with the given prefix in the specified domain zurück.
List<String>	getPseudonymsFor(String value, String domainName)	Gibt the pseudonyms for the given value in the specified domain zurück.
Map<String,List<String>>	getPseudonymsForList(Set<String> values, String domainName)	Gibt the pseudonyms for the given values in the specified domain zurück.
Map<String,List<String>>	getPseudonymsForValuePrefix(String valuePrefix, String domainName)	Gibt all pseudonyms for each value which starts with the given prefix in the specified domain zurück.
PSNNetDTO	getPSNNetFor(String valueOrPSN)	create psn net with all values that are somehow linked to the given psn
PSNTreeDTO	getPSNTreeForPSN(String psn, String domainName)	create psn tree with all values that are somehow linked to the given psn
String	getValueFor(String psn, String domainName)	searches the value for the given psn and domain; calls checkPSN(psn, domainName) before searching the value
Map<String,String>	getValueForList(Set<String> psnList, String domainName)	list version of getValueFor(String, String) returns a map<psn, value> (with value="*** PSN NOT FOUND ***" for each given psn which is unknown for the given domain)
void	insertValuePseudonymPair(String value, String pseudonym, String domainName)	insert a value - pseudonym pair value is expected to be a valid pseudonym
List<InsertPairExceptionDTO>	insertValuePseudonymPairs(Map<String,String> pairs, String domainName)	insert value - pseudonym pairs values within the map are expected to be valid pseudonyms
boolean	isAnonym(String value)	is the given value an anonym?
boolean	isAnonymised(String psn, String domainName)	is the given psn anonymised?
void	validatePSN(String psn, String domainName)	checks if the given string is a valid pseudonym

Methodendetails

createPseudonymFor

String createPseudonymFor(String value,
 String domainName)
                   throws DomainIsFullException,
InvalidParameterException,
UnknownDomainException

Gibt a new pseudonym for the given value in the specified domain zurück.

Note that an exception will be thrown if there are already pseudonyms for the value in a single-PSN domain (inconsistent data).

Preferably to be used for multi-PSN domains.

Parameter:

value - the value to create a pseudonym for

domainName - the name of the domain

Gibt zurück:

a new pseudonym for the given value in the specified domain

Löst aus:

DomainIsFullException - if the domain is full

InvalidParameterException - if there are already pseudonyms for the value in a single-PSN domain

UnknownDomainException - if the domain is unknown

createPseudonymsFor

List<String> createPseudonymsFor(String value,
 String domainName,
 int number)
                          throws DomainIsFullException,
InvalidParameterException,
UnknownDomainException

Gibt the specified number of new pseudonyms for the given value in the specified multi-PSN domain zurück.

Note that an exception will be thrown if the number is greater than 1 or if there are already pseudonyms for the value in a single-PSN domain (inconsistent data).

Preferably to be used for multi-PSN domains.

Parameter:

value - the value to create a pseudonym for

domainName - the name of the domain

number - the number of new pseudonyms to create

Gibt zurück:

the specified number of new pseudonyms for the given value in the specified multi-PSN domain

Löst aus:

DomainIsFullException - if the domain is full

InvalidParameterException - if there are already pseudonyms for the value in a single-PSN domain

UnknownDomainException - if the domain is unknown

createPseudonymForList

Map<String,String> createPseudonymForList(Set<String> values,
 String domainName)
                                   throws DomainIsFullException,
InvalidParameterException,
UnknownDomainException

Gibt a new pseudonym for each of the given values in the specified domain zurück.

Note that an exception will be thrown if there are already pseudonyms for the value in a single-PSN domain.

Preferably to be used for multi-PSN domains.

Parameter:

values - the values to create a pseudonym for

domainName - the name of the domain

Gibt zurück:

a new pseudonym for each of the given values in the specified domain

Löst aus:

DomainIsFullException - if the domain is full

InvalidParameterException - if there are already pseudonyms for the value in a single-PSN domain

UnknownDomainException - if the given domain is not found

createPseudonymsForList

Map<String,List<String>> createPseudonymsForList(Set<String> values,
 String domainName,
 int number)
                                          throws DomainIsFullException,
InvalidParameterException,
UnknownDomainException

Gibt the specified number of new pseudonyms for each of the given values in the specified multi-PSN domain zurück.

Note that an exception will be thrown if the number is greater than 1 or if there are already pseudonyms for the value in a single-PSN domain.

Preferably to be used for multi-PSN domains.

Parameter:

values - the values to create a pseudonym for

domainName - the name of the domain

number - the number of new pseudonyms to create

Gibt zurück:

the specified number of new pseudonyms for each of the given values in the specified multi-PSN domain

Löst aus:

DomainIsFullException - if the domain is full

InvalidParameterException - if the number is greater than 1 or if there are already pseudonyms for the value in a single-PSN domain

UnknownDomainException - if the given domain is not found

getOrCreatePseudonymFor

String getOrCreatePseudonymFor(String value,
 String domainName)
                        throws DomainIsFullException,
InvalidParameterException,
UnknownDomainException

Gibt the pseudonym for the given value in the specified domain, or create a new one if there is no such pseudonym, yet zurück.

Note that an exception will be thrown if there are multiple pseudonyms for a value in a single-PSN domain (inconsistent data), but also for a multi-PSN domain, as multiple pseudonyms cannot be returned as a single string (invalid parameter).

Preferably to be used for single-PSN domains.

Parameter:

value - the value to get or create a pseudonym for

domainName - the name of the domain

Gibt zurück:

the pseudonym for the given value in the specified domain, or create a new one if there is no such pseudonym, yet

Löst aus:

DomainIsFullException - if the domain is full

InvalidParameterException - if there exist more than one pseudonym for the value in a multi-PSN domain

UnknownDomainException - if the domain is unknown

getOrCreatePseudonymsFor

List<String> getOrCreatePseudonymsFor(String value,
 String domainName,
 int minNumber)
                               throws DomainIsFullException,
InvalidParameterException,
UnknownDomainException

Gibt all pseudonyms for the given value in the specified domain, and ensures that at least minNumber pseudonyms for the value, creating new ones as needed zurück.

Note that an exception will be thrown if there are multiple pseudonyms for a value in a single-PSN domain (inconsistent data).

Preferably to be used for multi-PSN domains.

Parameter:

value - the value to get or create a pseudonym for

domainName - the name of the domain

minNumber - the minimum number of pseudonyms for the given value

Gibt zurück:

all pseudonyms for the given value in the specified domain, and ensures that at least minNumber pseudonyms for the value, creating new ones as needed

Löst aus:

InvalidParameterException - if one of the required parameters is not set

DomainIsFullException - if the domain is full

UnknownDomainException - if the domain is unknown

getOrCreatePseudonymForList

Map<String,String> getOrCreatePseudonymForList(Set<String> values,
 String domainName)
                                        throws DomainIsFullException,
InvalidParameterException,
UnknownDomainException

Gibt pseudonyms for the given values in the specified domain, or create a new ones if there are no such pseudonyms, yet zurück.

Note that an exception will be thrown if there are multiple pseudonyms for a value in a single-PSN domain (inconsistent data), but also for a multi-PSN domain, as multiple pseudonyms cannot be returned as a single string (invalid parameter).

Preferably to be used for single-PSN domains.

Parameter:

values - the values to get or create a pseudonym for

domainName - the name of the domain

Gibt zurück:

pseudonyms for the given values in the specified domain, or create a new ones if there are no such pseudonyms, yet

Löst aus:

DomainIsFullException - if the domain is full

InvalidParameterException - if there exist more than one pseudonym for value in a multi-PSN domain

UnknownDomainException - if the domain is unknown

getOrCreatePseudonymsForList

Map<String,List<String>> getOrCreatePseudonymsForList(Set<String> values,
 String domainName,
 int minNumber)
                                               throws DomainIsFullException,
InvalidParameterException,
UnknownDomainException

Gibt all pseudonyms for each of the given values in the specified domain, and ensures that at least minNumber pseudonyms exist per value, creating new ones as needed zurück.

Note that an exception will be thrown if there are multiple pseudonyms for a value in a single-PSN domain (inconsistent data).

Preferably to be used for multi-PSN domains.

Parameter:

values - the value to get or create a pseudonym for

domainName - the name of the domain

minNumber - the minimum number of pseudonyms for the given values

Gibt zurück:

all pseudonyms for each of the given values in the specified domain, and ensures that at least minNumber pseudonyms exist per value, creating new ones as needed

Löst aus:

DomainIsFullException - if the domain is full

InvalidParameterException - if one of the required parameters is not set

UnknownDomainException - if the domain is unknown

getPseudonymFor

String getPseudonymFor(String value,
 String domainName)
                throws InvalidParameterException,
UnknownDomainException,
UnknownValueException

Gibt the pseudonym for the given value in the specified domain or throw an exception if there is no such pseudonym zurück.

Note that also an exception will be thrown if there are multiple pseudonyms for the value in a single-PSN domain (inconsistent data), but also for a multi-PSN domain, as they all cannot be returned as a single string (invalid parameter).

Preferably to be used for single-PSN domains.

Parameter:

value - the value to get a pseudonym for

domainName - the name of the domain

Gibt zurück:

the pseudonym for the given value in the specified domain or throw an exception if there is no such pseudonym

Löst aus:

InvalidParameterException - if there exist more than one pseudonym for the value in a multi-PSN domain

UnknownDomainException - if the domain is unknown

UnknownValueException

getPseudonymsFor

List<String> getPseudonymsFor(String value,
 String domainName)
                       throws InvalidParameterException,
UnknownDomainException,
UnknownValueException

Gibt the pseudonyms for the given value in the specified domain zurück.

Note that an exception will be thrown if there are multiple pseudonyms for a value in a single-PSN domain (inconsistent data).

Preferably to be used for multi-PSN domains.

Parameter:

value - the value to get pseudonyms for

domainName - the name of the domain

Gibt zurück:

the pseudonyms for the given value in the specified domain

Löst aus:

InvalidParameterException - if one of the required parameters is not set

UnknownDomainException - if the domain is unknown

UnknownValueException

getPseudonymForList

Map<String,String> getPseudonymForList(Set<String> values,
 String domainName)
                                throws InvalidParameterException,
UnknownDomainException

Gibt the pseudonyms for the given values in the specified domain or throw an exception if there is no such pseudonym zurück.

Note that also an exception will be thrown if there are multiple pseudonyms for the value in a single-PSN domain (inconsistent data), but also for a multi-PSN domain, as they all cannot be returned as a single string (invalid parameter).

Preferably to be used for single-PSN domains.

Parameter:

values - the value to get pseudonyms for

domainName - the name of the domain

Gibt zurück:

the pseudonyms for the given values in the specified domain or throw an exception if there is no such pseudonym

Löst aus:

InvalidParameterException - if there exist more than one pseudonym for the value in a multi-PSN domain

UnknownDomainException - if the domain is unknown

getPseudonymsForList

Map<String,List<String>> getPseudonymsForList(Set<String> values,
 String domainName)
                                       throws InvalidParameterException,
UnknownDomainException

Gibt the pseudonyms for the given values in the specified domain zurück.

Note that an exception will be thrown if there are multiple pseudonyms for a value in a single-PSN domain (inconsistent data).

Preferably to be used for multi-PSN domains.

Parameter:

values - the value to get pseudonyms for

domainName - the name of the domain

Gibt zurück:

the pseudonyms for the given values in the specified domain

Löst aus:

InvalidParameterException - if one of the required parameters is not set

UnknownDomainException - if the domain is unknown

getPseudonymForValuePrefix

Map<String,String> getPseudonymForValuePrefix(String valuePrefix,
 String domainName)
                                       throws InvalidParameterException,
UnknownDomainException

Gibt the pseudonyms for all values which starts with the given prefix in the specified domain zurück.

Note that also an exception will be thrown if there are multiple pseudonyms for the value in a single-PSN domain (inconsistent data), but also for a multi-PSN domain, as they all cannot be returned as a single string (invalid parameter).

Preferably to be used for single-PSN domains.

Parameter:

valuePrefix - the prefix of all values for which the pseudonyms should be retrieved

domainName - the name of the domain

Gibt zurück:

the pseudonyms for all values which starts with the given prefix in the specified domain

Löst aus:

InvalidParameterException - if there exist more than one pseudonym for the value in a multi-PSN domain

UnknownDomainException - if the domain is unknown

getPseudonymsForValuePrefix

Map<String,List<String>> getPseudonymsForValuePrefix(String valuePrefix,
 String domainName)
                                              throws InvalidParameterException,
UnknownDomainException

Gibt all pseudonyms for each value which starts with the given prefix in the specified domain zurück.

Note that an exception will be thrown if there are multiple pseudonyms for a value in a single-PSN domain (inconsistent data).

Preferably to be used for multi-PSN domains.

Parameter:

valuePrefix - the prefix of all values for which the pseudonyms should be retrieved

domainName - the name of the domain

Gibt zurück:

all pseudonyms for each value which starts with the given prefix in the specified domain

Löst aus:

InvalidParameterException - if one of the required parameters is not set

UnknownDomainException - if the domain is unknown

anonymiseEntry

void anonymiseEntry(String value,
 String domainName)
             throws DBException,
InvalidParameterException,
UnknownDomainException,
UnknownValueException,
ValueIsAnonymisedException

Anonymises a single pseudonym for the given value in the specified domain, replacing "value" with "###_anonym_###_randString_###_anonym_###". Throws an exception if there is not exactly one pseudonym for the value.

Parameter:

value - the value which should be anonymised

domainName - the name of the domain

Löst aus:

DBException - e.g. if there exist more than one pseudonym for a value in a single-PSN domain

InvalidParameterException - e.g. if there exist more than one pseudonym for a value in a multi-PSN domain

UnknownDomainException - if the domain is unknown

UnknownValueException - if there are no pseudonyms for the given value in the specified domain

ValueIsAnonymisedException - if the value cannot be anonymised

anonymiseEntries

Map<String,AnonymisationResult> anonymiseEntries(Set<String> values,
 String domainName)
                                          throws DBException,
InvalidParameterException,
UnknownDomainException

Gibt SUCCESS, NOT_FOUND, ALREADY_ANONYMISED, or ERROR for the values depending on the result of anonymising them (replacing each "value" with "###_anonym_###_randString_###_anonym_###") zurück. In particular, an AnonymisationResult.ERROR is returned for values with multiple pseudonyms associated.

Parameter:

values - the values which should be anonymised

domainName - the name of the domain

Gibt zurück:

SUCCESS, NOT_FOUND, ALREADY_ANONYMISED, or ERROR for the values depending on the result of anonymising them (replacing each "value" with "###_anonym_###_randString_###_anonym_###")

Löst aus:

DBException - e.g. if there exist more than one pseudonym for a value in a single-PSN domain

InvalidParameterException - if one of the required parameters is not set

UnknownDomainException - if the given domain is not found

anonymiseAllEntriesForValue

void anonymiseAllEntriesForValue(String value,
 String domainName)
                          throws DBException,
InvalidParameterException,
UnknownDomainException,
UnknownValueException,
ValueIsAnonymisedException

Anonymises all pseudonyms for the given value in the specified domain (replacing each "value" with "###_anonym_###_randString_###_anonym_###"). Throws an exception if there is no pseudonym for the value.

Parameter:

value - the value for which all entries should be anonymised

domainName - the name of the domain

Löst aus:

DBException - e.g. if there exist more than one pseudonym for a value in a single-PSN domain

InvalidParameterException - e.g. if there exist more than one pseudonym for a value in a multi-PSN domain

UnknownDomainException - if the given domain is not found

UnknownValueException - if there are no pseudonyms for the given value in the specified domain

ValueIsAnonymisedException - if the value cannot be anonymised

anonymiseAllEntriesForValues

Map<String,AnonymisationResult> anonymiseAllEntriesForValues(Set<String> values,
 String domainName)
                                                      throws DBException,
InvalidParameterException,
UnknownDomainException

Gibt SUCCESS, NOT_FOUND, ALREADY_ANONYMISED for the values depending on the result of anonymising all pseudonyms for each value zurück.

Parameter:

values - the values for which all entries should be anonymised

domainName - the name of the domain

Gibt zurück:

SUCCESS, NOT_FOUND, ALREADY_ANONYMISED for the values depending on the result of anonymising all pseudonyms for each value

Löst aus:

DBException - e.g. if there exist more than one pseudonym for a value in a single-PSN domain

InvalidParameterException - if one of the required parameters is not set

UnknownDomainException - if the given domain is not found

anonymisePseudonym

void anonymisePseudonym(String psn,
 String domainName)
                 throws DBException,
InvalidParameterException,
UnknownDomainException,
InvalidPSNException,
PSNNotFoundException

Anonymises the given pseudonym in the specified domain.

Parameter:

psn - the pseudonym to anonymise

domainName - the name of the domain

Löst aus:

DBException - e.g. if there exist more than one pseudonym for a value in a single-PSN domain

InvalidParameterException - if one of the required parameters is not set

UnknownDomainException - if the given domain is not found

InvalidPSNException

PSNNotFoundException

anonymisePseudonyms

Map<String,AnonymisationResult> anonymisePseudonyms(Set<String> psns,
 String domainName)
                                             throws DBException,
InvalidParameterException,
UnknownDomainException

Gibt SUCCESS, NOT_FOUND, or ALREADY_ANONYMISED for the pseudonyms depending on the result of anonymising them zurück.

Parameter:

psns - the pseudonyms to anonymise

domainName - the name of the domain

Gibt zurück:

SUCCESS, NOT_FOUND, or ALREADY_ANONYMISED for the pseudonyms depending on the result of anonymising them

Löst aus:

DBException - e.g. if there exist more than one pseudonym for a value in a single-PSN domain

InvalidParameterException - if one of the required parameters is not set

UnknownDomainException - if the given domain is not found

isAnonym

boolean isAnonym(String value)
          throws InvalidParameterException

is the given value an anonym?

Parameter:

value - the value which should be tested

Gibt zurück:

true if the given value is an anonym, false else

Löst aus:

InvalidParameterException - if one of the required parameters is not set

isAnonymised

boolean isAnonymised(String psn,
 String domainName)
              throws InvalidParameterException,
InvalidPSNException,
UnknownDomainException,
PSNNotFoundException

is the given psn anonymised?

Parameter:

psn - the psn which should be tested

domainName - for which domain the given psn should be tested

Gibt zurück:

true if the given psn is anonymised, false else

Löst aus:

InvalidParameterException - if one of the required parameters is not set

InvalidPSNException - if the given PSN is not valid

UnknownDomainException - if the given domain is not found

PSNNotFoundException - if the psn is not found within the given domain

deleteEntry

void deleteEntry(String value,
 String domainName)
          throws DeletionForbiddenException,
InvalidParameterException,
UnknownDomainException,
UnknownValueException

Deletes a single pseudonym for the given value in the specified domain. Throws an exception if there is not exactly one pseudonym for the value.

Parameter:

value - the value which should be deleted

domainName - the name of the domain

Löst aus:

InvalidParameterException - if one of the required parameters is not set

UnknownDomainException - if the given domain is not found

UnknownValueException - if there are no pseudonyms for the given value in the specified domain

DeletionForbiddenException

deleteEntries

Map<String,DeletionResult> deleteEntries(Set<String> values,
 String domainName)
                                  throws DeletionForbiddenException,
InvalidParameterException,
UnknownDomainException

Gibt SUCCESS, NOT_FOUND, or ERROR for the given values depending on the result of deleting all their pseudonyms zurück. In particular, an DeletionResult.ERROR is returned for values with multiple pseudonyms associated.

Parameter:

values - the values which should be deleted

domainName - the name of the domain

Gibt zurück:

SUCCESS, NOT_FOUND, or ERROR for the given values depending on the result of deleting all their pseudonyms

Löst aus:

InvalidParameterException - if one of the required parameters is not set

UnknownDomainException - if the given domain is not found

DeletionForbiddenException

deleteAllEntriesForValue

void deleteAllEntriesForValue(String value,
 String domainName)
                       throws DeletionForbiddenException,
InvalidParameterException,
UnknownDomainException,
UnknownValueException

Deletes all pseudonyms for the given value in the specified domain. Throws an exception if there is no pseudonym for the value.

Parameter:

value - the value for which all entries should be deleted

domainName - the name of the domain

Löst aus:

InvalidParameterException - e.g. if there exist more than one pseudonym for a value in a multi-PSN domain

UnknownDomainException - if the given domain is not found

UnknownValueException - if there are no pseudonyms for the given value in the specified domain

DeletionForbiddenException

deleteAllEntriesForValues

Map<String,DeletionResult> deleteAllEntriesForValues(Set<String> values,
 String domainName)
                                              throws DeletionForbiddenException,
InvalidParameterException,
UnknownDomainException

Gibt SUCCESS, NOT_FOUND for the values depending on the result of deleting all pseudonyms for each value zurück.

Parameter:

values - the values for which all entries should be deleted

domainName - the name of the domain

Gibt zurück:

SUCCESS, NOT_FOUND for the values depending on the result of deleting all pseudonyms for each value

Löst aus:

InvalidParameterException - if one of the required parameters is not set

UnknownDomainException - if the given domain is not found

DeletionForbiddenException

deletePseudonym

void deletePseudonym(String psn,
 String domainName)
              throws DeletionForbiddenException,
InvalidParameterException,
UnknownDomainException,
UnknownValueException,
InvalidPSNException,
PSNNotFoundException

Deletes the pseudonym in the specified domain.

Parameter:

psn - the pseudonym to delete

domainName - the name of the domain

Löst aus:

InvalidParameterException - if one of the required parameters is not set

UnknownDomainException - if the given domain is not found

UnknownValueException - if there are no pseudonyms for the given value in the specified domain

DeletionForbiddenException

InvalidPSNException

PSNNotFoundException

deletePseudonyms

Map<String,DeletionResult> deletePseudonyms(Set<String> psns,
 String domainName)
                                     throws DeletionForbiddenException,
InvalidParameterException,
UnknownDomainException

Gibt SUCCESS or NOT_FOUND for the given pseudonyms depending on the result of deleting pseudonyms zurück.

Parameter:

psns - the pseudonyms to delete

domainName - the name of the domain

Gibt zurück:

SUCCESS or NOT_FOUND for the given pseudonyms depending on the result of deleting pseudonyms

Löst aus:

InvalidParameterException - if one of the required parameters is not set

UnknownDomainException - if the given domain is not found

DeletionForbiddenException

validatePSN

void validatePSN(String psn,
 String domainName)
          throws InvalidParameterException,
InvalidPSNException,
UnknownDomainException

checks if the given string is a valid pseudonym

Parameter:

psn - the pseudonym which should be checked

domainName - for which domain should the given pseudonym be checked

Löst aus:

InvalidParameterException - if one of the required parameters is not set

InvalidPSNException - if the given PSN is not valid

UnknownDomainException - if the given domain is not found

getValueFor

String getValueFor(String psn,
 String domainName)
            throws InvalidParameterException,
InvalidPSNException,
PSNNotFoundException,
UnknownDomainException,
ValueIsAnonymisedException

searches the value for the given psn and domain; calls checkPSN(psn, domainName) before searching the value

Parameter:

psn - for which pseudonym should the original value be retrieved

domainName - for which domain should the original value to the given pseudonym be retrieved

Gibt zurück:

the original value

Löst aus:

InvalidParameterException - if one of the required parameters is not set

InvalidPSNException - if the given PSN is not valid

PSNNotFoundException - if the given PSN is not found within the db for that domain

UnknownDomainException - if the given domain is not found

ValueIsAnonymisedException - if pseudonym is anonymised

getValueForList

Map<String,String> getValueForList(Set<String> psnList,
 String domainName)
                            throws InvalidParameterException,
UnknownDomainException

list version of getValueFor(String, String)
returns a map<psn, value> (with value="*** PSN NOT FOUND ***" for each given psn which is unknown for the given domain)

Parameter:

psnList - list of pseudonyms for which the original values should be retrieved

domainName - for which domain should the original value to the given pseudonym be retrieved

Gibt zurück:

a map with pairs pseudonym -> original value

Löst aus:

InvalidParameterException - if one of the required parameters is not set

UnknownDomainException - if the given domain is not found

insertValuePseudonymPair

void insertValuePseudonymPair(String value,
 String pseudonym,
 String domainName)
                       throws InsertPairException,
InvalidParameterException,
UnknownDomainException

insert a value - pseudonym pair
value is expected to be a valid pseudonym

Parameter:

value - the value for which the pseudonym should be inserted

pseudonym - the pseudonym which should be inserted for the given value

domainName - for which domain should the given pairs be stored

Löst aus:

InsertPairException - if an error occurred while persisting the given pair (see InsertPairError)

InvalidParameterException - if one of the required parameters is not set

UnknownDomainException - if the given domain is not found

insertValuePseudonymPairs

List<InsertPairExceptionDTO> insertValuePseudonymPairs(Map<String,String> pairs,
 String domainName)
                                                throws InvalidParameterException,
UnknownDomainException

insert value - pseudonym pairs
values within the map are expected to be valid pseudonyms

Parameter:

pairs - map of pairs which should be stored

domainName - for which domain should the given pairs be stored

Gibt zurück:

a list with all occurred exceptions, see InsertPairExceptionDTO

Löst aus:

InvalidParameterException - if one of the required parameters is not set

UnknownDomainException - if the given domain is not found

getPSNTreeForPSN

PSNTreeDTO getPSNTreeForPSN(String psn,
 String domainName)
                     throws InvalidParameterException,
InvalidPSNException,
PSNNotFoundException,
UnknownDomainException,
ValueIsAnonymisedException

create psn tree
with all values that are somehow linked to the given psn

Parameter:

psn - pseudonym that should be used to create the psn tree

domainName - name of the domain for the given pseudonym

Gibt zurück:

a psn tree object with all psn connected to the given psn

Löst aus:

InvalidParameterException - if one of the required parameters is not set

InvalidPSNException - if the given PSN is not valid

PSNNotFoundException - if the given PSN is not found within the db for that domain

UnknownDomainException - if the given domain is not found

ValueIsAnonymisedException - if the value is already anonymised

getPSNNetFor

PSNNetDTO getPSNNetFor(String valueOrPSN)
                throws InvalidParameterException

create psn net
with all values that are somehow linked to the given psn

Parameter:

valueOrPSN - value or pseudonym that should be used to create the psn net

Gibt zurück:

a psn net object with all psn connected to the given psn / value

Löst aus:

InvalidParameterException - if one of the required parameters is not set