Overview  Package   Class  Use  Tree  Deprecated  Index  Help 
 PREV CLASS   NEXT CLASS FRAMES    NO FRAMES    
SUMMARY: NESTED | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD

edu.internet2.middleware.grouper.subj
Class ValidatingResolver

java.lang.Object
  extended by edu.internet2.middleware.grouper.subj.SubjectResolverDecorator
      extended by edu.internet2.middleware.grouper.subj.ValidatingResolver
All Implemented Interfaces:
SubjectResolver
public class ValidatingResolver
extends SubjectResolverDecorator

Decorator that provides parameter validation for SubjectResolver.

Since:
1.2.1
Version:
$Id: ValidatingResolver.java,v 1.8 2009-12-30 04:22:57 mchyzer Exp $
Author:
blair christensen.

Constructor Summary
ValidatingResolver(SubjectResolver resolver)
           
 
Method Summary
 edu.internet2.middleware.subject.Subject find(java.lang.String id)
           
 edu.internet2.middleware.subject.Subject find(java.lang.String id, java.lang.String source)
           
 java.util.Set<edu.internet2.middleware.subject.Subject> findAll(java.lang.String query)
           
 java.util.Set<edu.internet2.middleware.subject.Subject> findAll(java.lang.String query, java.util.Set<edu.internet2.middleware.subject.Source> sources)
          find subjects in a set of sources
 java.util.Set<edu.internet2.middleware.subject.Subject> findAll(java.lang.String query, java.lang.String source)
           
 java.util.Set<edu.internet2.middleware.subject.Subject> findAllInStem(java.lang.String stemName, java.lang.String query)
           
 edu.internet2.middleware.subject.Subject findByIdentifier(java.lang.String id)
           
 edu.internet2.middleware.subject.Subject findByIdentifier(java.lang.String id, java.lang.String source)
           
 java.util.Map<java.lang.String,edu.internet2.middleware.subject.Subject> findByIdentifiers(java.util.Collection<java.lang.String> identifiers)
           
 java.util.Map<java.lang.String,edu.internet2.middleware.subject.Subject> findByIdentifiers(java.util.Collection<java.lang.String> identifiers, java.lang.String source)
           
 edu.internet2.middleware.subject.Subject findByIdOrIdentifier(java.lang.String id)
           
 edu.internet2.middleware.subject.Subject findByIdOrIdentifier(java.lang.String id, java.lang.String source)
           
 java.util.Map<java.lang.String,edu.internet2.middleware.subject.Subject> findByIds(java.util.Collection<java.lang.String> ids)
           
 java.util.Map<java.lang.String,edu.internet2.middleware.subject.Subject> findByIds(java.util.Collection<java.lang.String> ids, java.lang.String source)
           
 java.util.Map<java.lang.String,edu.internet2.middleware.subject.Subject> findByIdsOrIdentifiers(java.util.Collection<java.lang.String> idsOrIdentifiers)
           
 java.util.Map<java.lang.String,edu.internet2.middleware.subject.Subject> findByIdsOrIdentifiers(java.util.Collection<java.lang.String> idsOrIdentifiers, java.lang.String source)
           
 edu.internet2.middleware.subject.SearchPageResult findPage(java.lang.String query)
           
 edu.internet2.middleware.subject.SearchPageResult findPage(java.lang.String query, java.util.Set<edu.internet2.middleware.subject.Source> sources)
          find a page of subjects in a set of sources
 edu.internet2.middleware.subject.SearchPageResult findPage(java.lang.String query, java.lang.String source)
           
 edu.internet2.middleware.subject.SearchPageResult findPageInStem(java.lang.String stemName, java.lang.String query)
           
 edu.internet2.middleware.subject.SearchPageResult findPageInStem(java.lang.String stemName, java.lang.String query, java.util.Set<edu.internet2.middleware.subject.Source> sources)
           
 void flushCache()
          flush the cache (e.g. for testing)
 edu.internet2.middleware.subject.Source getSource(java.lang.String id)
           
 java.util.Set<edu.internet2.middleware.subject.Source> getSources()
           
 
Methods inherited from class edu.internet2.middleware.grouper.subj.SubjectResolverDecorator
getDecoratedResolver
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

ValidatingResolver

public ValidatingResolver(SubjectResolver resolver)
Parameters:
resolver -
Since:
1.2.1
Method Detail

flushCache

public void flushCache()
flush the cache (e.g. for testing)

find

