Package org.keycloak.authorization.store

Interface ScopeStore

public interface ScopeStore

A ScopeStore is responsible to manage the persistence of Scope instances.

Author:

Pedro Igor

Method Summary

Modifier and Type	Method	Description
default Scope	create(ResourceServer resourceServer, String name)	Creates a new Scope instance.
Scope	create(ResourceServer resourceServer, String id, String name)	Creates a new Scope instance.
void	delete(String id)	Deletes a scope from the underlying persistence mechanism.
Scope	findById(ResourceServer resourceServer, String id)	Returns a Scope with the given id
Scope	findByName(ResourceServer resourceServer, String name)	Returns a Scope with the given name
List<Scope>	findByResourceServer(ResourceServer resourceServer)	Returns a list of Scope associated with a ResourceServer with the given resourceServer.
List<Scope>	findByResourceServer(ResourceServer resourceServer, Map<Scope.FilterOption,String[]> attributes, Integer firstResult, Integer maxResults)	Returns a list of Scope associated with a ResourceServer with the given resourceServerId.

Method Detail

create

default Scope create(ResourceServer resourceServer,
                     String name)

Creates a new Scope instance. The new instance is not necessarily persisted though, which may require a call to the {#save} method to actually make it persistent.

Parameters:

resourceServer - the resource server to which this scope belongs

name - the name of the scope

Returns:

a new instance of Scope

create

Scope create(ResourceServer resourceServer,
             String id,
             String name)

Creates a new Scope instance. The new instance is not necessarily persisted though, which may require a call to the {#save} method to actually make it persistent.

Parameters:

resourceServer - the resource server to which this scope belongs

id - the id of the scope. Is generated randomly when null

name - the name of the scope

Returns:

a new instance of Scope

delete

void delete(String id)

Deletes a scope from the underlying persistence mechanism.

Parameters:

id - the id of the scope to delete

findById

Scope findById(ResourceServer resourceServer,
               String id)

Returns a Scope with the given id

Parameters:

resourceServer - the resource server id

id - the identifier of the scope

Returns:

a scope with the given identifier.

findByName

Scope findByName(ResourceServer resourceServer,
                 String name)

Returns a Scope with the given name

Parameters:

resourceServer - the resource server

name - the name of the scope

Returns:

a scope with the given name.

findByResourceServer

List<Scope> findByResourceServer(ResourceServer resourceServer)

Returns a list of Scope associated with a ResourceServer with the given resourceServer.

Parameters:

resourceServer - the identifier of a resource server

Returns:

a list of scopes that belong to the given resource server

findByResourceServer

List<Scope> findByResourceServer(ResourceServer resourceServer,
                                 Map<Scope.FilterOption,String[]> attributes,
                                 Integer firstResult,
                                 Integer maxResults)

Returns a list of Scope associated with a ResourceServer with the given resourceServerId.

Parameters:

resourceServer - the resource server

attributes - a map holding the attributes that will be used as a filter; possible filter options are given by Scope.FilterOption

firstResult - first result to return. Ignored if negative or null.

maxResults - maximum number of results to return. Ignored if negative or null.

Returns:

a list of scopes that belong to the given resource server

Throws:

IllegalArgumentException - when there is an unknown attribute in the attributes map