Interface ResourceFactory

All Known Implementing Classes:

BndResourceFactory, CoreResourceFactory, EclipseResourceFactory, GitResourceFactory, JavaResourceFactory, MvnRepoResourceFactory

public interface ResourceFactory

Defines both an interface for factories that create Resources and factory methods for invoking an appropriate factory.

Field Summary

Fields

Modifier and Type	Field	Description
static final Map<ClassLoader, List<ResourceFactory>>	FACTORIES	The factories as found by the ServiceLoader.

Method Summary

Modifier and Type	Method	Description
static <T extends Resource> T	create(ResourceType<T> type, Object... args)	Short for create(type, null, args).
static <T extends Resource> T	create(ResourceType<T> type, Project project, Object... args)	Returns a new resource with the given type, passing the given arguments to the constructor of the resource.
<T extends Resource> Optional<T>	newResource(ResourceType<T> type, Project project, Object... args)	Returns a new resource of the given type if the factory instance can create it.

Field Details

FACTORIES

static final Map<ClassLoader, List<ResourceFactory>> FACTORIES

The factories as found by the ServiceLoader.

Method Details

create

static <T extends Resource> T create(ResourceType<T> type,
 Project project,
 Object... args)

Returns a new resource with the given type, passing the given arguments to the constructor of the resource. The implementation uses ServiceLoader to find a ResourceFactory that creates the resource, i.e. that does not return Optional.empty() when <T>newResource(org.jdrupes.builder.api.ResourceType<T>,org.jdrupes.builder.api.Project,java.lang.Object...) is called.

The implementation uses ServiceLoader.load(Class, ClassLoader) with the class loader of the Project if provided, or the class loader of the current thread otherwise.

Type Parameters:

T - the generic resource type

Parameters:

type - the resource type

project - the project

args - the additional arguments

Returns:

the resource

create

static <T extends Resource> T create(ResourceType<T> type,
 Object... args)

Short for create(type, null, args).

Type Parameters:

T - the generic resource type

Parameters:

type - the resource type

args - the additional arguments

Returns:

the resource

newResource

<T extends Resource> Optional<T> newResource(ResourceType<T> type,
 Project project,
 Object... args)

Returns a new resource of the given type if the factory instance can create it.

Type Parameters:

T - the generic resource type

Parameters:

type - the resource type

project - the project

args - the additional arguments

Returns:

the result. Optional.empty() if the resource cannot be created by the factory instance.