public edu.internet2.middleware.subject.Subject find(java.lang.String id)
                                              throws java.lang.IllegalArgumentException,
                                                     edu.internet2.middleware.subject.SubjectNotFoundException,
                                                     edu.internet2.middleware.subject.SubjectNotUniqueException
Parameters:
id - Subject id to search on.
Returns:
Subject matching search parameters.
Throws:
java.lang.IllegalArgumentException - if any parameter is null.
edu.internet2.middleware.subject.SubjectNotFoundException - if no matching subject is found.
edu.internet2.middleware.subject.SubjectNotUniqueException - if more than one matching subject is found.
Since:
1.2.1
See Also:
SubjectResolver.find(String)

find

public edu.internet2.middleware.subject.Subject find(java.lang.String id,
                                                     java.lang.String source)
                                              throws java.lang.IllegalArgumentException,
                                                     edu.internet2.middleware.subject.SourceUnavailableException,
                                                     edu.internet2.middleware.subject.SubjectNotFoundException,
                                                     edu.internet2.middleware.subject.SubjectNotUniqueException
Parameters:
id - Subject id to search on.
source - Source adapter to search within.
Returns:
Subject matching search parameters.
Throws:
java.lang.IllegalArgumentException - if any parameter is null.
edu.internet2.middleware.subject.SourceUnavailableException - if source is unavailable.
edu.internet2.middleware.subject.SubjectNotFoundException - if no matching subject is found.
edu.internet2.middleware.subject.SubjectNotUniqueException - if more than one matching subject is found.
Since:
1.2.1
See Also:
SubjectResolver.find(String, String)

findAll

public java.util.Set<edu.internet2.middleware.subject.Subject> findAll(java.lang.String query)
                                                                throws java.lang.IllegalArgumentException
Parameters:
query - A source-appropraite query string.
Returns:
All subjects matching query.
Throws:
java.lang.IllegalArgumentException - if any parameter is null.
Since:
1.2.1
See Also:
SubjectResolver.findAll(String)

findAll

public java.util.Set<edu.internet2.middleware.subject.Subject> findAll(java.lang.String query,
                                                                       java.util.Set<edu.internet2.middleware.subject.Source> sources)
                                                                throws java.lang.IllegalArgumentException
Description copied from interface: SubjectResolver
find subjects in a set of sources

Returns:
the subjects
Throws:
java.lang.IllegalArgumentException
See Also:
SubjectResolver.findAll(String, Set)

findPage

public edu.internet2.middleware.subject.SearchPageResult findPage(java.lang.String query,
                                                                  java.util.Set<edu.internet2.middleware.subject.Source> sources)
                                                           throws edu.internet2.middleware.subject.SourceUnavailableException
Description copied from interface: SubjectResolver
find a page of subjects in a set of sources

Returns:
the page of subjects
Throws:
edu.internet2.middleware.subject.SourceUnavailableException
See Also:
SubjectResolver.findPage(String, Set)

findAll

public java.util.Set<edu.internet2.middleware.subject.Subject> findAll(java.lang.String query,
                                                                       java.lang.String source)
                                                                throws java.lang.IllegalArgumentException,
                                                                       edu.internet2.middleware.subject.SourceUnavailableException
Parameters:
query - A source-appropriate query string.
source - Restrict query to within this source.
Returns:
All subjects matching query.
Throws:
java.lang.IllegalArgumentException - if any parameter is null.
edu.internet2.middleware.subject.SourceUnavailableException - if source is unavailable.
Since:
1.2.1
See Also:
SubjectResolver.findAll(String, String)

findByIdentifier

public edu.internet2.middleware.subject.Subject findByIdentifier(java.lang.String id)
                                                          throws java.lang.IllegalArgumentException,
                                                                 edu.internet2.middleware.subject.SubjectNotFoundException,
                                                                 edu.internet2.middleware.subject.SubjectNotUniqueException
Parameters:
id - Subject identifier to search on.
Returns:
Subject matching search parameters.
Throws:
java.lang.IllegalArgumentException - if any parameter is null.
edu.internet2.middleware.subject.SubjectNotFoundException - if no matching subject is found.
edu.internet2.middleware.subject.SubjectNotUniqueException - if more than one matching subject is found.
Since:
1.2.1
See Also:
SubjectResolver.findByIdentifier(String)

findByIdentifier

public edu.internet2.middleware.subject.Subject findByIdentifier(java.lang.String id,
                                                                 java.lang.String source)
                                                          throws java.lang.IllegalArgumentException,
                                                                 edu.internet2.middleware.subject.SourceUnavailableException,
                                                                 edu.internet2.middleware.subject.SubjectNotFoundException,
                                                                 edu.internet2.middleware.subject.SubjectNotUniqueException
