edu.internet2.middleware.subject.provider

Class LdapSourceAdapter

java.lang.Object

edu.internet2.middleware.subject.provider.BaseSourceAdapter

edu.internet2.middleware.subject.provider.LdapSourceAdapter

All Implemented Interfaces:

Source

Direct Known Subclasses:

HelperGrouperJndiSourceAdapter, JNDISourceAdapter

public class LdapSourceAdapter
extends BaseSourceAdapter

Ldap source adapter.

Field Summary

Fields inherited from class edu.internet2.middleware.subject.provider.BaseSourceAdapter

attributes, id, internalAttributes, name, params, searchAttributes, searches, sortAttributes, type, types

Constructor Summary

Constructors

Constructor and Description
LdapSourceAdapter()
LdapSourceAdapter(String id, String name)

Method Summary

Methods

Modifier and Type	Method and Description
void	checkConfig() make sure the config is ok, and log descriptive errors if not
protected String	escapeSearchFilter(String filter) Escape a search filter to prevent LDAP injection.
protected Map<String,Set<String>>	getAllAttributes(LdapSubject subject) Try to get more attributes for the subject.
edu.vt.middleware.ldap.pool.LdapPool<edu.vt.middleware.ldap.Ldap>	getLdapPool() Return the underlying LdapPool.
protected Iterator<SearchResult>	getLdapResults(Search search, String searchValue, String[] attributeNames)
protected Attributes	getLdapUnique(Search search, String searchValue, String[] attributeNames)
Integer	getMaxPage() max Page size
protected String	getNeededProperty(Properties props, String prop)
Subject	getSubject(String id) Deprecated.
Subject	getSubject(String id, boolean exceptionIfNull) Gets a Subject by its ID.
Subject	getSubjectByIdentifier(String id) Deprecated.
Subject	getSubjectByIdentifier(String id, boolean exceptionIfNull) note, you should implement this method since this implementation will become abstract at some point
void	init() Called by SourceManager when it loads this source.
static void	main(String[] args)
String	printConfig() in the startup on this i2mi app, print helpful and brief info about this source
Set<Subject>	search(String searchValue) Unstructured search for Subjects.
SearchPageResult	searchPage(String searchValue) Unstructured search for Subjects.
void	setMultipleResults(boolean multipleResults) Set whether or not multiple results are allowed.

Methods inherited from class edu.internet2.middleware.subject.provider.BaseSourceAdapter

addAttribute, addInitParam, addInternalAttribute, addSubjectType, equals, getAttributes, getId, getInitParam, getInternalAttributes, getName, getSearch, getSearchAttributes, getSearches, getSortAttributes, getSubject, getSubjectByIdentifier, getSubjectByIdOrIdentifier, getSubjectByIdOrIdentifier, getSubjectsByIdentifiers, getSubjectsByIdentifiers, getSubjectsByIds, getSubjectsByIds, getSubjectsByIdsOrIdentifiers, getSubjectsByIdsOrIdentifiers, getSubjectStatusConfig, getSubjectType, getSubjectTypes, hashCode, initParams, loadSearch, removeInitParam, resultSetLimit, search, searchPage, setId, setName, setSearchAttributes, setSearches, setSortAttributes

Methods inherited from class java.lang.Object

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

Constructor Detail

LdapSourceAdapter

public LdapSourceAdapter()

LdapSourceAdapter

public LdapSourceAdapter(String id,
                 String name)

Method Detail

main

public static void main(String[] args)

init

public void init()

Called by SourceManager when it loads this source.

Specified by:

init in interface Source

Specified by:

init in class BaseSourceAdapter

getSubject

public Subject getSubject(String id,
                 boolean exceptionIfNull)
                   throws SubjectNotFoundException,
                          SubjectNotUniqueException

Gets a Subject by its ID.

Specified by:

getSubject in interface Source

Overrides:

getSubject in class BaseSourceAdapter

exceptionIfNull - if SubjectNotFoundException should be throws if the subject is null, or if null should be returned

Returns:

subject

Throws:

SubjectNotFoundException

SubjectNotUniqueException

See Also:

Source.getSubject(java.lang.String, boolean)

getSubject

