Module org.elasticsearch.server

Package org.elasticsearch.plugins

Class PluginsService

java.lang.Object

org.elasticsearch.plugins.PluginsService

All Implemented Interfaces:

ReportingService<PluginsAndModules>

public class PluginsService
extends Object
implements ReportingService<PluginsAndModules>

Nested Class Summary

Nested classes/interfaces inherited from interface org.elasticsearch.node.ReportingService

ReportingService.Info

Field Summary

Fields

Modifier and Type	Field	Description
static final Setting<List<String>>	MANDATORY_SETTING

Constructor Summary

Constructors

Constructor	Description
PluginsService(Settings settings, Path configPath, PluginsLoader pluginsLoader)	Constructs a new PluginService

Method Summary

Modifier and Type	Method	Description
final <T> Stream<T>	filterPlugins(Class<T> type)
final <T> Stream<T>	flatMap(Function<Plugin,Collection<T>> function)	FlatMap a function over all plugins
final void	forEach(Consumer<Plugin> consumer)	Apply a consumer action to each plugin
StablePluginsRegistry	getStablePluginRegistry()
PluginsAndModules	info()	Get information about plugins and modules
<T> List<? extends T>	loadServiceProviders(Class<T> service)	SPI convenience method that uses the ServiceLoader JDK class to load various SPI providers from plugins/modules.
<T> T	loadSingletonServiceProvider(Class<T> service, Supplier<T> fallback)	Loads a single SPI extension.
final <T> Stream<T>	map(Function<Plugin,T> function)	Map a function over all plugins
final Map<String,Plugin>	pluginMap()	Sometimes we want the plugin name for error handling.
protected List<org.elasticsearch.plugins.PluginsService.LoadedPlugin>	plugins()

Methods inherited from class java.lang.Object

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

Field Details

MANDATORY_SETTING

public static final Setting<List<String>> MANDATORY_SETTING

Constructor Details

PluginsService

public PluginsService(Settings settings,
 Path configPath,
 PluginsLoader pluginsLoader)

Constructs a new PluginService

Parameters:

settings - The settings for this node

configPath - The configuration path for this node

pluginsLoader - the information required to complete loading of plugins

Method Details

getStablePluginRegistry

public StablePluginsRegistry getStablePluginRegistry()

map

public final <T> Stream<T> map(Function<Plugin,T> function)

Map a function over all plugins

Type Parameters:

T - The generic type of the result

Parameters:

function - a function that takes a plugin and returns a result

Returns:

A stream of results

flatMap

public final <T> Stream<T> flatMap(Function<Plugin,Collection<T>> function)

FlatMap a function over all plugins

Type Parameters:

T - The generic type of the collection

Parameters:

function - a function that takes a plugin and returns a collection

Returns:

A stream of results

forEach

public final void forEach(Consumer<Plugin> consumer)

Apply a consumer action to each plugin

Parameters:

consumer - An action that consumes a plugin

pluginMap

public final Map<String,Plugin> pluginMap()

Sometimes we want the plugin name for error handling.

Returns:

A map of plugin names to plugin instances.

info

public PluginsAndModules info()

Get information about plugins and modules

Specified by:

info in interface ReportingService<PluginsAndModules>

plugins

protected List<org.elasticsearch.plugins.PluginsService.LoadedPlugin> plugins()

loadServiceProviders

public <T> List<? extends T> loadServiceProviders(Class<T> service)

SPI convenience method that uses the ServiceLoader JDK class to load various SPI providers from plugins/modules.

For example:

 var pluginHandlers = pluginsService.loadServiceProviders(OperatorHandlerProvider.class);
 

Parameters:

service - A templated service class to look for providers in plugins

Returns:

an immutable List of discovered providers in the plugins/modules

loadSingletonServiceProvider

public <T> T loadSingletonServiceProvider(Class<T> service,
 Supplier<T> fallback)

Loads a single SPI extension. There should be no more than one extension found. If no service providers are found, the supplied fallback is used.

Type Parameters:

T - the SPI service type

Parameters:

service - the SPI class that should be loaded

fallback - a supplier for an instance if no providers are found

Returns:

an instance of the service

filterPlugins

public final <T> Stream<T> filterPlugins(Class<T> type)