Parameters:
id - Subject identifier to search on.
source - Source adapter to search within.
Returns:
Subject matching search parameters.
Throws:
java.lang.IllegalArgumentException - if any parameter is null.
edu.internet2.middleware.subject.SourceUnavailableException - if source is unavailable.
edu.internet2.middleware.subject.SubjectNotFoundException - if no matching subject is found.
edu.internet2.middleware.subject.SubjectNotUniqueException - if more than one matching subject is found.
Since:
1.2.1
See Also:
SubjectResolver.findByIdentifier(String, String)

getSource

public edu.internet2.middleware.subject.Source getSource(java.lang.String id)
                                                  throws java.lang.IllegalArgumentException,
                                                         edu.internet2.middleware.subject.SourceUnavailableException
Returns:
Subject source identified by id.
Throws:
java.lang.IllegalArgumentException - if id is null.
edu.internet2.middleware.subject.SourceUnavailableException - if source cannot be returned.
Since:
1.2.1
See Also:
SubjectResolver.getSource(String)

getSources

public java.util.Set<edu.internet2.middleware.subject.Source> getSources()
Returns:
All Subject sources.
Since:
1.2.1
See Also:
SubjectResolver.getSources()

findByIdOrIdentifier

public edu.internet2.middleware.subject.Subject findByIdOrIdentifier(java.lang.String id)
                                                              throws java.lang.IllegalArgumentException,
                                                                     edu.internet2.middleware.subject.SubjectNotFoundException,
                                                                     edu.internet2.middleware.subject.SubjectNotUniqueException
Parameters:
id - Subject identifier to search on.
Returns:
Subject matching search parameters.
Throws:
java.lang.IllegalArgumentException - if any parameter is null.
edu.internet2.middleware.subject.SubjectNotFoundException - if no matching subject is found.
edu.internet2.middleware.subject.SubjectNotUniqueException - if more than one matching subject is found.
See Also:
SubjectResolver.findByIdOrIdentifier(String)

findByIdOrIdentifier

public edu.internet2.middleware.subject.Subject findByIdOrIdentifier(java.lang.String id,
                                                                     java.lang.String source)
                                                              throws java.lang.IllegalArgumentException,
                                                                     edu.internet2.middleware.subject.SourceUnavailableException,
                                                                     edu.internet2.middleware.subject.SubjectNotFoundException,
                                                                     edu.internet2.middleware.subject.SubjectNotUniqueException
Parameters:
id - Subject identifier to search on.
source - Source adapter to search within.
Returns:
Subject matching search parameters.
Throws:
java.lang.IllegalArgumentException - if any parameter is null.
edu.internet2.middleware.subject.SourceUnavailableException - if source is unavailable.
edu.internet2.middleware.subject.SubjectNotFoundException - if no matching subject is found.
edu.internet2.middleware.subject.SubjectNotUniqueException - if more than one matching subject is found.
See Also:
SubjectResolver.findByIdOrIdentifier(String, String)

findAllInStem

public java.util.Set<edu.internet2.middleware.subject.Subject> findAllInStem(java.lang.String stemName,
                                                                             java.lang.String query)
                                                                      throws java.lang.IllegalArgumentException
Parameters:
stemName - name of stem we are querying
query - A source-appropriate query string.
Returns:
All subjects matching query.
Throws:
java.lang.IllegalArgumentException - if any parameter is null.
See Also:
SubjectResolver.findAllInStem(String, String)

findPage

public edu.internet2.middleware.subject.SearchPageResult findPage(java.lang.String query)
                                                           throws java.lang.IllegalArgumentException
Parameters:
query - A source-appropraite query string.
Returns:
Paged subjects matching query.
Throws:
java.lang.IllegalArgumentException - if any parameter is null.
Since:
2.0.2
See Also:
SubjectResolver.findPage(String)

findPage

public edu.internet2.middleware.subject.SearchPageResult findPage(java.lang.String query,
                                                                  java.lang.String source)
                                                           throws java.lang.IllegalArgumentException,
                                                                  edu.internet2.middleware.subject.SourceUnavailableException
Parameters:
query - A source-appropriate query string.
source - Restrict query to within this source.
Returns:
Page of subjects matching query.
Throws:
java.lang.IllegalArgumentException - if any parameter is null.
edu.internet2.middleware.subject.SourceUnavailableException - if source is unavailable.
Since:
2.0.2
See Also:
SubjectResolver.findPage(String, String)

findPageInStem

