SoftServiceLoader (Grace Data

org.grails.datastore.mapping.services.SoftServiceLoader

All Implemented Interfaces and Traits:

Iterable
```
public final class SoftServiceLoader<S>
extends Object
implements Iterable
```
Variation of ServiceLoader that allows soft loading and conditional loading of META-INF/services classes.

Type Parameters:
S - The service type
Authors:
Graeme Rocher
Since:
1.0

Field Summary

Fields
Modifiers	Name	Description
`static String`	`META_INF_SERVICES`
`static String`	`PROPERTY_GRAILS_CLASSLOADER_LOGGING`
`static org.slf4j.Logger`	`REFLECTION_LOGGER`

Methods Summary

Methods
Type Params	Return Type	Name and description
	`public Optional<ServiceDefinition<S>>`	`first()` Returns: Return the first such instance
	`public Optional<ServiceDefinition<S>>`	`firstOr(String alternative, ClassLoader classLoader)` Parameters: `alternative` - An alternative type to use if the type is not present
	`public static org.slf4j.Logger`	`getLogger(Class type)` Special case `getLogger` method that should be used by classes that are used in the annotation processor.
	`public boolean`	`hasNext()`
	`public Iterator<ServiceDefinition<S>>`	`iterator()` Returns: The iterator
`<S>`	`public static SoftServiceLoader<S>`	`load(Class<S> service)` Creates a new SoftServiceLoader using the thread context loader by default.
`<S>`	`public static SoftServiceLoader<S>`	`load(Class<S> service, ClassLoader loader)` Creates a new SoftServiceLoader using the given type and class loader.
`<S>`	`public static SoftServiceLoader<S>`	`load(Class<S> service, ClassLoader loader, Predicate<String> condition)` Creates a new SoftServiceLoader using the given type and class loader.
	`protected ServiceDefinition<S>`	`newService(String name, Optional<Class> loadedClass)` Parameters: `name` - The name
	`public ServiceDefinition<S>`	`next()`

Inherited Methods Summary

Inherited Methods
Methods inherited from class	Name
`class Object`	`equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

- Field Detail
  - public static final String META_INF_SERVICES
  - public static final String PROPERTY_GRAILS_CLASSLOADER_LOGGING
  - public static final org.slf4j.Logger REFLECTION_LOGGER
- Method Detail
  - public Optional<ServiceDefinition<S>> first()
    
    Returns:
    Return the first such instance
  - public Optional<ServiceDefinition<S>> firstOr(String alternative, ClassLoader classLoader)
    
    Parameters:
    alternative - An alternative type to use if the type is not present
    classLoader - The classloader
    Returns:
    Return the first such instance
  - public static org.slf4j.Logger getLogger(Class type)
    
    Special case getLogger method that should be used by classes that are used in the annotation processor.
    Parameters:
    type - The type
    Returns:
    The logger
  - @Override
    public boolean hasNext()
  - @Override
    public Iterator<ServiceDefinition<S>> iterator()
    
    Returns:
    The iterator
  - <S> public static SoftServiceLoader<S> load(Class<S> service)
    
    Creates a new SoftServiceLoader using the thread context loader by default.
    Parameters:
    service - The service type
    Type Parameters:
    S - The service generic type
    Returns:
    A new service loader
  - <S> public static SoftServiceLoader<S> load(Class<S> service, ClassLoader loader)
    
    Creates a new SoftServiceLoader using the given type and class loader.
    Parameters:
    service - The service type
    loader - The class loader
    Type Parameters:
    S - The service generic type
    Returns:
    A new service loader
  - <S> public static SoftServiceLoader<S> load(Class<S> service, ClassLoader loader, Predicate<String> condition)
    
    Creates a new SoftServiceLoader using the given type and class loader.
    Parameters:
    service - The service type
    loader - The class loader to use
    condition - A Predicate to use to conditionally load the service. The predicate is passed the service class name
    Type Parameters:
    S - The service generic type
    Returns:
    A new service loader
  - @SuppressWarnings("unchecked")
    protected ServiceDefinition<S> newService(String name, Optional<Class> loadedClass)
    
    Parameters:
    name - The name
    loadedClass - The loaded class
    Returns:
    The service definition
  - @Override
    public ServiceDefinition<S> next()

Summary:
Field
Method

| Detail:
Field
Method

Groovy Documentation

[Java] Class SoftServiceLoader<S>

Field Summary

Methods Summary

Inherited Methods Summary

Field Detail

public static final String META_INF_SERVICES

public static final String PROPERTY_GRAILS_CLASSLOADER_LOGGING

public static final org.slf4j.Logger REFLECTION_LOGGER

Method Detail

public Optional<ServiceDefinition<S>> first()

public Optional<ServiceDefinition<S>> firstOr(String alternative, ClassLoader classLoader)

public static org.slf4j.Logger getLogger(Class type)

@Override
public boolean hasNext()

@Override
public Iterator<ServiceDefinition<S>> iterator()

<S> public static SoftServiceLoader<S> load(Class<S> service)

<S> public static SoftServiceLoader<S> load(Class<S> service, ClassLoader loader)

<S> public static SoftServiceLoader<S> load(Class<S> service, ClassLoader loader, Predicate<String> condition)

@SuppressWarnings("unchecked")
protected ServiceDefinition<S> newService(String name, Optional<Class> loadedClass)

@Override
public ServiceDefinition<S> next()

[Java] Class SoftServiceLoader<S>

Field Summary

Methods Summary

Inherited Methods Summary

Field Detail

public static final String META_INF_SERVICES

public static final String PROPERTY_GRAILS_CLASSLOADER_LOGGING

public static final org.slf4j.Logger REFLECTION_LOGGER

Method Detail

public Optional<ServiceDefinition<S>> first()

public Optional<ServiceDefinition<S>> firstOr(String alternative, ClassLoader classLoader)

public static org.slf4j.Logger getLogger(Class type)

@Overridepublic boolean hasNext()

@Overridepublic Iterator<ServiceDefinition<S>> iterator()

<S> public static SoftServiceLoader<S> load(Class<S> service)

<S> public static SoftServiceLoader<S> load(Class<S> service, ClassLoader loader)

<S> public static SoftServiceLoader<S> load(Class<S> service, ClassLoader loader, Predicate<String> condition)

@SuppressWarnings("unchecked")protected ServiceDefinition<S> newService(String name, Optional<Class> loadedClass)

@Overridepublic ServiceDefinition<S> next()

@Override
public boolean hasNext()

@Override
public Iterator<ServiceDefinition<S>> iterator()

@SuppressWarnings("unchecked")
protected ServiceDefinition<S> newService(String name, Optional<Class> loadedClass)

@Override
public ServiceDefinition<S> next()