Class urn_perun_user_attribute_def_virt_institutionsCountries

java.lang.Object

cz.metacentrum.perun.core.implApi.modules.attributes.AttributesModuleAbstract

cz.metacentrum.perun.core.implApi.modules.attributes.UserAttributesModuleAbstract

cz.metacentrum.perun.core.implApi.modules.attributes.UserVirtualAttributesModuleAbstract

cz.metacentrum.perun.core.implApi.modules.attributes.UserVirtualAttributeCollectedFromUserExtSource<cz.metacentrum.perun.core.impl.modules.attributes.DnsMapCtx>

cz.metacentrum.perun.core.impl.modules.attributes.urn_perun_user_attribute_def_virt_institutionsCountries

All Implemented Interfaces:

AttributesModuleImplApi, UserAttributesModuleImplApi, UserVirtualAttributesModuleImplApi, VirtualAttributesModuleImplApi

public class urn_perun_user_attribute_def_virt_institutionsCountries
extends UserVirtualAttributeCollectedFromUserExtSource<cz.metacentrum.perun.core.impl.modules.attributes.DnsMapCtx>

Virtual user's attribute for converting schacHomeOrganization names to country names. Using help of entityless attribute dnsStateMapping for conversion. Using the greedy approach -> always taking the longest match from the available ones. Returns only non-empty values.

Examples:
muni.cz -> Czech Republic
oxford.ac.uk -> United Kingdom
.ebi.ac.uk -> null

Author:

Vladimir Mecko vladimir.mecko@gmail.com, Martin Kuba makub@ics.muni.cz

Nested Class Summary

Nested classes/interfaces inherited from class UserVirtualAttributeCollectedFromUserExtSource

UserVirtualAttributeCollectedFromUserExtSource.AttributeHandleIdentifier, UserVirtualAttributeCollectedFromUserExtSource.ModifyValueContext

Constructor Summary

Constructors

Constructor	Description
urn_perun_user_attribute_def_virt_institutionsCountries()

Method Summary

Modifier and Type	Method	Description
String	getDestinationAttributeDescription()
String	getDestinationAttributeFriendlyName()	Specifies friendly (short) name of attribute from namespace urn:perun:user:attribute-def:virt where values will be stored
String	getSourceAttributeFriendlyName()	Specifies friendly (short) name of attribute from namespace urn:perun:ues:attribute-def:def whose values are to be collected.
protected cz.metacentrum.perun.core.impl.modules.attributes.DnsMapCtx	initModifyValueContext(PerunSessionImpl sess, User user, AttributeDefinition attr)	Loads DNS-to-country translation map from attribute urn:perun:entityless:attribute-def:def:dnsStateMaping.
String	modifyValue(PerunSession session, cz.metacentrum.perun.core.impl.modules.attributes.DnsMapCtx ctx, UserExtSource ues, String value)	Replaces DNS domain with country name, or null.
List<AuditEvent>	resolveVirtualAttributeValueChange(PerunSessionImpl sess, AuditEvent message)	For a change in dnsStateMapping attribute, finds all affected users and generates audit message about changing this attribute for each of them.

Methods inherited from class UserVirtualAttributeCollectedFromUserExtSource

getAlsoExtLogin, getAttributeDefinition, getAttributeValue, getDestinationAttributeDisplayName, getDestinationAttributeName, getExtSourceFilter, getHandleIdentifiers, getSourceAttributeName, getValueFilter, isLastAccessValid

Methods inherited from class UserVirtualAttributesModuleAbstract

getStrongDependencies, removeAttributeValue, searchInAttributesValues, setAttributeValue

Methods inherited from class UserAttributesModuleAbstract

changedAttributeHook, checkAttributeSemantics, checkAttributeSyntax, deletedEntityHook, fillAttribute, getAnonymizedValue

Methods inherited from class AttributesModuleAbstract

getAuthorizedRoles, getDependencies

Methods inherited from class Object

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

Methods inherited from interface AttributesModuleImplApi

getAuthorizedRoles, getDependencies

Methods inherited from interface UserAttributesModuleImplApi

changedAttributeHook, checkAttributeSemantics, checkAttributeSyntax, deletedEntityHook, fillAttribute, getAnonymizedValue

Constructor Details

urn_perun_user_attribute_def_virt_institutionsCountries

public urn_perun_user_attribute_def_virt_institutionsCountries()

Method Details

getDestinationAttributeDescription

public String getDestinationAttributeDescription()

Overrides:

getDestinationAttributeDescription in class UserVirtualAttributeCollectedFromUserExtSource<cz.metacentrum.perun.core.impl.modules.attributes.DnsMapCtx>

getDestinationAttributeFriendlyName

public String getDestinationAttributeFriendlyName()

Description copied from class: UserVirtualAttributeCollectedFromUserExtSource

Specifies friendly (short) name of attribute from namespace urn:perun:user:attribute-def:virt where values will be stored

Specified by:

getDestinationAttributeFriendlyName in class UserVirtualAttributeCollectedFromUserExtSource<cz.metacentrum.perun.core.impl.modules.attributes.DnsMapCtx>

Returns:

short name of user attribute which is destination for collected values

getSourceAttributeFriendlyName

public String getSourceAttributeFriendlyName()

Description copied from class: UserVirtualAttributeCollectedFromUserExtSource

Specifies friendly (short) name of attribute from namespace urn:perun:ues:attribute-def:def whose values are to be collected.

Specified by:

getSourceAttributeFriendlyName in class UserVirtualAttributeCollectedFromUserExtSource<cz.metacentrum.perun.core.impl.modules.attributes.DnsMapCtx>

Returns:

short name of userExtSource attribute which is source of values

initModifyValueContext

protected cz.metacentrum.perun.core.impl.modules.attributes.DnsMapCtx initModifyValueContext(PerunSessionImpl sess,
 User user,
 AttributeDefinition attr)

Loads DNS-to-country translation map from attribute urn:perun:entityless:attribute-def:def:dnsStateMaping. DNS domains are in keys, country names are in values of the attribute.

Overrides:

initModifyValueContext in class UserVirtualAttributeCollectedFromUserExtSource<cz.metacentrum.perun.core.impl.modules.attributes.DnsMapCtx>

modifyValue

public String modifyValue(PerunSession session,
 cz.metacentrum.perun.core.impl.modules.attributes.DnsMapCtx ctx,
 UserExtSource ues,
 String value)

Replaces DNS domain with country name, or null.

Overrides:

modifyValue in class UserVirtualAttributeCollectedFromUserExtSource<cz.metacentrum.perun.core.impl.modules.attributes.DnsMapCtx>

Parameters:

session - PerunSession

ctx - context initialized in initModifyValueContext method

ues - UserExtSource

value - of userExtSource attribute

Returns:

modified value or null to skip the value

resolveVirtualAttributeValueChange

public List<AuditEvent> resolveVirtualAttributeValueChange(PerunSessionImpl sess,
 AuditEvent message)
                                                    throws WrongReferenceAttributeValueException,
AttributeNotExistsException,
WrongAttributeAssignmentException

For a change in dnsStateMapping attribute, finds all affected users and generates audit message about changing this attribute for each of them.

Specified by:

resolveVirtualAttributeValueChange in interface AttributesModuleImplApi

Overrides:

resolveVirtualAttributeValueChange in class UserVirtualAttributeCollectedFromUserExtSource<cz.metacentrum.perun.core.impl.modules.attributes.DnsMapCtx>

Parameters:

sess -

message -

Returns:

list of additional messages for auditer to log it

Throws:

WrongReferenceAttributeValueException

AttributeNotExistsException

WrongAttributeAssignmentException