Package org.talend.sdk.component.api.service.dependency

Interface Resolver

public interface Resolver

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static interface	Resolver.ClassLoaderDescriptor	Abstract a classloader adding the metadata about the resolution done to create it.

Method Summary

Modifier and Type	Method	Description
Resolver.ClassLoaderDescriptor	mapDescriptorToClassLoader(InputStream descriptor)	Creates a classloader from the passed descriptor (dependencies.txt).
default Resolver.ClassLoaderDescriptor	mapDescriptorToClassLoader(InputStream descriptor, ClassLoaderDefinition configuration)	Creates a classloader from the passed classloader configuration and descriptor (dependencies.txt).
default Resolver.ClassLoaderDescriptor	mapDescriptorToClassLoader(List<String> gavs)	Alias to load dependencies from a plain list of gav (groupId:artifactId:version).
default Resolver.ClassLoaderDescriptor	mapDescriptorToClassLoader(List<String> gavs, ClassLoaderDefinition configuration)
Collection<File>	resolveFromDescriptor(InputStream descriptor)	Resolves the dependencies from the descriptor passed as an InputStream.
default Collection<File>	resolveFromDescriptor(List<String> gavs)	Alias to load dependencies from a plain list of gav (groupId:artifactId:version).

Method Details

mapDescriptorToClassLoader

Resolver.ClassLoaderDescriptor mapDescriptorToClassLoader(InputStream descriptor)

Creates a classloader from the passed descriptor (dependencies.txt). WARNING: note it is very important to close the descriptor once no more used otherwise you can leak memory.

Parameters:

descriptor - the dependencies.txt InputStream.

Returns:

the classloader initialized with the resolved dependencies.

mapDescriptorToClassLoader

default Resolver.ClassLoaderDescriptor mapDescriptorToClassLoader(List<String> gavs)

Alias to load dependencies from a plain list of gav (groupId:artifactId:version).

Parameters:

gavs - the dependencies to use to resolve dependencies.

Returns:

the collection of file representing the available dependencies.

mapDescriptorToClassLoader

default Resolver.ClassLoaderDescriptor mapDescriptorToClassLoader(InputStream descriptor,
 ClassLoaderDefinition configuration)

Creates a classloader from the passed classloader configuration and descriptor (dependencies.txt). WARNING: note it is very important to close the descriptor once no more used otherwise you can leak memory.

The default implementation of this method is unsupported and will always throw UnsupportedOperationException. Implementations that support configurable classloader creation must override this method.

Parameters:

descriptor - the dependencies.txt InputStream.

configuration - the classloader configuration to apply when creating the classloader.

Returns:

the classloader initialized with the configuration provided and the resolved dependencies.

Throws:

UnsupportedOperationException - if this implementation does not support configurable classloader creation.

mapDescriptorToClassLoader

default Resolver.ClassLoaderDescriptor mapDescriptorToClassLoader(List<String> gavs,
 ClassLoaderDefinition configuration)

resolveFromDescriptor

Collection<File> resolveFromDescriptor(InputStream descriptor)

Resolves the dependencies from the descriptor passed as an InputStream. IMPORTANT: this is to use when you are sure the file is resolvable if you don't have a fallback. In that last case, prefer the mapDescriptorToClassLoader.

Parameters:

descriptor - the dependencies.txt to use to resolve dependencies.

Returns:

the collection of file representing the available dependencies.

resolveFromDescriptor

default Collection<File> resolveFromDescriptor(List<String> gavs)

Alias to load dependencies from a plain list of gav (groupId:artifactId:version).

Parameters:

gavs - the dependencies to use to resolve dependencies.

Returns:

the collection of file representing the available dependencies.