@Deprecated
public Subject getSubject(String id)
                   throws SubjectNotFoundException,
                          SubjectNotUniqueException

Deprecated.

Gets a Subject by its ID.

Specified by:

getSubject in interface Source

Specified by:

getSubject in class BaseSourceAdapter

Returns:

subject

Throws:

SubjectNotFoundException

SubjectNotUniqueException

See Also:

Source.getSubject(java.lang.String)

getSubjectByIdentifier

public Subject getSubjectByIdentifier(String id,
                             boolean exceptionIfNull)
                               throws SubjectNotFoundException,
                                      SubjectNotUniqueException

note, you should implement this method since this implementation will become abstract at some point

Specified by:

getSubjectByIdentifier in interface Source

Overrides:

getSubjectByIdentifier in class BaseSourceAdapter

Returns:

subject

Throws:

SubjectNotFoundException

SubjectNotUniqueException

See Also:

Source.getSubjectByIdentifier(java.lang.String, boolean)

getSubjectByIdentifier

@Deprecated
public Subject getSubjectByIdentifier(String id)
                               throws SubjectNotFoundException,
                                      SubjectNotUniqueException

Deprecated.

Gets a Subject by other well-known identifiers, aside from the subject ID, for example, login ID.

Specified by:

getSubjectByIdentifier in interface Source

Specified by:

getSubjectByIdentifier in class BaseSourceAdapter

Returns:

subject

Throws:

SubjectNotFoundException

SubjectNotUniqueException

See Also:

Source.getSubjectByIdentifier(java.lang.String)

searchPage

public SearchPageResult searchPage(String searchValue)

Description copied from interface: Source

Unstructured search for Subjects. Each implementation utilizes its own search algorithm tailored to the Subject repository and schema. Note if config param: throwErrorOnFindAllFailure is false, then swallow and log exceptions if maxPageSize is set in sources.xml, then only return max that many, and if there are more, set the tooManyResults flag

Specified by:

searchPage in interface Source

Overrides:

searchPage in class BaseSourceAdapter

Returns:

results and if there are too many, never return null!!!

See Also:

BaseSourceAdapter.searchPage(java.lang.String)

search

public Set<Subject> search(String searchValue)

Unstructured search for Subjects. Each implementation utilizes its own search algorithm tailored to the Subject repository and schema. Note if config param: throwErrorOnFindAllFailure is false, then swallow and log exceptions

Specified by:

search in interface Source

Specified by:

search in class BaseSourceAdapter

Returns:

set

getNeededProperty

protected String getNeededProperty(Properties props,
                       String prop)

getAllAttributes

protected Map<String,Set<String>> getAllAttributes(LdapSubject subject)

Try to get more attributes for the subject.

Parameters:

subject -

getLdapResults

protected Iterator<SearchResult> getLdapResults(Search search,
                                    String searchValue,
                                    String[] attributeNames)

getLdapUnique

protected Attributes getLdapUnique(Search search,
                       String searchValue,
                       String[] attributeNames)
                            throws SubjectNotFoundException,
                                   SubjectNotUniqueException,
                                   SourceUnavailableException

Throws:

SubjectNotFoundException

SubjectNotUniqueException

SourceUnavailableException

escapeSearchFilter

protected String escapeSearchFilter(String filter)

Escape a search filter to prevent LDAP injection. From http://www.owasp.org/index.php/Preventing_LDAP_Injection_in_Java

Parameters:

filter -

Returns:

escaped filter

checkConfig

public void checkConfig()

Description copied from interface: Source

make sure the config is ok, and log descriptive errors if not

See Also:

Source.checkConfig()

printConfig

public String printConfig()

Description copied from interface: Source

in the startup on this i2mi app, print helpful and brief info about this source

Returns:

the info

See Also:

Source.printConfig()

getLdapPool

public edu.vt.middleware.ldap.pool.LdapPool<edu.vt.middleware.ldap.Ldap> getLdapPool()

Return the underlying LdapPool.

Returns:

the ldap pool

setMultipleResults

public void setMultipleResults(boolean multipleResults)

Set whether or not multiple results are allowed. Primarily for tests.

Parameters:

multipleResults -

getMaxPage

public Integer getMaxPage()

max Page size

Returns:

the maxPage