public edu.internet2.middleware.subject.SearchPageResult findPageInStem(java.lang.String stemName,
                                                                        java.lang.String query)
                                                                 throws java.lang.IllegalArgumentException
Parameters:
stemName - name of stem we are querying
query - A source-appropriate query string.
Returns:
All subjects matching query.
Throws:
java.lang.IllegalArgumentException - if any parameter is null.
See Also:
SubjectResolver.findPageInStem(String, String)

findPageInStem

public edu.internet2.middleware.subject.SearchPageResult findPageInStem(java.lang.String stemName,
                                                                        java.lang.String query,
                                                                        java.util.Set<edu.internet2.middleware.subject.Source> sources)
                                                                 throws java.lang.IllegalArgumentException
Parameters:
stemName - name of stem we are querying
query - A source-appropriate query string.
Returns:
All subjects matching query.
Throws:
java.lang.IllegalArgumentException - if any parameter is null.
See Also:
SubjectResolver.findPageInStem(String, String, Set)

findByIdentifiers

public java.util.Map<java.lang.String,edu.internet2.middleware.subject.Subject> findByIdentifiers(java.util.Collection<java.lang.String> identifiers)
                                                                                           throws java.lang.IllegalArgumentException
Returns:
map of search param to subject
Throws:
java.lang.IllegalArgumentException - if any parameter is null.
See Also:
SubjectResolver.findByIdentifiers(Collection)

findByIdentifiers

public java.util.Map<java.lang.String,edu.internet2.middleware.subject.Subject> findByIdentifiers(java.util.Collection<java.lang.String> identifiers,
                                                                                                  java.lang.String source)
                                                                                           throws java.lang.IllegalArgumentException,
                                                                                                  edu.internet2.middleware.subject.SourceUnavailableException
source - Source adapter to search within.
Returns:
map of search param to subject
Throws:
java.lang.IllegalArgumentException - if any parameter is null.
edu.internet2.middleware.subject.SourceUnavailableException - if source is unavailable.
See Also:
SubjectResolver.findByIdentifiers(Collection, String)

findByIds

public java.util.Map<java.lang.String,edu.internet2.middleware.subject.Subject> findByIds(java.util.Collection<java.lang.String> ids)
                                                                                   throws java.lang.IllegalArgumentException
Parameters:
ids - Subject id to search on.
Returns:
map of search param to subject
Throws:
java.lang.IllegalArgumentException - if any parameter is null.
See Also:
SubjectResolver.findByIds(Collection)

findByIds

public java.util.Map<java.lang.String,edu.internet2.middleware.subject.Subject> findByIds(java.util.Collection<java.lang.String> ids,
                                                                                          java.lang.String source)
                                                                                   throws java.lang.IllegalArgumentException,
                                                                                          edu.internet2.middleware.subject.SourceUnavailableException
source - Source adapter to search within.
Returns:
map of search param to subject
Throws:
java.lang.IllegalArgumentException - if any parameter is null.
edu.internet2.middleware.subject.SourceUnavailableException - if source is unavailable.
See Also:
SubjectResolver.findByIds(Collection, String)

findByIdsOrIdentifiers

public java.util.Map<java.lang.String,edu.internet2.middleware.subject.Subject> findByIdsOrIdentifiers(java.util.Collection<java.lang.String> idsOrIdentifiers)
                                                                                                throws java.lang.IllegalArgumentException
Parameters:
idsOrIdentifiers - Subject identifiers to search on.
Returns:
map of search param to subject
Throws:
java.lang.IllegalArgumentException - if any parameter is null.
See Also:
SubjectResolver.findByIdsOrIdentifiers(Collection)

findByIdsOrIdentifiers

public java.util.Map<java.lang.String,edu.internet2.middleware.subject.Subject> findByIdsOrIdentifiers(java.util.Collection<java.lang.String> idsOrIdentifiers,
                                                                                                       java.lang.String source)
                                                                                                throws java.lang.IllegalArgumentException,
                                                                                                       edu.internet2.middleware.subject.SourceUnavailableException
source - Source adapter to search within.
Returns:
map of search param to subject
Throws:
java.lang.IllegalArgumentException - if any parameter is null.
edu.internet2.middleware.subject.SourceUnavailableException - if source is unavailable.
See Also:
SubjectResolver.findByIdsOrIdentifiers(Collection, String)
Overview  Package   Class  Use  Tree  Deprecated  Index  Help 
 PREV CLASS   NEXT CLASS FRAMES    NO FRAMES    
SUMMARY: NESTED | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD