org.apache.maven.api

Interface Session

@Experimental
 @ThreadSafe
public interface Session

The session to install / deploy / resolve artifacts and dependencies.

Since:

4.0

Method Summary

Modifier and Type	Method and Description
Node	collectDependencies(Artifact artifact) Shortcut for getService(DependencyCollector.class).collect(...)
Node	collectDependencies(DependencyCoordinate dependency) Shortcut for getService(DependencyResolver.class).resolve(...)
Node	collectDependencies(Project project) Shortcut for getService(DependencyCollector.class).collect(...)
Artifact	createArtifact(String groupId, String artifactId, String version, String extension) Shortcut for getService(ArtifactFactory.class).create(...)
Artifact	createArtifact(String groupId, String artifactId, String version, String classifier, String extension, String type) Shortcut for getService(ArtifactFactory.class).create(...)
ArtifactCoordinate	createArtifactCoordinate(Artifact artifact) Shortcut for getService(ArtifactFactory.class).create(...)
ArtifactCoordinate	createArtifactCoordinate(String groupId, String artifactId, String version, String extension) Shortcut for getService(ArtifactFactory.class).create(...)
ArtifactCoordinate	createArtifactCoordinate(String groupId, String artifactId, String version, String classifier, String extension, String type) Shortcut for getService(ArtifactFactory.class).create(...)
DependencyCoordinate	createDependencyCoordinate(ArtifactCoordinate coordinate) Shortcut for getService(DependencyFactory.class).create(...)
LocalRepository	createLocalRepository(Path path) Shortcut for getService(RepositoryFactory.class).createLocal(...)
RemoteRepository	createRemoteRepository(Repository repository) Shortcut for getService(RepositoryFactory.class).createRemote(...)
RemoteRepository	createRemoteRepository(String id, String url) Shortcut for getService(RepositoryFactory.class).createRemote(...)
void	deployArtifact(RemoteRepository repository, Artifact... artifacts) Shortcut for getService(ArtifactDeployer.class).deploy(...)
Optional<Path>	getArtifactPath(Artifact artifact) Shortcut for getService(ArtifactManager.class).getPath(...)
SessionData	getData()
int	getDegreeOfConcurrency()
Path	getExecutionRootDirectory()
Collection<Listener>	getListeners() Returns the list of registered listeners.
LocalRepository	getLocalRepository()
String	getMavenVersion() Returns the current maven version
Path	getMultiModuleProjectDirectory()
Path	getPathForLocalArtifact(Artifact artifact)
Path	getPathForRemoteArtifact(RemoteRepository remote, Artifact artifact)
Map<String,Object>	getPluginContext(Project project) Returns the plugin context for mojo being executed and the specified Project, never returns null as if context not present, creates it.
List<Project>	getProjects()
List<RemoteRepository>	getRemoteRepositories()
<T extends Service> T	getService(Class<T> clazz) Retrieves the service for the interface
Settings	getSettings()
Instant	getStartTime()
Map<String,String>	getSystemProperties()
Map<String,String>	getUserProperties()
void	installArtifacts(Artifact... artifacts) Shortcut for getService(ArtifactInstaller.class).install(...)
void	installArtifacts(Collection<Artifact> artifacts) Shortcut for getService(ArtifactInstaller.class).install(...)
boolean	isVersionSnapshot(String version) Shortcut for getService(ArtifactManager.class).isSnapshot(...)
Version	parseVersion(String version) Shortcut for getService(VersionParser.class).parseVersion(...)
VersionRange	parseVersionRange(String versionRange) Shortcut for getService(VersionParser.class).parseVersionRange(...)
void	registerListener(Listener listener) Register the given listener which will receive all events.
Artifact	resolveArtifact(Artifact artifact) Shortcut for getService(ArtifactResolver.class).resolve(...)
Artifact	resolveArtifact(ArtifactCoordinate coordinate) Shortcut for getService(ArtifactResolver.class).resolve(...)
Collection<Artifact>	resolveArtifacts(Artifact... artifacts) Shortcut for getService(ArtifactResolver.class).resolve(...)
Collection<Artifact>	resolveArtifacts(ArtifactCoordinate... coordinates) Shortcut for getService(ArtifactResolver.class).resolve(...)
Collection<Artifact>	resolveArtifacts(Collection<? extends ArtifactCoordinate> coordinates) Shortcut for getService(ArtifactResolver.class).resolve(...)
void	setArtifactPath(Artifact artifact, Path path) Shortcut for getService(ArtifactManager.class).setPath(...)
void	unregisterListener(Listener listener) Unregisters a previously registered listener.
Session	withLocalRepository(LocalRepository localRepository) Creates a derived session using the given local repository.
Session	withRemoteRepositories(List<RemoteRepository> repositories) Creates a derived session using the given remote repositories.

Method Detail

getSettings

@Nonnull
Settings getSettings()

