org.mule.maven.client.api

Interface MavenClient

public interface MavenClient

Maven client API to work with maven artifacts.

To access get an instance of the client use MavenClientProvider.discoverProvider(ClassLoader) which will resolve the implementation through SPI by loading an instance of MavenClientProvider that must be in the classpath.

Since:

1.0

Method Summary

Modifier and Type	Method and Description
MavenConfiguration	getMavenConfiguration()
org.apache.maven.model.Model	getRawPomModel(File artifactFile) Creates the pom model by reading the pom inside the artifact.
List<BundleDependency>	resolveArtifactDependencies(File artifactFile, boolean includeTestDependencies, Optional<File> localRepositoryLocationSupplier, Optional<File> temporaryFolder) Resolves the artifact dependencies for an artifact.
BundleDependency	resolveBundleDescriptor(BundleDescriptor bundleDescriptor) Retrieves the BundleDependency for a BundleDescriptor.
List<BundleDependency>	resolveBundleDescriptorDependencies(boolean includeTestDependencies, boolean includeProvidedDependencies, BundleDescriptor bundleDescriptor) Resolves dependencies of a bundle.
List<BundleDependency>	resolveBundleDescriptorDependencies(boolean includeTestDependencies, BundleDescriptor bundleDescriptor) Resolves dependencies of a bundle.
List<BundleDependency>	resolvePluginBundleDescriptorsDependencies(List<BundleDescriptor> bundleDescriptors) Resolve the effective list of plugins.

Method Detail

getMavenConfiguration

MavenConfiguration getMavenConfiguration()

Returns:

the maven configuration of this client

resolveArtifactDependencies

List<BundleDependency> resolveArtifactDependencies(File artifactFile,
                                                   boolean includeTestDependencies,
                                                   Optional<File> localRepositoryLocationSupplier,
                                                   Optional<File> temporaryFolder)

Resolves the artifact dependencies for an artifact.

Parameters:

artifactFile - the artifact file to resolve the dependencies for. It may be an exploded archive following the mule deployable artifact structure or a compressed artifact following the maven conventions.

includeTestDependencies - true if the test dependencies must be included in the list, false otherwise.

localRepositoryLocationSupplier - a supplier of the local repository folder location. It may be empty in which case the one of the provided maven configuration will be used.

temporaryFolder - a temporary folder that it's only mandatory if the artifact is compressed.

Returns:

the list of dependencies of the artifact.

resolveBundleDescriptorDependencies

List<BundleDependency> resolveBundleDescriptorDependencies(boolean includeTestDependencies,
                                                           BundleDescriptor bundleDescriptor)

Resolves dependencies of a bundle.

Parameters:

includeTestDependencies - true if the test dependencies must be included in the list, false otherwise.

bundleDescriptor - descriptor of the artifact

Returns:

the list of dependencies of the artifact

resolveBundleDescriptorDependencies

List<BundleDependency> resolveBundleDescriptorDependencies(boolean includeTestDependencies,
                                                           boolean includeProvidedDependencies,
                                                           BundleDescriptor bundleDescriptor)

Resolves dependencies of a bundle.

Parameters:

includeTestDependencies - true if the test dependencies must be included in the list, false otherwise.

includeProvidedDependencies - true if the provided dependencies must be included in the dependency graph, false otherwise.

bundleDescriptor - descriptor of the artifact

Returns:

the list of dependencies of the artifact

resolveBundleDescriptor

BundleDependency resolveBundleDescriptor(BundleDescriptor bundleDescriptor)

Retrieves the BundleDependency for a BundleDescriptor.

Parameters:

bundleDescriptor - the bundle descriptor.

Returns:

the resolved BundleDependency

getRawPomModel

org.apache.maven.model.Model getRawPomModel(File artifactFile)

Creates the pom model by reading the pom inside the artifact. It won't solve the effective pom meaning that, for instance, properties defined in parent pom will not be lookup to resolve the pom values.

The artifact can be a compressed file or an exploded artifact. The only requirement is that it contains the expected maven structure.

Parameters:

artifactFile - the compressed artifact

Returns:

the effective pom model

resolvePluginBundleDescriptorsDependencies

List<BundleDependency> resolvePluginBundleDescriptorsDependencies(List<BundleDescriptor> bundleDescriptors)

Resolve the effective list of plugins.

Parameters:

bundleDescriptors - a list of plugins to resolve the effective list of plugins considering their dependencies

Returns:

the effective list of plugins.