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
org.apache.maven.model.Model	getEffectiveModel(File artifactFile, Optional<File> temporaryFolder) Creates the effective pom model by reading the pom inside the artifact.
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, boolean includeProvidedDependencies, Optional<File> localRepositoryLocationSupplier, Optional<File> temporaryFolder) Resolves the artifact dependencies for an artifact.
List<BundleDependency>	resolveArtifactDependencies(File artifactFile, boolean includeTestDependencies, boolean includeProvidedDependencies, Optional<File> localRepositoryLocationSupplier, Optional<MavenReactorResolver> mavenReactorResolver, 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.
VersionRangeResult	resolveVersionRange(BundleDescriptor bundleDescriptor) Resolves for a bundle descriptor with a version range the available versions from remote repositories.

Method Detail

getMavenConfiguration

MavenConfiguration getMavenConfiguration()

Returns:

the maven configuration of this client

resolveVersionRange

VersionRangeResult resolveVersionRange(BundleDescriptor bundleDescriptor)

Resolves for a bundle descriptor with a version range the available versions from remote repositories.

Parameters:

bundleDescriptor - descriptor of the artifact

Returns:

a VersionRangeResult

resolveArtifactDependencies

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

Resolves the artifact dependencies for an artifact. While resolving the dependencies for an artifact it will also take into account the MavenConfiguration.getActiveProfiles() and MavenConfiguration.getInactiveProfiles().

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 of direct dependencies, false otherwise.

includeProvidedDependencies - true if the provided dependencies must be included in the list of direct dependencies, 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. The folder will be used to create temporary files.

Returns:

the list of dependencies of the artifact.

resolveArtifactDependencies

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

Resolves the artifact dependencies for an artifact. While resolving the dependencies for an artifact it will also take into account the MavenConfiguration.getActiveProfiles() and MavenConfiguration.getInactiveProfiles().

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 of direct dependencies, false otherwise.

includeProvidedDependencies - true if the provided dependencies must be included in the list of direct dependencies, 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.

mavenReactorResolver - MavenReactorResolver to look for artifacts first.

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. MavenConfiguration.getActiveProfiles() and MavenConfiguration.getInactiveProfiles() will not be considered when resolving the dependencies and building the pom model.

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. MavenConfiguration.getActiveProfiles() and MavenConfiguration.getInactiveProfiles() will not be considered when resolving the dependencies and building the pom model.

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 list of direct dependencies, 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

getEffectiveModel

org.apache.maven.model.Model getEffectiveModel(File artifactFile,
                                               Optional<File> temporaryFolder)

Creates the effective pom model by reading the pom inside the artifact. Properties defined in the pom file will be resolved.

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

temporaryFolder - a folder to be used for creating temporary files.

Returns:

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.