getLocalRepository

@Nonnull
LocalRepository getLocalRepository()

getRemoteRepositories

@Nonnull
List<RemoteRepository> getRemoteRepositories()

getData

@Nonnull
SessionData getData()

getUserProperties

@Nonnull
Map<String,String> getUserProperties()

getSystemProperties

@Nonnull
Map<String,String> getSystemProperties()

getMavenVersion

@Nonnull
String getMavenVersion()

Returns the current maven version

Returns:

the maven version, never null.

getDegreeOfConcurrency

int getDegreeOfConcurrency()

getStartTime

@Nonnull
Instant getStartTime()

getMultiModuleProjectDirectory

@Nonnull
Path getMultiModuleProjectDirectory()

getExecutionRootDirectory

@Nonnull
Path getExecutionRootDirectory()

getProjects

@Nonnull
List<Project> getProjects()

getPluginContext

@Nonnull
Map<String,Object> getPluginContext(@Nonnull
                                             Project project)

Returns the plugin context for mojo being executed and the specified Project, never returns null as if context not present, creates it. Implementation note: while this method return type is Map, the returned map instance implements ConcurrentMap as well.

Throws:

MavenException - if not called from the within a mojo execution

getService

@Nonnull
<T extends Service> T getService(@Nonnull
                                          Class<T> clazz)

Retrieves the service for the interface

Throws:

NoSuchElementException - if the service could not be found

withLocalRepository

@Nonnull
Session withLocalRepository(@Nonnull
                                     LocalRepository localRepository)

Creates a derived session using the given local repository.

Parameters:

localRepository - the new local repository

Returns:

the derived session

Throws:

NullPointerException - if localRepository is null

withRemoteRepositories

@Nonnull
Session withRemoteRepositories(@Nonnull
                                        List<RemoteRepository> repositories)

Creates a derived session using the given remote repositories.

Parameters:

repositories - the new list of remote repositories

Returns:

the derived session

Throws:

NullPointerException - if repositories is null

registerListener

void registerListener(@Nonnull
                      Listener listener)

Register the given listener which will receive all events.

Parameters:

listener - the listener to register

Throws:

NullPointerException - if listener is null

unregisterListener

void unregisterListener(@Nonnull
                        Listener listener)

Unregisters a previously registered listener.

Parameters:

listener - the listener to unregister

Throws:

NullPointerException - if listener is null

getListeners

@Nonnull
Collection<Listener> getListeners()

Returns the list of registered listeners.

Returns:

an immutable collection of listeners, never null

createLocalRepository

LocalRepository createLocalRepository(Path path)

Shortcut for getService(RepositoryFactory.class).createLocal(...)

See Also:

RepositoryFactory.createLocal(Path)

createRemoteRepository

@Nonnull
RemoteRepository createRemoteRepository(@Nonnull
                                                 String id,
                                                 @Nonnull
                                                 String url)

Shortcut for getService(RepositoryFactory.class).createRemote(...)

See Also:

RepositoryFactory.createRemote(String, String)

createRemoteRepository

@Nonnull
RemoteRepository createRemoteRepository(@Nonnull
                                                 Repository repository)

Shortcut for getService(RepositoryFactory.class).createRemote(...)

See Also:

RepositoryFactory.createRemote(Repository)

createArtifactCoordinate

ArtifactCoordinate createArtifactCoordinate(String groupId,
                                            String artifactId,
                                            String version,
                                            String extension)

Shortcut for getService(ArtifactFactory.class).create(...)

See Also:

ArtifactFactory.create(Session, String, String, String, String)

createArtifactCoordinate

ArtifactCoordinate createArtifactCoordinate(String groupId,
                                            String artifactId,
                                            String version,
                                            String classifier,
                                            String extension,
                                            String type)

Shortcut for getService(ArtifactFactory.class).create(...)

See Also:

ArtifactFactory.create(Session, String, String, String, String, String, String)

createArtifactCoordinate

ArtifactCoordinate createArtifactCoordinate(Artifact artifact)

Shortcut for getService(ArtifactFactory.class).create(...)

See Also:

ArtifactFactory.create(Session, String, String, String, String, String, String)

createDependencyCoordinate

@Nonnull
DependencyCoordinate createDependencyCoordinate(@Nonnull
                                                         ArtifactCoordinate coordinate)

Shortcut for getService(DependencyFactory.class).create(...)

See Also:

DependencyCoordinateFactory.create(Session, ArtifactCoordinate)

createArtifact

Artifact createArtifact(String groupId,
                        String artifactId,
                        String version,
                        String extension)

Shortcut for getService(ArtifactFactory.class).create(...)

See Also:

ArtifactFactory.create(Session, String, String, String, String)

createArtifact

Artifact createArtifact(String groupId,
                        String artifactId,
                        String version,
                        String classifier,
                        String extension,
                        String type)

