dev.langchain4j.spi

Class ServiceHelper

java.lang.Object

dev.langchain4j.spi.ServiceHelper

public class ServiceHelper
extends Object

Utility wrapper around ServiceLoader.load().

Method Summary

Modifier and Type	Method and Description
static <T> Collection<T>	loadFactories(Class<T> clazz) Load all the services of a given type.
static <T> Collection<T>	loadFactories(Class<T> clazz, ClassLoader classLoader) Load all the services of a given type.
static <F,T> T	loadFactoryService(Class<F> factoryClass, Function<F,T> factoryBuilder, Supplier<T> defaultBuilder) Load a service provided by a service factory.
static <T,F extends Supplier<T>> T	loadFactoryService(Class<F> factoryClass, Supplier<T> defaultBuilder) Load a service provided by a service factory where the factory is itself a Supplier.
static <F> F	loadService(Class<F> factoryClass, Supplier<F> defaultBuilder) Load a service.

Methods inherited from class java.lang.Object

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

Method Detail

loadService

public static <F> F loadService(Class<F> factoryClass,
                                Supplier<F> defaultBuilder)

Load a service.

Type Parameters:

F - the type of factory.

Parameters:

factoryClass - the type of factory.

defaultBuilder - if no factory is found, build the service.

Returns:

the factory.

loadFactoryService

public static <F,T> T loadFactoryService(Class<F> factoryClass,
                                         Function<F,T> factoryBuilder,
                                         Supplier<T> defaultBuilder)

Load a service provided by a service factory.

Type Parameters:

F - the type of service factory.

T - the type of service.

Parameters:

factoryClass - the type of service factory.

factoryBuilder - given a factory, build the service.

defaultBuilder - if no factory is found, build the service.

Returns:

the service.

loadFactoryService

public static <T,F extends Supplier<T>> T loadFactoryService(Class<F> factoryClass,
                                                             Supplier<T> defaultBuilder)

Load a service provided by a service factory where the factory is itself a Supplier.

Type Parameters:

T - the type of service.

F - the type of service factory

Parameters:

factoryClass - The type of service factory.

defaultBuilder - if no factory is found, build the service.

Returns:

the service.

loadFactories

public static <T> Collection<T> loadFactories(Class<T> clazz)

Load all the services of a given type.

Type Parameters:

T - the type of service

Parameters:

clazz - the type of service

Returns:

the list of services, empty if none

loadFactories

public static <T> Collection<T> loadFactories(Class<T> clazz,
                                              ClassLoader classLoader)

Load all the services of a given type.

Utility mechanism around ServiceLoader.load()

• If classloader is null, will try ServiceLoader.load(clazz)
• If classloader is not null, will try ServiceLoader.load(clazz, classloader)

If the above return nothing, will fall back to ServiceLoader.load(clazz, $this class loader$)

Type Parameters:

T - the type of service

Parameters:

clazz - the type of service

classLoader - the classloader to use, may be null

Returns:

the list of services, empty if none