org.tinylog.configuration

Class ServiceLoader<T>

java.lang.Object

org.tinylog.configuration.ServiceLoader<T>

Type Parameters:

T - Service interface

public final class ServiceLoader<T>
extends Object

Alternative service loader that supports constructors with arguments in opposite to ServiceLoader.

Constructor Summary

Constructors

Constructor and Description
ServiceLoader(Class<? extends T> service, Class<?>... argumentTypes)

Method Summary

Modifier and Type	Method and Description
T	create(String name, Object... arguments) Creates a defined service implementation.
Collection<T>	createAll(Object... arguments) Creates all registered service implementations.
List<T>	createList(String list) Creates service implementations from a comma separated list of names.
String	toSimpleClassName(String name) Generates the simple class name from an acronym.

Methods inherited from class java.lang.Object

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

Constructor Detail

ServiceLoader

public ServiceLoader(Class<? extends T> service,
                     Class<?>... argumentTypes)

Parameters:

service - Service interface

argumentTypes - Expected argument types for constructors

Method Detail

create

public T create(String name,
                Object... arguments)

Creates a defined service implementation. The name can be either the fully-qualified class name or the simplified acronym. The acronym is the class name without package and service suffix.

The acronym for org.tinylog.writers.RollingFileWriter is for example rolling file.

Parameters:

name - Acronym or class name of service implementation

arguments - Arguments for constructor of service implementation

Returns:

A new instance of service or null if failed to create service

createList

public List<T> createList(String list)

Creates service implementations from a comma separated list of names. Names can be either fully-qualified class names or their simplified acronyms. An acronym is the class name without package and service suffix. Optionally, each name can be enriched by a string argument. There must be a colon between the name and argument. All service implementations need a constructor that accepts a string as argument.

Parameters:

list - Comma separated list of names with optional arguments

Returns:

All created service implementations (one for each name)

createAll

public Collection<T> createAll(Object... arguments)

Creates all registered service implementations.

Parameters:

arguments - Arguments for constructors of service implementations

Returns:

Instances of all service implementations

toSimpleClassName

public String toSimpleClassName(String name)

Generates the simple class name from an acronym. A simple class name is the class name without package.

The acronym rolling file, for example, will be transformed into RollingFileWriter for the service interface Writer.

Parameters:

name - Simplified acronym

Returns:

Simple class without package