grammarscope.generator.codedeps

Class Aether

java.lang.Object

grammarscope.generator.codedeps.Aether

public final class Aether
extends java.lang.Object

Resolver of dependencies for one artifact.

#143 This class should be @Immutable, but RemoteRepository is not immutable. Let's create a new class to encapsulate all necessary properties from RemoteRepository.

You need the following dependencies to have in classpath in order to to work with this class:

 org.sonatype.aether:aether-api:1.13.1
 org.apache.maven:maven-core:3.0.3
 

Since:

0.1.6

Version:

$Id$

Author:

Yegor Bugayenko (yegor@tpc2.com)

See Also:

Aether 1.13.1 JavaDoc

Field Summary

Fields

Modifier and Type	Field and Description
private java.io.File	localRepo Location of local repo.
private org.sonatype.aether.repository.RemoteRepository[]	remotes Remote project repositories.
private org.sonatype.aether.RepositorySystem	system Repository system.

Constructor Summary

Constructors

Constructor and Description
Aether(org.sonatype.aether.repository.RemoteRepository[] remotes, java.io.File repo) Public ctor, requires information about all remote repos and one local.

Method Summary

Modifier and Type	Method and Description
private java.util.List<org.sonatype.aether.artifact.Artifact>	fetch(org.sonatype.aether.RepositorySystemSession session, org.sonatype.aether.resolution.DependencyRequest dreq) Fetch dependencies.
private static java.util.Collection<java.lang.String>	reps(java.util.Collection<org.sonatype.aether.repository.RemoteRepository> repos) Convert a list of repositories into a list of strings.
private org.sonatype.aether.collection.CollectRequest	request(org.sonatype.aether.graph.Dependency root) Create collect request.
java.util.List<org.sonatype.aether.artifact.Artifact>	resolve(org.sonatype.aether.artifact.Artifact root, java.lang.String scope) List of transitive deps of the artifact.
java.util.List<org.sonatype.aether.artifact.Artifact>	resolve(org.sonatype.aether.artifact.Artifact root, java.lang.String scope, org.sonatype.aether.graph.DependencyFilter filter) List of transitive deps of the artifact.
private org.sonatype.aether.RepositorySystemSession	session() Create RepositorySystemSession.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

remotes

private final transient org.sonatype.aether.repository.RemoteRepository[] remotes

Remote project repositories.

localRepo

private final transient java.io.File localRepo

Location of local repo.

system

private final transient org.sonatype.aether.RepositorySystem system

Repository system.

Constructor Detail

Aether

public Aether(org.sonatype.aether.repository.RemoteRepository[] remotes,
              java.io.File repo)

Public ctor, requires information about all remote repos and one local.

Parameters:

remotes - Remote repositories

repo - Local repository location (directory path)

Method Detail

resolve

public java.util.List<org.sonatype.aether.artifact.Artifact> resolve(org.sonatype.aether.artifact.Artifact root,
                                                                     java.lang.String scope)
                                                              throws org.sonatype.aether.resolution.DependencyResolutionException

List of transitive deps of the artifact. #51 This "filter IF NOT NULL" validation is a workaround, since I don't know what the actual problem is. Looks like sometimes (for some unknown reason) #classpathFilter() returns NULL. When exactly this may happen I have no idea. That's why this workaround. Sometime later we should do a proper testing and reproduce this defect in a test.

Parameters:

root - The artifact to work with

scope - The scope to work with ("runtime", "test", etc.)

Returns:

The list of dependencies

Throws:

org.sonatype.aether.resolution.DependencyResolutionException - If can't fetch it

resolve

public java.util.List<org.sonatype.aether.artifact.Artifact> resolve(org.sonatype.aether.artifact.Artifact root,
                                                                     java.lang.String scope,
                                                                     org.sonatype.aether.graph.DependencyFilter filter)
                                                              throws org.sonatype.aether.resolution.DependencyResolutionException

List of transitive deps of the artifact.

Parameters:

root - The artifact to work with

scope - The scope to work with ("runtime", "test", etc.)

filter - The dependency filter to work with

Returns:

The list of dependencies

Throws:

org.sonatype.aether.resolution.DependencyResolutionException - If can't fetch it

fetch

private java.util.List<org.sonatype.aether.artifact.Artifact> fetch(org.sonatype.aether.RepositorySystemSession session,
                                                                    org.sonatype.aether.resolution.DependencyRequest dreq)
                                                             throws org.sonatype.aether.resolution.DependencyResolutionException

Fetch dependencies. #51 This catch of NPE is a temporary measure. I don't know why Aether throws NPE in case of unresolvable artifact. This is the best I can do at the moment in order to protect clients of the class.

Parameters:

session - The session

dreq - Dependency request

Returns:

The list of dependencies

Throws:

org.sonatype.aether.resolution.DependencyResolutionException - If can't fetch it

request

private org.sonatype.aether.collection.CollectRequest request(org.sonatype.aether.graph.Dependency root)

Create collect request.

Parameters:

root - The root to start with

Returns:

The request

reps

private static java.util.Collection<java.lang.String> reps(java.util.Collection<org.sonatype.aether.repository.RemoteRepository> repos)

Convert a list of repositories into a list of strings.

Parameters:

repos - The list of them

Returns:

The list of texts

session

private org.sonatype.aether.RepositorySystemSession session()

Create RepositorySystemSession.

Returns:

The session