com.cloudbees.plugins.credentials

Class CredentialsMatchers

java.lang.Object

com.cloudbees.plugins.credentials.CredentialsMatchers

public class CredentialsMatchers
extends Object

Some standard matchers and filtering utility methods.

Since:

1.5

Method Summary

Methods

Modifier and Type	Method and Description
static CredentialsMatcher	allOf(CredentialsMatcher... matchers) Creates a matcher that matches when all of the supplied matchers match.
static CredentialsMatcher	always() Creates a matcher that always matches.
static CredentialsMatcher	anyOf(CredentialsMatcher... matchers) Creates a matcher that matches when any of the supplied matchers match.
static CredentialsMatcher	both(CredentialsMatcher matcher1, CredentialsMatcher matcher2) Creates a matcher that matches when both of the supplied matchers match.
static CredentialsMatcher	either(CredentialsMatcher matcher1, CredentialsMatcher matcher2) Creates a matcher that matches when either of the supplied matchers match.
static <C extends Credentials> Collection<C>	filter(Collection<C> credentials, CredentialsMatcher matcher) Filters credentials using the supplied matcher.
static <C extends Credentials> Iterable<C>	filter(Iterable<C> credentials, CredentialsMatcher matcher) Filters credentials using the supplied matcher.
static <C extends Credentials> List<C>	filter(List<C> credentials, CredentialsMatcher matcher) Filters credentials using the supplied matcher.
static <C extends Credentials> Set<C>	filter(Set<C> credentials, CredentialsMatcher matcher) Filters credentials using the supplied matcher.
static <C extends Credentials,V> Map<C,V>	filterKeys(Map<C,V> credentialMap, CredentialsMatcher matcher) Filters a map keyed by credentials using the supplied matcher.
static <C extends Credentials,K> Map<K,C>	filterValues(Map<K,C> credentialMap, CredentialsMatcher matcher) Filters a map based on credential values using the supplied matcher.
static <C extends Credentials> C	firstOrDefault(Iterable<C> credentials, CredentialsMatcher matcher, C defaultIfNone) Returns the first credential from a collection that matches the supplied matcher or if none match then the specified default.
static <C extends Credentials> C	firstOrNull(Iterable<C> credentials, CredentialsMatcher matcher) Returns the first credential from a collection that matches the supplied matcher or null if none match.
static CredentialsMatcher	instanceOf(Class clazz) Creates a matcher that matches credentials of the specified type.
static CredentialsMatcher	never() Creates a matcher that never matches.
static CredentialsMatcher	noneOf(CredentialsMatcher... matchers) Creates a matcher that matches when none of the supplied matchers match.
static CredentialsMatcher	not(CredentialsMatcher matcher) Creates a matcher that inverts the supplied matcher.
static CredentialsMatcher	withId(String id) Creates a matcher that matches IdCredentials with the supplied IdCredentials.getId()
static CredentialsMatcher	withScope(CredentialsScope scope) Creates a matcher that matches Credentials with the supplied CredentialsScope.
static CredentialsMatcher	withScopes(Collection<CredentialsScope> scopes) Creates a matcher that matches Credentials with the supplied CredentialsScope.
static CredentialsMatcher	withScopes(CredentialsScope... scopes) Creates a matcher that matches Credentials with the supplied CredentialsScope.
static CredentialsMatcher	withUsername(String username) Creates a matcher that matches UsernameCredentials with the supplied UsernameCredentials.getUsername()

Methods inherited from class java.lang.Object

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

Method Detail

always

@NonNull
public static CredentialsMatcher always()

Creates a matcher that always matches.

Returns:

a matcher that always matches.

never

@NonNull
public static CredentialsMatcher never()

Creates a matcher that never matches.

Returns:

a matcher that never matches.

not

@NonNull
public static CredentialsMatcher not(@NonNull
                             CredentialsMatcher matcher)

Creates a matcher that inverts the supplied matcher.

Parameters:

matcher - matcher to invert.

Returns:

a matcher that is the opposite of the supplied matcher.

instanceOf

@NonNull
public static CredentialsMatcher instanceOf(@NonNull
                                    Class clazz)

Creates a matcher that matches credentials of the specified type.

Parameters:

clazz - the type of credential to match.

Returns:

a matcher that matches credentials of the specified type.

withId

@NonNull
public static CredentialsMatcher withId(@NonNull
                                String id)

Creates a matcher that matches IdCredentials with the supplied IdCredentials.getId()

Parameters:

id - the IdCredentials.getId() to match.

Returns:

a matcher that matches IdCredentials with the supplied IdCredentials.getId()

withScope

@NonNull
public static CredentialsMatcher withScope(@NonNull
                                   CredentialsScope scope)

Creates a matcher that matches Credentials with the supplied CredentialsScope.

Parameters:

scope - the CredentialsScope to match.

Returns:

a matcher that matches Credentials with the supplied CredentialsScope.

withScopes

@NonNull
public static CredentialsMatcher withScopes(@NonNull
                                    CredentialsScope... scopes)

Creates a matcher that matches Credentials with the supplied CredentialsScope.

Parameters:

scopes - the CredentialsScopes to match.

Returns:

a matcher that matches Credentials with the supplied CredentialsScopes.

withScopes

@NonNull
public static CredentialsMatcher withScopes(@NonNull
                                    Collection<CredentialsScope> scopes)

Creates a matcher that matches Credentials with the supplied CredentialsScope.

Parameters:

scopes - the CredentialsScopes to match.

Returns:

a matcher that matches Credentials with the supplied CredentialsScopes.

withUsername

