Package cz.metacentrum.perun.core.impl

Class ExtSourceIT4I

java.lang.Object

cz.metacentrum.perun.core.api.PerunBean

cz.metacentrum.perun.core.api.Auditable

cz.metacentrum.perun.core.api.ExtSource

cz.metacentrum.perun.core.impl.ExtSourceImpl

cz.metacentrum.perun.core.impl.ExtSourceIT4I

All Implemented Interfaces:

ExtSourceSimpleApi, Serializable, Comparable<PerunBean>

public class ExtSourceIT4I
extends ExtSourceImpl
implements ExtSourceSimpleApi

Implementation of ExtSource for IT4I SCS API. It is used to retrieve groups (projects) from IT4I including group members (list of users einfra logins).

All synchronizations must be set to "lightweight" mode with fixed members ext source value to "PERUN" as IT4I doesn't provide full user data and Perun is source of truth in this case.

Author:

Pavel Zlámal <zlamal@cesnet.cz>

See Also:

• Serialized Form

Field Summary

Fields inherited from class cz.metacentrum.perun.core.impl.ExtSourceImpl

perunBl

Constructor Summary

Constructors

Constructor	Description
ExtSourceIT4I()

Method Summary

Modifier and Type	Method	Description
void	close()	If extSource needs to be closed, this method must be called.
List<Map<String,String>>	findSubjectsLogins(String searchString)	Finds all subjects logins in the external source, that contains searchString.
List<Map<String,String>>	findSubjectsLogins(String searchString, int maxResults)	Finds all subjects logins in the external source, that contains searchString, limited by the maxResults.
List<Map<String,String>>	getGroupSubjects(Map<String,String> attributes)	Get the list of the subjects in the external group.
Map<String,String>	getSubjectByLogin(String login)	Finds subject from the external source by the primary login used in external source.
List<Map<String,String>>	getSubjectGroups(Map<String,String> attributes)	Get the list of the subject groups in the external source.
List<Map<String,String>>	getUsersSubjects()	Get the list of subjects from the external source.

Methods inherited from class cz.metacentrum.perun.core.impl.ExtSourceImpl

getAttributes

Methods inherited from class cz.metacentrum.perun.core.api.ExtSource

compareTo, equals, getBeanName, getName, getType, hashCode, serializeToString, setName, setType, toString

Methods inherited from class cz.metacentrum.perun.core.api.Auditable

getCreatedAt, getCreatedBy, getCreatedByUid, getModifiedAt, getModifiedBy, getModifiedByUid, setCreatedAt, setCreatedBy, setCreatedByUid, setModifiedAt, setModifiedBy, setModifiedByUid

Methods inherited from class cz.metacentrum.perun.core.api.PerunBean

getId, setId

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Details

ExtSourceIT4I

public ExtSourceIT4I()

Method Details

close

public void close()
           throws ExtSourceUnsupportedOperationException

Description copied from interface: ExtSourceSimpleApi

If extSource needs to be closed, this method must be called.

Specified by:

close in interface ExtSourceSimpleApi

Throws:

ExtSourceUnsupportedOperationException

findSubjectsLogins

public List<Map<String,String>> findSubjectsLogins(String searchString,
 int maxResults)
                                            throws ExtSourceUnsupportedOperationException

Description copied from interface: ExtSourceSimpleApi

Finds all subjects logins in the external source, that contains searchString, limited by the maxResults.

This method is used for getting all logins of subjects in external source and then use them to searching in external source for other subjects attributes

Specified by:

findSubjectsLogins in interface ExtSourceSimpleApi

maxResults - limit returned results

Returns:

list of maps, which contains attr_name->attr_value but only for login definition eg. login;MichalS

Throws:

ExtSourceUnsupportedOperationException

findSubjectsLogins

public List<Map<String,String>> findSubjectsLogins(String searchString)
                                            throws ExtSourceUnsupportedOperationException

Description copied from interface: ExtSourceSimpleApi

Finds all subjects logins in the external source, that contains searchString.

This method is used for getting all logins of subjects in external source and then use them to searching in external source for other subjects attributes.

Specified by:

findSubjectsLogins in interface ExtSourceSimpleApi

Returns:

list of maps, which contains attr_name->attr_value but only for login definition eg. login;MichalS

Throws:

ExtSourceUnsupportedOperationException

getGroupSubjects

public List<Map<String,String>> getGroupSubjects(Map<String,String> attributes)
                                          throws ExtSourceUnsupportedOperationException

Description copied from interface: ExtSourceSimpleApi

Get the list of the subjects in the external group.

Specified by:

getGroupSubjects in interface ExtSourceSimpleApi

Parameters:

attributes - map of attributes used for quering the external source

Returns:

list of maps, which contains attr_name->attr_value, e.g. firstName->Michal

Throws:

ExtSourceUnsupportedOperationException

getSubjectByLogin

public Map<String,String> getSubjectByLogin(String login)
                                     throws SubjectNotExistsException,
ExtSourceUnsupportedOperationException

Description copied from interface: ExtSourceSimpleApi

Finds subject from the external source by the primary login used in external source.

Specified by:

getSubjectByLogin in interface ExtSourceSimpleApi

Parameters:

login - login used in the external source

Returns:

map which contains attr_name -> attr_value, e.g. firstName->Michal

Throws:

SubjectNotExistsException - if the subject cannot be found

ExtSourceUnsupportedOperationException

getSubjectGroups

public List<Map<String,String>> getSubjectGroups(Map<String,String> attributes)
                                          throws ExtSourceUnsupportedOperationException

Description copied from interface: ExtSourceSimpleApi

Get the list of the subject groups in the external source.

Specified by:

getSubjectGroups in interface ExtSourceSimpleApi

Parameters:

attributes - map of attributes used for quering the external source

Returns:

list of maps, which contains attr name and attr value

Throws:

ExtSourceUnsupportedOperationException

getUsersSubjects

public List<Map<String,String>> getUsersSubjects()
                                          throws ExtSourceUnsupportedOperationException

Description copied from interface: ExtSourceSimpleApi

Get the list of subjects from the external source.

Specified by:

getUsersSubjects in interface ExtSourceSimpleApi

Returns:

list of maps, which contains attr_name->attr_value, e.g. firstName->Michal

Throws:

ExtSourceUnsupportedOperationException