jenkins.security

Class UserDetailsCache

java.lang.Object

jenkins.security.UserDetailsCache

@Extension
public final class UserDetailsCache
extends Object

Cache layer for UserDetails lookup.

Since:

2.15

Constructor Summary

Constructors

Constructor and Description
UserDetailsCache() Constructor intended to be instantiated by Jenkins only.

Method Summary

Modifier and Type	Method and Description
static UserDetailsCache	get() The singleton instance registered in Jenkins.
org.acegisecurity.userdetails.UserDetails	getCached(String idOrFullName) Gets the cached UserDetails for the given username.
void	invalidate(String idOrFullName) Discards any cached value for key.
void	invalidateAll() Discards all entries in the cache.
org.acegisecurity.userdetails.UserDetails	loadUserByUsername(String idOrFullName) Locates the user based on the username, by first looking in the cache and then delegate to SecurityRealm.loadUserByUsername(String).

Methods inherited from class java.lang.Object

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

Constructor Detail

UserDetailsCache

@Restricted(value=org.kohsuke.accmod.restrictions.NoExternalUse.class)
public UserDetailsCache()

Constructor intended to be instantiated by Jenkins only.

Method Detail

get

public static UserDetailsCache get()

The singleton instance registered in Jenkins.

Returns:

the cache

getCached

@CheckForNull
public org.acegisecurity.userdetails.UserDetails getCached(String idOrFullName)
                                                                  throws org.acegisecurity.userdetails.UsernameNotFoundException

Gets the cached UserDetails for the given username. Similar to loadUserByUsername(String) except it doesn't perform the actual lookup if there is a cache miss.

Parameters:

idOrFullName - the username

Returns:

null if the cache doesn't contain any data for the key or the user details cached for the key.

Throws:

org.acegisecurity.userdetails.UsernameNotFoundException - if a previous lookup resulted in the same

loadUserByUsername

@NonNull
public org.acegisecurity.userdetails.UserDetails loadUserByUsername(String idOrFullName)
                                                                      throws org.acegisecurity.userdetails.UsernameNotFoundException,
                                                                             org.springframework.dao.DataAccessException,
                                                                             ExecutionException

Locates the user based on the username, by first looking in the cache and then delegate to SecurityRealm.loadUserByUsername(String).

Parameters:

idOrFullName - the username

Returns:

the details

Throws:

org.acegisecurity.userdetails.UsernameNotFoundException - (normally a UserMayOrMayNotExistException) if the user could not be found or the user has no GrantedAuthority

org.springframework.dao.DataAccessException - if user could not be found for a repository-specific reason

ExecutionException - if anything else went wrong in the cache lookup/retrieval

invalidateAll

public void invalidateAll()

Discards all entries in the cache.

invalidate

public void invalidate(String idOrFullName)

Discards any cached value for key.

Parameters:

idOrFullName - the key