org.ehcache.core.spi.service

Class ServiceUtils

java.lang.Object

org.ehcache.core.spi.service.ServiceUtils

public final class ServiceUtils
extends java.lang.Object

Helper class to find a service or service configuration matching the wanted type. Note that the class is named ServiceUtils but it would actually work with anything, not only service implementations.

Method Summary

Modifier and Type	Method and Description
static <T> java.util.Collection<T>	findAmongst(java.lang.Class<T> clazz, java.util.Collection<?> instances) Find instances of clazz among the instances.
static <T> java.util.Collection<T>	findAmongst(java.lang.Class<T> clazz, java.lang.Object... instances) Find instances of clazz among the instances.
static <T> java.util.Optional<T>	findOptionalAmongst(java.lang.Class<T> clazz, java.util.Collection<?> instances) Find the only expected instance of clazz among the instances.
static <T> java.util.Optional<T>	findOptionalAmongst(java.lang.Class<T> clazz, java.lang.Object... instances) Find the only expected instance of clazz among the instances.
static <T> T	findSingletonAmongst(java.lang.Class<T> clazz, java.util.Collection<?> instances) Find the only expected instance of clazz among the instances.
static <T> T	findSingletonAmongst(java.lang.Class<T> clazz, java.lang.Object... instances) Find the only expected instance of clazz among the instances.

Methods inherited from class java.lang.Object

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

Method Detail

findAmongst

public static <T> java.util.Collection<T> findAmongst(java.lang.Class<T> clazz,
                                                      java.util.Collection<?> instances)

Find instances of clazz among the instances.

Type Parameters:

T - type of the searched instances

Parameters:

clazz - searched class

instances - instances looked at

Returns:

the list of compatible instances

findAmongst

public static <T> java.util.Collection<T> findAmongst(java.lang.Class<T> clazz,
                                                      java.lang.Object... instances)

Find instances of clazz among the instances.

Type Parameters:

T - type of the searched instances

Parameters:

clazz - searched class

instances - instances looked at

Returns:

the list of compatible instances

findSingletonAmongst

public static <T> T findSingletonAmongst(java.lang.Class<T> clazz,
                                         java.util.Collection<?> instances)

Find the only expected instance of clazz among the instances.

Type Parameters:

T - type of the searched instance

Parameters:

clazz - searched class

instances - instances looked at

Returns:

the compatible instance or null if none are found

Throws:

java.lang.IllegalArgumentException - if more than one matching instance

findOptionalAmongst

public static <T> java.util.Optional<T> findOptionalAmongst(java.lang.Class<T> clazz,
                                                            java.util.Collection<?> instances)

Find the only expected instance of clazz among the instances.

Type Parameters:

T - type of the searched instance

Parameters:

clazz - searched class

instances - instances looked at

Returns:

the optionally found compatible instance

Throws:

java.lang.IllegalArgumentException - if more than one matching instance

findSingletonAmongst

public static <T> T findSingletonAmongst(java.lang.Class<T> clazz,
                                         java.lang.Object... instances)

Find the only expected instance of clazz among the instances.

Type Parameters:

T - type of the searched instance

Parameters:

clazz - searched class

instances - instances looked at

Returns:

the compatible instance or null if none are found

Throws:

java.lang.IllegalArgumentException - if more than one matching instance

findOptionalAmongst

public static <T> java.util.Optional<T> findOptionalAmongst(java.lang.Class<T> clazz,
                                                            java.lang.Object... instances)

Find the only expected instance of clazz among the instances.

Type Parameters:

T - type of the searched instance

Parameters:

clazz - searched class

instances - instances looked at

Returns:

the optionally found compatible instance

Throws:

java.lang.IllegalArgumentException - if more than one matching instance