org.opensaml.saml.metadata.resolver.impl

Class BasicRoleDescriptorResolver

java.lang.Object

net.shibboleth.utilities.java.support.component.AbstractInitializableComponent

net.shibboleth.utilities.java.support.component.AbstractIdentifiedInitializableComponent

org.opensaml.saml.metadata.resolver.impl.BasicRoleDescriptorResolver

All Implemented Interfaces:

Component, DestructableComponent, IdentifiedComponent, InitializableComponent, Resolver<RoleDescriptor,CriteriaSet>, RoleDescriptorResolver

Deprecated.

use PredicateRoleDescriptorResolver

@Deprecated
public class BasicRoleDescriptorResolver
extends AbstractIdentifiedInitializableComponent
implements RoleDescriptorResolver

Simple impl of RoleDescriptorResolver which wraps an instance of MetadataResolver to support basic EntityDescriptor resolution, and then performs further role-related filtering over the returned EntityDescriptor.

Field Summary

Fields

Modifier and Type	Field and Description
private MetadataResolver	entityDescriptorResolver Deprecated. Resolver of EntityDescriptors.
private org.slf4j.Logger	log Deprecated. Logger.
private boolean	requireValidMetadata Deprecated. Whether metadata is required to be valid.

Constructor Summary

Constructors

Constructor and Description
BasicRoleDescriptorResolver(MetadataResolver mdResolver) Deprecated. Constructor.

Method Summary

Modifier and Type	Method and Description
protected EntityDescriptor	doGetEntityDescriptor(String entityID) Deprecated. Resolve an entity descriptor based on entityID using the wrapped metadata resolver.
protected List<RoleDescriptor>	doGetRole(String entityID, QName roleName) Deprecated. Gets the identified roles from an EntityDescriptor.
protected RoleDescriptor	doGetRole(String entityID, QName roleName, String supportedProtocol) Deprecated. Gets the role which supports the given protocol.
protected List<RoleDescriptor>	getRole(String entityID, QName roleName) Deprecated. Get role descriptors for a given entityID and role.
protected RoleDescriptor	getRole(String entityID, QName roleName, String supportedProtocol) Deprecated. Get role descriptor for a given entityID and role and protocol.
boolean	isRequireValidMetadata() Deprecated.
protected boolean	isValid(org.opensaml.core.xml.XMLObject descriptor) Deprecated. Returns whether the given descriptor is valid.
Iterable<RoleDescriptor>	resolve(CriteriaSet criteria) Deprecated.
RoleDescriptor	resolveSingle(CriteriaSet criteria) Deprecated.
void	setRequireValidMetadata(boolean require) Deprecated.

Methods inherited from class net.shibboleth.utilities.java.support.component.AbstractIdentifiedInitializableComponent

doInitialize, getId, setId

Methods inherited from class net.shibboleth.utilities.java.support.component.AbstractInitializableComponent

destroy, doDestroy, initialize, isDestroyed, isInitialized

Methods inherited from class java.lang.Object

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

Methods inherited from interface net.shibboleth.utilities.java.support.component.IdentifiedComponent

getId

Field Detail

log

private org.slf4j.Logger log

Deprecated.

Logger.

requireValidMetadata

private boolean requireValidMetadata

Deprecated.

Whether metadata is required to be valid.

entityDescriptorResolver

private MetadataResolver entityDescriptorResolver

Deprecated.

Resolver of EntityDescriptors.

Constructor Detail

BasicRoleDescriptorResolver

public BasicRoleDescriptorResolver(@Nonnull
                                   MetadataResolver mdResolver)

Deprecated.

Constructor.

Parameters:

mdResolver - the resolver of EntityDescriptors

Method Detail

isRequireValidMetadata

public boolean isRequireValidMetadata()

Deprecated.

Specified by:

isRequireValidMetadata in interface RoleDescriptorResolver

setRequireValidMetadata

public void setRequireValidMetadata(boolean require)

Deprecated.

Specified by:

setRequireValidMetadata in interface RoleDescriptorResolver

resolveSingle

@Nullable
public RoleDescriptor resolveSingle(CriteriaSet criteria)
                                       throws ResolverException

Deprecated.

Specified by:

resolveSingle in interface Resolver<RoleDescriptor,CriteriaSet>

Throws:

ResolverException

resolve

@Nonnull
public Iterable<RoleDescriptor> resolve(CriteriaSet criteria)
                                          throws ResolverException

Deprecated.

Specified by:

resolve in interface Resolver<RoleDescriptor,CriteriaSet>

Throws:

ResolverException

getRole

@Nonnull
 @NonnullElements
protected List<RoleDescriptor> getRole(@Nullable
                                                                  String entityID,
                                                                  @Nullable
                                                                  QName roleName)
                                                           throws ResolverException

Deprecated.

Get role descriptors for a given entityID and role.

Parameters:

entityID - entityID to lookup

roleName - role to lookup

Returns:

list of roles

Throws:

ResolverException - if an error occurs

doGetRole

@Nonnull
 @NonnullElements
protected List<RoleDescriptor> doGetRole(@Nullable
                                                                    String entityID,
                                                                    @Nullable
                                                                    QName roleName)
                                                             throws ResolverException

Deprecated.

Gets the identified roles from an EntityDescriptor. This method should not check if the provider is initialized, if arguments are null, if the roles are valid, etc. All of this is done by the invoker of this method.

Parameters:

entityID - ID of the entity from which to retrieve the roles, never null

roleName - name of the roles to search for, never null

Returns:

the modifiable list of identified roles or an empty list if no roles exists

Throws:

ResolverException - thrown if there is a problem searching for the roles

doGetEntityDescriptor

protected EntityDescriptor doGetEntityDescriptor(String entityID)
                                          throws ResolverException

Deprecated.

Resolve an entity descriptor based on entityID using the wrapped metadata resolver.

Parameters:

entityID - the entityID of the EntityDescriptor to resolve.

Returns:

the resolved EntityDescriptor, or null if not found

Throws:

ResolverException - if there is a problem resolving the EntityDescriptor

getRole

@Nullable
protected RoleDescriptor getRole(@Nullable
                                           String entityID,
                                           @Nullable
                                           QName roleName,
                                           @Nullable
                                           String supportedProtocol)
                                    throws ResolverException

Deprecated.

Get role descriptor for a given entityID and role and protocol.

Parameters:

entityID - entityID to lookup

roleName - role to lookup

supportedProtocol - protocol to lookup

Returns:

list of roles

Throws:

ResolverException - if an error occurs

doGetRole

protected RoleDescriptor doGetRole(String entityID,
                                   QName roleName,
                                   String supportedProtocol)
                            throws ResolverException

Deprecated.

Gets the role which supports the given protocol.

Parameters:

entityID - ID of the entity from which to retrieve roles, never null

roleName - name of the role to search for, never null

supportedProtocol - protocol to search for, never null

Returns:

the role supporting the protocol or null if no such role exists

Throws:

ResolverException - thrown if there is a problem search for the roles

isValid

protected boolean isValid(org.opensaml.core.xml.XMLObject descriptor)

Deprecated.

Returns whether the given descriptor is valid. If valid metadata is not required this method always returns true.

Parameters:

descriptor - the descriptor to check

Returns:

true if valid metadata is not required or the given descriptor is valid, false otherwise