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

Schnittstelle PSNManagerWithNotification

public interface PSNManagerWithNotification

Methodenübersicht

Modifizierer und Typ	Methode	Beschreibung
Map<String,AnonymisationResult>	anonymiseEntries(String notificationClientID, Set<String> values, String domainName)	deletes the assignments value - pseudonym from the db (replaces "value" with "###_anonym_###_randString_###_anonym_###")
void	anonymiseEntry(String notificationClientID, String value, String domainName)	deletes the assignment value - pseudonym from the db (replaces "value" with "###_anonym_###_randString_###_anonym_###")
Map<String,DeletionResult>	deleteEntries(String notificationClientID, Set<String> values, String domainName)	deletes the given values and corresponding pseudonyms from the db
void	deleteEntry(String notificationClientID, String value, String domainName)	deletes the given value and corresponding pseudonym from the db
String	getOrCreatePseudonymFor(String notificationClientID, String value, String domainName)	returns a pseudonym for the given value
Map<String,String>	getOrCreatePseudonymForList(String notificationClientID, Set<String> values, String domainName)	list version of getOrCreatePseudonymFor(String, String, String) returns a map<value, psn> for all values
void	insertValuePseudonymPair(String notificationClientID, String value, String pseudonym, String domainName)	insert a value - pseudonym pair value is expected to be a valid pseudonym
List<InsertPairExceptionDTO>	insertValuePseudonymPairs(String notificationClientID, Map<String,String> pairs, String domainName)	insert value - pseudonym pairs values within the map are expected to be valid pseudonyms

Methodendetails

getOrCreatePseudonymFor

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

returns a pseudonym for the given value

Parameter:

value - string for which the pseudonym should be retrieved / generated

domainName - for / in which domain should the pair value-pseudonym be retrieved / stored

Gibt zurück:

a map with pairs original value -> pseudonym

Löst aus:

DBException - if an error occurred while persisting a new entry

DomainIsFullException - if a pseudonym for the given value couldn't be found, has therefor to be created but no more pseudonyms could be created for the given domain

InvalidParameterException - if one of the required parameters is not set

UnknownDomainException - if the given domain is not found

getOrCreatePseudonymForList

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

list version of getOrCreatePseudonymFor(String, String, String) returns a map<value, psn> for all values

Parameter:

values - list of strings for which pseudonyms should be retrieved / generated

domainName - for / in which domain should the pair value-pseudonym be retrieved / stored

Gibt zurück:

a map with pairs original value -> pseudonym

Löst aus:

DBException - if an error occurred while persisting a new entry

DomainIsFullException - if a pseudonym for the given value couldn't be found, has therefor to be created but no more pseudonyms could be created for the given domain

InvalidParameterException - if one of the required parameters is not set

UnknownDomainException - if the given domain is not found

anonymiseEntry

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

deletes the assignment value - pseudonym from the db (replaces "value" with "###_anonym_###_randString_###_anonym_###")

Parameter:

value - the value which should be anonymised

domainName - for which domain should the given value be anonymised

Löst aus:

DBException - if an error occurred while anonymising the entry

InvalidParameterException - if one of the required parameters is not set

UnknownDomainException - if the given domain is not found

UnknownValueException - if the value is not found within the given domain

ValueIsAnonymisedException - if the value is already anonymised

anonymiseEntries

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

deletes the assignments value - pseudonym from the db (replaces "value" with "###_anonym_###_randString_###_anonym_###")

Parameter:

values - the values which should be anonymised

domainName - for which domain should the given value be anonymised

Gibt zurück:

the success status

Löst aus:

DBException - if an error occurred while anonymising the entry

InvalidParameterException - if one of the required parameters is not set

UnknownDomainException - if the given domain is not found

deleteEntry

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

deletes the given value and corresponding pseudonym from the db

Parameter:

value - the value which should be delete

domainName - within which domain should the assignment be deleted

Löst aus:

DeletionForbiddenException - when it's not allowed to delete value-pseudonym-assignments within a domain
see DomainProperties.PSNS_DELETABLE

InvalidParameterException - if one of the required parameters is not set

UnknownDomainException - if the given domain is not found

UnknownValueException - if the given value is not found within the db for that domain

deleteEntries

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

deletes the given values and corresponding pseudonyms from the db

Parameter:

values - the values which should be delete

domainName - within which domain should the assignments be deleted

Gibt zurück:

a map with all values and the corresponding success status

Löst aus:

DeletionForbiddenException - when it's not allowed to delete value-pseudonym-assignments within a domain
see DomainProperties.PSNS_DELETABLE

InvalidParameterException - if one of the required parameters is not set

UnknownDomainException - if the given domain is not found

insertValuePseudonymPair

void insertValuePseudonymPair(String notificationClientID,
 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(String notificationClientID,
 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