@NonNull
public static CredentialsMatcher withUsername(@NonNull
                                      String username)

Creates a matcher that matches UsernameCredentials with the supplied UsernameCredentials.getUsername()

Parameters:

username - the UsernameCredentials.getUsername() to match.

Returns:

a matcher that matches UsernameCredentials with the supplied UsernameCredentials.getUsername()

allOf

@NonNull
public static CredentialsMatcher allOf(@NonNull
                               CredentialsMatcher... matchers)

Creates a matcher that matches when all of the supplied matchers match.

Parameters:

matchers - the matchers to match.

Returns:

a matcher that matches when all of the supplied matchers match.

anyOf

@NonNull
public static CredentialsMatcher anyOf(@NonNull
                               CredentialsMatcher... matchers)

Creates a matcher that matches when any of the supplied matchers match.

Parameters:

matchers - the matchers to match.

Returns:

a matcher that matches when any of the supplied matchers match.

both

@NonNull
public static CredentialsMatcher both(@NonNull
                              CredentialsMatcher matcher1,
                              @NonNull
                              CredentialsMatcher matcher2)

Creates a matcher that matches when both of the supplied matchers match.

Parameters:

matcher1 - the first matcher to match.

matcher2 - the second matcher to match.

Returns:

a matcher that matches when both of the supplied matchers match.

either

@NonNull
public static CredentialsMatcher either(@NonNull
                                CredentialsMatcher matcher1,
                                @NonNull
                                CredentialsMatcher matcher2)

Creates a matcher that matches when either of the supplied matchers match.

Parameters:

matcher1 - the first matcher to match.

matcher2 - the second matcher to match.

Returns:

a matcher that matches when either of the supplied matchers match.

noneOf

@NonNull
public static CredentialsMatcher noneOf(@NonNull
                                CredentialsMatcher... matchers)

Creates a matcher that matches when none of the supplied matchers match.

Parameters:

matchers - the matchers to match.

Returns:

a matcher that matches when none of the supplied matchers match.

filter

@NonNull
public static <C extends Credentials> Collection<C> filter(@NonNull
                                                   Collection<C> credentials,
                                                   @NonNull
                                                   CredentialsMatcher matcher)

Filters credentials using the supplied matcher.

Type Parameters:

C - the type of credentials.

Parameters:

credentials - the credentials to filter.

matcher - the matcher to match on.

Returns:

only those credentials that match the supplied matcher.

filter

@NonNull
public static <C extends Credentials> Set<C> filter(@NonNull
                                            Set<C> credentials,
                                            @NonNull
                                            CredentialsMatcher matcher)

Filters credentials using the supplied matcher.

Type Parameters:

C - the type of credentials.

Parameters:

credentials - the credentials to filter.

matcher - the matcher to match on.

Returns:

only those credentials that match the supplied matcher.

filter

@NonNull
public static <C extends Credentials> List<C> filter(@NonNull
                                             List<C> credentials,
                                             @NonNull
                                             CredentialsMatcher matcher)

Filters credentials using the supplied matcher.

Type Parameters:

C - the type of credentials.

Parameters:

credentials - the credentials to filter.

matcher - the matcher to match on.

Returns:

only those credentials that match the supplied matcher.

filter

@NonNull
public static <C extends Credentials> Iterable<C> filter(@NonNull
                                                 Iterable<C> credentials,
                                                 @NonNull
                                                 CredentialsMatcher matcher)

Filters credentials using the supplied matcher.

Type Parameters:

C - the type of credentials.

Parameters:

credentials - the credentials to filter.

matcher - the matcher to match on.

Returns:

only those credentials that match the supplied matcher.

filterKeys

@NonNull
public static <C extends Credentials,V> Map<C,V> filterKeys(@NonNull
                                                    Map<C,V> credentialMap,
                                                    @NonNull
                                                    CredentialsMatcher matcher)

Filters a map keyed by credentials using the supplied matcher.

Type Parameters:

C - the type of credentials.

V - the type of the map values.

Parameters:

credentialMap - the map keyed by credentials to filter.

matcher - the matcher to match on.

Returns:

only those entries with keys that that match the supplied matcher.

filterValues

@NonNull
public static <C extends Credentials,K> Map<K,C> filterValues(@NonNull
                                                      Map<K,C> credentialMap,
                                                      @NonNull
                                                      CredentialsMatcher matcher)

Filters a map based on credential values using the supplied matcher.

Type Parameters:

K - the type of the map keys.

C - the type of credentials.

Parameters:

credentialMap - the map with credentials values to filter.

matcher - the matcher to match on.

Returns:

only those entries with keys that that match the supplied matcher.

firstOrDefault

@CheckForNull
public static <C extends Credentials> C firstOrDefault(@NonNull
                                                    Iterable<C> credentials,
                                                    @NonNull
                                                    CredentialsMatcher matcher,
                                                    @CheckForNull
                                                    C defaultIfNone)

Returns the first credential from a collection that matches the supplied matcher or if none match then the specified default.

Type Parameters:

C - the type of credential.

Parameters:

credentials - the credentials to select from.

matcher - the matcher.

defaultIfNone - the default value if no match found.

Returns:

a matching credential or the supplied default.

firstOrNull

@CheckForNull
public static <C extends Credentials> C firstOrNull(@NonNull
                                                 Iterable<C> credentials,
                                                 @NonNull
                                                 CredentialsMatcher matcher)

Returns the first credential from a collection that matches the supplied matcher or null if none match.

Type Parameters:

C - the type of credential.

Parameters:

credentials - the credentials to select from.

matcher - the matcher.

Returns:

a matching credential or the supplied default.