Package org.emau.icmvc.ganimed.ttp.cm2

Interface GICSManagementService

public interface GICSManagementService

Method Summary

Modifier and Type	Method	Description
void	addConsentTemplate(ConsentTemplateDTO consentTemplateDTO, boolean finaliseRelatedEntities)	stores the given consent template the policies within the modulDTOs are ignored and therefore doesn't need to be set
void	addDomain(DomainDTO domainDTO)	creates a new domain
void	addModule(ModuleDTO moduleDTO, boolean finaliseRelatedEntities)	stores the given module
void	addPolicy(PolicyDTO policyDTO)	stores the given policy
void	addSignerIdType(String domainName, String signerIdTypeName)	add a signer id type with the given name to the given domain
void	deleteConsentTemplate(ConsentTemplateKeyDTO keyDTO)	deletes the given consent template (only if it's not in use, i.e.
void	deleteDomain(String domainName)	deletes the given domain
void	deleteModule(ModuleKeyDTO keyDTO)	deletes the given module (only if it's not in use, i.e.
void	deletePolicy(PolicyKeyDTO keyDTO)	deletes the given policy (only if it's not in use, i.e.
void	deleteSignerIdType(String domainName, String signerIdTypeName)	removes the given signer id type from the given domain
void	finaliseAllForDomain(String domainName)	finalises the given domain and all its policies, modules, and templates
void	finaliseDomain(String domainName)	finalises the given domain
void	finaliseModule(ModuleKeyDTO moduleKeyDTO, boolean finaliseRelatedEntities)	finalises the given module
void	finalisePolicy(PolicyKeyDTO policyKeyDTO)	finalises the given policy
void	finaliseTemplate(ConsentTemplateKeyDTO consentTemplateKeyDTO, boolean finaliseRelatedEntities)	finalises the given consent template
void	processPoliciyValidityChangesForAllDomains()
void	processPolicyValidityChanges(List<DomainDTO> domains)
void	updateConsentTemplate(ConsentTemplateDTO consentTemplateDTO, boolean finaliseRelatedEntities)	updates the given consent template
void	updateConsentTemplateInUse(ConsentTemplateDTO consentTemplateDTO)	updates label, title, comment, externProperties, scanBase64, scanFileType, assignedModule.comment, assignedModule.externProperties, freeTextDef.comment
void	updateDomain(DomainDTO domainDTO)	updates the given domain
void	updateDomainInUse(String domainName, String label, String logo, String externProperties, ExpirationPropertiesDTO expirationProperties, String comment, DomainConfig config)	updates the given domain with the given values
void	updateModule(ModuleDTO moduleDTO, boolean finaliseRelatedEntities)	updates the given module
void	updateModuleInUse(ModuleKeyDTO moduleKeyDTO, String label, String shortText, String externProperties, String comment, Set<AssignedPolicyDTO> assignedPolicyDTOs)	updates the given module with the given values
void	updatePolicy(PolicyDTO policyDTO)	updates the given policy
void	updatePolicyInUse(PolicyKeyDTO policyKeyDTO, String label, String externProperties, String comment)	updates the given policy with the given values
void	updateSignerIdType(String domainName, String signerIdTypeName, String label, String comment)	updates the given signerIdType with the given values

Method Details

addDomain

void addDomain(DomainDTO domainDTO)
        throws DuplicateEntryException,
InvalidParameterException,
VersionConverterClassException

creates a new domain

Parameters:

domainDTO - see DomainDTO

Throws:

DuplicateEntryException - if a domain with that name already exists

InvalidParameterException

VersionConverterClassException

deleteDomain

void deleteDomain(String domainName)
           throws InvalidParameterException,
ObjectInUseException,
UnknownDomainException

deletes the given domain

Parameters:

domainName - the name of the domain

Throws:

InvalidParameterException

ObjectInUseException - if there's at least one pseudonym within that domain

UnknownDomainException - if the given domain is not found

finaliseAllForDomain

void finaliseAllForDomain(String domainName)
                   throws InvalidParameterException,
UnknownDomainException,
InvalidVersionException,
UnknownPolicyException,
UnknownConsentTemplateException,
UnknownModuleException,
RequirementsNotFullfilledException,
VersionConverterClassException

finalises the given domain and all its policies, modules, and templates

Parameters:

domainName - the name of the domain

Throws:

InvalidParameterException

UnknownDomainException

InvalidVersionException

UnknownPolicyException

UnknownConsentTemplateException

UnknownModuleException

RequirementsNotFullfilledException

VersionConverterClassException

finaliseDomain

void finaliseDomain(String domainName)
             throws InvalidParameterException,
UnknownDomainException,
VersionConverterClassException

finalises the given domain

Parameters:

domainName - the name of the domain

Throws:

InvalidParameterException

UnknownDomainException

VersionConverterClassException

updateDomain

void updateDomain(DomainDTO domainDTO)
           throws InvalidParameterException,
ObjectInUseException,
UnknownDomainException,
VersionConverterClassException

updates the given domain

Parameters:

domainDTO -

Throws:

InvalidParameterException

ObjectInUseException

UnknownDomainException

VersionConverterClassException

updateDomainInUse

void updateDomainInUse(String domainName,
 String label,
 String logo,
 String externProperties,
 ExpirationPropertiesDTO expirationProperties,
 String comment,
 DomainConfig config)
                throws InvalidParameterException,
UnknownDomainException,
VersionConverterClassException

updates the given domain with the given values

Parameters:

domainName - the name of the domain

label -

logo -

externProperties -

comment -

config -

Throws:

InvalidParameterException

UnknownDomainException

VersionConverterClassException

addConsentTemplate

void addConsentTemplate(ConsentTemplateDTO consentTemplateDTO,
 boolean finaliseRelatedEntities)
                 throws UnknownDomainException,
UnknownModuleException,
DuplicateEntryException,
InvalidParameterException,
InvalidVersionException,
FreeTextConverterStringException,
InvalidPropertiesException,
RequirementsNotFullfilledException,
UnknownConsentTemplateException,
IllegalCompositionException

stores the given consent template
the policies within the modulDTOs are ignored and therefore doesn't need to be set

Parameters:

consentTemplateDTO -

Throws:

UnknownDomainException

UnknownModuleException

DuplicateEntryException

InvalidParameterException

InvalidVersionException

FreeTextConverterStringException - is thrown when the given converter string (in case of FreeTextType.Date) is not a valid string for SimpleDateFormat

InvalidPropertiesException

RequirementsNotFullfilledException

InvalidParameterException

UnknownConsentTemplateException

IllegalCompositionException

deleteConsentTemplate

void deleteConsentTemplate(ConsentTemplateKeyDTO keyDTO)
                    throws UnknownDomainException,
UnknownConsentTemplateException,
ObjectInUseException,
InvalidParameterException,
InvalidVersionException

deletes the given consent template (only if it's not in use, i.e. there's no consent belonging to that consent template)

Parameters:

keyDTO -

Throws:

UnknownDomainException

UnknownConsentTemplateException

ObjectInUseException

InvalidParameterException

InvalidVersionException

finaliseTemplate

void finaliseTemplate(ConsentTemplateKeyDTO consentTemplateKeyDTO,
 boolean finaliseRelatedEntities)
               throws InvalidParameterException,
InvalidVersionException,
RequirementsNotFullfilledException,
UnknownConsentTemplateException,
UnknownDomainException

finalises the given consent template

Parameters:

consentTemplateKeyDTO -

finaliseRelatedEntities -

Throws:

InvalidParameterException

InvalidVersionException

RequirementsNotFullfilledException

UnknownConsentTemplateException

UnknownDomainException

updateConsentTemplate

void updateConsentTemplate(ConsentTemplateDTO consentTemplateDTO,
 boolean finaliseRelatedEntities)
                    throws DuplicateEntryException,
FreeTextConverterStringException,
InvalidFreeTextException,
InvalidParameterException,
InvalidPropertiesException,
InvalidVersionException,
ObjectInUseException,
RequirementsNotFullfilledException,
UnknownConsentTemplateException,
UnknownDomainException,
UnknownModuleException,
IllegalCompositionException

updates the given consent template

Parameters:

consentTemplateDTO -

Throws:

DuplicateEntryException

FreeTextConverterStringException

InvalidFreeTextException

InvalidParameterException

InvalidPropertiesException

InvalidVersionException

ObjectInUseException

RequirementsNotFullfilledException

UnknownConsentTemplateException

UnknownDomainException

UnknownModuleException

IllegalCompositionException

updateConsentTemplateInUse

void updateConsentTemplateInUse(ConsentTemplateDTO consentTemplateDTO)
                         throws InvalidFreeTextException,
InvalidParameterException,
InvalidVersionException,
UnknownConsentTemplateException,
UnknownDomainException,
UnknownModuleException

updates label, title, comment, externProperties, scanBase64, scanFileType, assignedModule.comment, assignedModule.externProperties, freeTextDef.comment

Parameters:

consentTemplateDTO -

Throws:

InvalidFreeTextException

InvalidParameterException

InvalidVersionException

UnknownConsentTemplateException

UnknownDomainException

UnknownModuleException

addModule

void addModule(ModuleDTO moduleDTO,
 boolean finaliseRelatedEntities)
        throws UnknownDomainException,
UnknownPolicyException,
DuplicateEntryException,
InvalidParameterException,
InvalidVersionException,
RequirementsNotFullfilledException,
IllegalCompositionException

stores the given module

Parameters:

moduleDTO -

Throws:

UnknownDomainException

UnknownPolicyException

DuplicateEntryException

InvalidParameterException

InvalidVersionException

RequirementsNotFullfilledException

IllegalCompositionException

deleteModule

void deleteModule(ModuleKeyDTO keyDTO)
           throws UnknownDomainException,
UnknownModuleException,
ObjectInUseException,
InvalidParameterException,
InvalidVersionException

deletes the given module (only if it's not in use, i.e. there's no consent template linked to that module)

Parameters:

keyDTO -

Throws:

UnknownDomainException

UnknownModuleException

ObjectInUseException

InvalidParameterException

InvalidVersionException

finaliseModule

void finaliseModule(ModuleKeyDTO moduleKeyDTO,
 boolean finaliseRelatedEntities)
             throws InvalidParameterException,
InvalidVersionException,
RequirementsNotFullfilledException,
UnknownDomainException,
UnknownModuleException

finalises the given module

Parameters:

moduleKeyDTO -

finaliseRelatedEntities -

Throws:

InvalidParameterException

InvalidVersionException

RequirementsNotFullfilledException

UnknownDomainException

UnknownModuleException

updateModule

void updateModule(ModuleDTO moduleDTO,
 boolean finaliseRelatedEntities)
           throws DuplicateEntryException,
InvalidParameterException,
InvalidVersionException,
ObjectInUseException,
RequirementsNotFullfilledException,
UnknownDomainException,
UnknownModuleException,
UnknownPolicyException,
IllegalCompositionException

updates the given module

Parameters:

moduleDTO -

Throws:

DuplicateEntryException

InvalidParameterException

InvalidVersionException

ObjectInUseException

RequirementsNotFullfilledException

UnknownDomainException

UnknownModuleException

UnknownPolicyException

IllegalCompositionException

updateModuleInUse

void updateModuleInUse(ModuleKeyDTO moduleKeyDTO,
 String label,
 String shortText,
 String externProperties,
 String comment,
 Set<AssignedPolicyDTO> assignedPolicyDTOs)
                throws InvalidParameterException,
InvalidVersionException,
UnknownDomainException,
UnknownModuleException

updates the given module with the given values

Parameters:

moduleKeyDTO -

label -

shortText -

externProperties -

comment -

assignedPolicyDTOs - only externProperties and comments of this objects are updated

Throws:

InvalidParameterException

InvalidVersionException

UnknownDomainException

UnknownModuleException

addPolicy

void addPolicy(PolicyDTO policyDTO)
        throws UnknownDomainException,
DuplicateEntryException,
InvalidParameterException,
InvalidVersionException,
RequirementsNotFullfilledException

stores the given policy

Parameters:

policyDTO -

Throws:

UnknownDomainException

DuplicateEntryException

InvalidParameterException

InvalidVersionException

RequirementsNotFullfilledException

deletePolicy

void deletePolicy(PolicyKeyDTO keyDTO)
           throws UnknownDomainException,
UnknownPolicyException,
ObjectInUseException,
InvalidParameterException,
InvalidVersionException

deletes the given policy (only if it's not in use, i.e. there's no module linked to that policy)

Parameters:

keyDTO -

Throws:

UnknownDomainException

UnknownPolicyException

ObjectInUseException

InvalidParameterException

InvalidVersionException

finalisePolicy

void finalisePolicy(PolicyKeyDTO policyKeyDTO)
             throws InvalidParameterException,
InvalidVersionException,
UnknownDomainException,
UnknownPolicyException

finalises the given policy

Parameters:

policyKeyDTO -

Throws:

InvalidParameterException

InvalidVersionException

UnknownDomainException

UnknownPolicyException

updatePolicy

void updatePolicy(PolicyDTO policyDTO)
           throws InvalidParameterException,
InvalidVersionException,
ObjectInUseException,
UnknownDomainException,
UnknownPolicyException

updates the given policy

Parameters:

policyDTO -

Throws:

InvalidParameterException

InvalidVersionException

ObjectInUseException

UnknownDomainException

UnknownPolicyException

updatePolicyInUse

void updatePolicyInUse(PolicyKeyDTO policyKeyDTO,
 String label,
 String externProperties,
 String comment)
                throws InvalidParameterException,
InvalidVersionException,
UnknownDomainException,
UnknownPolicyException

updates the given policy with the given values

Parameters:

policyKeyDTO -

label -

externProperties -

comment -

Throws:

InvalidParameterException

InvalidVersionException

UnknownDomainException

UnknownPolicyException

addSignerIdType

void addSignerIdType(String domainName,
 String signerIdTypeName)
              throws InvalidParameterException,
UnknownDomainException,
DuplicateEntryException

add a signer id type with the given name to the given domain

Parameters:

domainName - domain to which the signerIdType belongs to

signerIdTypeName - identifier

Throws:

InvalidParameterException

UnknownDomainException - if the given domain is not found

DuplicateEntryException - if the signerIdType already exists

updateSignerIdType

void updateSignerIdType(String domainName,
 String signerIdTypeName,
 String label,
 String comment)
                 throws InvalidParameterException,
UnknownDomainException,
UnknownSignerIdTypeException

updates the given signerIdType with the given values

Parameters:

domainName - domain to which the signerIdType belongs to

signerIdTypeName - identifier

label -

comment -

Throws:

InvalidParameterException

UnknownDomainException - if the given domain is not found

UnknownSignerIdTypeException - if the given signerIdType is not found

deleteSignerIdType

void deleteSignerIdType(String domainName,
 String signerIdTypeName)
                 throws InvalidParameterException,
UnknownDomainException,
UnknownSignerIdTypeException,
ObjectInUseException

removes the given signer id type from the given domain

Parameters:

domainName - domain to which the signerIdType belongs to

signerIdTypeName - identifier

Throws:

InvalidParameterException

UnknownDomainException

UnknownSignerIdTypeException

ObjectInUseException

processPolicyValidityChanges

void processPolicyValidityChanges(List<DomainDTO> domains)
                           throws UnknownSignerIdTypeException,
UnknownSignerIdException,
InvalidVersionException,
UnknownDomainException,
VersionConverterClassException

Throws:

UnknownSignerIdTypeException

UnknownSignerIdException

InvalidVersionException

UnknownDomainException

VersionConverterClassException

processPoliciyValidityChangesForAllDomains

void processPoliciyValidityChangesForAllDomains()
                                         throws UnknownSignerIdTypeException,
UnknownSignerIdException,
InvalidVersionException,
UnknownDomainException,
VersionConverterClassException

Throws:

UnknownSignerIdTypeException

UnknownSignerIdException

InvalidVersionException

UnknownDomainException

VersionConverterClassException