Package org.apache.lucene.analysis.util

Class AnalysisSPILoader<S extends AbstractAnalysisFactory>

java.lang.Object

org.apache.lucene.analysis.util.AnalysisSPILoader<S>

public final class AnalysisSPILoader<S extends AbstractAnalysisFactory>
extends Object

Helper class for loading named SPIs from classpath (e.g. Tokenizers, TokenStreams).

Field Summary

Fields

Modifier and Type	Field	Description
private final Class<S>	clazz
private Set<String>	originalNames
private static final Pattern	SERVICE_NAME_PATTERN
private Map<String,Class<? extends S>>	services
private final String[]	suffixes

Constructor Summary

Constructors

Constructor	Description
AnalysisSPILoader(Class<S> clazz)
AnalysisSPILoader(Class<S> clazz, String[] suffixes)
AnalysisSPILoader(Class<S> clazz, String[] suffixes, ClassLoader classloader)

Method Summary

Modifier and Type	Method	Description
Set<String>	availableServices()
private boolean	isValidName(String name)
Class<? extends S>	lookupClass(String name)
static <T extends AbstractAnalysisFactory> T	newFactoryClassInstance(Class<T> clazz, Map<String,String> args)	Creates a new instance of the given AbstractAnalysisFactory by invoking the constructor, passing the given argument map.
S	newInstance(String name, Map<String,String> args)
void	reload(ClassLoader classloader)	Reloads the internal SPI list from the given ClassLoader.

Methods inherited from class java.lang.Object

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

Field Details

services

private volatile Map<String,Class<? extends S extends AbstractAnalysisFactory>> services

originalNames

private volatile Set<String> originalNames

clazz

private final Class<S extends AbstractAnalysisFactory> clazz

suffixes

private final String[] suffixes

SERVICE_NAME_PATTERN

private static final Pattern SERVICE_NAME_PATTERN

Constructor Details

AnalysisSPILoader

public AnalysisSPILoader(Class<S> clazz)

AnalysisSPILoader

public AnalysisSPILoader(Class<S> clazz,
 String[] suffixes)

AnalysisSPILoader

public AnalysisSPILoader(Class<S> clazz,
 String[] suffixes,
 ClassLoader classloader)

Method Details

reload

public void reload(ClassLoader classloader)

Reloads the internal SPI list from the given ClassLoader. Changes to the service list are visible after the method ends, all iterators (e.g., from availableServices(),...) stay consistent.

NOTE: Only new service providers are added, existing ones are never removed or replaced.

This method is expensive and should only be called for discovery of new service providers on the given classpath/classloader!

isValidName

private boolean isValidName(String name)

newInstance

public S newInstance(String name,
 Map<String,String> args)

lookupClass

public Class<? extends S> lookupClass(String name)

availableServices

public Set<String> availableServices()

newFactoryClassInstance

public static <T extends AbstractAnalysisFactory> T newFactoryClassInstance(Class<T> clazz,
 Map<String,String> args)

Creates a new instance of the given AbstractAnalysisFactory by invoking the constructor, passing the given argument map.