Shortcut for getService(ArtifactFactory.class).create(...)

See Also:

ArtifactFactory.create(Session, String, String, String, String, String, String)

resolveArtifact

Artifact resolveArtifact(ArtifactCoordinate coordinate)

Shortcut for getService(ArtifactResolver.class).resolve(...)

Throws:

ArtifactResolverException - if the artifact resolution failed

See Also:

ArtifactResolver.resolve(Session, Collection)

resolveArtifacts

Collection<Artifact> resolveArtifacts(ArtifactCoordinate... coordinates)

Shortcut for getService(ArtifactResolver.class).resolve(...)

Throws:

ArtifactResolverException - if the artifact resolution failed

See Also:

ArtifactResolver.resolve(Session, Collection)

resolveArtifacts

Collection<Artifact> resolveArtifacts(Collection<? extends ArtifactCoordinate> coordinates)

Shortcut for getService(ArtifactResolver.class).resolve(...)

Throws:

ArtifactResolverException - if the artifact resolution failed

See Also:

ArtifactResolver.resolve(Session, Collection)

resolveArtifact

Artifact resolveArtifact(Artifact artifact)

Shortcut for getService(ArtifactResolver.class).resolve(...)

Throws:

ArtifactResolverException - if the artifact resolution failed

See Also:

ArtifactResolver.resolve(Session, Collection)

resolveArtifacts

Collection<Artifact> resolveArtifacts(Artifact... artifacts)

Shortcut for getService(ArtifactResolver.class).resolve(...)

Throws:

ArtifactResolverException - if the artifact resolution failed

See Also:

ArtifactResolver.resolve(Session, Collection)

installArtifacts

void installArtifacts(Artifact... artifacts)

Shortcut for getService(ArtifactInstaller.class).install(...)

Throws:

ArtifactInstallerException - if the artifacts installation failed

See Also:

ArtifactInstaller.install(Session, Collection)

installArtifacts

void installArtifacts(Collection<Artifact> artifacts)

Shortcut for getService(ArtifactInstaller.class).install(...)

Throws:

ArtifactInstallerException - if the artifacts installation failed

See Also:

ArtifactInstaller.install(Session, Collection)

deployArtifact

void deployArtifact(RemoteRepository repository,
                    Artifact... artifacts)

Shortcut for getService(ArtifactDeployer.class).deploy(...)

Throws:

ArtifactDeployerException - if the artifacts deployment failed

See Also:

ArtifactDeployer.deploy(Session, RemoteRepository, Collection)

setArtifactPath

void setArtifactPath(@Nonnull
                     Artifact artifact,
                     @Nonnull
                     Path path)

Shortcut for getService(ArtifactManager.class).setPath(...)

See Also:

ArtifactManager.setPath(Artifact, Path)

getArtifactPath

@Nonnull
Optional<Path> getArtifactPath(@Nonnull
                                        Artifact artifact)

Shortcut for getService(ArtifactManager.class).getPath(...)

See Also:

ArtifactManager.getPath(Artifact)

isVersionSnapshot

boolean isVersionSnapshot(@Nonnull
                          String version)

Shortcut for getService(ArtifactManager.class).isSnapshot(...)

See Also:

VersionParser.isSnapshot(String)

collectDependencies

@Nonnull
Node collectDependencies(@Nonnull
                                  Artifact artifact)

Shortcut for getService(DependencyCollector.class).collect(...)

Throws:

DependencyCollectorException - if the dependency collection failed

See Also:

DependencyCollector.collect(Session, Artifact)

collectDependencies

@Nonnull
Node collectDependencies(@Nonnull
                                  Project project)

Shortcut for getService(DependencyCollector.class).collect(...)

Throws:

DependencyCollectorException - if the dependency collection failed

See Also:

DependencyCollector.collect(Session, Project)

collectDependencies

@Nonnull
Node collectDependencies(@Nonnull
                                  DependencyCoordinate dependency)

Shortcut for getService(DependencyResolver.class).resolve(...)

Throws:

DependencyCollectorException - if the dependency collection failed

See Also:

DependencyCollector.collect(Session, DependencyCoordinate)

getPathForLocalArtifact

Path getPathForLocalArtifact(@Nonnull
                             Artifact artifact)

getPathForRemoteArtifact

Path getPathForRemoteArtifact(RemoteRepository remote,
                              Artifact artifact)

parseVersion

@Nonnull
Version parseVersion(@Nonnull
                              String version)

Shortcut for getService(VersionParser.class).parseVersion(...)

Throws:

VersionParserException - if the parsing failed

See Also:

VersionParser.parseVersion(String)

parseVersionRange

@Nonnull
VersionRange parseVersionRange(@Nonnull
                                        String versionRange)

Shortcut for getService(VersionParser.class).parseVersionRange(...)

Throws:

VersionParserException - if the parsing failed

See Also:

VersionParser.parseVersionRange(String)